Crear mesa
POST /api/restaurant/table
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Crea una mesa (o un pedido delivery / para llevar como mesa temporal).
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.
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
label |
string | Sí | Nombre o número visible de la mesa (p. ej. M7). |
environment |
string | Sí | Nombre del ambiente (p. ej. Salón, Terraza, Delivery, Para Llevar). Debe ser un ambiente de Mesas y ambientes. |
shape |
string | No | Forma para el plano: CUADRADO (por defecto), REDONDO, etc. |
status |
string | No | available (libre, por defecto) o notavailable (ocupada). |
products |
array | No | Pedido de la mesa (por defecto vacío). |
total |
numeric | No | Total del pedido (por defecto 0). |
personas |
integer | No | Comensales (por defecto 1). |
cliente |
string/object | No | Cliente del pedido. |
waiter |
string | No | Mozo asignado. |
order_status |
string | No | Estado del pedido: pending, served, delivered... |
delivery |
object | No | Datos de entrega (dirección, teléfono...) para pedidos delivery. |
Reglas:
- Los campos no se validan: envía al menos
labelyenvironment.
Cuerpo
Content-Type: application/json
{
"label": "M13",
"environment": "Salón",
"shape": "CUADRADO",
"status": "available",
"products": [],
"total": 0,
"personas": 1,
"cliente": null,
"waiter": null,
"order_status": null,
"delivery": null
}
Respuestas
200 — Creada
{
"success": true,
"data": {
"id": 13,
"status": "available",
"products": [],
"total": 0,
"personas": 1,
"cliente": null,
"label": "M13",
"shape": "CUADRADO",
"environment": "Salón",
"waiter": null,
"order_status": null,
"delivery": null,
"opening_token": null
},
"message": "Mesa creada con éxito."
}
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.