Documentação da API
POST /send_danfe_xml
Resumo
Este endpoint envia ou reenvia por e-mail os arquivos de DANFE (PDF) e XML da nota fiscal associada a um pedido de venda.
Descrição
Utilize este endpoint para disparar o envio dos documentos fiscais (DANFE e XML) ao cliente ou aos administradores, com base nas configurações do pedido e da unidade. O core é responsável por localizar os arquivos vinculados à nota e enviá-los ao e-mail de destino.
Requisição
Body da Requisição
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
access_token | string | Sim | Token de autenticação do usuário. | b31643fc-a45f-448c-99ee-736a547f6989 |
unit_token | string | Sim | Token da unidade. | e6988e9e-b0c1-410c-ae08-aed7c64ac71f |
cod_pv | string | Sim | Código do pedido de venda que possui a nota fiscal emitida. | "PV-2024-0001" |
Exemplo de Requisição
curl -X POST 'https://portal.fipli.pro/api/v1/send_danfe_xml' -H 'Content-Type: application/json' -d '{
"access_token": "b31643fc-a45f-448c-99ee-736a547f6989",
"unit_token": "e6988e9e-b0c1-410c-ae08-aed7c64ac71f",
"cod_pv": "PV-2024-0001"
}'
Resposta
{
"ok": true,
"success": true,
"message": "DANFE e XML enviados com sucesso."
}
Erros Comuns
| Status | Mensagem | Descrição |
|---|---|---|
400 | "Pedido sem NF para enviar (nem emitida nem cancelada)." | Não há NF vinculada ao pedido. |
403 | "Invalid data" | Autenticação inválida. |
500 | "Erro ao enviar DANFE/XML" | Erro interno ao buscar/gerar arquivos ou ao enviar e-mail. |