Fluxos de Processamento: NF-e, NFC-e, Taxes e Taxes Payment Forms
| Produto | Emissão de Nota Fiscal de Produto NFE.io (dfetech-product-invoice-api) |
| Documento | 2 de 4: Desenho dos fluxos de processamento |
| Versão | 1.0 (24/09/2026) |
| Público | Clientes, times de arquitetura, TI e área fiscal |
| Documentos relacionados | 1 de 4: Arquitetura · 3 de 4: Processamento, resiliência, idempotência e contingência · 4 de 4: Mensageria e filas · English version |
1. Como ler este documento
Este documento traz os diagramas dos fluxos de cada subproduto. As regras de tempo, os limites de tentativas, as garantias de idempotência e a parametrização da contingência estão explicadas por escrito no documento 3.
Nos diagramas, os nomes em inglês (por exemplo, Issued ou issued_error) são os valores que o cliente vê no campo status da nota e na ação do webhook.
1.1 Visão comum: a vida de uma nota
1.2 Situações da nota (status)
2. NF-e (modelo 55)
2.1 Recepção do pedido (API)
2.2 Criação da nota e cálculo de impostos
2.3 Numeração, assinatura e autorização
2.4 Tratamento da resposta da SEFAZ e consulta pela chave de acesso
2.5 XML de distribuição, notificação e DANFE
2.6 Cancelamento
2.7 Carta de Correção Eletrônica (CC-e)
2.8 Inutilização de numeração
2.9 Contingência EPEC
3. NFC-e (modelo 65)
3.1 Emissão assíncrona
3.2 Emissão síncrona
3.3 Contingência offline (tpEmis=9)
3.4 Transmissão posterior das notas em contingência
3.5 Cancelamento e inutilização
Os fluxos seguem os mesmos passos da NF-e (seções 2.6 e 2.8), com o tipo de evento consumer_invoice. O cancelamento exige a nota autorizada (Issued): uma nota em IssuedContingency ainda não transmitida só pode ser cancelada depois de autorizada. A NFC-e não tem Carta de Correção.
4. Taxes: cálculo de impostos
4.1 Cálculo por item
O IBS e a CBS são calculados em uma chamada separada, feita pela NF-e e pela NFC-e para os itens que pedem o cálculo oficial (seção 6).
4.2 Cadastro de produto
5. Taxes Payment Forms: guias de recolhimento do DIFAL
6. Relação entre NF-e, NFC-e e Taxes
- A NF-e e a NFC-e chamam o Taxes somente quando o cliente pede o cálculo automático nos itens. Sem o pedido, os valores informados no payload são usados como vieram.
- As notas de crédito e as de débito dos tipos 01, 02, 03, 05 e 08 dispensam o cálculo.
- O Taxes não se comunica com a SEFAZ. O Payment Forms não é chamado pela emissão: ele lê a NF-e já autorizada quando o cliente pede a guia.