Nota fiscal (NF-e)
Dados, XML e DANFE da nota fiscal eletrônica do pedido.
Quando o seller emite a NF-e (nota fiscal eletrônica) do pedido, o cliente tem direito de recebê-la. Estas três rotas entregam os dados da nota, o arquivo XML assinado pela SEFAZ e o DANFE em PDF (a versão impressa da nota). Dependem do módulo focusnfe; com o módulo desligado a resposta é 403 module_disabled.
Só existe resposta de sucesso para nota autorizada pela SEFAZ. Enquanto a nota não foi emitida (pedido ainda não faturado), foi rejeitada ou cancelada, as três rotas respondem 404 NF-e not available for this order: trate como "ainda não disponível".
/api/v1/storefront/orders/{id}/nfeClienteDados da NF-e do pedido
Parâmetros de caminho
iduuidobrigatóriocurl "$BASE_URL/api/v1/storefront/orders/$ORDER_ID/nfe" \
-H "Authorization: Bearer $TOKEN"{
"status": "authorized",
"chave_nfe": "35261012345678000190550010000001231000001234",
"numero": "123",
"serie": "1",
"issued_at": "2026-10-12T14:03:10Z"
}Campos da resposta
statusstringauthorized nesta rota.chave_nfestringnumerostringseriestringissued_atstring/api/v1/storefront/orders/{id}/nfe/xmlClienteBaixa o XML da NF-e
Devolve o XML assinado como download (Content-Disposition: attachment; filename=nfe_<número>.xml). O Content-Type é o que o emissor devolve (normalmente application/xml). Guarde o arquivo: ele é o documento fiscal válido.
Parâmetros de caminho
iduuidobrigatóriocurl "$BASE_URL/api/v1/storefront/orders/$ORDER_ID/nfe/xml" \
-H "Authorization: Bearer $TOKEN"/api/v1/storefront/orders/{id}/nfe/danfeClienteBaixa o DANFE (PDF) da NF-e
Devolve o DANFE em PDF como download (Content-Disposition: attachment; filename=danfe_<número>.pdf). É a versão para imprimir ou mostrar junto da mercadoria.
Parâmetros de caminho
iduuidobrigatóriocurl "$BASE_URL/api/v1/storefront/orders/$ORDER_ID/nfe/danfe" \
-H "Authorization: Bearer $TOKEN"Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Sem token, ou token inválido ou expirado | {"error":"missing authorization header"} / {"error":"invalid or expired token"} |
| 403 | Módulo focusnfe desligado na loja | {"error":"module_disabled","module":"focusnfe"} |
| 404 | Pedido que não é seu, ou nota ainda não autorizada | {"error":"order not found"} / {"error":"NF-e not available for this order"} |
| 500 | Falha ao ler a nota ou ao baixar o XML/DANFE do emissor | {"error":"failed to download DANFE PDF","detail":"..."} |
| 503 | Serviço de pedidos indisponível | {"error":"order service unavailable"} |