Download de XML NF-e em Dois Sistemas: Por Que Um "Engole" as Notas do Outro

Você já passou por essa situação? O sistema do seu fornecedor baixou as NF-e de entrada e, quando você tenta consultar no seu próprio sistema, nenhuma nota aparece. Parece bug, mas não é. É o comportamento esperado da SEFAZ.

Neste artigo, vamos explicar tecnicamente por que isso acontece, como funciona o serviço de Distribuição DF-e, o que é o famoso NSU, e principalmente: como resolver esse problema na sua transportadora.

Como Funciona o Serviço de Distribuição DF-e

Para baixar os XMLs das NF-e destinadas a sua empresa, utiliza-se o Web Service de Distribuição DF-e oferecido pela SEFAZ. Esse serviço permite que atores interessados (emitente, destinatário, transportador ou terceiros autorizados) consultem documentos fiscais eletrônicos.

O Que é NSU (Número Sequencial Único)?

Cada documento ou evento disponível gera um NSU associado ao CNPJ interessado. Funciona como um identificador sequêncial que indica a ordem de recepção dos documentos no Ambiente Nacional.

Limitações Importantes

Existem duas limitações críticas que você precisa conhecer:

1. Prazo de 90 dias: A SEFAZ só mantém documentos disponíveis por até 90 dias após autorização. NF-e mais antigas não podem ser obtidas por esse serviço.
2. Manifestação obrigatória: Para obter o XML completo, é necessário registrar a Manifestação do Destinatário (Ciência da Operação ou Confirmação). Antes disso, só vem um resumo.

O Problema: Dois Sistemas, Um CNPJ

Aqui está o ponto crucial: para a SEFAZ, não existe "Sistema A" e "Sistema B". Se ambos usam o mesmo CNPJ e certificado digital para consultar o serviço de Distribuição DF-e, eles são tratados como uma única entidade.

Isso significa que quando um sistema consulta e avança o NSU, aqueles documentos são marcados como já distribuídos. O segundo sistema, ao tentar consultar depois, simplesmente não encontra nada.

Por Que Isso Acontece? (Regras NT 2014.002)

A SEFAZ implementou regras rígidas para evitar cargas excessivas no serviço. Os pontos principais da NT 2014.002 são:

1. Consulta Sequencial Obrigatória

A aplicação deve sempre usar o ultNSU fornecido na última resposta. Consultar fora dessa ordem é identificado como uso indevido.

2. Intervalo Mínimo de 1 Hora

Se a consulta retornou cStat=137 (nenhum documento localizado), deve-se aguardar pelo menos 1 hora antes de consultar novamente.

O Que Acontece na Prática?

Quando o Sistema A baixa as notas corretamente e avança o NSU, ao Sistema B tentar consultar:

• cStat=137: "Nenhum documento localizado" - as notas já foram consumidas
• cStat=656: "Consumo Indevido" - consulta fora de sequência, bloqueio de 1h

Em ambos os casos, o segundo sistema não recebe os XMLs. A SEFAZ não redistribui documentos já consultados para o mesmo destinatário.

Como Resolver: 4 Estratégias Práticas

Opção 1: Centralizar em Um Único Sistema (Recomendada)

Eleger um único sistema como fonte de consultas DF-e. O outro sistema deve obter as notas a partir do primeiro (via integração, exportação de XML ou banco de dados compartilhado).

Opção 2: Sincronizar NSU Entre Sistemas

Se for indispensável que ambos consultem a SEFAZ, eles precisam compartilhar o estado do último NSU em um local central (arquivo, tabela ou serviço). Um só consulta se o outro não o fez ainda.

Atenção: Isso é complexo e qualquer deslize (ambos consultarem ao mesmo tempo) resulta em erro.

Opção 3: Usar Serviço Agregador Especializado

Existem soluções especializadas (APIs de captura de NFe) que fazem o trabalho de forma unificada. A empresa usa esse serviço central e integra ambos os sistemas a ele.

Opção 4: Consulta Pontual por Chave de Acesso

Para recuperar notas específicas já consumidas pelo outro sistema, use a consulta por chave (consChNFe) informando a chave de 44 dígitos.

Limitação: Máximo de 20 consultas por hora. Serve para casos pontuais, não para uso massivo.

Checklist: Boas Práticas para Evitar Problemas

Conclusão

Não existe uma maneira suportada de "baixar novamente" via distribuição documentos que outro sistema já consumiu. A SEFAZ não redisponibiliza documentos duplicadamente para o mesmo destinatário.

A solução passa por organização e arquitetura: um único pipeline de download por CNPJ, do qual todos os sistemas interessados possam se alimentar, garantindo que nenhuma NF-e fique de fora.

Grandes empresas de software fiscal resolvem isso com uma arquitetura centralizada: um "monitor de DF-e" faz todas as consultas e armazena os XMLs em uma base unificada. Os demais sistemas consomem dessa base. É exatamente assim que o SmartGT funciona.