Documentação da API

POST /generate_nf

Resumo

Este endpoint solicita a emissão de nota fiscal (NF-e, NFC-e ou NFS-e nacional) para um ou mais pedidos de venda.

---

Descrição

Com base nas configurações fiscais do pedido e da unidade, este endpoint dispara a emissão de nota fiscal junto ao provedor configurado (por exemplo, Focus NFe / NFSe nacional). O tipo de nota (produto ou serviço) é decidido pelo core com base nos dados 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 emissão da nota fiscal.	"PV-2024-0001" ou ["PV-2024-0001"]

---

Exemplo de Requisição

curl -X POST 'https://portal.fipli.pro/api/v1/generate_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"
}'

---

Resposta

{
  "ok": true,
  "success": true,
  "nf_kind": "nfsen",
  "results": [
    {
      "cod_pv": "PV-2024-0001",
      "nf_id": "123456",
      "status": "autorizado"
    }
  ]
}

A decisão entre NFS-e nacional ou NF-e/NFC-e é feita pelo core (emit_nf_api / emit_nfse_api / etc.), com base nos dados do pedido e da unidade.

Erros Comuns

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