Documentação da API

POST /insert_product_or_service

Resumo

Este endpoint permite o cadastro de um novo produto ou serviço para uma unidade específica do sistema.

---

Descrição

Use este endpoint para cadastrar produtos ou serviços em uma unidade da plataforma. É necessário fornecer os tokens de acesso e da unidade, além das informações do produto/serviço.

---

Requisição

Body da Requisição

O corpo deve ser um objeto JSON com os seguintes parâmetros:

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 identificador da unidade.	e6988e9e-b0c1-410c-ae08-aed7c64ac71f
description	string	Sim	Descrição do produto ou serviço.	Produto Premium
type	string	Sim	Tipo do item: "product" para produtos ou "service" para serviços.	"product"
monetary_value	string	Sim	Valor monetário no formato brasileiro (999.999,99).	"1.500,50"

---

Exemplo de Requisição

Curl

curl -X POST 'https://portal.fipli.pro/api/v1/insert_product_or_service' \
-H 'Content-Type: application/json' \
-d '{
  "access_token": "b31643fc-a45f-448c-99ee-736a547f6989",
  "unit_token": "e6988e9e-b0c1-410c-ae08-aed7c64ac71f",
  "description": "Produto Premium",
  "type": "product",
  "monetary_value": "1.500,50"
}'

---

Resposta

200 OK

Produto/serviço cadastrado com sucesso.

{
  "success": true,
  "message": "Product/Service inserted successfully",
  "data": {}
}

Erros Comuns

Status	Mensagem	Descrição
400	"Missing parameters"	Algum parâmetro obrigatório não foi enviado na requisição.
403	"Invalid data"	Token inválido ou não autorizado.
404	"Unit not found"	A unidade com o token fornecido não foi encontrada no sistema.
500	"Something went wrong. Please try again later."	Erro interno no servidor.

---

Observações

• Os produtos/serviços cadastrados ficam atrelados à unidade informada.
• O valor monetário deve ser enviado no formato brasileiro com vírgula como separador decimal.
• O campo type aceita apenas "product" ou "service".
• Produtos/serviços são criados como ativos por padrão.