Distribuição de DF-e no XmlCenter: NSUs, Demora da SEFAZ e Diagnóstico

---
title: "Distribuição de DF-e no XmlCenter: NSUs, Demora da SEFAZ e Diagnóstico"
slug: "distribuicao-dfe-xmlcenter"
sistema:
  - "XmlCenter [15]"
chamado: "0000567806"
categoria: user_manual
tipo: how-to
publico: "Suporte"
autor: "Gustavo"
setor: "Suporte"
modulo: "Distribuição DF-e"
keywords:
  - NSU
  - ultNSU
  - maxNSU
  - NfeDistribuicaoDFe
  - Rejeição 656
  - Consumo Indevido
  - cStat 137
  - Manifestação do Destinatário
  - Ambiente Nacional
  - Nota Técnica 2014.002
versao_doc: "1.0"
revisao: "2026-06-12"
ultima_revisao: ""
aprovado_em: ""
versao_pipeline: ""
---

## Visão Geral

O Serviço de Distribuição de Documentos Fiscais Eletrônicos (NfeDistribuicaoDFe) é o WebService da SEFAZ Nacional pelo qual o XmlCenter consulta e baixa as Notas Fiscais Eletrônicas (NF-e) e Conhecimentos de Transporte Eletrônicos (CT-e) emitidos contra o Cadastro Nacional da Pessoa Jurídica (CNPJ) de um cliente. Entender como funciona a fila de Números Sequenciais Únicos (NSU), por que as notas às vezes demoram horas para aparecer e como a SEFAZ pune o uso ineficiente do serviço permite à equipe de suporte diagnosticar com propriedade técnica e argumentar com o cliente quando a lentidão não é falha do software (chamado 0000567806).

## Ficha

- **Público:** Equipe de suporte (1º e 2º nível) do XmlCenter
- **Pré-requisitos:** acesso ao servidor de notas do cliente para inspeção dos arquivos de log
- **Quando usar:** ao atender chamados de "nota não localizada", "nota demora para aparecer" ou "XML não baixa" no XmlCenter

## Entender o Serviço de Distribuição de DF-e (NfeDistribuicaoDFe)

O Serviço de Distribuição de DF-e (NfeDistribuicaoDFe) é o WebService da SEFAZ Nacional que permite a uma empresa — ou aos atores envolvidos, como transportadores e contadores — consultar e baixar os documentos fiscais eletrônicos (NF-e, CT-e) emitidos contra o seu CNPJ.

> **Nota:** A SEFAZ nunca envia notas por "vontade própria". O XmlCenter precisa consultar ativamente, de tempos em tempos, perguntando à SEFAZ se há algo novo para aquele CNPJ. Não existe entrega automática (push) do governo para o sistema.

## Interpretar a lógica de NSUs (ultNSU e maxNSU)

No Serviço de Distribuição de DF-e, **NSU** significa **Número Sequencial Único** — um contador cronológico de eventos gerados dentro da SEFAZ para um destinatário, equivalente a uma "senha de fila".

- **Como o NSU nasce:** toda vez que uma NF-e é emitida contra o CNPJ, ou que ocorre um evento atrelado a ela (cancelamento, carta de correção ou manifestação), a SEFAZ cria um novo NSU exclusivo para aquele destinatário.
- **A sequência:** começa no **1** e sobe de 1 em 1 (2, 3, 4, 5...). A SEFAZ nunca pula números para um mesmo CNPJ.
- **`ultNSU` (Último NSU):** o número do último documento ou evento que o XmlCenter conseguiu baixar com sucesso.
- **`maxNSU` (NSU Máximo):** o número do último evento gerado no banco de dados da SEFAZ — o "topo da fila" atual do governo.

### Calcular a busca em lote de até 50 documentos

Quando o XmlCenter faz uma consulta ao Serviço de Distribuição de DF-e, ele envia o seu `ultNSU` e a SEFAZ devolve um lote com **no máximo 50 documentos ou eventos** sequenciais a partir dali. O sistema só para de buscar quando o `ultNSU` ficar **igual** ao `maxNSU`.

