Como baixo o XML e o DANFE da nota pela chave de acesso?

Toda nota encontrada retorna xmlUrl (download do XML) e danfeUrl (download do DANFE em PDF). São links públicos clicáveis, sem precisar de token. O XML completo também vem inline no campo xml.data, para quem prefere processar direto.

A API entrega os campos da nota já separados em JSON?

Esta versão entrega o XML completo da NF-e em um único campo (xml.data), o que mantém a API estável a mudanças de layout. Você parseia exatamente os campos que precisar: emitente, destinatário, produtos, NCM, CFOP, impostos e totais.

Funciona com notas antigas?

A consulta é feita pela chave de acesso de 44 dígitos, sem janela de data fixa. Notas não localizadas na origem retornam encontrado: false, sem cobrança.

Como saber se uma nota fiscal foi autorizada pela Sefaz?

A resposta traz o protocolo de autorização e o cStat da nota, o código de situação devolvido pela Sefaz. Com isso dá para confirmar se o documento recebido de um fornecedor foi de fato autorizado antes de lançar a entrada ou pagar a fatura.

Qual a diferença entre a API de NF-e e a de CT-e?

A NF-e (modelo 55) documenta a venda de mercadorias; o CT-e (modelo 57) documenta a prestação do serviço de transporte da carga. Para consultar conhecimentos de transporte por chave, use a API de CT-e.

Como conferir os itens e impostos de uma nota fiscal pela chave?

A API devolve a nota já separada em JSON: emitente, destinatário, cada item com quantidade e valor, os impostos por item e os totais, além do protocolo de autorização. O XML e o DANFE vêm junto para arquivo e conferência.

API de Consulta de NF-e por Chave de Acesso

XML completo da nota fiscal eletrônica e DANFE em PDF a partir da chave de acesso de 44 dígitos.

JSON CSV XLSX XML

Testar grátis na Apify Todas as APIs

Não tem conta Apify? Crie grátis aqui.

Como integrar

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":["NFe35260444823938000187551090000002691092067649","3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649"]}'

{
  "chaves": [
    "NFe35260444823938000187551090000002691092067649",
    "3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649"
  ]
}

import requests

res = requests.post(
    "https://api.apify.com/v2/actors/brasildados~api-consulta-nfe-por-chave/run-sync-get-dataset-items",
    headers={"Authorization": "Bearer SEU_APIFY_TOKEN"},
    json={
      "chaves": [
        "NFe35260444823938000187551090000002691092067649",
        "3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649"
      ]
    },
)
for item in res.json():
    print(item)

const res = await fetch(
  "https://api.apify.com/v2/actors/brasildados~api-consulta-nfe-por-chave/run-sync-get-dataset-items",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer SEU_APIFY_TOKEN",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "chaves": [
        "NFe35260444823938000187551090000002691092067649",
        "3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649"
      ]
    }),
  }
);
const items = await res.json();
console.log(items);

<?php
$ch = curl_init("https://api.apify.com/v2/actors/brasildados~api-consulta-nfe-por-chave/run-sync-get-dataset-items");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer SEU_APIFY_TOKEN",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => '{"chaves":["NFe35260444823938000187551090000002691092067649","3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649"]}',
]);
$items = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($items);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.apify.com/v2/actors/brasildados~api-consulta-nfe-por-chave/run-sync-get-dataset-items"))
    .header("Authorization", "Bearer SEU_APIFY_TOKEN")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"chaves\":[\"NFe35260444823938000187551090000002691092067649\",\"3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649\"]}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer SEU_APIFY_TOKEN");
var content = new StringContent(
    "{\"chaves\":[\"NFe35260444823938000187551090000002691092067649\",\"3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649\"]}",
    Encoding.UTF8,
    "application/json");
