Como baixar o XML de várias NF-e de uma vez pelas chaves

Para baixar o XML de várias NF-e de uma vez, cole as chaves de acesso no painel da FiscalAPI, até 50 por consulta, envie o certificado A1 da empresa que participou das notas e baixe todos os XML num único arquivo .zip. Para centenas de notas por dia ou uma rotina automática, use a API: uma requisição por chave, em sequência ou algumas em paralelo. Só a nota que volta com XML é cobrada, e quem ainda não assinou plano tem 10 XML grátis por mês no painel.

Atualizado em 22 de outubro de 2026.

Qual caminho usar#

Em todos os casos vale a mesma regra: o titular do certificado precisa aparecer em cada nota como emitente, destinatário, transportador ou autorizado a baixar o XML. Sem certificado de participante, nenhum serviço entrega o XML completo de forma legítima. Só com a chave, sai apenas o resumo.

Passo a passo no painel#

1. Junte as chaves. Copie a coluna da planilha, a lista do e-mail ou as chaves dos PDFs. Não precisa limpar: espaços, pontos e quebras de linha são removidos, e a mesma chave colada duas vezes aparece uma vez só.
2. Entre no painel em app.fiscalapi.com.br e abra a tela NF-e por Chave.
3. Envie o certificado A1 (.pfx ou .p12) e digite a senha. Ele fica disponível só na sessão, para você consultar vários lotes seguidos sem enviar de novo, e não é guardado nos nossos servidores.
4. Cole as chaves, até 50 por consulta. Chave com dígito verificador errado é marcada antes de consultar, sem custo.
5. Clique em consultar. O painel consulta uma chave por vez e mostra cada resultado conforme chega: XML disponível ou o motivo de não ter vindo.
6. Baixe tudo num `.zip`, com um arquivo por nota, nomeado pela chave. O DANFE em PDF de cada nota também sai na tabela, sem custo.

Mais de 50 chaves no painel#

Divida a lista em blocos de 50 e cole um bloco por vez. O certificado continua na sessão, então é só colar o próximo bloco e consultar de novo.

No fim, abra a aba Histórico: ela guarda toda nota que voltou com XML, mesmo que você tenha fechado a aba. Dali dá para filtrar, selecionar e baixar várias notas, ou o histórico inteiro, num único .zip. Baixar de novo não desconta nada do saldo, porque a nota já foi paga na primeira consulta.

Pela API: uma chamada por chave#

A rota POST /api/consultar-nfe-xml recebe uma chave por requisição. Para um lote, percorra a lista. O exemplo em Python lê as chaves de um arquivo de texto (uma por linha) e salva cada XML com um nome comum, <chave>-procNFe.xml:

import base64
import requests

API = "https://api.fiscalapi.com.br/api/consultar-nfe-xml"
HEADERS = {"X-API-Key": "SUA_CHAVE_DE_API"}

with open("certificado.pfx", "rb") as f:
    certificado = base64.b64encode(f.read()).decode()

with open("chaves.txt") as f:
    chaves = [linha.strip() for linha in f if linha.strip()]

for chave in chaves:
    resp = requests.post(
        API,
        headers=HEADERS,
        json={"chave": chave, "certificado": certificado, "senha": "SENHA_DO_CERTIFICADO"},
        timeout=120,
    )
    if resp.status_code != 200:
        print(chave, "erro HTTP", resp.status_code, resp.text[:200])
        continue
    item = resp.json()["resultados"][0]
    if item["status"] == "ok":
        with open(f"{item['chave']}-procNFe.xml", "w", encoding="utf-8") as out:
            out.write(item["xml"])
    else:
        print(chave, item["status"], item["mensagem"])

Quando a nota é encontrada, status vem ok e o campo xml traz o nfeProc. Nos outros casos, status diz o motivo (nao_autorizado, cancelada, fora_prazo, somente_resumo, chave_invalida, entre outros) e a chave não é cobrada.

Para milhares de notas, prefira ir em sequência ou 2 a 3 chamadas por vez: chamadas demais em paralelo fazem a SEFAZ bloquear o certificado por cerca de 1 hora. Guarde as chaves que voltaram com erro temporário para tentar de novo depois. A API começa no plano Lite. Campos e exemplos em Node.js estão na documentação da consulta por chave e no tutorial API para baixar XML de NF-e por chave.

Quanto custa um lote#

Cobra só a nota que volta com XML. Nos planos Lite, Starter e Pro, cada XML conta como 3 consultas da franquia; no Enterprise, como 1.

Exemplo: um lote de 300 chaves em que 280 voltam com XML custa 280 notas. No Pro, 280 × R$ 0,195 = R$ 54,60. No Enterprise, 280 × R$ 0,025 = R$ 7,00. As 20 que não vieram não entram na conta. Detalhes em planos e preços.

O que costuma travar um lote#

• Notas de empresas diferentes no mesmo certificado. Cada consulta usa um certificado. Se o lote mistura notas de duas empresas do grupo, separe as chaves por empresa e use o A1 de cada uma.
• Certificado de quem não participou. O A1 do escritório de contabilidade não abre as notas dos clientes. Use o certificado da empresa que vendeu, comprou ou transportou.
• Cupom fiscal no meio. Chave de NFC-e (modelo 65) não sai por aqui. Veja XML de NFC-e pela chave.
• Chave copiada pela metade. Acontece muito ao copiar do PDF. No painel, a chave com menos de 44 dígitos não é reconhecida: confira se o contador de chaves detectadas bate com a sua lista. Na API, ela volta com erro de chave inválida, sem cobrança. Veja chave de acesso inválida.
• Notas canceladas. O XML de nota cancelada não é mais entregue. Peça ao emitente a nota que a substituiu.
• Notas antigas. Veja o que fazer em XML de NF-e antiga.

Perguntas frequentes#

Dá para subir uma planilha Excel com as chaves? Para NF-e, não há envio de planilha. Copie a coluna das chaves e cole no campo do painel, até 50 por vez. O envio de planilha existe para a consulta de Inscrição Estadual em massa.

Consigo baixar todas as notas emitidas contra o meu CNPJ sem ter as chaves? Não por esta ferramenta. Ela trabalha pela chave de acesso, que você encontra no DANFE, no e-mail do fornecedor ou no seu ERP.

Posso misturar notas de vários fornecedores no mesmo lote? Pode, desde que o seu certificado seja de participante de todas. É o caso comum de quem é o destinatário das compras.

Quantas chaves posso consultar de uma vez? No painel, 50 por consulta, quantas consultas seguidas você quiser. Na API, uma chave por requisição.

Se só parte do lote vier, pago pelo lote inteiro? Não. Só a nota que volta com XML é cobrada. Chave inválida, nota cancelada ou certificado sem permissão não gastam nada.

O DANFE em PDF sai junto? Sim, no painel. Cada nota com XML tem o botão do PDF, sem custo, e o mesmo vale no histórico.

Fontes#

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

Artigos relacionados#

• Baixar XML pela chave de acesso: como baixar o XML da NF-e
• XML de NF-e grátis: como baixar 10 por mês pela chave de acesso
• API para baixar XML de NF-e por chave
• Perdi o XML da nota fiscal: como recuperar

Tem uma pilha de chaves para baixar? Crie sua conta grátis, cole as chaves na tela NF-e por Chave e baixe tudo num .zip.