Gerar DANFSE

Método: GET

Endpoint: https://api.emitix.com.br/nfse/danfse

Descrição Geral

Embora a API Emitix gere automaticamente o link da DANFSE após a emissão bem-sucedida de uma nota, oferecemos esta rota dedicada para que você possa gerar ou recuperar a representação gráfica (DANFSE) de uma NFS-e a qualquer momento a partir de sua Chave de Acesso.

Função da Rota

• Solicitar a geração do arquivo PDF da DANFSE referente a uma NFS-e emitida.
• Obter os dados (como um XML retornado ou link) específicos da representação visual da nota fiscal.

Situações de Uso

• O link original da DANFSE expirou ou não foi salvo no momento da emissão.
• O sistema do cliente contábil requer o reenvio de um PDF da nota fiscal em uma data posterior.
• Funcionalidades de "2ª via" da nota dentro do seu ERP.

Campos da Requisição (Payload)

Embora o método seja GET, a requisição aceita um corpo (Payload) em JSON com os seguintes campos:

Campo	Tipo	Obrigatório	Descrição
chaveAcesso	string	✅	Chave de acesso da NFS-e a ser gerada a DANFSE (44 caracteres numéricos).
cnpj	string	⚙️ Opcional*	CNPJ do prestador (obrigatório se CPF não for informado).
cpf	string	⚙️ Opcional*	CPF do prestador (obrigatório se CNPJ não for informado).
certificate	string	⚙️ Opcional	Certificado digital A1 em base64. Se não enviado, utiliza-se o cadastrado no sistema.
pass_certificate	string	⚙️ Opcional	Senha do certificado digital A1.

Observação: Deve ser informado obrigatoriamente apenas um dos identificadores do prestador: cnpj ou cpf.

Autenticação

A rota exige autenticação dupla através dos cabeçalhos:

• Bearer Token
  • Authorization: Bearer <seu_token_de_acesso>
• API Key
  • api-key: <sua_api_key>

Exemplo de Payload

{
  "chaveAcesso": "12345678901234567890123456789012345678901234",
  "cnpj": "12345678000199"
}

Exemplo de Requisição Completa

curl -X GET https://api.emitix.com.br/nfse/danfse \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <seu_token_de_acesso>" \
  -H "api-key: <sua_api_key>" \
  -d '{
    "chaveAcesso": "12345678901234567890123456789012345678901234",
    "cnpj": "12345678000199"
  }'

Exemplo de Resposta

{
  "success": true,
  "message": "DANFSe gerada com sucesso",
  "statusCode": 200,
  "data": {
    "url": "https://api.emitix.com.br/arquivos/danfse/12345678901234567890123456789012345678901234.pdf",
    "chaveAcesso": "12345678901234567890123456789012345678901234"
  }
}