Integração e API

API REST para consulta e geração de documentos fiscais

Integre consulta de DANFE, geração de PDF e download de XML diretamente no seu sistema. Chamadas HTTP RESTful, respostas em JSON, autenticação via API Key.

HTTPS obrigatórioXML e PDF sem custo extraSLA 98% / 30s
request.sh
curl -X GET "https://api.danferapida.com.br/documents/b2b/search/35250000000000000000550010000000011000000017" \
  -H "x-api-key: SUA_API_KEY" \
  -H "Content-Type: application/json"

response.json

{
  "xmlCode": "<?xml version=\"1.0\"?><nfeProc ...",
  "base64Code": "JVBERi0xLjQK...[PDF em Base64]",
  "accessKey": "35250000000000000000550010000000011000000017"
}

Como Funciona

Quatro passos simples para integrar a Danfe Rápida ao seu sistema.

1

Cadastre-se

Crie sua conta e confirme o e-mail.

2

Compre consultas

Pague via PIX na área da conta; o saldo vale para todas as chaves.

3

Gere API Key

Crie a chave na área da conta, em Chaves.

4

Faça requisições

Use o header x-api-key: {API_KEY} e acompanhe o consumo na conta.

Endpoints Disponíveis

REST API com endpoints dedicados para cada operação fiscal.

MétodoEndpointDescrição
POST/batchsCriar lote de chaves para processamento assíncrono
GET/batchsListar seus lotes e status (paginado)
GET/documents/b2b/search/:accessKeyConsulta individual síncrona (XML + PDF Base64)
POST/batchs/xml-to-pdfGerar DANFEs PDF a partir de lista de XMLs
GET/batchs/:id/danfesGerar PDFs de todos os documentos de um lote
GET/dacte/:accessKeyConsultar DACTE / CT-e pela chave de acesso

Casos de Uso

Onde a API faz a diferença no dia-a-dia.

  • Consultorias tributárias

    Automatizar emissão e consulta de DANFE de múltiplos clientes em lote.

  • ERPs importando XMLs

    Sincronizar XMLs e DANFEs com o ERP via webhook a cada nova nota emitida.

  • E-commerce conferindo notas

    Validar autenticidade e status de NF-e recebidas de fornecedores antes da entrada em estoque.

  • SPED e auditoria

    Importar XMLs para escrituração contábil e auditoria fiscal periódica.

Consultas e Autenticação

Saldo pré-pago por conta. A consulta devolve o saldo restante no header X-Queries-Remaining.

Consulta pela chave1 consulta por nota entregue
Lote1 consulta por chave ou XML, com devolução
Sem saldoHTTP 402 · INSUFFICIENT_QUERIES

Autenticação

x-api-key: SUA_API_KEY

SLA

98% uptime · até 30s

Consultas pré-pagas · PIX

Pegue sua API Key agora

Crie sua conta, gere a chave e pague só pelas notas entregues, com API completa (NF-e, CT-e, MDF-e, DANFE, XML, manifesto).

Sem mensalidade · Sem fidelidade · Sem certificado digital

Webhooks e Notificações

Em breve

No roadmap: notificações em tempo real para eventos: nfe.nova, nfe.cancelada, nfe.corrigida. Você poderá configurar URL e secret no painel.

Segurança

HTTPS obrigatório, autenticação via API Key (header x-api-key), rotação periódica de chaves e logs de auditoria. Erros HTTP padrão com corpo JSON estruturado.

Exemplos de Código

Snippets prontos para Python, Node.js, PHP e cURL.

Python

Python (requests)

Node.js

Node.js (fetch / axios)

PHP

PHP (cURL / Guzzle)

cURL

cURL HTTP direto

Modelo de Cobrança da API

Você paga só pelas notas entregues, na consulta por Chave de Acesso ou em lote, em consultas pré-pagas. Conversões e listagens não consomem consulta.

Grátis

Conversões e listagens

XML para DANFE PDF, PDFs de um lote já processado e listagens. Não consomem consulta.

1 consulta

Por nota entregue

Consulta por Chave de Acesso ou em lote: só a nota entregue consome. Nota não encontrada não consome; no lote, as consultas das que falharem voltam ao saldo.

Pré-pago

Sem mensalidade

Compre consultas via PIX na área da conta; o saldo vale para todas as suas chaves. Ver preços · SLA completo.

FAQ — Integração

Preciso de certificado digital para usar a API?

Não. A autenticação é feita via API Key gerada no painel.

Quais endpoints da API são cobrados?

Consomem saldo a consulta de NF-e pela Chave de Acesso e o lote (POST /batchs): 1 consulta por nota entregue. Nota não encontrada não consome, e no lote as consultas das notas que falharem voltam ao saldo quando o lote termina. Conversão de XML em PDF, os PDFs de um lote e as listagens não consomem consulta.

Qual o formato das respostas?

JSON estruturado. PDFs e XMLs disponíveis via endpoint dedicado.

Quais linguagens são suportadas?

Qualquer linguagem com suporte a HTTP REST. Documentamos exemplos em Python, Node.js, PHP e cURL.

A API funciona 24/7?

Sim. A API tem meta de 98% de uptime mensal e tempo de resposta de até 30 segundos. Indisponibilidade da SEFAZ ou Receita Federal não conta como downtime. Detalhes em /sla.

Como pego minha API Key?

Crie sua conta pelo botão "Pegar API Key agora" abaixo da seção de Casos de Uso e gere a chave na área da conta. As consultas usam o saldo de consultas da conta, compradas via PIX, sem mensalidade.

Consulta NFe e DANFe Online - Nota Fiscal Eletrônica Sefaz