Pantalla de cocina
POST
Cambiar estado de un producto en cocina
POST /api/kds/set-job-status
Descripción
Avanza o revierte la preparación de un producto en su estación.
Detalles
Mueve un producto de la comanda entre los estados en cola, en preparación, listo y despachado. Valida que el cambio sea legal desde el estado actual y permite deshacer un paso hacia atrás. El estado consolidado del producto queda visible para todo el equipo.
Permisos requeridos
kitchen.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| jobId | int | Sí |
min_value:1
|
| status | string | Sí |
in:fired,preparing,ready,served
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/kds/set-job-status \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"jobId": 1,
"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
{
"jobId": 3,
"status": "preparing"
}Response
{
"success": true,
"message": "Estado actualizado",
"data": {
"jobId": 3,
"status": "preparing"
}
}