Por exemplo, se o `ultNSU` do cliente é **100** e o `maxNSU` na SEFAZ é **250**, o sistema precisa de pelo menos 3 consultas seguidas para trazer tudo:

1. Consulta 1: busca do 101 ao 150 (atualiza `ultNSU` para 150).
2. Consulta 2: busca do 151 ao 200 (atualiza `ultNSU` para 200).
3. Consulta 3: busca do 201 ao 250 (atualiza `ultNSU` para 250).

## Diferenciar o resumo da NF-e do XML completo

Uma dúvida frequente do cliente é por que a nota aparece na tela, mas não é possível ver os produtos ou o XML completo. No Serviço de Distribuição de DF-e, isso ocorre por causa das regras de Manifestação do Destinatário:

1. **Resumo da NF-e:** inicialmente a SEFAZ entrega apenas um resumo da nota (chave de acesso, CNPJ do emitente, valor e data). O destinatário ainda não tem direito ao XML completo de forma direta.
2. **Manifestação:** para liberar o XML completo, o destinatário precisa se manifestar. O XmlCenter normalmente envia uma **Ciência da Operação** de forma automática.
3. **Liberação:** assim que a SEFAZ processa a manifestação, ela gera um **novo NSU** contendo, finalmente, o XML completo com todos os itens para download.

## Reconhecer a Rejeição 656 (Consumo Indevido)

Para evitar que robôs sobrecarreguem os servidores federais, a SEFAZ pune o uso ineficiente do WebService de Distribuição de DF-e. Quando o cliente cai em Consumo Indevido, o CNPJ fica **bloqueado por 1 hora**. A equipe de suporte deve identificar os três gatilhos da Rejeição 656:

| Gatilho | Motivo | Regra da SEFAZ |
| :--- | :--- | :--- |
| **Consultar sem novidades** | O sistema consulta a SEFAZ e ela responde `cStat = 137` (Nenhum documento localizado), ou seja, o cliente já está emparelhado com o `maxNSU`. | O sistema é **obrigado** a aguardar 1 hora antes de tentar de novo. |
| **Fora de sequência** | O sistema precisa pedir os NSUs estritamente na ordem. Se o último foi o 150, a próxima requisição deve partir do 150. | Quebra de sequência ou pedido de lotes antigos/futuros de forma aleatória gera bloqueio. |
| **Excesso por documento** | Consultar repetidamente uma mesma chave de acesso ou NSU específico. | Há um limite rígido de 20 consultas por hora para um mesmo documento. |

> ⚠️ **Atenção:** Se o CNPJ foi bloqueado por Consumo Indevido, o cliente precisa **esperar 1 hora inteira sem forçar novas consultas**. Cada nova tentativa durante a penalidade **zera o cronômetro** da SEFAZ, e a contagem de 1 hora recomeça do início.

## Explicar a demora da SEFAZ na chegada das notas

Quando o fornecedor afirma que "já emitiu a nota" mas ela não aparece no XmlCenter, o suporte deve explicar o caminho físico da informação no Serviço de Distribuição de DF-e:

1. **Autorização local:** o fornecedor emite a nota, que é autorizada na SEFAZ do estado dele (ex.: SEFAZ-SP, SEFAZ-MG). O emitente já tem o XML em mãos, mas o destinatário ainda não.
2. **Sincronização:** a SEFAZ estadual precisa transmitir os dados para o **Ambiente Nacional (AN)** da SEFAZ. Esse processo não é instantâneo — pode levar minutos ou várias horas em dias de alto volume ou de lentidão governamental.
3. **Geração de NSU:** quando a nota chega ao Ambiente Nacional, ela entra em uma fila interna para receber um NSU correspondente ao CNPJ do destinatário. Só depois que esse NSU é gerado o XmlCenter consegue enxergar e baixar o arquivo.

### Entender por que o XmlCenter não acelera o processo

