Saltar al contenido
Facturador

Crear grupo de mesas

POST /api/restaurant/tables/group/create

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

Crea un grupo (para juntar mesas en un solo pedido) con la mesa principal indicada.

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 group con el grupo creado.

Cuerpo (JSON):

Campo Tipo Obligatorio Descripción / valores permitidos
main_table_id integer Sí Mesa principal: activa y sin grupo.

Errores:

  • 400 {success: false, message} si la mesa está fuera de servicio o ya está en un grupo.
  • 422 {success: false, message: {campo: [errores]}} si falla la validación de campos.

Cuerpo

Content-Type: application/json

{
  "main_table_id": "1"
}

Respuestas

200 — Creado

{
  "success": true,
  "group": {
    "id": 2,
    "main_table_id": 7,
    "status": "open",
    "opening_date": "2026-11-07T19:05:00.000000Z",
    "total": 0,
    "updated_at": "2026-11-07T19:05:00.000000Z",
    "created_at": "2026-11-07T19:05:00.000000Z"
  }
}

400 — Ya agrupada

{
  "success": false,
  "message": "Esta mesa ya pertenece a un grupo"
}

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.