Como baixar o XML da NF-e pela chave de acesso, sem certificado digital

A nota fiscal chegou só em papel, o fornecedor não mandou o XML, o arquivo se perdeu num e-mail antigo ou o contador está cobrando as notas do mês. Em todos esses casos, a solução começa pelo mesmo número: a chave de acesso.

Com ela, dá para recuperar o XML completo e o DANFE de uma NF-e sem pedir nada ao emitente, sem certificado digital e sem login na SEFAZ. Este guia mostra onde achar a chave, o que cada parte dela significa e como baixar uma nota ou dezenas de uma vez.

XML e DANFE: qual é a nota de verdade

Muita gente acha que o papel que chega com a mercadoria é a nota fiscal. Não é. A NF-e é um arquivo digital, o XML, autorizado pela SEFAZ do estado no momento da venda. O papel é o DANFE, uma versão simplificada para acompanhar o transporte.

Por isso o XML importa tanto: é ele que o contador lança, que o sistema da empresa importa e que a fiscalização pede. Quem emite e quem recebe a nota precisa guardá-lo, em geral por 5 anos.

Onde achar a chave de acesso

A chave de acesso tem 44 dígitos e identifica uma única nota no país inteiro. Ela aparece:

• No DANFE, no alto da nota, logo abaixo do código de barras, separada em grupos de 4 números.
• No XML, no campo de identificação da nota, com o prefixo “NFe” na frente.
• No e-mail que o emitente manda junto com a nota, na maioria dos sistemas.

Não precisa se preocupar com o formato: com espaços, sem espaços ou com o prefixo “NFe”, a consulta entende do mesmo jeito.

O que cada parte da chave significa

A chave não é um número aleatório. Lendo da esquerda para a direita:

Só olhando a chave já dá para saber de qual estado e de qual empresa veio a nota, e de quando ela é. Se o CNPJ dentro da chave não é o do fornecedor que você conhece, desconfie.

Como baixar o XML de uma nota pela chave

O caminho oficial

O portal nacional da NF-e consulta a nota pela chave, com captcha, e mostra um resumo: se ela existe, quem emitiu e se foi cancelada. Para baixar o XML completo, porém, o portal costuma exigir o certificado digital do emitente ou do destinatário. Quem não tem o certificado em mãos, como o contador de um cliente ou o funcionário que só recebeu o papel, fica travado.

Pela chave, sem certificado

A consulta de NF-e por chave de acesso resolve com a chave só. Para cada nota encontrada, você recebe:

• o link para baixar o XML completo;
• o link para baixar o DANFE em PDF;
• os dados principais da nota: número, série, data de emissão, natureza da operação (venda, devolução, transferência) e se é de entrada ou saída.

Cabem até 50 chaves por consulta, e nota não encontrada não é cobrada. Testar grátis na Apify.

Teste com uma nota que você recebeu: crie uma conta grátis na Apify, abra a consulta de NF-e por chave, cole a chave do DANFE e clique em Start. Em poucos segundos aparecem os links do XML e do PDF. O crédito de US$5 por mês que a Apify dá a toda conta cobre as primeiras consultas.

Um cuidado: os links dos arquivos ficam disponíveis por um tempo limitado. Baixe o XML e guarde no seu computador, no sistema da empresa ou com o contador.

Como baixar muitas notas de uma vez

No fim do mês, o problema raramente é uma nota só. O contador precisa de todas as notas de compra de um cliente; a empresa precisa importar no sistema as notas de vários fornecedores.

O download de NF-e em lote recebe até 30 chaves por vez e devolve um único arquivo ZIP organizado assim:

• uma pasta com todos os XMLs;
• uma pasta com todos os DANFEs em PDF;
• um relatório dizendo quais chaves foram encontradas, quais não foram e quais estavam digitadas errado.

É o formato mais prático para mandar ao contador ou importar no sistema de uma vez. Testar grátis na Apify.

Se você recebe as chaves numa planilha, basta copiar a coluna inteira e colar no campo de entrada: uma chave por linha.

Antes de pagar um fornecedor: confira a nota

A consulta pela chave também serve para evitar golpe. Boleto falso acompanhado de uma “nota fiscal” bem montada é um golpe comum contra empresas. Antes de pagar:

1. Consulte a chave. Se a nota não existe, não pague.
2. Compare os dados com o DANFE que você recebeu: número, série, data e natureza da operação.
3. Confira o CNPJ dentro da chave (os dígitos 7 a 20): ele precisa ser o do seu fornecedor.
4. Na dúvida sobre o fornecedor, o checklist para saber se uma empresa é confiável mostra o que mais olhar pelo CNPJ.

E a nota do frete? O CT-e

Quando o assunto é transporte, o documento é outro: o CT-e, Conhecimento de Transporte Eletrônico, que documenta o frete. Ele também tem uma chave de 44 dígitos e funciona do mesmo jeito. A consulta de CT-e por chave de acesso traz os dados do frete, e há também a versão para baixar CT-e em lote. Testar a consulta de CT-e grátis na Apify.

Atenção: nenhuma dessas ferramentas consulta a NFS-e, a nota de serviço emitida pela prefeitura. Ela segue outro sistema, que varia de cidade para cidade.

Use só notas das quais você participou

A chave de acesso está impressa em todo DANFE, mas o XML traz os dados completos da operação, inclusive do comprador. Consulte só as notas das quais a sua empresa participou, como emitente, destinatária ou transportadora, ou de clientes que autorizaram, no caso de escritórios de contabilidade. Quando o comprador é pessoa física, o XML tem o CPF dela, e esse dado é protegido pela LGPD.

Resumo

1. A nota que vale é o XML; o DANFE é só a versão para imprimir.
2. A chave de acesso tem 44 dígitos e fica embaixo do código de barras do DANFE.
3. O portal oficial mostra um resumo; o XML completo, em geral, só com certificado digital.
4. Pela chave, a consulta de NF-e devolve o XML e o DANFE sem certificado.
5. Para muitas notas, o download em lote entrega tudo num ZIP.
6. Antes de pagar um fornecedor, confira a nota pela chave.

Para quem programa

Se você quer automatizar a entrada de notas no seu sistema, a mesma consulta funciona por API. O token da Apify vai no header, nunca na URL. O guia da Apify para iniciantes mostra onde encontrá-lo.

curl -X POST "https://api.apify.com/v2/actors/brasildados~api-consulta-nfe-por-chave/run-sync-get-dataset-items" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chaves":["35260444823938000187551090000002691092067649"]}'

A resposta traz, para cada nota, os campos xmlUrl e danfeUrl com os links dos arquivos.