Saltar al contenido
Facturador

Guardar mesa (pedido, abrir, cerrar)

POST /api/restaurant/table/{restaurant_table_id}

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Guarda el estado completo de la mesa: pedido (products), total, comensales, cliente, mozo y estado. También abre (open) o cierra (close) la mesa. Si la mesa queda sin productos se liberan las cantidades reservadas y se borran sus comandas.

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 devuelve el opening_token actualizado; ante un conflicto de versión responde success: false y stale: true.

Parámetros de la URL:

Campo Tipo Obligatorio Descripción / valores permitidos
id integer Sí Id de la mesa.

Cuerpo (JSON):

Campo Tipo Obligatorio Descripción / valores permitidos
products array Sí Pedido completo de la mesa (envía [] para vaciarla).
status string Sí available o notavailable. Si products tiene elementos se guarda siempre notavailable.
total numeric No Total del pedido.
personas integer No Comensales.
cliente string/object No Cliente.
comentarios string No Comentarios del pedido.
waiter string No Mozo asignado.
label string No Nombre de la mesa.
shape string No Forma.
environment string No Ambiente.
order_status string Sí en delivery / para llevar Estado del pedido (pending, served, delivered, deleted...).
is_paid boolean No true si el pedido ya se cobró.
delivery object No Datos de entrega.
open boolean No true para abrir la mesa (inicia el tiempo de atención).
close boolean No true para cerrar la mesa.
expected_opening_token integer Recomendado opening_token que leíste. Si la mesa cambió en otro equipo no se guarda (stale: true).

Reglas:

  • Una mesa libre y vacía solo se reabre con open: true; si llegan productos sin open responde stale: true.
  • Cerrar la mesa (close) requiere ser administrador, tener rol de restaurante administrador o que la configuración permita cerrar mesas al rol del usuario (mozo/cajero).
  • En pedidos Delivery / Para Llevar, order_status: deleted (o un pedido ya entregado) elimina la mesa temporal y sus comandas.
  • Si la mesa pertenece a un grupo, el total y el estado se copian a todas las mesas del grupo.

Errores:

  • 200 con success: false y stale: true cuando tu copia de la mesa está desactualizada: vuelve a leer la mesa.
  • 403 si el usuario no puede cerrar mesas.
  • 404 {success: false, message: "Registro no encontrado."} si el id no existe.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
restaurant_table_id ruta sí 1

Cuerpo

Content-Type: application/json

{
  "products": [
    {
      "id": 15,
      "name": "LOMO SALTADO",
      "quantity": 2,
      "price": 32.0,
      "note": "sin cebolla"
    }
  ],
  "status": "notavailable",
  "total": 64.0,
  "personas": 2,
  "cliente": null,
  "comentarios": null,
  "waiter": "CARLOS RAMOS",
  "label": "M7",
  "shape": "CUADRADO",
  "environment": "Salón",
  "order_status": "pending",
  "is_paid": false,
  "delivery": null,
  "open": true,
  "close": false,
  "expected_opening_token": null
}

Respuestas

200 — Guardada

{
  "success": true,
  "message": "Mesa actualizada.",
  "opening_token": 1762536000
}

200 — Cambió en otro equipo

{
  "success": false,
  "stale": true,
  "message": "La mesa cambió en otro equipo. Se actualizaron los datos."
}

200 — Pedido entregado

{
  "success": true,
  "message": "Pedido finalizado, entrega realizada"
}

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.