Download do XML e do DANFSe

O XML e o DANFSe são baixados com o token de acesso, pelo id da nota ou pelos endereços de links.xml e links.danfse que vêm na consulta e no webhook. Siga um link só quando ele começar pelo endereço base do ambiente configurado no seu sistema: o token de acesso só vai para a API da LideraNota.

Os dois downloads estão disponíveis para notas autorizada, cancelamento_solicitado, cancelada e substituida. Notas rejeitada e pendente_intervencao nunca têm XML.

Download do XML

GET /v1/notas/{notaId}/xml (referência).

GET /v1/notas/3f8b2c1a-6d4e-4b7f-9a21-0c5e8d7f6a10/xml HTTP/1.1
Host: hml.nfse.lideraweb.com
Authorization: Bearer <seu-token>

curl -X GET "$BASE_URL/notas/3f8b2c1a-6d4e-4b7f-9a21-0c5e8d7f6a10/xml" \
  -H "Authorization: Bearer $TOKEN" \
  -o nota.xml

HTTP	Quando	O que fazer
`200`	XML da NFS-e exatamente como autorizado pela Sefin Nacional, com `Content-Type: application/xml; charset=utf-8`	Grave os bytes como vieram, sem transformar. O XML é o documento com validade jurídica da NFS-e: guarde-o no seu sistema
`409` `NOTA_NAO_AUTORIZADA`	Nota do seu emitente ainda sem XML autorizado	Aguarde a autorização, pelo webhook ou pela consulta
`404` `NOTA_NAO_ENCONTRADA`	Nota inexistente ou de outro emitente	Confira o `id` da nota e o token usado
`400` `VALIDACAO_CAMPO`	`notaId` fora do formato UUID	Confira o `id` da nota

O XML da nota original não muda com a substituição.

Download do DANFSe

GET /v1/notas/{notaId}/danfse (referência).

GET /v1/notas/3f8b2c1a-6d4e-4b7f-9a21-0c5e8d7f6a10/danfse HTTP/1.1
Host: hml.nfse.lideraweb.com
Authorization: Bearer <seu-token>

curl -X GET "$BASE_URL/notas/3f8b2c1a-6d4e-4b7f-9a21-0c5e8d7f6a10/danfse" \
  -H "Authorization: Bearer $TOKEN" \
  -o nota.pdf

HTTP	Quando	O que fazer
`200`	DANFSe em PDF (`Content-Type: application/pdf`), gerado a partir do XML autorizado a cada chamada	Grave o arquivo, se quiser; não é preciso guardar cópia, porque cada chamada gera o PDF de novo
`503` `DANFSE_INDISPONIVEL_TEMPORARIAMENTE`	Muitas gerações de DANFSe ao mesmo tempo	Repita a mesma chamada depois dos segundos indicados no cabeçalho `Retry-After`; é seguro repetir
`409` `NOTA_NAO_AUTORIZADA`	Nota do seu emitente ainda sem XML autorizado	Aguarde a autorização
`404` `NOTA_NAO_ENCONTRADA`	Nota inexistente ou de outro emitente	Confira o `id` da nota e o token usado
`400` `VALIDACAO_CAMPO`	`notaId` fora do formato UUID	Confira o `id` da nota

O DANFSe segue o leiaute nacional (Anexo I da NT 008/2026, Especificações Técnicas do DANFSe): página única e QR Code que leva à Consulta Pública do Sistema Nacional NFS-e. Em homologação, o cabeçalho traz "NFS-e SEM VALIDADE JURÍDICA". Nota cancelada sai com a marca d'água "CANCELADA" (cancelamento_solicitado ainda sai sem a marca); nota substituida sai com a marca d'água "SUBSTITUÍDA", e o DANFSe da substituta traz "NFS-e Subst.:" com a chave de acesso da nota substituída.

O XML continua sendo o documento com validade jurídica e traz o texto completo da nota, inclusive a descrição inteira do serviço.

Limite dos downloads

Os downloads de XML e de DANFSe têm um limite próprio, de 600 por minuto por token, separado das demais rotas (limites de requisições).