Desenvolvedores

última atualização: terça-feira, 03 de abril de 2018

DANFE.br.com API

DANFE.br.com é um sistema para controle de notas fiscais eletrônicas, e o principal objetivo dessa API é facilitar a vida dos desenvolvedores. Com a nossa API você consegue os dados de uma NFe (XML ou PDF), através da chave de acesso ou xml em poucos minutos.

Achou algum Bug?

Se você achar alguma falha ou precisar de ajuda para conseguir fazer a API funcionar entre em contato com o nosso suporte, danfe.br.com/suporte.

Acesso da API

1º Passo

Você deve liberar que a API tenha acesso a sua conta, por padrão todas as contas vem bloqueadas o acesso via API. Para liberar o acesso da API, acesse a sua conta e vá para o menu (configurações -> sistema), basta marca a opção "Permitir o uso da API em minha conta?" e salvar.

configurações > sistema:

http://danfe.br.com/app/sistema

2º Passo

Pegando sua API Key, a chave da sua API garante que as NFe geradas via API caia diretamente na sua conta, assim você pode gerenciar a qualquer momento. Para ter acesso a sua API Key, acesse sua conta e vá para o menu (configurações -> api key).

configurações > api key:

http://danfe.br.com/app/apikey

Gerando DANFE

Aviso API

Lembre-se se o portal da nota fiscal eletrônica (nfe.fazenda.gov.br) atualizar os seus dados, possa ser que surja uma nova versão da API. Fique de olho nessa página e no blog que sempre terá novidades.

API 1.0 [XML]

Endereço da API
URL Formatos
http://danfe.br.com/api/nfe/danfe.json .json, .jsonp, .xml, .csv, .php e .html
modelo de uso:

Método HTTP GET: apikey

Método HTTP POST: string com xml

http://danfe.br.com/api/nfe/danfe.json?apikey=API_KEY

Erros da API (status = false)
Erro Descrição
ERRO_XML_INVALIDO XML inválido.
Sucesso da API (status = true)
Variável Descrição
xml Endereço com XML da NFe
pdf Endereço com PDF da NFe
Exemplos de Códigos

API 1.0 [CHAVE]

Endereço da API
URL Formatos
http://danfe.br.com/api/nfe/danfe.json .json, .jsonp, .xml, .csv, .php e .html
modelo de uso:

Método HTTP GET: apikey e chave

http://danfe.br.com/api/nfe/danfe.json?apikey=API_KEY&chave=CHAVE_DE_ACESSO

Erros da API (status = false)
Erro Descrição
ERRO_APIKEY_INVALIDA A API Key é inválida, ela deve ter 32 caracteres, somente letras e números.
ERRO_APIKEY_INEXISTENTE A API Key não existe, verifique se você mudou a chave da sua API.
ERRO_API_ACESSO Conta sem liberar o acesso da API. Verifique no menu (configurações > sistema).
ERRO_CHAVE_INVALIDA Verifique a chave de acesso da NFe.
ERRO_RECEITA Variável adicional "mensagem" com erro fornecido pelo portal da NFe.
ERRO_RECEITA_OBTER_DADOS Portal da NFe temporariamente offline.
Sucesso da API (status = true)
Variável Descrição
xml Endereço com XML da NFe (sem assinatura)
pdf Endereço com PDF da NFe
urlcertificado Endereço com XML da NFe (com assinatura), requer certificado digital
Exemplos de Códigos