Pantalla de cocina
POST
Avanzar una comanda completa
POST /api/kds/set-order-jobs-status
Descripción
Cambia de estado todos los productos de una orden en cocina.
Detalles
Avanza en bloque los productos de una comanda hacia el estado indicado: iniciar preparación, marcar todo listo o despachar. También recupera al tablero una comanda ya despachada. Solo mueve los productos cuyo cambio es válido; el resto no se toca.
Permisos requeridos
kitchen.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| orderUuid | string | Sí |
uuid
|
| stationId | int | No |
min_value:1
|
| status | string | Sí |
in:preparing,ready,served
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/kds/set-order-jobs-status \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"orderUuid": "string",
"status": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"orderUuid": "2cc02b62-f511-47fe-8345-4536123f6c2c",
"stationId": 2,
"status": "ready"
}Response
{
"success": true,
"message": "Comanda actualizada",
"data": {
"orderUuid": "2cc02b62-f511-47fe-8345-4536123f6c2c",
"status": "ready",
"updatedCount": 1
}
}