Fluxos de Processamento da Captura Fiscal — NF-e, CT-e e NFS-e Inbound
| Produto | Captura Fiscal NFE.io (dfetech-distribution-api) |
| Documento | 2 de 3 — Desenho dos fluxos de processamento |
| Versão | 1.1 — 24/09/2026 |
| Público | Clientes, times de arquitetura, TI e área fiscal |
| Documentos relacionados | 1 de 3 — Arquitetura · 3 de 3 — Detalhamento do processamento e regras de periodicidade · English version |
1. Como ler este documento
Este documento traz os diagramas dos fluxos de processamento de cada subproduto. Cada fluxo está dividido em quatro partes:
- Agendamento: como e quando a NFE.io decide consultar o ambiente nacional para uma empresa.
- Captura: a consulta ao governo e o tratamento de cada resposta possível.
- Processamento por documento: o que acontece com cada NSU recebido.
- Fluxos complementares: manifestação, recuperação de lacunas e capturas sob demanda.
As regras de tempo mostradas nos diagramas (intervalos, esperas e bloqueios) estão explicadas e justificadas no documento 3, com referência às Notas Técnicas do governo.
1.1 Fluxo comum aos três produtos
2. NF-e Inbound
2.1 Agendamento e captura
2.2 Processamento de cada NSU
2.3 Manifestação do destinatário e liberação do XML completo
2.4 Recuperação de lacunas de NSU
2.5 Consultas pontuais e limite de consumo (NF-e e CT-e)
Vale para consNSU e consChNFe na NF-e e para consNSU no CT-e, tanto na recuperação de lacunas quanto no reprocessamento pedido pelo cliente.
3. CT-e Inbound
3.1 Agendamento e captura
3.2 Processamento de cada NSU
3.3 Recuperação de lacunas e reprocessamento
O CT-e não possui consulta por chave de acesso no Web Service de distribuição. Toda recuperação é feita por NSU.
4. NFS-e Inbound
4.1 Agendamento e captura
4.2 Processamento de cada documento
4.3 Manifestação do tomador e captura sob demanda
4.4 Recuperação de lacunas
5. Ciclo de vida da cadência de consulta (os três produtos)
| Estado | NF-e | CT-e | NFS-e |
|---|---|---|---|
| Consultando | Consultas encadeadas enquanto ultNSU for menor que maxNSU | Consultas encadeadas enquanto ultNSU for menor que maxNSU | Até 50 lotes seguidos por execução, retomando a cada 30 s |
| Em espera | Mínimo de 1 hora após alcançar o maxNSU ou receber cStat 137 (até cerca de 65 min) | Mínimo de 1 hora após o ambiente indicar fim da fila (cStat 137) | 1 hora após NENHUM_DOCUMENTO_LOCALIZADO |
| Bloqueada | 1 hora por empresa após rejeição, inclusive 656; o 656 também suspende as consultas pontuais do CNPJ | 1 hora por empresa após rejeição, inclusive 656; o 656 em consulta pontual suspende as consultas pontuais do CNPJ | Tempo informado pelo ADN no HTTP 429, ou 1 hora; 10 min após REJEICAO sem documentos capturados; 1 hora por certificado indisponível |
| Pausa global | 5 min (cStat 108) e 20 min (cStat 109) | 5 min (cStat 108) e 20 min (cStat 109) | Disjuntor global e por certificado, 60 s |