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órioAPI grátis (exceto Chave)SLA 99,5%
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 ative o acesso à API.

2

Gere API Key

Crie uma chave única no painel de desenvolvedor.

3

Faça requisições

Use o header x-api-key: {API_KEY}.

4

Monitore logs

Acompanhe consumo, erros e respostas no painel.

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.

Limites e Autenticação

Rate limit por plano. Headers X-RateLimit retornados em cada resposta.

Xml/Danfe Grátis100 consultas/dia
Danfe Profissional10.000 consultas/mês
Escala API/DEVIlimitado · rate limit configurável
Max Crédito AvulsoR$ 0,05/consulta

Autenticação

x-api-key: SUA_API_KEY

Status

status.danferapida.com.br

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 apenas pela busca direta na SEFAZ via Chave de Acesso. Todos os outros serviços da API são gratuitos em todos os planos (XML já existe; PDF/Excel/relatórios são apenas conversões).

Grátis

XML, DANFE PDF, conversões e relatórios

Todos os endpoints da API exceto NF-e via Chave de Acesso. Sem custo adicional em qualquer plano.

R$ 0,05

Por consulta via Chave

Apenas a busca direta na SEFAZ via Chave de Acesso de 44 dígitos consome crédito. Chave inexistente só cobra na 2ª tentativa.

Por plano

Do grátis ao ilimitado

Xml/Danfe Grátis (100/dia), Danfe Profissional (10.000/mês) e Escala API/DEV (ilimitado). Ver planos.

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?

Apenas a consulta de NF-e via Chave de Acesso direta na SEFAZ é cobrada (R$ 0,05/consulta). XML, DANFE PDF, conversões, relatórios e demais endpoints são gratuitos em todos os planos.

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. SLA de 99,5% de disponibilidade. Status público em status.danferapida.com.br.

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