Saltar al contenido
Facturador

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 label y environment.

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.