Obtener Movimientos de Stock
Obtén el historial de movimientos de stock (adiciones, remociones, transferencias).
Requiere scope read:stock.
Solicitud
GET /api/v1/stock/movements
Parámetros de Consulta
Items por página (máx 100)
Filtrar por ID de producto
Filtrar por ID de ubicación
Filtrar por tipo de movimiento (IN, OUT, TRANSFER, ADJUSTMENT)
Filtrar desde fecha (YYYY-MM-DD)
Filtrar hasta fecha (YYYY-MM-DD)
Ejemplo
curl -X GET "https://api.zenflow.com.ar/api/v1/stock/movements?product_id=100&start_date=2024-01-01" \
-H "X-API-Key: zenflow_live_your_key"
Respuesta
{
"success": true,
"data": {
"movements": [
{
"id": "MOV-12345",
"product_id": 100,
"product_name": "Widget A",
"location_id": "LOC-A1",
"movement_type": "IN",
"quantity": 50,
"previous_quantity": 25,
"new_quantity": 75,
"reason": "Reposición de stock",
"user_id": 1,
"created_at": "2024-01-14T10:30:00Z"
},
{
"id": "MOV-12344",
"product_id": 100,
"product_name": "Widget A",
"location_id": "LOC-A1",
"movement_type": "OUT",
"quantity": 5,
"previous_quantity": 30,
"new_quantity": 25,
"reason": "Fulfillment de pedido",
"order_id": 12345,
"created_at": "2024-01-13T15:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 150,
"total_pages": 3
}
}
}
Tipos de Movimiento
| Tipo | Descripción |
|---|
IN | Stock agregado (recepción, devoluciones) |
OUT | Stock removido (pedidos, daños) |
TRANSFER | Stock movido entre ubicaciones |
ADJUSTMENT | Corrección de conteo de inventario |