API para gerar PDF DANFSe a partir do XML
Contrato técnico para software houses, ERPs e integrações que transformam XML de origem aceito em PDF DANFSe por requisição.
Conversão unitária, teste e lote síncrono
As entradas, respostas e regras abaixo compõem o contrato técnico da API.
Rotas da API
-
POST /v1/danfse -
Entrada: XML UTF-8 bruto em
application/xml, com até 1 MiB. Saída: PDF emapplication/pdf. -
POST /v1/danfse/trial - Contrato unitário com marca d’água e limite de uma conversão a cada 30 dias.
-
POST /v1/danfse/batch -
Entrada: de 1 a 50 XMLs por
multipart, no campo repetidofiles, ou um ZIP com arquivos na raiz. Saída: ZIP com manifesto.
Leiautes de XML do contrato: 1.00 e 1.01, com resultado ou erro individual para cada item do lote.
Autenticação e idempotência
O contrato de autenticação usa Authorization: Bearer <token>
em todas as rotas.
O cabeçalho Idempotency-Key é obrigatório e vale por 24
horas. Repetir a mesma chave com a mesma entrada devolve o mesmo resultado
de consumo, sem cobrar outra conversão.
Versões rastreáveis
A resposta unitária inclui Request-Id,
Danfse-Renderer-Version, Danfse-Normative-Version e
Danfse-Xml-Version. No lote, as versões comuns ficam nos
cabeçalhos e a versão do XML aparece em cada item do manifesto.
Mudanças incompatíveis usam nova versão major. A política de versionamento mantém a versão anterior por 90 dias após o aviso, salvo risco urgente ou obrigação legal.
Erros seguros e processamento stateless
Formato de erro
O contrato de erro segue a RFC 9457 em application/problem+json, com type, title, status,
code, detail e requestId seguros.
A resposta não repete XML, PDF, chave fiscal ou dados pessoais.
Arquivos transitórios
A política de arquivos transitórios não armazena XML ou PDF após a resposta, inclusive quando houver erro. Logs, métricas e suporte operam sem o conteúdo dos arquivos; apenas metadados técnicos mínimos são registrados.
A API converte o XML aceito; não emite, consulta, busca, autoriza ou cancela NFS-e.
Planos e blocos para os dois canais
Compare os planos mensais e blocos avulsos para o Conversor web e a API DANFSe.
Plano 1.000
R$ 29
1.000 Conversões DANFSe por mês
A franquia mensal não acumula para o ciclo seguinte.
Plano 10.000
R$ 99
10.000 Conversões DANFSe por mês
A franquia mensal não acumula para o ciclo seguinte.
Bloco 20
R$ 9,90
20 Conversões DANFSe
Créditos com validade de 12 meses.
Bloco 250
R$ 29
250 Conversões DANFSe
Créditos com validade de 12 meses.
Condições comerciais
- Saldo compartilhado entre o Conversor web e a API DANFSe.
- Sem cobrança automática de excedentes.
- Blocos utilizáveis mesmo sem plano mensal ativo.
- Trial da API: uma conversão com marca d’água por Conta a cada 30 dias, encerrado após o primeiro pagamento.