Documentação da API

POST /update_inventory_movement

Resumo

Este endpoint permite atualizar informações de uma movimentação de estoque específica.

---

Descrição

Use este endpoint para modificar dados de uma movimentação de estoque existente em uma unidade da plataforma. É necessário fornecer os tokens de acesso, da unidade e da movimentaçã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 da movimentação a ser atualizada.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
date_in_out	string	Sim	Data da movimentação no formato DD/MM/AAAA.	"20/03/2024"
id_token_product	string	Não	Token do produto a ser movimentado.	a6927665-6d56-4839-ad23-37d48717da13
type	string	Não	Tipo da movimentação: "in" para entrada ou "out" para saída.	"out"
quantity	string	Não	Quantidade movimentada no formato brasileiro (999.999,99).	"15,75"
id_token_contact	string	Não	Token do contato relacionado à movimentação.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
lote	string	Não	Identificação do lote do produto.	"LOTE002"
validation_date	string	Não	Data de validade do produto no formato DD/MM/AAAA.	"30/06/2025"
unitary_value	string	Não	Valor unitário do produto no formato brasileiro (999.999,99).	"75,00"
total_value	string	Não	Valor total da movimentação no formato brasileiro (999.999,99).	"1.181,25"

---

Exemplo de Requisição

Curl

curl -X POST 'https://portal.fipli.pro/api/v1/update_inventory_movement' \
-H 'Content-Type: application/json' \
-d '{
  "access_token": "<access_token>",
  "unit_token": "<unit_token>",
  "id_token": "<id_token>",
  "date_in_out": "<date_in_out>",
  "type": "<type>",
  "quantity": "<quantity>",
  "unitary_value": "<unitary_value>",
  "total_value": "<total_value>"
}'

---

Resposta

200 OK

Movimentação atualizada com sucesso.

{
  "success": true,
  "message": "Sucesso ao alterar movimentação."
}

Erros Comuns

Status	Mensagem	Descrição
400	"Movement ID is required"	Token da movimentação não foi enviado na requisição.
400	"Data de entrada/saída é obrigatória."	Campo date_in_out é obrigatório para a atualização.
403	"Invalid data"	Token inválido ou não autorizado.
500	"Erro ao tentar alterar movimentação."	Erro interno no servidor.

---

Observações

• A data de entrada/saída é sempre obrigatória e deve estar no formato DD/MM/AAAA.
• Você pode enviar apenas os campos que deseja atualizar, exceto a data que é obrigatória.
• Valores monetários devem ser enviados no formato brasileiro com vírgula como separador decimal.
• Quantidades devem usar vírgula como separador decimal.
• O campo type aceita apenas "in" (entrada) ou "out" (saída).