var response = await client.PostAsync("https://api.apify.com/v2/actors/brasildados~api-consulta-nfe-por-chave/run-sync-get-dataset-items", content);
Console.WriteLine(await response.Content.ReadAsStringAsync());

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := bytes.NewBufferString(`{"chaves":["NFe35260444823938000187551090000002691092067649","3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649"]}`)
	req, _ := http.NewRequest("POST", "https://api.apify.com/v2/actors/brasildados~api-consulta-nfe-por-chave/run-sync-get-dataset-items", body)
	req.Header.Set("Authorization", "Bearer SEU_APIFY_TOKEN")
	req.Header.Set("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

Exemplo de resposta

{
  "chave": "35260444823938000187551090000002691092067649",
  "encontrado": true,
  "consultadoEm": "2026-09-09T11:49:23.456Z",
  "referenciaConsulta": "bd-af03c0f94e82",
  "dados": {
    "identificacao": {
      "chave": "35260444823938000187551090000002691092067649",
      "modelo": "55",
      "serie": "109",
      "numero": "269",
      "naturezaOperacao": "VENDA",
      "dataEmissao": "2026-04-15T18:26:21-03:00",
      "dataSaidaEntrada": "2026-04-15T18:26:21-03:00",
      "tipoOperacao": "saída",
      "finalidade": "normal",
      "consumidorFinal": "sim",
      "presencaComprador": "presencial",
      "ambiente": "produção",
      "digitoVerificador": "9"
    },
    "emitente": {
      "cnpjCpf": "44823938000187",
      "razaoSocial": "PRODUTOS ALIMENTICIOS CORNETA LTDA - EPP",
      "nomeFantasia": "PADARIA CORNETA",
      "inscricaoEstadual": "637029531117",
      "indicadorIE": null,
      "email": null,
      "regimeTributario": "Regime Normal",
      "endereco": {
        "logradouro": "RUA ANANIAS E EVANGELISTA DE TOLETO",
        "numero": "869",
        "complemento": null,
        "bairro": "VILA PRADO",
        "codigoMunicipio": "3548906",
        "municipio": "Sao Carlos",
        "uf": "SP",
        "cep": "13574280",
        "pais": "BRASIL",
        "telefone": "1633721103"
      }
    },
    "destinatario": {
      "cnpjCpf": "12345678000195",
      "razaoSocial": "MERCEARIA MODELO LTDA ME",
      "nomeFantasia": null,
      "inscricaoEstadual": "637160318112",
      "indicadorIE": "1",
      "email": null,
      "regimeTributario": null,
      "endereco": {
        "logradouro": "PASSEIO DOS FLAMBOYANTS",
        "numero": "200",
        "complemento": "LJ 17B, 18B E19B PISO TERREO SHOPPING",
        "bairro": "PARQUE FABER",
        "codigoMunicipio": "3548906",
        "municipio": "SAO CARLOS",
        "uf": "SP",
        "cep": "13561352",
        "pais": "BRASIL",
        "telefone": null
      }
    },
    "itens": [
      {
        "numero": 1,
        "codigo": "1900",
        "codigoBarras": null,
        "descricao": "TORRADA TEMP. ATACADO",
        "ncm": "19054000",
        "cest": "1705900",
        "cfop": "5102",
        "unidadeComercial": "KG",
        "quantidade": 1.306,
        "valorUnitario": 29.5,
        "valorTotal": 38.53,
        "valorFrete": null,
        "valorDesconto": null,
        "valorOutros": null,
        "impostos": {
          "icms": {
            "origem": "0",
            "cst": "00",
            "csosn": null,
            "baseCalculo": 38.53,
            "aliquota": 3.2,
            "valor": 1.23,
            "percentualReducao": null,
            "baseCalculoST": null,
            "aliquotaST": null,
            "valorST": null
          },
          "ipi": null,
          "pis": {
            "origem": null,
            "cst": "49",
            "csosn": null,
            "baseCalculo": 0,
            "aliquota": 0,
            "valor": 0,
            "percentualReducao": null,
            "baseCalculoST": null,
            "aliquotaST": null,
            "valorST": null
          },
          "cofins": {
            "origem": null,
            "cst": "49",
            "csosn": null,
            "baseCalculo": 0,
            "aliquota": 0,
            "valor": 0,
            "percentualReducao": null,
            "baseCalculoST": null,
            "aliquotaST": null,
            "valorST": null
          }
        }
      },
      {
        "numero": 2,
        "codigo": "1900",
        "codigoBarras": null,
        "descricao": "TORRADA TEMP. ATACADO",
        "ncm": "19054000",
        "cest": "1705900",
        "cfop": "5102",
        "unidadeComercial": "KG",
        "quantidade": 1.846,
        "valorUnitario": 29.5,
        "valorTotal": 54.46,
        "valorFrete": null,
        "valorDesconto": null,
        "valorOutros": null,
        "impostos": {
          "icms": {
            "origem": "0",
            "cst": "00",
            "csosn": null,
            "baseCalculo": 54.46,
            "aliquota": 3.2,
            "valor": 1.74,
            "percentualReducao": null,
            "baseCalculoST": null,
            "aliquotaST": null,
            "valorST": null
          },
          "ipi": null,
          "pis": {
            "origem": null,
            "cst": "49",
            "csosn": null,
            "baseCalculo": 0,
            "aliquota": 0,
            "valor": 0,
            "percentualReducao": null,
            "baseCalculoST": null,
            "aliquotaST": null,
            "valorST": null
          },
          "cofins": {
            "origem": null,
            "cst": "49",
            "csosn": null,
            "baseCalculo": 0,
            "aliquota": 0,
            "valor": 0,
            "percentualReducao": null,
            "baseCalculoST": null,
            "aliquotaST": null,
            "valorST": null
          }
        }
      }
    ],
    "totais": {
      "baseCalculoICMS": 132.52,
      "valorICMS": 4.23,
      "valorICMSST": 0,
      "valorProdutos": 132.52,
      "valorFrete": 0,
      "valorSeguro": 0,
      "valorDesconto": 0,
      "valorIPI": 0,
      "valorPIS": 0,
      "valorCOFINS": 0,
      "valorOutros": 0,
      "valorTotalNota": 132.52,
      "valorTributosAproximado": 4.23
    },
    "transporte": {
      "modalidadeFrete": "sem frete",
      "transportadora": null,
      "volumes": []
    },
    "pagamento": [
      {
        "forma": "crédito loja",
        "valor": 132.52
      }
    ],
    "informacoesAdicionais": {
      "fisco": null,
      "complementares": "&lt;lf&gt;; CP:9206764 OP:000266&lt;lf&gt; ID:5263C6D21A58459E8E45D51C05B6D027"
    },
    "protocolo": {
      "numero": "135261438676180",
      "dataAutorizacao": "2026-04-15T18:26:20-03:00",
      "status": "100",
      "motivo": "Autorizado o uso da NF-e",
      "ambiente": null,
      "situacao": "autorizada"
    }
  },
  "xml": {
    "name": "NFE-35260444823938000187551090000002691092067649.xml",
    "type": "NFE",
    "format": "XML",
    "data": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><nfeProc versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\"><protNFe><infProt><nProt>135261438676180</nProt><digVal>97+X6Dr4Dj/ojeOOUje1g/D8htY=</digVal><dhRecbto>2026-04-15T18:26:20-03:00</dhR..."
  },
  "xmlUrl": "https://api.apify.com/v2/key-value-stores/*****/records/xml-35260444823938000187551090000002691092067649?signature=*****",
  "danfeUrl": "https://api.apify.com/v2/key-value-stores/*****/records/danfe-35260444823938000187551090000002691092067649?signature=*****",
  "erro": null
}

O que a API de consulta de NF-e por chave de acesso retorna

XML completo da NF-e (layout nfeProc 4.00) em um único campo
Link de download do XML (xmlUrl), clicável e sem token
Link de download do DANFE em PDF (danfeUrl)
Emitente, destinatário, produtos e impostos dentro do XML
Situação da nota: protocolo de autorização e cStat
Status da consulta: chave, encontrado e data/hora
Até 50 chaves por execução, em lote ou em tempo real

API de Consulta de NF-e por Chave de Acesso

XML completo da nota fiscal eletrônica e DANFE em PDF a partir da chave de acesso de 44 dígitos.

O que a API de consulta de NF-e por chave de acesso retorna

XML completo da NF-e (layout nfeProc 4.00) em um único campo

Link de download do XML (xmlUrl), clicável e sem token

Link de download do DANFE em PDF (danfeUrl)

Emitente, destinatário, produtos e impostos dentro do XML

Situação da nota: protocolo de autorização e cStat

Status da consulta: chave, encontrado e data/hora

Até 50 chaves por execução, em lote ou em tempo real

Casos de uso da API de consulta de NF-e por chave de acesso

Escrituração fiscal e captura de XML para SPED e EFD

Conciliação contábil de notas fiscais recebidas

Validação de autorização de notas direto da origem

Importação de XML de NF-e para ERP

Perguntas frequentes sobre consulta de NF-e por chave de acesso

APIs relacionadas a consulta de NF-e por chave de acesso

CT-e: Consulta por Chave de Acesso

Consulta Veicular por Placa

Baixar NF-e em Lote (XML e DANFE)