API Docs

API DANFE

Automatize a geração de DANFE e DACTE em PDF a partir do XML ou da chave de acesso. REST simples, autenticação por chave e respostas em JSON.

Base URL

Introdução

A API do Gerador de Danfe recebe o XML autorizado da NF-e/CT-e ou consulta uma NF-e pela chave de acesso de 44 dígitos. Todas as chamadas usam HTTPS e respostas em JSON. O conteúdo binário do PDF é retornado em base64.

Base URL HTTPS

https://geradordedanfe.com/api/v1

Autenticação

Use sua chave secreta no cabeçalho Authorization. Gere e revogue chaves no painel da conta. Nunca exponha a chave no front-end.

Authorization headercURL

# Toda requisição autenticada curl https://geradordedanfe.com/api/v1/generate \ -H "Authorization: Bearer danf_xxxxxxxxxxxx"

Planos e limites

A API exige uma assinatura Premium ou API ativa. Usuários sem assinatura ativa não conseguem criar chaves nem usar endpoints autenticados.

Plano	Acesso à API	Limite por hora	Limite diário
Gratuito	Não	—	—
Premium	Sim	100 requisições/h	100 requisições/dia
API	Sim	1.000 requisições/h	1.000 requisições/dia

POST/api/v1/generate

Gerar DANFE

Envie o XML como string. A API valida o conteúdo, identifica o tipo (NF-e ou CT-e) e retorna o PDF. XML com DOCTYPE/ENTITY é recusado por segurança.

RequisiçãocURL

curl -X POST https://geradordedanfe.com/api/v1/generate \ -H "Authorization: Bearer danf_xxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "xml": "<nfeProc>...</nfeProc>", "format": "pdf" }'

Resposta 200 OKJSON

{ "status": "success", "type": "nfe", "pdf": { "base64": "JVBERi0xLjQK...", "filename": "danfe_3526...4400.pdf" }, "summary": { "chaveAcesso": "3526...4400" }, "processing_time": "0.4s" }

GET/api/v1/danfe/{chave}

Consultar por chave

Informe uma chave de acesso de 44 dígitos. A API retorna o DANFE do cache quando já existe ou consulta a SEFAZ, processa o documento e devolve PDF, XML reconstruído/obtido e resumo em JSON.

RequisiçãocURL

curl https://geradordedanfe.com/api/v1/danfe/35260411222333000144550010000000011000000017 \ -H "Authorization: Bearer danf_xxxxxxxxxxxx"

Resposta 200 OKJSON

{ "status": "success", "source": "sefaz", "type": "nfe", "pdf": { "base64": "JVBERi0xLjQK...", "filename": "danfe_3526...4400.pdf" }, "xml": "<nfeProc>...</nfeProc>", "summary": { "chaveAcesso": "3526...4400" }, "processing_time": "2.8s" }

Códigos de erro

Código	Significado
400	XML ausente, vazio ou grande demais.
422	XML inválido ou com DOCTYPE/ENTITY (recusado).
401	Chave de API ausente ou inválida.
402	Créditos insuficientes.
429	Limite de requisições excedido.

Pronto para integrar?

Crie uma conta para gerar suas chaves de API e comprar créditos por volume.

Criar conta Falar com vendas