Manual de Configuración Integración Ágora POS con Mews

Este manual describe el proceso completo para configurar la integración de Ágora POS con Mews a través de Connect Manager, permitiendo realizar cargos automáticos a habitaciones y servicios del hotel.

1. Configuración General

En esta sección se configuran los datos principales para la conexión con la API de Mews:

• Proveedor: Selecciona Mews.

• URL API: Introduce la URL base de la API de Mews (https://api.mews.com/).

• Client Token: Copia el token de cliente proporcionado por Mews.

• Access Token: Introduce el token de acceso correspondiente.

• ID del hotel: Inserta el identificador único del hotel asignado por Mews.

Z-Cierre (Opcional)

• Activa la opción Z-Cierre si deseas que Connect Manager genere un fichero contable diario.

• Configura la hora de generación de dicho fichero.

2. Configuración de Cargos

En el panel de la derecha se define cómo Ágora enviará los cargos a Mews:

• Usar API externa de Ágora: Debe estar activado.

• Nº de días para cerrar albaranes: Número máximo de días abiertos antes de cierre automático.

• Cliente genérico: Permite asignar cargos a un cliente genérico cuando no se especifica huésped.

• Servicio: Selecciona el servicio de Mews al que se aplicarán los cargos (recuperado vía services/getAll).

• Outlet: Selecciona el outlet correspondiente (recuperado vía outlets/getAll).

• Categoría contable: Vincula los cargos a la categoría contable correcta (accountingCategories/getAll).

• Método de pago: Asocia el método de pago de Ágora con el de Mews.

? Enlace API: Al final de la sección, Connect Manager genera automáticamente la URL personalizada para que Ágora envíe los cargos.

3. Configuración de Centros de Venta

En esta pantalla se relacionan los centros de venta de Ágora con los datos de Mews:

• Centro de venta de Ágora → Servicio (Mews)

• Outlet (Mews)

Esto permite que cada centro de venta en Ágora envíe cargos al servicio y outlet correspondientes dentro de Mews.

4. Configuración de Familias

Permite vincular las familias de productos de Ágora con categorías contables de Mews:

• Familia (Ágora) → Categoría contable (Mews)

Esto asegura que los productos de una misma familia se contabilicen correctamente en Mews.

5. Métodos de Pago

Relaciona los métodos de pago de Ágora con los disponibles en Mews:

• Método de pago Ágora → Método de pago Mews

De esta forma, los cargos enviados reflejan correctamente el método de pago utilizado.

Flujo de Integración

1. Configurar credenciales de Mews y parámetros generales.

2. Activar API externa de Ágora y definir servicio, outlet, categoría contable y métodos de pago.

3. Mapear centros de venta, familias y métodos de pago.

4. (Opcional) Configurar Z-Cierre para generación de ficheros contables diarios.

5. Guardar y probar la integración.