O XmlCenter não tem como antecipar a chegada de uma nota porque depende da liberação sequencial da SEFAZ no Serviço de Distribuição de DF-e:

- **Fila de mão única:** o sistema depende da liberação sequencial da SEFAZ. Não há como "adivinhar" o número de uma nota ou saltar a fila de NSUs.
- **Risco de bloqueio:** forçar consultas repetidas para tentar acelerar o processo dispara a Rejeição 656, atrasando ainda mais a rotina do cliente.

## Investigar a lentidão nos logs do XmlCenter

Para provar tecnicamente se a lentidão está no sistema ou na SEFAZ, o analista de suporte inspeciona os arquivos de log gerados no servidor de notas. A estrutura completa de pastas e as subpastas de auditoria estão detalhadas em [Organização de logs do XmlCenter](https://docs.teorema.inf.br/doc/f1964dc4-5b71-11f1-9837-0242ac1a0002). Os logs de comunicação são gerados de hora em hora e organizados em subpastas conforme o padrão:

```text
server\log\xml-center\[Modelo_da_Nota]\[Código_da_Empresa]\[Ano]\[Mês]\[Dia]\
```

Por exemplo, para uma nota de modelo 55 (NF-e), da empresa 0001, emitida em 12 de junho de 2026, os arquivos por hora ficam em:

```text
server\log\xml-center\55\0001\2026\06\12\
```

### Diagnosticar o arquivo de log

No arquivo de log do horário em que o cliente relata que a nota sumiu, execute os seguintes diagnósticos:

1. **Valores de NSU:** localize os registros de envio e retorno que mostram o `ultNSU` e o `maxNSU`.
2. **Prova de inércia da SEFAZ:** se o log mostrar `ultNSU` **igual** ao `maxNSU`, o XmlCenter já buscou e processou **tudo** o que o governo disponibilizou na fila do cliente até aquele instante.
3. Se os dois valores forem iguais e a nota pretendida não estiver na listagem, a lentidão está na sincronização interestadual da SEFAZ — não há falha no software.
4. **Erros de bloqueio:** procure pelas expressões `Consumo Indevido` ou pelo código `656`. Se encontrar, o download foi interrompido temporariamente pelas travas de segurança da própria SEFAZ.

## Aplicar o checklist de atendimento para "nota não localizada"

Ao receber um chamado de "nota não localizada" ou "nota não baixa" no XmlCenter, siga rigorosamente estes passos:

1. **Verificar uso de múltiplos sistemas:** questione se o cliente ou o escritório de contabilidade usam outra ferramenta de captura de XML (ex.: Arquivei, Sieg, Qive) com o **mesmo certificado digital**. Se duas ferramentas consultam o Serviço de Distribuição de DF-e simultaneamente, uma "rouba" o `ultNSU` da outra, quebra a sequência e gera Consumo Indevido automático. O comportamento da sequência de NSUs entre sistemas concorrentes é detalhado em [Melhorias Xml Center](https://docs.teorema.inf.br/doc/b6eff47c-5ab8-11f1-af76-0242ac1b0002).
2. **Analisar erros nos logs:** acesse o diretório de logs do XmlCenter do dia corrente e analise o retorno da SEFAZ. Ao encontrar a Rejeição 656, oriente o cliente a aguardar 1 hora sem interações.
3. **Verificar emparelhamento:** confirme no log se `ultNSU == maxNSU`. Se sim, a fila do cliente está zerada e a demora é da SEFAZ — oriente o cliente conforme [Explicar a demora da SEFAZ na chegada das notas](#explicar-a-demora-da-sefaz-na-chegada-das-notas).

## Troubleshooting

| Sintoma | Causa provável | Solução |
|---|---|---|
| Nota emitida pelo fornecedor não aparece no XmlCenter | Sincronização interestadual da SEFAZ até o Ambiente Nacional ainda não concluída; NSU do destinatário não foi gerado | Confirmar no log que `ultNSU == maxNSU`; orientar o cliente a aguardar a liberação da SEFAZ, sem forçar consultas — ver [Explicar a demora da SEFAZ](#explicar-a-demora-da-sefaz-na-chegada-das-notas) |
| CNPJ bloqueado / `Rejeição 656` ou `Consumo Indevido` no log | Consultas sem novidade (`cStat 137`), fora de sequência ou em excesso por documento | Orientar o cliente a aguardar 1 hora **inteira** sem novas tentativas (cada tentativa zera o cronômetro) — ver [Reconhecer a Rejeição 656](#reconhecer-a-rejeicao-656-consumo-indevido) |
| Sequência de NSU quebrando / Consumo Indevido recorrente | Outra ferramenta de captura de XML usa o mesmo certificado digital e disputa o `ultNSU` | Identificar e desativar a ferramenta concorrente, ou integrar a sequência de NSUs entre os sistemas |
| Nota aparece na tela, mas sem produtos / XML completo | Apenas o resumo da NF-e foi entregue; falta processar a Manifestação do Destinatário | Aguardar o XmlCenter enviar a Ciência da Operação e a SEFAZ gerar o novo NSU com o XML completo — ver [Diferenciar o resumo da NF-e do XML completo](#diferenciar-o-resumo-da-nf-e-do-xml-completo) |
| Log do XmlCenter vazio / sem registros de consulta | Geração de logs desativada no servidor | Ativar os logs no `server.ini` do servidor de notas e monitorar as próximas consultas — parâmetros em [Melhorias no XmlCenter e novas tags do `server.ini`](https://docs.teorema.inf.br/doc/f5cd1cc0-5b4d-11f1-9a47-0242ac1a0002) |
| Notas mais novas atrasam atrás de NSUs não localizados na fila | Sequência travada em NSUs antigos que a SEFAZ ainda não disponibilizou | Avaliar as tags `CONSULTA_NSUS_FALTANTES_PULAR_NAO_LOCALIZADOS` e `CONSULTA_NSUS_FALTANTES_ORDEM_DECRESCENTE` no `server.ini` — ver [Melhorias no XmlCenter e novas tags do `server.ini`](https://docs.teorema.inf.br/doc/f5cd1cc0-5b4d-11f1-9a47-0242ac1a0002) |

## Referências técnicas e legislação

Para respaldar o conhecimento da equipe ou responder a auditorias de clientes, consulte a documentação oficial da SEFAZ sobre o Serviço de Distribuição de DF-e:

- **Nota Técnica 2014.002 (versão atualizada):** regulamenta o WebService de Distribuição de DF-e (NfeDistribuicaoDFe), definindo as regras de controle de NSU, as mensagens de retorno (`cStat 137`) e as punições por Consumo Indevido (Rejeição 656).
- **Manual de Orientação do Contribuinte (MOC):** define os padrões técnicos de comunicação e os esquemas XML utilizados no processo.
- **Portal Nacional da NF-e:** [nfe.fazenda.gov.br](https://www.nfe.fazenda.gov.br/) — onde constam as tabelas de indisponibilidade de serviços e os avisos de manutenção do Ambiente Nacional.

### Documentos relacionados no XmlCenter

- [Melhorias Xml Center](https://docs.teorema.inf.br/doc/b6eff47c-5ab8-11f1-af76-0242ac1b0002) — sequência de NSUs e o impacto de múltiplos sistemas buscadores de XML no mesmo CNPJ.
- [Melhorias no XmlCenter e novas tags do `server.ini`](https://docs.teorema.inf.br/doc/f5cd1cc0-5b4d-11f1-9a47-0242ac1a0002) — parâmetros de consulta, limites de download e tratamento de NSUs não localizados.
- [Organização de logs do XmlCenter](https://docs.teorema.inf.br/doc/f1964dc4-5b71-11f1-9837-0242ac1a0002) — estrutura de pastas dos logs por hora e planilhas de auditoria de NSU.

## Informações do documento

> Autor: Gustavo
> Setor: Suporte
> Módulo: Distribuição DF-e
> Chamado: 0000567806
> Versão do Sistema:
> Aprovado em: