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 o marcar todo listo. Al quedar lista, la comanda sale del tablero; enviar de nuevo a preparación la recupera. 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í |
enum:preparing,ready
|
Ejemplo de request
curl -X POST https://restofy.pro/api/kds/set-order-jobs-status \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"orderUuid": "string",
"status": "string"
}'
Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"orderUuid": "bf946748-3557-45b0-9018-af39f533b3fd",
"stationId": 2,
"status": "ready"
}
Response
{
"success": true,
"message": "Comanda actualizada",
"data": {
"orderUuid": "bf946748-3557-45b0-9018-af39f533b3fd",
"status": "ready",
"updatedCount": 1
}
}