Documentação da API

POST /cancel_nf

Resumo

Este endpoint solicita o cancelamento da nota fiscal vinculada a um ou mais pedidos de venda.

---

Descrição

Utilize este endpoint quando for necessário cancelar uma nota fiscal já emitida (dentro das regras e prazos da legislação e do provedor). O core se encarrega de chamar o provedor de NF (NF-e/NFS-e) e atualizar os campos locais do pedido.

---

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 | array	Sim	Código(s) do(s) pedido(s) de venda para cancelamento da nota fiscal.	"PV-2024-0001" ou ["PV-2024-0001"]
justification	string	Não	Justificativa do cancelamento (quando exigida pelo provedor/legislação).	Cancelamento por erro de emissão.

---

Exemplo de Requisição

curl -X POST 'https://portal.fipli.pro/api/v1/cancel_nf' -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",
  "justification": "Cancelamento por erro de emissão."
}'

---

Resposta

{
  "ok": true,
  "success": true,
  "results": [
    {
      "cod_pv": "PV-2024-0001",
      "nf_id": "123456",
      "status_before": "autorizado",
      "status_after": "cancelado"
    }
  ]
}

Erros Comuns

Status	Mensagem	Descrição
400	"Informe o código do pedido de venda para cancelar a nota."	cod_pv não informado.
403	"Invalid data"	Autenticação inválida.
500	"Erro ao cancelar nota fiscal"	Erro interno ao cancelar a nota.