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).

Autenticação com Certificado Digital A1

Para que a API NFER possa realizar a busca legal de documentos fiscais perante os órgãos autorizadores, a empresa precisa possuir um Certificado Digital e-CNPJ A1 (.pfx) ativo e configurado. Todas as chamadas aos webservices governamentais utilizam mTLS 1.2 com assinatura criptográfica da sua empresa.

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.

Algoritmo Anti-cStat 656 NFER

Você não precisa se preocupar com temporizadores manuais: o NFER implementa controle de cooldown automático. Caso uma chamada manual seja realizada antes do tempo mínimo permitido pela SEFAZ, a API retorna status: "cooldown" de forma graciosa sem disparar requisição vazia para o Fisco.

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	SVRS (SEFAZ Virtual do Rio Grande do Sul)