Documentação da API

POST /get_inventory_moviment

Resumo

Este endpoint permite listar movimentações de estoque de uma unidade específica com opções de filtros.

---

Descrição

Use este endpoint para obter uma lista de movimentações de estoque (entradas e saídas) de uma unidade da plataforma. É possível aplicar filtros por contato, produto, lote, período e tipo de 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.	b31643fc-a45f-448c-99ee-736a547f6989
unit_token	string	Sim	Token identificador da unidade.	e6988e9e-b0c1-410c-ae08-aed7c64ac71f
id_contact	string	Não	Token do contato para filtrar movimentações.	d125837d-a4f7-4562-91bb-e63db2e86ab2
id_product	string	Não	Token do produto para filtrar movimentações.	a6927665-6d56-4839-ad23-37d48717da13
lote	string	Não	Lote para filtrar movimentações (busca parcial).	"LOTE001"
dateRange1	string	Não	Data inicial do período (formato ISO: YYYY-MM-DD).	"2024-01-01"
dateRange2	string	Não	Data final do período (formato ISO: YYYY-MM-DD).	"2024-12-31"
module_type	string	Não	Tipo de movimentação: "in", "out" ou "all" para todas.	"in"

---

Exemplo de Requisição

Curl

curl -X POST 'https://portal.fipli.pro/api/v1/get_inventory_moviment' \
-H 'Content-Type: application/json' \
-d '{
  "access_token": "b31643fc-a45f-448c-99ee-736a547f6989",
  "unit_token": "e6988e9e-b0c1-410c-ae08-aed7c64ac71f",
  "id_contact": "d125837d-a4f7-4562-91bb-e63db2e86ab2",
  "dateRange1": "2024-01-01",
  "dateRange2": "2024-12-31",
  "module_type": "all"
}'

---

Resposta

200 OK

Lista de movimentações obtida com sucesso.

{
  "success": true,
  "data": [
    {
      "token": "c7938887-8f78-6051-cf45-59f6a939fc35",
      "id_unit": "e6988e9e-b0c1-410c-ae08-aed7c64ac71f",
      "id_contact": "d125837d-a4f7-4562-91bb-e63db2e86ab2",
      "active": true,
      "created_date": "2024-03-15T10:30:00.000Z",
      "type": "in",
      "quantity": "10.50",
      "id_stock_product": "a6927665-6d56-4839-ad23-37d48717da13",
      "unit": "Unidade Principal",
      "product": "Produto A",
      "lote": "LOTE001",
      "validation_date": "31/12/2024",
      "date_in_out": "15/03/2024",
      "unitary_value": "50.00",
      "total_value": "525.00",
      "contact_name": "João Silva"
    }
  ]
}

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	"DB Query Error"	Erro interno no servidor.

---

Observações

• Apenas movimentações ativas são retornadas por padrão.
• As datas devem ser fornecidas no formato ISO (YYYY-MM-DD) para os filtros de período.
• Se apenas dateRange1 for fornecida, será filtrado a partir dessa data.
• Se apenas dateRange2 for fornecida, será filtrado até essa data.
• O campo lote faz busca parcial (contém o texto informado).
• Os resultados são ordenados pela data de movimentação em ordem decrescente.
• Valores monetários são retornados sem formatação de moeda.