Enviar producto a cocina (comanda)
POST /api/restaurant/command-item/save
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra un producto de la mesa como comanda para cocina/bar: descuenta los insumos de la receta, reserva el stock (también de los componentes de un combo y de los modificadores que son productos) y notifica a las pantallas de cocina.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success. En el éxito trae kitchen_complete y order_status (estado del pedido de la mesa).
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
table_id |
integer | Sí | Id de la mesa. |
item_id |
integer | Sí | Id del producto. |
quantity |
numeric | Sí | Cantidad. |
item |
object | Sí | Producto tal como lo devuelve Listar productos de la carta (se guarda completo). Se usan name, has_supplies, has_sets, items_sets[].id / items_sets[].pivot.quantity y modifiersApplied[].items[] (type: item, item_id). |
note |
string | No | Nota de preparación. |
status |
integer | Sí | Estado inicial: 1 (Recibido). |
status_description |
string | No | Texto del estado, p. ej. Recibido. |
Reglas:
- Si la mesa estaba en
served, al agregar un producto vuelve apending.
Errores:
200consuccess: falsesi falla el descuento de insumos o la reserva de stock.
Cuerpo
Content-Type: application/json
{
"table_id": "1",
"item_id": "1",
"quantity": 2,
"note": "sin cebolla",
"status": 1,
"status_description": "Recibido",
"item": {
"id": 15,
"name": "LOMO SALTADO",
"has_supplies": true,
"has_sets": false,
"items_sets": [],
"modifiersApplied": [
{
"group": "Acompañamiento",
"items": [
{
"type": "item",
"item_id": 40,
"name": "Arroz"
}
]
}
]
}
}
Respuestas
200 — Enviado
{
"success": true,
"message": "Producto agregado con éxito.",
"kitchen_complete": false,
"order_status": "pending"
}
200 — Error de stock
{
"success": false,
"message": "Error al reservar stock."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.