O NSU (Número Sequencial Único) é o identificador crescente atribuído pela SEFAZ a cada documento ou evento entregue ao CNPJ de uma empresa através do serviço de Distribuição de DF-e. Funciona como uma "fila de mensagens" da SEFAZ: a empresa consulta "a partir do NSU X" e recebe todos os documentos novos disponíveis até o NSU mais recente.
O que é
O NSU é o mecanismo central do serviço NFeDistribuicaoDFe (Distribuição de Documentos Fiscais Eletrônicos) da SEFAZ Nacional. Por meio desse serviço, qualquer CNPJ pode consultar todas as NF-e emitidas contra ele, eventos de cancelamento, manifestações do destinatário e demais DF-e vinculados ao seu CNPJ.
Cada consulta retorna um pacote de documentos entre o NSU consultado e o NSU atual. A empresa (ou seu sistema) armazena o último NSU recebido e, na próxima consulta, parte de onde parou.
O NSU não é o mesmo que a chave de acesso da NF-e — é um número sequencial geral do ambiente SEFAZ por CNPJ.
Como funciona
Fluxo de captura por NSU:
- Sistema consulta a SEFAZ com CNPJ + último NSU armazenado + certificado digital
- SEFAZ retorna lote com os documentos novos (NSU N+1 até NSU atual)
- Sistema processa e armazena os XMLs
- Sistema atualiza o último NSU para a próxima consulta
- Próxima consulta repete o processo
Se a consulta for feita com NSU zero, a SEFAZ retorna os últimos 90 dias de documentos disponíveis (janela padrão).
Para quem importa
- Destinatários de NF-e: o NSU é a forma oficial de receber notas sem depender de e-mail do fornecedor
- Sistemas de captura fiscal: precisam gerenciar o NSU para não perder documentos nem consultar duplicados
- Contadores: a captura por NSU garante que nenhuma NF-e recebida seja perdida, mesmo que o fornecedor não envie o XML diretamente
Legislação relacionada
- Ajuste SINIEF 07/2005 — define o serviço de Distribuição DF-e
- Manual de Orientação do Contribuinte (MOC) da NF-e — versão vigente
Como o BoxFiscal lida com NSU
O BoxFiscal realiza Captura SEFAZ por NSU de forma automática e contínua para cada empresa cadastrada. O sistema:
- Consulta periodicamente a SEFAZ com o último NSU armazenado
- Suporta multi-page NSU (consultas encadeadas quando há grande volume)
- Usa retry exponencial em caso de falha da SEFAZ
- Registra logs SOAP completos para diagnóstico
- Exibe o status de captura em
/config/monitor
Isso garante que todas as NF-e emitidas contra o CNPJ apareçam no BoxFiscal sem intervenção manual.
Saiba mais sobre gestão de documentos fiscais no BoxFiscal.
