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.