Arquivos da NF-e (XML e DANFE)
Baixa o XML assinado e o DANFE em PDF de uma nota autorizada.
O XML é o documento fiscal oficial, que deve ser guardado por cinco anos; o DANFE é a versão para impressão. Os dois só existem depois que a nota fica autorizado.
Baixar o XML
/api/v1/admin/nfe/{id}/xmlAdminBaixa o XML da NF-e
Parâmetros de caminho
iduuidobrigatórioId interno da nota.
Exemplo de requisição
bash
curl "$BASE_URL/api/v1/admin/nfe/b7a76302-e926-4988-a015-789e8f225c60/xml" \
-H "Authorization: Bearer $TOKEN" \
-o nfe.xmlResposta
200Arquivo XML
Corpo application/xml com Content-Disposition: attachment; filename=nfe_<id>.xml.
Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 401 | Sem token ou token inválido. | {"error":"missing authorization header"} |
| 403 | O usuário não tem manage_nfe nem manage_settings. | {"error":"insufficient privileges","privilege_required_any":["manage_nfe","manage_settings"]} |
| 403 | O módulo focusnfe está desligado na loja. | {"error":"module_disabled","module":"focusnfe"} |
| 404 | Nota inexistente. | {"error":"NF-e not found"} |
| 500 | Nota ainda sem XML (não autorizada) ou falha no provedor. | {"error":"failed to download NF-e XML","detail":"nfe ... has no XML URL (status: processando)"} |
Baixar o DANFE
/api/v1/admin/nfe/{id}/danfeAdminBaixa o DANFE da NF-e
Parâmetros de caminho
iduuidobrigatórioId interno da nota.
Exemplo de requisição
bash
curl "$BASE_URL/api/v1/admin/nfe/b7a76302-e926-4988-a015-789e8f225c60/danfe" \
-H "Authorization: Bearer $TOKEN" \
-o danfe.pdfResposta
200Arquivo PDF
Corpo application/pdf com Content-Disposition: attachment; filename=danfe_<id>.pdf.
Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 401 | Sem token ou token inválido. | {"error":"missing authorization header"} |
| 403 | O usuário não tem manage_nfe nem manage_settings. | {"error":"insufficient privileges","privilege_required_any":["manage_nfe","manage_settings"]} |
| 403 | O módulo focusnfe está desligado na loja. | {"error":"module_disabled","module":"focusnfe"} |
| 404 | Nota inexistente. | {"error":"NF-e not found"} |
| 500 | Nota ainda sem DANFE ou falha no provedor. | {"error":"failed to download DANFE PDF","detail":"..."} |