Skip to content

Movimentações de Estoque

Este módulo da API gerencia as movimentações de estoque de produtos, registrando entradas e saídas para manter o controle preciso do inventário.

Objeto Movimentação de Estoque

AtributoTipoDescrição
idstringO ID único da movimentação (UUID).
product_idstringO ID do produto movimentado.
typestringTipo de movimentação (entry para entrada, exit para saída, adjustment para ajuste).
quantityintegerQuantidade movimentada.
unit_costnumberCusto unitário do produto no momento da movimentação.
movement_datestringData da movimentação no formato YYYY-MM-DD.
journal_entry_idstringOpcional. ID do lançamento contábil associado.
organization_idstringO ID da organização à qual a movimentação pertence.
accounting_period_idstringO ID do período contábil ao qual a movimentação pertence.

Endpoints

  • Registrar Movimentação: Registra uma nova movimentação de estoque.
    • POST /api/inventory/stock-movements
    • Corpo da Requisição: {"product_id": "uuid", "type": "entry", "quantity": 10, "unit_cost": 50.00, "movement_date": "2025-10-12"}
    • Resposta: Objeto Movimentação de Estoque criada.
  • Listar Movimentações: Retorna uma lista de movimentações de estoque para um produto ou período.
    • GET /api/inventory/stock-movements
    • Parâmetros de Query: product_id (string, opcional), type (string, opcional), startDate (string, opcional), endDate (string, opcional).
    • Resposta: Array de objetos Movimentação de Estoque.

Códigos de Status HTTP

  • 200 OK: Movimentações listadas com sucesso.
  • 201 Created: Movimentação registrada com sucesso.
  • 400 Bad Request: Dados da requisição inválidos.
  • 401 Unauthorized: Autenticação necessária ou credenciais inválidas.
  • 404 Not Found: Produto não encontrado.
  • 500 Internal Server Error: Erro interno do servidor.