Skip to main content
GET
https://api.zenflow.com.ar
/
api
/
v1
/
stock
/
movements
Obtener Movimientos de Stock
curl --request GET \
  --url https://api.zenflow.com.ar/api/v1/stock/movements \
  --header 'X-API-Key: <api-key>'

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

page
integer
default:"1"
Número de página
limit
integer
default:"50"
Items por página (máx 100)
product_id
integer
Filtrar por ID de producto
location_id
string
Filtrar por ID de ubicación
movement_type
string
Filtrar por tipo de movimiento (IN, OUT, TRANSFER, ADJUSTMENT)
start_date
string
Filtrar desde fecha (YYYY-MM-DD)
end_date
string
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

TipoDescripción
INStock agregado (recepción, devoluciones)
OUTStock removido (pedidos, daños)
TRANSFERStock movido entre ubicaciones
ADJUSTMENTCorrección de conteo de inventario