Downloads de XML e DANFE
Depois que a emissão conclui (job Concluido, ou nota emitida pelo portal), baixe os documentos
pela chave de acesso (44 dígitos):
GET /api/integracao/notas/{chave}/xml → application/xml
GET /api/integracao/notas/{chave}/danfe → application/pdf
GET /api/integracao/dce/{chave}/xml → application/xml (DC-e)
GET /api/integracao/dce/{chave}/dace → application/pdf (DACE da DC-e)
curl -H "X-Api-Key: $KEY" \
"$BASE/notas/35260643636483000128550010000000011234567890/xml" -o nota.xml
curl -H "X-Api-Key: $KEY" \
"$BASE/notas/35260643636483000128550010000000011234567890/danfe" -o danfe.pdf
XML autorizado
- É o procNFe completo: a NF-e assinada mais o protocolo de autorização da SEFAZ — o documento fiscal com validade jurídica.
- Imutável: o conteúdo nunca muda depois da autorização (guarda legal de 5 anos no Notavia).
- Para notas canceladas, o XML da nota continua disponível; o XML do evento de cancelamento acompanha a nota no portal.
DANFE (PDF)
- Gerado sob demanda a cada chamada, a partir do XML autorizado — não é arquivado.
- É a representação gráfica para impressão/transporte; o documento fiscal é o XML.
Respostas
| HTTP | Significado |
|---|---|
200 |
Documento no corpo da resposta |
404 |
Chave inexistente na sua empresa |
409 |
Documento existe mas ainda não tem XML autorizado (ex.: rejeitado) |
Dica: o cliente da nota (se tiver e-mail cadastrado) já recebe XML + DANFE automaticamente — muitas integrações só precisam arquivar o XML do lado do emissor.
Exportação em massa
Para baixar todos os XMLs de uma vez (backup/portabilidade), use a exportação em ZIP no portal: tela Notas → Exportar XMLs (como funciona). Pela API, os downloads são por chave de acesso.