O fluxo de envio de notas para o PlugNotas pode gerar dúvidas, mas aqui vamos te explicar de forma clara e simples como ele funciona:

Os envios de notas são realizados de forma assíncrona, ou seja, o retorno imediato do envio não informa se a nota foi autorizada ou rejeitada. Para isso, é necessário consultar o status da nota via API ou configurar um WebHook para receber notificações. Nesta documentação, explicamos ambos os fluxos.

Consideramos que os passos anteriores já foram realizados, como cadastro da empresa, configurações e montagem do JSON.

Fluxo utilizando a consulta

O fluxo se inicia com o envio do JSON da nota via API para o PlugNotas. Assim que recebemos, buscamos os dados da empresa, definimos a numeração, realizamos os cálculos de impostos (se necessário) e geramos o XML para envio à SEFAZ. Simultaneamente, retornamos para você o ID dessa nota no nosso sistema.

A SEFAZ processa a nota e retorna o resultado para o PlugNotas. Para consultar o status da nota (se está autorizada, rejeitada ou em processamento), utilize a rota de consulta informando o ID recebido no envio.

Os possíveis retornos são:

- PENDENTE: Aguardando para ser processada
- CONCLUÍDO: Nota autorizada
- REJEITADO: Nota rejeitada (corrigir e reenviar)
- PROCESSANDO: Aguardando retorno da SEFAZ

Quando autorizada, você pode, se desejar, solicitar o XML e/ou o PDF da nota.

Em caso de rejeição, verifique o motivo, corrija as informações e envie uma nova nota.

Se estiver em processamento, aguarde e realize novas consultas até obter um status final.

Fluxo utilizando o WebHook

Para este fluxo, é fundamental que você configure corretamente o WebHook, que será responsável por receber as notificações de retorno. O passo a passo para configuração está disponível na documentação "Obtendo o Retorno".

Assim como no fluxo anterior, o processo começa com o envio do JSON via API. O PlugNotas realiza a validação dos dados, define a numeração, calcula os impostos (se necessário), monta o XML e envia para a SEFAZ. Nesse momento, o ID da nota já foi retornado para você.

Após o processamento da SEFAZ, o PlugNotas envia automaticamente uma notificação para o WebHook configurado, informando o status final da nota.

As notificações indicam:
- CONCLUÍDO: Nota autorizada
- REJEITADO: Nota rejeitada

Caso a nota seja autorizada, você pode gerar o PDF e/ou o XML conforme sua necessidade.

Em caso de rejeição, é necessário verificar o motivo, realizar os ajustes e enviar uma nova nota.

Importante: notificações via WebHook são enviadas apenas quando a nota chega em um status final (CONCLUÍDO ou REJEITADO). Notas em PROCESSANDO não disparam notificações.