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:
AGENDADO
Este status informa que a nota esta agendada para emissão e será posta na fila de processamento.
PROCESSANDO
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.
CONCLUIDO
Este status informa que a nota foi processada e esta com status final de Autorizada.
CANCELADO
Este status informa que a nota consultada esta com status final de Cancelada.
REJEITADO
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
https://api.plugnotas.com.br/nfse/consultar/{{idNfseOrProtocol}}
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:
200 - Resumo da NFSe vinculada ao ID informado, caso exista.
Existe também outra forma para a consulta da nota, nesta utilizaremos o IdIntegração e o CNPJ do prestador, desta forma :
GET
https://api.plugnotas.com.br/nfse/consultar/{{idIntegracao}}/{{cnpj}}
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:
200 - Resumo da NFSe vinculada ao ID informado, caso exista.
Comentários
0 comentário
Por favor, entre para comentar.