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 sinopenrespondestale: 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:
200consuccess: falseystale: truecuando tu copia de la mesa está desactualizada: vuelve a leer la mesa.403si 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.