Mews: Funciones de la API

"Agora by Connect 1.0.0"

La integración permite que Ágora POS realice cargos a habitaciones y servicios de un hotel gestionado con Mews. A continuación, se detallan las funciones de la API utilizadas en este proceso:

1. customers/search – Búsqueda de huéspedes

• Descripción: Permite localizar huéspedes registrados en Mews desde Ágora POS.

• Uso: Al iniciar un cargo, el sistema de Ágora busca el cliente introduciendo nombre, apellido o email.

• Beneficio: Evita errores en la asignación de consumos, garantizando que el cargo se realiza al huésped correcto.

2. outlets/getAll – Obtención de puntos de venta

• Descripción: Recupera la lista de outlets (restaurantes, bares u otros puntos de venta) configurados en Mews.

• Uso: Ágora utiliza esta información para identificar desde qué outlet se realiza un consumo.

• Beneficio: Permite segmentar y reportar correctamente los ingresos por local o departamento.

3. resources/getAll – Recursos del hotel

• Descripción: Devuelve la lista de recursos disponibles (habitaciones, mesas, espacios).

• Uso: Al generar un cargo, Ágora asigna el consumo a un recurso específico (habitualmente, la habitación del huésped).

• Beneficio: Asegura la trazabilidad de los cargos y facilita la conciliación de consumos por habitación.

4. services/getAll – Servicios disponibles

• Descripción: Lista los servicios habilitados en Mews (alojamiento, restauración, spa, etc.).

• Uso: Ágora necesita esta información para categorizar correctamente los cargos y vincularlos al servicio correspondiente.

• Beneficio: Mejora la contabilidad y el desglose de ingresos en los informes del hotel.

5. accountingCategories/getAll – Categorías contables

• Descripción: Devuelve las categorías contables definidas en Mews.

• Uso: Cuando Ágora envía un cargo, selecciona la categoría contable adecuada (ej. F&B, minibar, lavandería).

• Beneficio: Permite que los consumos se reflejen correctamente en la contabilidad del hotel y en los informes financieros.

6. orders/add – Creación de cargos/pedidos

• Descripción: Crea un pedido en Mews asociado a un huésped, recurso y categoría contable.

• Uso: Una vez seleccionado el cliente, el outlet, el servicio y la categoría, Ágora envía el consumo como un cargo a la habitación.

• Beneficio: Automatiza el proceso de facturación, evitando transcripciones manuales y reduciendo errores.

Flujo de integración

1. Búsqueda del huésped (customers/search).

2. Selección del outlet y servicio (outlets/getAll, services/getAll).

3. Asignación de recurso (habitación) (resources/getAll).

4. Obtención de la categoría contable (accountingCategories/getAll).

5. Creación del cargo (orders/add).