XML de NF-e sem certificado: como baixar só com a chave de acesso

Dá para baixar o XML de uma NF-e só com a chave de acesso, sem certificado digital, com uma ressalva: o arquivo é uma cópia para leitura, sem a assinatura digital. Na FiscalAPI, o XML da NF-e sem certificado recebe a chave de 44 dígitos e devolve o XML com os dados da nota (emitente, destinatário, itens com NCM e CFOP, ICMS, PIS, Cofins, totais, transporte e pagamento), no painel ou pela API. Serve para conferir a nota, cadastrar produtos e alimentar planilhas e sistemas. Não substitui o XML oficial na escrituração: esse vem do emitente ou do XML da NF-e com certificado, com o A1 de quem participou da nota. No plano Enterprise custa R$ 0,05 por nota. Cobrada quando a chave é válida, mesmo se a nota não for encontrada. Chave inválida e falha nossa não são cobradas.

Atualizado em 5 de novembro de 2026.

Com certificado ou sem certificado#

A FiscalAPI tem dois produtos de XML de NF-e pela chave: o XML da NF-e com certificado e o XML da NF-e sem certificado. Eles entregam arquivos diferentes.

Se a sua empresa tem o A1 e aparece na nota, o XML da NF-e com certificado é o melhor caminho: sai o arquivo oficial. A sem certificado resolve quando você tem a chave, mas não tem o certificado de ninguém da nota, ou não quer esperar por ele.

Passo a passo no painel#

1. Entre no painel em app.fiscalapi.com.br. O XML da NF-e sem certificado precisa de um plano pago.
2. Abra NF-e por Chave e escolha Sem certificado. Os campos de certificado e senha somem.
3. Cole a chave de acesso. Pode colar do jeito que está no DANFE, com espaços ou pontos. Tem várias? Cole até 50 chaves por vez.
4. Clique em Consultar. O painel consulta uma chave de cada vez, em sequência, e mostra se a nota veio, não foi encontrada ou se a chave tem algum problema.
5. Baixe o XML. Cada nota baixa como {chave}-sem-assinatura.xml, e várias notas saem num .zip. A nota fica no histórico com a etiqueta "sem assinatura". Baixar de novo pelo histórico não cobra.

A chave fica no DANFE, abaixo do código de barras, em 11 blocos de 4 dígitos. Também aparece no e-mail do fornecedor e no seu ERP.

Pela API#

A rota é POST /api/consultar-nfe-xml-sem-certificado, com a sua chave de API no cabeçalho X-API-Key e só a chave da nota no corpo. Uma chave por requisição.

import requests

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

chave = "35261012345678000195550010000001231123456784"
resp = requests.post(API, headers=HEADERS, json={"chave": chave}, timeout=120)

if resp.status_code == 400:
    print("Chave inválida:", resp.json())  # não é cobrada
else:
    resp.raise_for_status()
    item = resp.json()["resultados"][0]
    if item["status"] == "ok":
        with open(f"{item['chave']}-sem-assinatura.xml", "w", encoding="utf-8") as out:
            out.write(item["xml"])
    else:
        print(item["status"], item["mensagem"])

A resposta lembra a do XML da NF-e com certificado, sem cstat, from_cache e manifestacao, e com dois campos que deixam claro o que é o arquivo:

{
  "request_id": "...",
  "total": 1,
  "com_dado": 1,
  "creditos_cobrados": 2,
  "resultados": [
    {
      "chave": "35261012345678000195550010000001231123456784",
      "status": "ok",
      "mensagem": "Nota encontrada.",
      "xml": "<nfeProc ...>...</nfeProc>",
      "assinado": false,
      "tipo_xml": "leitura"
    }
  ]
}

O status pode ser ok, nao_encontrado ou erro. Chave com problema volta antes, com HTTP 400 e o código CHAVE_INVALIDA. Campos, erros e exemplos em cURL, JavaScript e PHP estão na documentação da consulta sem certificado.

Quanto custa e quando cobra#

As regras de cobrança:

