Com a NFSe, temos dois tipos de consulta, uma retornará exatamente o JSON que foi enviado para processamento e na outra rota será retornado o resultado do processamento da nota como um resumo da NFSe, neste retorno será possível encontrar as principais informações das notas, como Número, Código de verificação, entre outros. Caso queira realizar a consulta do JSON da NFSe enviada basta verificar a rota Consultando uma Nota (JSON de envio) .

Para realizar a consulta da nota enviada pela rota de Envio e obter o resumo da NFSe, vamos utilizar a rota de consulta de NFSe da API.  Temos todos os exemplos disponíveis sobre as rotas em nossa documentação API PlugNotas.

 

 

Durante a consulta podemos nos deparar com alguns status, são eles:

 

 Este status informa que a nota esta agendada para emissão e será posta na fila de processamento.

 

 

 Este status informa que a nota ainda está sendo processada, porém, não obteve o status final do processamento.

Isso significa que a nota está nas mãos da API, em alguma fase do processamento, desde o início da fila até obter o retorno da prefeitura.

Em todo esse caminho, nós cuidamos da nota para você de maneira automática.

 

Este status informa que a nota foi processada e esta com status final de Autorizada.

 

 

Este status informa que a nota consultada esta com status final de Cancelada.

 

 

 Este status informa que as informações enviadas no JSON foram processadas pela API e rejeitada por algum motivo. Essa rejeição pode ter sido por um erro nas informações enviadas (parou na validação da API), ou rejeitada pela própria prefeitura. Caso o motivo da rejeição não esteja claro para você*, é necessário entrar em contato com a consultoria para análise da motivação da Rejeição e tratamento para o reenvio.

 *Nós temos um mapeamento gigante de rejeições e tratamentos que são feitos na nota para reprocessar e tratar rejeições relacionadas a instabilidades, porém é comum recebermos retornos dos webservices que são genéricos ou não deixam claro o que fazer. Como nossa API é transparente e retorna exatamente a mesma mensagem da prefeitura para você, se sentir necessidade de ajuda para tratar a mensagem entre em contato conosco pelo chat ou ticket

 

A consulta pode ser feita como no exemplo :

 

 

GET

 

 

 

Headers

 

Nome	Descrição	Exemplo
accept	Indica a forma de retorno do arquivo	application/json
x-api-key	Aqui deverá ser informado seu token do PlugNotas	TOKEN

 

 

 

 

Response:

 

 

 

Existe também outra forma para a consulta da nota, nesta utilizaremos o IdIntegração e o CNPJ do prestador, desta forma :

 

 

GET

 

 

 

Headers

 

Nome	Descrição	Exemplo
accept	Indica a forma de retorno do arquivo	application/json
x-api-key	Aqui deverá ser informado seu token do PlugNotas	TOKEN

 

 

 

 

Response: