Como buscar notas destinadas via API do PlugStorage ?

Com o PlugStorage é possível realizar a busca das notas destinadas, basta realizar a configuração do certificado do cliente no painel do parceiro e as notas serão recebidas no PlugStorage, além disso, é possível buscar as notas destinadas no PlugStorage via API, para que você possa realizar a integração com o seu software. O objetivo desse post é ensinar como realizar essa busca de notas destinadas no PlugStorage, utilizando o Postman.  

Para realizar essa busca é necessário que a configuração do certificado do cliente esteja configurado, e as notas destinadas estejam sendo recebidas no portal do PlugStorage, pois essa rota busca as notas no banco de dados do PlugStorage.

Exemplo utilizando Postman

Após abrir o aplicativo, para importar uma coleção de requisições, basta clicar no botão "Import", no canto esquerdo da barra superior, selecionar a opção "Import From Link", colar o endereço abaixo e clicar novamente no botão "Import".

Endereço da coleção de requisições:

https://www.getpostman.com/collections/03a72a9f926b7936f949

A rota da API que vamos precisar utilizar é a de consultar chave das notas, onde é necessário passar alguns parâmetros. Segue um exemplo da utilização da rota no Postman:

Url utilizada:

 https://app.plugstorage.com.br/api/invoices/keys

Params

Utilizar login e senha do cliente, que está configurado para receber as notas destinadas.

Depois de realizar as configurações, basta clicar em "Send". É retornado um Json e se não houve nenhum problema, seu retorno será semelhante a esse:

{
    "error": false,
    "message": "Chaves retornadas.",
    "data": {
        "invoices": [
            {
                "key": "9999999999999999999999999999999999999999999",
                "id": "5556511",
                "mod": "55",
                "serie": "001",
                "cnpj_emitter": "09999999999999",
                "number":"57",
                "date_emission": "2019-07-01",
                "value": 128.7

            },
            {
                "key": "9999999999999999999999999999999999999999999",
                "id": "5556533",
                "mod": "55",
                "serie": "001",
                "cnpj_emitter": "09999999999999",
                "number":"5731",
                "date_emission": "2019-07-01",
                "value": 128.7
            },
            {
                "key": "9999999999999999999999999999999999999999999",
                "id": "5556561",
                "mod": "55",
                "serie": "001",
                "cnpj_emitter": "09999999999999",
                "number":"572",
                "date_emission": "2019-07-01",
                "value": 121.7
            }, continua...
        ],
        "last_id": "5556565",
        "mod": "NFE",
        "count": 30,
        "total": 49
    }
}
 

O retorno máximo em uma requisição é de 30 chaves de notas, e para buscar o restante é necessário preencher o parâmetro last_id, com o código que você obteve no retorno da requisição, segue o exemplo da utilização do restante da busca:

Você terá o restante das busca das notas, onde a propriedade "count" do retorno, terá a quantidade de notas que retornou na segunda busca.

Exemplo json da segunda busca:

{
    "error": false,
    "message": "Chaves retornadas.",
    "data": {
        "invoices": [
            {
                "key": "9999999999999999999999999999999999999999999",
                "id": "24538744",
                "mod": "55",
                "serie": "001",
                "cnpj_emitter": "09999999999999",
                "number":"5767",
                "date_emission": "2019-07-01",
                "value": 178.7
            },
            {
                "key": "9999999999999999999999999999999999999999999",
                "id": "24544895",
                "mod": "55",
                "serie": "001",
                "cnpj_emitter": "09999999999999",
                "number":"5267",
                "date_emission": "2019-07-01",
                "value": 180.7
            },
            {
                "key": "9999999999999999999999999999999999999999999",
                "id": "24558954",
                "mod": "55",
                "serie": "001",
                "cnpj_emitter": "09999999999999",
                "number":"5567",
                "date_emission": "2019-07-01",
                "value": 180.7
            }, continua...
        ],
        "last_id": "24857106",
        "mod": "NFE",
        "count": 19,
        "total": 49
    }
}
 

Com essas informações já é possível buscar o xml da nota destinada, para buscar o xml dessas notas, você pode estar utilizando a rota da API (obter o xml ou pdf de uma nota), onde é necessário passar como parâmetro a chave do xml.

Demonstração GitHub

A Tecnospeed também conta com um repositório oficial no GitHub, onde disponibilizamos algumas demonstrações utilizando essas rotas da API em algumas linguagens. Clique aqui para acessar.

https://github.com/tecnospeed/API_NotaSegura