Restaurante
Mozos y PIN, carta, mesas y grupos, comandas e impresión de órdenes.
Antes de empezar
Endpoints de la app de mozos / punto de venta de restaurante
Listar mozos para el inicio de sesión
Devuelve los usuarios con rol de mozo (nombre y correo) para mostrar la lista de selección en la pantalla de inicio de sesión de la app de mozos, antes de tener token.
Datos iniciales de la app de restaurante
Devuelve los datos del usuario y de la empresa necesarios al iniciar la app
Configuración del restaurante
Devuelve la configuración del módulo de restaurante (menús habilitados, ambientes y cantidad de mesas, permisos de cierre de mesa, impresión...) y datos de conexión (info
Guardar configuración de impresión
Actualiza la configuración de impresión del restaurante.
Listar mozos
Lista los usuarios con rol de mozo (id y nombre), por ejemplo para asignar el mozo de una mesa.
Listar usuarios de restaurante activos
Lista los usuarios activos que tienen algún rol de restaurante (id, nombre y correo), para elegir quién atiende o validar su PIN.
Validar PIN de usuario de restaurante
⚠️ Este endpoint usa GET por compatibilidad; próximamente tendrá una versión POST.
Listar productos de la carta
Lista los productos marcados para restaurante con código interno, con stock del almacén del establecimiento del usuario, área de preparación (area_print), insumos, combos (items_sets), modificadores y, si la empresa usa listas de precios, item_unit_types con sus precios.
Listar categorías de la carta
Lista todas las categorías de productos.
Stock disponible de la carta
Devuelve el stock de restaurante de cada producto
Cambiar precio de un producto
Cambia el precio de venta unitario del producto.
Marcar o desmarcar producto favorito
Alterna el producto entre favorito y no favorito de la carta (cada llamada invierte el estado).
Listar notas de preparación
Lista las notas predefinidas para los pedidos (p.
Mesas y ambientes
Devuelve todas las mesas con su pedido, total, mozo, grupo, estado de pago y tiempo de apertura, la configuración de los 4 ambientes clásicos y la lista de ambientes activos (environments).
Ver mesa
Devuelve una mesa con su pedido actual y su opening_token.
Crear mesa
Crea una mesa (o un pedido delivery / para llevar como mesa temporal).
Guardar mesa (pedido, abrir, cerrar)
Guarda el estado completo de la mesa
Renombrar mesa
Cambia el nombre visible y la forma de una mesa.
Mover pedido a otra mesa
Mueve el pedido completo (productos, total, cliente, mozo, comandas) de una mesa a otra y deja libre la mesa de origen.
Activar o poner fuera de servicio una mesa
Alterna la mesa entre activa y fuera de servicio.
Cambiar mesa de ambiente
Mueve una mesa libre a otro ambiente activo.
Restaurar mesa a su ambiente original
Devuelve una mesa movida a su ambiente original.
Crear grupo de mesas
Crea un grupo (para juntar mesas en un solo pedido) con la mesa principal indicada.
Agregar mesa a un grupo
Agrega una mesa secundaria al grupo.
Separar mesa de un grupo
Separa una mesa secundaria de su grupo y la deja libre.
Disolver grupo de mesas
Disuelve el grupo
Recalcular total del grupo
Recalcula el total del grupo como la suma de los totales de sus mesas.
Enviar producto a cocina (comanda)
Registra un producto de la mesa como comanda para cocina/bar
Comandas por estado
Devuelve las comandas agrupadas por estado
Avanzar estado de una comanda
⚠️ Este endpoint usa GET por compatibilidad; próximamente tendrá una versión POST.
¿Mesa completamente servida?
Indica si todas las comandas de la mesa están entregadas.
Registrar orden de impresión
Envía un documento (PDF en base64) a la cola del servicio de impresión local del restaurante.
Actualizar estado de orden de impresión
El servicio de impresión confirma el resultado de una orden.
Listar órdenes de impresión pendientes
Devuelve las órdenes en estado 0 (pendiente), de la más antigua a la más reciente.