Saltar al contenido
Facturador

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.