Saltar al contenido
Facturador

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 a pending.

Errores:

  • 200 con success: false si 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.