Monitor Fiscal & Distribuição DF-e
Sincronização contínua por NSU, certificado A1 mTLS e prevenção de cStat 656.
O Monitor Fiscal (DF-e Recebidos) da API NFER é a infraestrutura de sincronização contínua de todos os documentos fiscais eletrônicos emitidos contra o CNPJ da sua empresa em território nacional. A plataforma conecta-se diretamente aos webservices oficiais da SEFAZ Nacional, SVRS e do Ambiente de Dados Nacional (ADN da Receita Federal).
O Conceito de NSU (Número Sequencial Único)
Diferente de APIs convencionais onde você consulta por parâmetros livres, os servidores da SEFAZ e do ADN trabalham como uma fila ordenada por um contador estritamente crescente chamado NSU (Número Sequencial Único).
| Termo Fiscal | Significado | Como o NFER gerencia |
|---|---|---|
| ultNSU | Último NSU consultado com sucesso pela sua empresa. | O NFER armazena o cursor no banco de dados e nunca repete requisições com o mesmo valor. |
| maxNSU | Maior NSU disponível na SEFAZ até o momento da consulta. | Quando ultNSU == maxNSU, o NFER sabe que todos os documentos foram capturados. |
| resNFe | Resumo da NF-e (apenas emitente, chave e valor). | Capturado no primeiro ciclo. O NFER registra a Ciência para obter o XML completo. |
| procNFe | XML completo da NF-e com produtos e impostos. | Disponibilizado na fila de distribuição após a manifestação do destinatário. |
Prevenção do Bloqueio cStat 656 (Consumo Indevido)
A SEFAZ bloqueia temporariamente certificados e IPs que realizam consultas desnecessárias ou com intervalos inferiores a 60 minutos sem novos documentos.
Modelos Fiscais Suportados
| Modelo | Descrição | Webservice Oficial | Ambiente |
|---|---|---|---|
| NF-e (Mod. 55) | Notas de mercadorias, compras, insumos e devoluções | NfeDistribuicaoDFe | SEFAZ Nacional (Ambiente Central) |
| NFS-e Nacional | Notas de serviços tomados de qualquer município brasileiro | DistribuicaoPorNSU | ADN (Ambiente de Dados Nacional / Receita Federal) |
| CT-e (Mod. 57) | Conhecimentos de transporte rodoviário e fretes contratados | CteDistribuicaoDFe | Ambiente Nacional (Receita Federal / Fazenda Nacional) |
| MDF-e (Mod. 58) | Manifestos eletrônicos de carga, percursos rodoviários e lotes | MdfeDistribuicaoDFe | SEFAZ Nacional (Ambiente Central) |
Notificações em Tempo Real via Webhooks
Não é necessário efetuar polling contínuo para descobrir se novos documentos foram emitidos contra o seu CNPJ. O motor do Monitor Fiscal sincroniza as distribuições oficiais e dispara webhooks HTTP POST em tempo real para o seu sistema sempre que novas notas de compras, serviços tomados ou fretes forem capturados.
Receba eventos automáticos como nfe.recebida.detectada, nfe.recebida.completa, nfse.recebida e cte.recebido com assinatura HMAC-SHA256 e payload estruturado para integração imediata ao seu ERP.