Pular para o conteúdo principal

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âmetroTipoObrigatórioDescriçãoExemplo
access_tokenstringSimToken de autenticação do usuário.b31643fc-a45f-448c-99ee-736a547f6989
unit_tokenstringSimToken identificador da unidade.e6988e9e-b0c1-410c-ae08-aed7c64ac71f
tokenstringSimToken identificador do produto/serviço a ser atualizado.a6927665-6d56-4839-ad23-37d48717da13
descriptionstringNãoNova descrição do produto ou serviço.Produto Premium Atualizado
typestringNãoNovo tipo do item: "product" para produtos ou "service" para serviços."service"
monetary_valuestringNãoNovo 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": "b31643fc-a45f-448c-99ee-736a547f6989",
  "unit_token": "e6988e9e-b0c1-410c-ae08-aed7c64ac71f",
  "token": "a6927665-6d56-4839-ad23-37d48717da13",
  "description": "Produto Premium Atualizado",
  "type": "service",
  "monetary_value": "2.000,00"
}'

Resposta​

200 OK​

Produto/serviço atualizado com sucesso.

{
  "success": true,
  "message": "Product/Service updated successfully",
  "data": {
    "token": "a6927665-6d56-4839-ad23-37d48717da13"
  }
}

Erros Comuns​

StatusMensagemDescriçã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.