Documentação da API

POST /update_product_or_service

Resumo

Este endpoint permite atualizar informações de um produto ou serviço específico em uma unidade do sistema.

---

Descrição

Use este endpoint para modificar descrição, tipo ou valor monetário de produtos ou serviços em uma unidade da plataforma. É necessário fornecer os tokens de acesso, da unidade e 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.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
unit_token	string	Sim	Token identificador da unidade.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
id_token	string	Sim	Token identificador do produto/serviço a ser atualizado.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
description	string	Não	Nova descrição do produto ou serviço.	Produto Premium Atualizado
type	string	Não	Novo tipo do item: "product" para produtos ou "service" para serviços.	"service"
monetary_value	string	Não	Novo valor monetário no formato brasileiro (999.999,99).	"2.000,00"

---

Exemplo de Requisição

Curl

curl -X POST 'https://portal.fipli.pro/api/v1/update_product_or_service' \
-H 'Content-Type: application/json' \
-d '{
  "access_token": "<access_token>",
  "unit_token": "<unit_token>",
  "id_token": "<id_token>",
  "description": "<description>",
  "type": "<type>",
  "monetary_value": "<monetary_value>"
}'

---

Resposta

200 OK

Produto/serviço atualizado com sucesso.

{
  "success": true,
  "message": "Product/Service updated successfully",
  "data": {
    "token": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
  }
}

Erros Comuns

Status	Mensagem	Descrição
400	"Missing required parameters"	Token de acesso, unidade ou do produto/serviço não foi enviado.
400	"No fields provided to update"	Nenhum campo para atualização foi fornecido 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.
404	"Product not found or not updated"	O produto/serviço não foi encontrado ou não pôde ser atualizado.
500	"Something went wrong. Please try again later."	Erro interno no servidor.

---

Observações

• Você pode enviar apenas os campos que deseja atualizar, não é necessário enviar todos.
• O valor monetário deve ser enviado no formato brasileiro com vírgula como separador decimal.
• O campo type aceita apenas "product" ou "service".
• Certifique-se de que o token do produto/serviço seja válido e pertença à unidade especificada.