Como baixar o XML de milhares de NF-e de uma vez (planilha de chaves)

Para baixar o XML de milhares de NF-e de uma vez, monte uma planilha com as chaves de acesso, uma por linha, e envie na aba Lotes da tela NF-e por Chave da FiscalAPI, junto com o certificado digital A1 da empresa que participou das notas. O lote aceita até 200 mil chaves, roda no servidor (você pode fechar a página) e, no fim, você baixa todos os XML num único arquivo .zip. Chave que não traz XML não é cobrada. O lote usa o saldo de um plano pago.

Atualizado em 27 de outubro de 2026.

Qual caminho usar#

Passo a passo do lote por planilha#

1. Crie a conta em app.fiscalapi.com.br/register e assine um plano. O lote usa a franquia do plano ou créditos de recarga; os 10 XML grátis valem só na aba Consultar.
2. Abra NF-e por Chave e clique na aba Lotes.
3. Informe o certificado A1 (.pfx ou .p12) e a senha da empresa que participou das notas.
4. Clique em Baixar modelo, se quiser partir da planilha pronta. O lote aceita .xlsx, .csv ou .txt, com uma chave por linha, em arquivo de até 15 MB.
5. Clique em Enviar planilha. Antes de começar, o painel mostra quantas chaves únicas a planilha tem, quantas são inválidas e quantas se repetem. Inválidas e repetidas não entram no lote.
6. Confira o saldo. Se o saldo não cobre todas as chaves, o painel avisa quantas ele cobre. O lote pausa quando o saldo acaba; depois de recarregar, você retoma o lote na lista.
7. Autorize e inicie. Para o lote rodar sem você na tela, o certificado e a senha ficam guardados cifrados enquanto ele processa. Eles são apagados no fim, ou depois de 72 horas com o lote parado.
8. Acompanhe em Seus lotes e, quando concluir, baixe o .zip com todos os XML.

Pode fechar a página depois de iniciar: o lote continua sendo processado. Os XML baixados também ficam na aba Histórico, para baixar de novo sem gastar saldo.

O que pode acontecer no meio do caminho#

As chaves que não trouxeram XML aparecem na lista de erros do lote, com o motivo, e podem ser baixadas em planilha. As que falharam por indisponibilidade momentânea podem ser tentadas de novo pelo próprio lote (se o lote já terminou, o painel pede o certificado de novo).

Por que algumas chaves voltam sem XML#

• O titular do certificado não participou da nota. O XML completo só sai para o emitente, o destinatário, o transportador ou quem está autorizado no XML. Use o A1 da empresa certa.
• A nota foi cancelada.
• A chave é de NFC-e (cupom fiscal, modelo 65), que não sai por aqui.
• A chave está errada: menos de 44 caracteres ou dígito verificador que não confere. Essas já ficam de fora na prévia.

Em todos esses casos, a chave não é cobrada. Se muitas chaves seguidas voltarem com "o certificado não é participante desta nota", o lote pausa para você conferir se enviou o certificado certo.

O lote não registra manifestação do destinatário em seu nome. Se você é o destinatário e ainda não se manifestou sobre uma nota, ela pode voltar como "XML completo indisponível". Consulte essas chaves na aba Consultar. Quando você é o destinatário, ela registra a Ciência da Operação com o seu certificado (fora do prazo da Ciência, a Confirmação da Operação) para liberar o XML, como descrito nos Termos de Uso.

De onde tirar a lista de chaves#

• Relatório do ERP de notas de entrada ou de saída, exportado para Excel.
• SPED Fiscal (EFD ICMS/IPI): cada nota aparece no registro C100, com a chave no campo CHV_NFE. Útil para o contador que recebeu o SPED do cliente, mas não os XML.
• Planilhas do fornecedor ou da transportadora com as notas do período.
• E-mails e DANFEs: a chave está abaixo do código de barras, em blocos de 4. O lote aceita a chave com espaços ou pontos.

Formate a coluna como texto no Excel para os 44 caracteres não virarem notação científica.

Um certificado por lote#

O certificado A1 enviado precisa ser de quem participou das notas da planilha. Se você é contador e as notas são de várias empresas clientes, monte um lote por empresa, cada um com o A1 dela. O certificado do escritório não abre as notas dos clientes. O A3 (token ou cartão) não serve, porque não pode ser enviado.

Pela API#

Para integrar no ERP, a rota POST /api/consultar-nfe-xml recebe uma chave por requisição, com o certificado em base64 e a senha. Para uma lista, percorra as chaves num laço, uma por requisição. Se receber o código 429, aguarde o tempo indicado em Retry-After e tente de novo. Na API, o certificado é usado só durante a requisição e descartado. Exemplos em cURL, Node.js e Python estão em API para baixar XML de NF-e por chave e na documentação.

Quanto custa#

Nos planos Lite, Starter e Pro, cada XML entregue conta como 3 consultas da franquia; no Enterprise, como 1. Para lotes grandes, o Enterprise é o que faz sentido: 10.000 notas por R$ 250 no mês. Acima disso, fale com a gente sobre volume. Chave sem XML não conta. Veja planos e preços.

Perguntas frequentes#

Quantas chaves cabem num lote? Até 200 mil chaves por planilha, em arquivo de até 15 MB. Para mais, divida em mais de um lote.

Preciso deixar a página aberta? Não. O lote roda no servidor. Volte depois e baixe o .zip em Seus lotes.

O lote vem com o DANFE em PDF? O .zip do lote traz os XML. O PDF do DANFE de cada nota pode ser gerado na aba Histórico, sem custo.

Os 10 XML grátis valem no lote? Não. O lote usa a franquia do plano ou créditos de recarga. Os 10 grátis valem na aba Consultar, para quem ainda não assinou plano.

A FiscalAPI guarda o meu certificado? No lote, com a sua autorização, ele fica cifrado só enquanto o lote processa e é apagado no fim, ou depois de 72 horas com o lote parado. Na consulta avulsa e na API, é usado só durante a consulta e descartado.

O que acontece se o saldo acabar no meio? O lote pausa. O que já veio fica disponível e nada é cobrado em dobro. Recarregue ou mude de plano e retome o lote.

O lote registra a Ciência da Operação? Não. Notas que só liberam o XML depois da manifestação do destinatário podem voltar como "XML completo indisponível". Consulte essas chaves na aba Consultar, que registra a manifestação com o seu certificado (Ciência da Operação ou, fora do prazo dela, Confirmação da Operação).

Posso misturar notas de empresas diferentes na mesma planilha? Pode, mas só voltam com XML as notas em que o titular do certificado participou, e muitas notas seguidas de outra empresa fazem o lote pausar. Para várias empresas, faça um lote por certificado.

Fontes#

• Consultar NF-e por chave, documentação da FiscalAPI
• NF-e por chave, FiscalAPI
• Planos e preços, FiscalAPI

Artigos relacionados#

• Como baixar o XML de várias NF-e de uma vez pelas chaves
• Perdi o XML da nota fiscal: como recuperar pela chave de acesso
• XML da nota fiscal: o que é, para que serve e como baixar
• APIs para baixar XML de NF-e pela chave: comparação

Tem uma planilha de chaves e o certificado A1? Crie sua conta e envie o lote na tela NF-e por Chave.