Como baixar os XMLs dos seus clientes automaticamente pelo CNPJ
Resposta rápida: para baixar os XMLs de um cliente automaticamente, vincule o CNPJ do escritório (ou o certificado digital do cliente) a uma ferramenta de captura fiscal e ative o download por CNPJ. As notas emitidas contra o cliente são puxadas direto do Ambiente Nacional da SEFAZ, via Web Service de Distribuição de DF-e (NFeDistribuicaoDFe / CTeDistribuicaoDFe), em consultas periódicas (de hora em hora, por exemplo); as emitidas pelo cliente dependem de o sistema dele disponibilizar os arquivos. Com a autorização correta — a tag `autXML` na emissão ou a manifestação do destinatário —, o XML completo chega sem você precisar pedir.
Buscar XML manualmente, nota a nota, é um dos maiores ladrões de tempo do escritório. A boa notícia: dá para automatizar quase tudo. A seguir, o passo a passo técnico, com base nas regras oficiais da SEFAZ, para o seu escritório capturar NF-e, NFC-e e CT-e dos clientes do varejo por CNPJ.
1. Entenda os dois fluxos de XML por CNPJ
Antes de automatizar, separe a operação do cliente em dois fluxos — cada um tem uma regra diferente de download:
- Notas que o cliente recebe (compras de fornecedores — NF-e e CT-e): podem
ser capturadas no Ambiente Nacional da SEFAZ a partir do CNPJ do destinatário, mesmo sem o fornecedor enviar nada — desde que exista autorização. É aqui que mora a automação real por CNPJ.
- Notas que o cliente emite (vendas — NF-e e NFC-e): ficam no sistema de
gestão do cliente. A captura automática depende de o ERP dele exportar ou disponibilizar os XMLs, porque a SEFAZ não distribui livremente a venda do emitente para terceiros do jeito que faz com as notas de entrada.
Entender essa divisão evita a frustração de achar que "tudo" se baixa por CNPJ. A entrada, sim. A saída própria, depende do ERP do cliente.
2. Baixar XML automático por CNPJ pelo Ambiente Nacional (Distribuição de DF-e)
O coração da captura automática é o Web Service de Distribuição de DF-e, o serviço da SEFAZ que entrega ao interessado os documentos fiscais eletrônicos e seus eventos vinculados ao seu CNPJ. Para NF-e o serviço é o `NFeDistribuicaoDFe`; para conhecimento de transporte, o `CTeDistribuicaoDFe`. Ambos são compartilhados por todas as SEFAZ estaduais e concentrados no Ambiente Nacional.
A mecânica é incremental e baseada no NSU (Número Sequencial Único): a cada consulta, a ferramenta informa o último NSU já recebido e a SEFAZ devolve apenas o que é novo a partir dali. É por isso que dá para rodar a captura de hora em hora sem reprocessar tudo — o serviço só entrega o que entrou de novo desde a última leitura. Os documentos ficam disponíveis para distribuição por até 3 meses após a recepção no Ambiente Nacional, então a captura periódica é essencial: não convém deixar acumular.
O serviço retorna dois tipos de conteúdo:
- Resumos (resumo da NF-e e resumo de eventos): uma prévia com chave de acesso, valor, emitente e situação — disponível assim que a nota é autorizada contra o CNPJ.
- Documento completo (o XML `procNFe`/`procCTe` e os XMLs dos eventos): liberado conforme a autorização do interessado, como veremos nos passos 3 e 4.
Para acessar o serviço, o solicitante precisa se identificar por certificado digital vinculado ao CNPJ consultado. Por isso a captura de notas de entrada do cliente normalmente roda com o certificado A1 do próprio cliente (ou uma procuração eletrônica), configurado uma vez na ferramenta.
3. Autorize o download com a tag autXML
A forma mais limpa de autorizar o escritório a baixar a nota é informar o CNPJ do contador na tag `<autXML>` no momento da emissão do documento. Essa tag autoriza até 10 CNPJs ou CPFs a obter o XML completo do DF-e diretamente da SEFAZ, e vale para NF-e, CT-e e MDF-e. Uma vez que aquele CNPJ está na `autXML` da nota, ele aparece nas consultas de Distribuição de DF-e daquele documento e baixa o XML completo sem depender de mais nada.
Dois detalhes importantes, definidos nas regras oficiais (Nota Técnica 2013.005):
- A `autXML` é gravada na emissão — não dá para adicionar um autorizado depois
que a nota já foi autorizada. Por isso vale orientar o cliente (ou configurar o ERP dele) para já incluir o CNPJ do escritório por padrão.
- O CNPJ do próprio destinatário não pode ir na `autXML` — a SEFAZ considera
redundante, porque o destinatário já tem acesso por outro caminho (a manifestação, abaixo).
A `autXML` é o caminho ideal quando o seu cliente emite a nota e quer que você receba o XML, ou quando um fornecedor recorrente concorda em autorizar o seu CNPJ. O detalhe completo está em tag autXML: como autorizar seu escritório a baixar as notas do cliente.
4. Use a manifestação do destinatário para as notas de fornecedores
Quando você não está na `autXML` (o caso típico das compras do cliente, em que o fornecedor emite a nota e não lista o contador), o caminho é a manifestação do destinatário. Pelas regras da Distribuição de DF-e (Nota Técnica 2014.002), o destinatário só recebe o resumo da NF-e até registrar a manifestação; é o evento de manifestação que libera o download do XML completo.
São quatro eventos de manifestação do destinatário:
- Ciência da Operação (Ciência da Emissão): registra que o destinatário tomou
ciência da nota emitida contra o CNPJ dele. Esse evento libera o download do XML completo e é o que as ferramentas disparam automaticamente.
- Confirmação da Operação: confirma que a operação ocorreu; também dá acesso
ao XML completo.
- Operação não Realizada: registra que a operação não se concretizou; mesmo
assim permite obter o XML completo.
- Desconhecimento da Operação: declara que o destinatário não reconhece a
operação — e, por isso, não libera o download do XML completo.
Na prática, a ferramenta de captura registra a Ciência da Operação de forma automática (de hora em hora, junto com a varredura de NSU) e, a partir dali, baixa o XML completo. Vale lembrar que a manifestação final do destinatário (confirmar, desconhecer ou declarar não realizada) deve ocorrer dentro do prazo regulamentar — até 180 dias da autorização da nota —, então a rotina automática também ajuda o cliente a não estourar prazo.
5. CT-e: capture o frete pelo CNPJ do tomador
O conhecimento de transporte segue a mesma lógica, no serviço `CTeDistribuicaoDFe`. Ele disponibiliza os CT-e e seus eventos aos atores do documento — emitente, tomador do serviço, remetente, destinatário e terceiros autorizados via `autXML`. Para o varejo, o relevante é o cliente como tomador do frete: os CT-e emitidos contra o CNPJ dele entram na captura por CNPJ exatamente como as NF-e de fornecedores.
No CT-e, o evento de manifestação equivalente é a Prestação de Serviço em Desacordo, pelo qual o tomador registra discordância com o documento emitido pela transportadora. Para fins de captura do XML, o que importa é que o tomador é ator do CT-e e, portanto, recebe o documento na Distribuição de DF-e.
6. NFC-e (cupom): o ponto que não se resolve por CNPJ de terceiros
Aqui está o limite da automação por CNPJ. A NFC-e (modelo 65, o cupom fiscal eletrônico do varejo) em geral não fica disponível para download por terceiros do mesmo modo que a NF-e de entrada. Como é venda ao consumidor final, não há um destinatário com CNPJ manifestando, e a Distribuição de DF-e não a entrega ao contador por CNPJ.
O caminho confiável para os XMLs de NFC-e — e também das NF-e de saída do cliente — é o próprio sistema de gestão do cliente disponibilizar esses arquivos. É por isso que o ERP que o seu cliente usa faz tanta diferença no volume de trabalho que sobra para o escritório.
7. Centralize com uma ferramenta de captura
Reunindo tudo: plataformas de captura fiscal conectam ao Ambiente Nacional, rodam o ciclo de NSU de hora em hora, registram a Ciência da Operação automaticamente e baixam NF-e, NFC-e, CT-e, MDF-e e seus eventos para os CNPJs cadastrados, organizando os arquivos em pastas por cliente e competência. Isso elimina a busca manual e reduz o risco de nota faltando na escrituração.
A captura por CNPJ resolve muito bem a entrada. O nó continua sendo a saída própria do cliente (NF-e e NFC-e de venda), que depende do ERP dele.
8. O caminho sem fricção: o cliente no ERP certo
Quando o cliente opera num ERP que já entrega os XMLs ao contador, o problema desaparece na origem: os XMLs de fornecedores ficam disponíveis diariamente e os XMLs de NFC-e/NF-e próprios são consolidados no fechamento do mês — inclusive os cupons, que você não consegue puxar por CNPJ de terceiros. É justamente o que acontece quando você recebe os XMLs dos seus clientes como contador parceiro da Apogeu Tech.
Há ainda um ganho de precisão. Na Distribuição de DF-e da SEFAZ ficam listadas todas as notas emitidas contra o CNPJ do cliente — inclusive as que ele não chegou a receber ou que foram emitidas por engano contra o CNPJ dele. Com a Apogeu, o escritório recebe apenas os XMLs das notas que o cliente confirmou e deu entrada no ERP, ou seja, somente as operações que realmente fazem parte do negócio — escrituração mais precisa, sem lançar notas indevidas.
Com os XMLs em mãos, o próximo passo é a apuração — veja como gerar o SPED ICMS/IPI dos clientes do varejo.
Perguntas frequentes
Preciso do certificado digital do cliente para baixar os XMLs? Para capturar notas de fornecedores via Distribuição de DF-e e manifestação, normalmente sim — o solicitante precisa se identificar por certificado digital vinculado ao CNPJ consultado (ou ter procuração eletrônica). Já para as notas em que o seu CNPJ foi informado na tag `autXML`, o seu próprio certificado já habilita o download do XML completo daquela nota.
Dá para baixar XML de NFC-e (cupom) de terceiros pelo CNPJ? Não de forma geral. A NFC-e não fica disponível para download por terceiros como a NF-e de entrada, porque é venda ao consumidor final, sem destinatário com CNPJ manifestando. O caminho confiável é o próprio sistema de gestão do cliente disponibilizar esses XMLs.
A tag autXML serve para CT-e e MDF-e também? Sim. A `autXML` autoriza até 10 CNPJs ou CPFs a obter o XML completo e está prevista para NF-e, CT-e e MDF-e. No CT-e, o tomador do frete já é ator do documento e o recebe na Distribuição de DF-e mesmo sem `autXML`.
Qual a diferença entre os XMLs da parceria e baixar direto na SEFAZ? Na SEFAZ aparecem todas as notas emitidas contra o CNPJ do cliente, incluindo as que ele não recebeu ou que foram emitidas por engano. Com a parceria Apogeu, você recebe apenas os XMLs das notas que o cliente confirmou e deu entrada no ERP — só o que realmente faz parte da operação dele —, além dos XMLs de venda e dos cupons (NFC-e), que não se capturam por CNPJ de terceiros. O resultado é uma escrituração mais precisa e completa.
Cansado de cobrar XML dos clientes? Conheça a parceria para contadores da Apogeu Tech e receba os documentos prontos.
