Entendo o fluxo de envio das notas

O fluxo de envio de notas para o PlugNotas pode te deixar confuso, mas aqui vamos explicar de forma simples como ela funciona :)

Os envios de notas são realizados de forma assíncrona, o que significa que o retorno direto do seu envio, NÃO é informando se a nota está autorizada ou não. Para isso, será necessário o uso de consultas dessas notas ou o uso do webhook para receber notificações. Nessa documentação, ambos os fluxos estão explicados. 

Nesse fluxo, vamos assumir que os passos anteriores já foram realizados, como todos os cadastros, configurações da empresa e informações dentro do json.

Fluxo utilizando a consulta

O fluxo se inicia com o envio do arquivo json via API para o PlugNotas. Quando chega ali, nós vamos mapear para qual cidade será o envio, buscar os dados do cadastro da empresa, contabilizar o RPS, realizar os cálculos de impostos e valores (caso eles não constem no json) e montar o XML para enviar isso tudo para a prefeitura. Ao mesmo tempo em que todo esse processo é feito, a API já retornou para você o ID dessa nota dentro do nosso banco de dados.

A prefeitura vai processar essa nota e retornar para nós. Para que você consiga saber o resultado do processamento ou se ela ainda permance em processamento, você deve utilizar a rota de consulta de notas usando como filtro o ID retornado da rota de envio.

O retorno da consulta vai dizer se a nota foi autorizada (CONCLUÍDO), rejeitada (REJEITADO) ou se ainda está pendente de processamento (PROCESSANDO).

Em caso de autorização, o processo por si só está finalizado, mas caso seja do seu interesse ou do seu cliente, você pode solicitar o PDF e/ou o XML dessa nota para o PlugNotas.

Em caso de rejeição, você deve analisar o motivo da rejeição e aplicar a correção, gerando um novo envio depois disso.

Em caso de processamento pendente, resta apenas aguardar e realizar novas consultas periódicamente para saber se o processo foi finalizado.

Fluxo utilizando o WebHook

Para esse fluxo é primordial que se realize as configurações do WebHook para o qual enviaremos as notificações. A documentação após essa aqui, explica sobre o WebHook.

O fluxo se inicia com o envio do arquivo json via API para o PlugNotas. Quando chega ali, nós vamos mapear para qual cidade será o envio, buscar os dados do cadastro da empresa, contabilizar o RPS, realizar os cálculos de impostos e valores (caso eles não constem no json) e montar o XML para enviar isso tudo para a prefeitura. Ao mesmo tempo em que todo esse processo é feito, a API já retornou para você o ID dessa nota dentro do nosso banco de dados.

A prefeitura vai processar essa nota e retornar para nós. Para que você consiga saber o resultado do processamento, você receberá uma notificação via webhook configurado anteriormente.

O retorno desse WebHook vai dizer se a nota foi autorizada (CONCLUÍDO) ou rejeitada (REJEITADO).

Em caso de autorização, o processo por si só está finalizado, mas caso seja do seu interesse ou do seu cliente, você pode solicitar o PDF e/ou o XML dessa nota para o PlugNotas.

Em caso de rejeição, você deve analisar o motivo da rejeição e aplicar a correção, gerando um novo envio depois disso.

Notas pendentes de processamento não serão notificadas, apenas notas em estado final.