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
| Atributo | Tipo | Descrição |
|---|---|---|
id | string | O ID único da movimentação (UUID). |
product_id | string | O ID do produto movimentado. |
type | string | Tipo de movimentação (entry para entrada, exit para saída, adjustment para ajuste). |
quantity | integer | Quantidade movimentada. |
unit_cost | number | Custo unitário do produto no momento da movimentação. |
movement_date | string | Data da movimentação no formato YYYY-MM-DD. |
journal_entry_id | string | Opcional. ID do lançamento contábil associado. |
organization_id | string | O ID da organização à qual a movimentação pertence. |
accounting_period_id | string | O 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.