Endpoints de la API. Especificación exacta de cada operación de la API v1 (parámetros, cuerpo, respuestas y ejemplos), generada del documento OpenAPI con el que se valida cada respuesta real. Los procedimientos completos están en Guías.

Documentos y operación

Olas

Grupos de pedidos que se surten juntos. Requiere el módulo de olas.

Operaciones

Operación	Método y ruta	Alcance
Listar olas	GET `/waves`	`pickings:read`
Planear una ola	POST `/waves`	`pickings:write`
Consultar una ola	GET `/waves/{id}`	`pickings:read`

Rutas de olas

Objeto ola

id integer obligatorio
code string obligatorio
warehouse_code string | null
strategy string obligatorio

Valores: discrete, by_customer, batch, cluster, zone, pick_and_pass
status string obligatorio

Valores: draft, planned, released, in_progress, picked, completed, closed, cancelled
carrier_code string | null
cutoff_at string (date-time) | null
released_at string (date-time) | null
metrics objeto

Pedidos, líneas, unidades y avance de la ola.
created_at string (date-time) | null
updated_at string (date-time) | null
orders array de objetos

Solo en el detalle.
2 campos de orders
- picking_id integer obligatorio
- status string obligatorio

Objeto ola

{
    "id": 1,
    "code": "W-0001",
    "warehouse_code": "CEDIS-GDL",
    "strategy": "cluster",
    "status": "planned",
    "carrier_code": null,
    "cutoff_at": null,
    "released_at": null,
    "metrics": {
        "lines": 2,
        "trips": 0,
        "units": 3,
        "orders": 2,
        "standard_minutes": 1
    },
    "created_at": "2026-10-06T10:20:11-06:00",
    "updated_at": "2026-10-06T10:20:11-06:00"
}