Saltar al contenido
Facturador

Cambiar mesa de ambiente

POST /api/restaurant/table/cambiar-ambiente

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

Mueve una mesa libre a otro ambiente activo. Se recuerda el ambiente original para poder restaurarla.

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
table_id integer Sí Id de la mesa.
nuevo_ambiente string Sí Nombre del ambiente destino (máx. 100), debe existir y estar activo.

Reglas:

  • La mesa debe estar libre (available) y no pertenecer a un grupo.

Errores:

  • 400 {success: false, message}: mesa ocupada, agrupada, ya está en ese ambiente o ambiente inexistente.
  • 422 {success: false, message: {campo: [errores]}} si falla la validación de campos.

Cuerpo

Content-Type: application/json

{
  "table_id": "1",
  "nuevo_ambiente": "Terraza"
}

Respuestas

200 — Movida

{
  "success": true,
  "message": "Mesa M7 movida a Terraza",
  "mesa": {
    "id": 7,
    "label": "M7",
    "environment": "Terraza",
    "original_environment": "Salón"
  }
}

400 — Ocupada

{
  "success": false,
  "message": "No se puede mover una mesa ocupada"
}

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.