• Cobra quando a chave é válida e a nota vem.
• Cobra também quando a chave é válida e a nota não é encontrada, porque a busca acontece do mesmo jeito.
• Não cobra de novo se você repetir a mesma chave logo em seguida: por 1 hora para nota do mês atual ou do anterior, e por 24 horas para as outras. Depois disso, consultar a mesma chave de novo cobra de novo.
• Não cobra chave inválida. Ela é recusada antes da busca.
• Não cobra falha nossa. Se a consulta der erro do nosso lado, tente de novo.
• Não cobra baixar de novo, pelo histórico do painel, uma nota que você já consultou.
• Não entra nas 10 notas grátis por mês, que valem só para o XML da NF-e com certificado.

Exemplo no Enterprise: 200 chaves, das quais 5 têm dígito errado e 10 não são encontradas. Você paga 195 × R$ 0,05 = R$ 9,75. As 5 chaves inválidas não entram na conta. Veja planos e preços.

Quando a chave não traz o XML#

Nota emitida há poucas horas pode ainda não aparecer, e a "não encontrada" é cobrada. Repetir a mesma chave logo em seguida devolve a mesma resposta, sem cobrar de novo: por 1 hora para nota do mês atual ou do anterior, e por 24 horas para as outras. Passado esse prazo, uma nova consulta cobra de novo. Para conferir se a chave é de uma nota que existe, a consulta pública da SEFAZ mostra o resumo da nota, de graça. Veja chave de acesso inválida para entender cada parte da chave.

Para que serve a cópia para leitura#

Serve para tudo que depende de ler a nota: conferir o pedido contra a nota, ver CFOP e impostos antes do lançamento, cadastrar produtos e NCM, calcular custo e frete, montar relatórios. A cópia traz emitente, destinatário, itens com NCM e CFOP, ICMS, PIS, Cofins, totais, transporte e pagamento. IPI e IBS/CBS aparecem quando a nota traz.

Não serve para o que depende da validade do arquivo: escriturar a entrada, tomar crédito, guardar como prova, validar a assinatura ou o schema. A diferença, caso a caso, está em XML para leitura ou XML oficial.

Use a consulta para notas de operações que dizem respeito à sua empresa, como compras, vendas, fretes ou a auditoria de um cliente. É a condição dos Termos de Uso.

Perguntas frequentes#

O XML sem certificado é o XML oficial da nota? Não. É uma cópia para leitura, sem a assinatura digital. Ele traz os dados da nota, mas não substitui o XML oficial na escrituração nem na guarda.

Posso escriturar a nota com essa cópia? Não. Para escriturar e tomar crédito, use o XML oficial: peça ao emitente, que é obrigado a enviar, ou baixe o XML da NF-e com certificado, com o A1 de quem participou da nota.

Por que pago quando a nota não é encontrada? Porque a busca é feita do mesmo jeito. Cobrada quando a chave é válida, mesmo se a nota não for encontrada. Chave inválida e falha nossa não são cobradas.

As 10 notas grátis valem aqui? Não. Elas valem só para o XML da NF-e com certificado, no painel, para quem ainda não assinou plano.

Preciso ser o emitente ou o destinatário? Não para consultar. Mas use só para notas de operações em que sua empresa tem interesse, como preveem os Termos de Uso.

Dá para baixar várias chaves de uma vez? Sim. No painel, cole até 50 chaves por vez e baixe os XML num .zip. Pela API, é uma chave por requisição. Ainda não há envio de planilha para o XML da NF-e sem certificado.

Serve para NFC-e (cupom fiscal)? Não. A consulta aceita só NF-e, modelo 55. Veja XML de NFC-e pela chave.

Fontes#

• Ajuste SINIEF 07/05, cláusula sétima, § 7º: envio do arquivo da NF-e com o protocolo ao destinatário
• Ajuste SINIEF 16/2018: consulta pública da NF-e restrita ao resumo
• XML da NF-e sem certificado, documentação da FiscalAPI
• Planos e preços e Termos de Uso, FiscalAPI

Artigos relacionados#

• XML para leitura ou XML oficial da NF-e: quando cada um basta
• Fornecedor não mandou o XML da NF-e: o que fazer
• Como importar a NF-e do fornecedor no ERP sem certificado digital
• XML da NF-e com certificado: baixar pela chave de acesso

Tem só a chave? Veja como funciona e quanto custa ou crie sua conta e consulte em NF-e por Chave, opção Sem certificado.