Ágora - Conectar TPV

✨ Método recomendado: Usa el Agora Conector. Se conecta a haddock sin complicaciones, funciona en segundo plano y sincroniza automáticamente los datos de tu TPV con haddock.

Conexión API directa heredada: Los pasos siguientes corresponden a la integración API antigua de Agora. Prefiere el Agora Conector salvo que tu técnico te indique lo contrario.

Antes de conectar — reunir los datos de Agora

Esta integración lee las ventas a través de la API HTTP de integración de Agora. Antes de rellenar el formulario en haddock hay que activar ese módulo y anotar cuatro datos. Necesitas Agora 6.0.6 o superior y que tu licencia incluya el Módulo de Servicios de Integración — lo activa tu distribuidor.

✅ Si algo ya está configurado, no lo cambies: apunta el dato y pasa al punto siguiente. Los puntos B, C y D son solo de consulta, no modifican nada en Agora.

💡 Si no tienes acceso al Monitor de Agora o no te sientes seguro con estos pasos, pídeselos a tu distribuidor de Agora — son los datos que necesita cualquier integración.

A — Activar el módulo y obtener la Clave de acceso (Token API)

1. En el Monitor de Agora (el servidor, no el TPV), abre Herramientas > Activar Módulos Adicionales.

   
   

   
   
2. Marca la casilla Activar Módulo de Servicios de Integración, en la columna de la izquierda.

   
   

   
   
3. Haz clic en Configurar Servicios de Integración, justo debajo, habilita la API HTTP de integración e introduce una clave. Puede ser cualquier valor, pero usa una clave larga y única: con ella se accede a las ventas del TPV. Anótala, porque esa clave es la Clave de acceso que pide haddock.
4. Pulsa Aceptar para guardar.

El puerto de esa API es el 8984 por defecto.

⚠️ Si la casilla no se puede marcar, tu licencia no incluye el módulo: pídele a tu distribuidor de Agora que lo active.

¿Ya está hecho? Si la casilla ya está marcada y la API HTTP ya tiene una clave, copia esa clave tal cual y pasa al punto B. No la cambies: si otra integración la usa, la romperías.

B — Obtener el ID del local (Workplace ID) — solo con ACMS

Solo hace falta si tienes ACMS (Agora Central Management System), es decir, una instalación central que gestiona varios locales sobre la misma base de datos; sirve para que haddock traiga únicamente las ventas de este restaurante. Con un solo local, deja el campo vacío y pasa al punto C.

En la Administración web de Agora, ve a Administración > Locales: la columna Id es el valor que necesitas (en el ejemplo, «La Macarena» tiene el Id 1). Si un mismo restaurante de haddock recoge las ventas de varios locales, indícalos separados por comas: 1, 2.

🚨 Con ACMS, este campo no es opcional en la práctica. Si lo dejas vacío teniendo varios locales en la misma instalación, haddock recogerá las ventas de todos ellos y las sumará a este restaurante. Y si pones un número equivocado, no llegará ninguna venta. Introduce el Id exacto de este local.

C — Obtener el ID de TPV (Punto de Venta) — solo si separas TPVs

Solo hace falta si un mismo local tiene varios TPVs y quieres que cada uno vaya a un restaurante distinto de haddock (por ejemplo, una barra y una terraza facturadas por separado). En cualquier otro caso — lo más habitual — sáltate este punto: haddock recogerá las ventas de todos los TPVs del local.

En la Administración web de Agora, ve a Administración > Puntos de Venta: la columna Id de cada TPV es el valor que necesitas. La columna Local indica a qué local pertenece y Tipo si es un TPV, una comandera, una tablet, etc. Para varios, sepáralos por comas: 1006, 1009.

⚠️ No confundas los Puntos de Venta con los Grupos de Puntos de Venta: los grupos solo filtran informes dentro de Agora y no son válidos aquí.

D — Obtener la URL del servidor

Es la IP fija del local donde está el servidor de Agora, accesible desde internet. Si tienes varios locales con la misma IP, tienes que especificar el puerto en la URL; con un solo local no será necesario.

⚠️ Esta integración necesita IP fija y el puerto abierto en el router. Si no dispones de ellos, el Agora Conector no los requiere: envía los datos hacia fuera, sin que haya que abrir nada.

Conectar en haddock

1. Haz clic en el nombre del restaurante para abrir el menú.

2. Ve a Configuración del restaurante > Mis integraciones.

3. En la sección Integraciones, busca Agora.
4. Rellena los datos que has reunido en la sección anterior:

   
   

5. • Clave de acceso o API token (punto A).
   • URL del servidor (punto D).
   • ID del local (punto B) — opcional, solo con ACMS.
   • ID de TPV (POS) (punto C) — opcional, solo si separas TPVs.
5. Haz clic en "Conectar".

⚙️ Requisitos técnicos

• Activar la licencia de integración de Ágora.
• Comprobar que la licencia de Ágora está actualizada mínimo a la versión 6.0.6.
• Debes disponer de una IP fija en el local. Si no tienes, puede contratarla a su servicio telefónico.
• Comprobar que el equipo está encendido y el puerto direccionado al router.

Las integraciones pueden incluir costes adicionales no soportados por haddock.

❓ Preguntas frecuentes

En haddock aparecen ventas que no son de este restaurante

Casi siempre es el ID del local vacío en una instalación con ACMS. Si la instalación de Agora gestiona varios locales sobre la misma base de datos y ese campo está vacío, haddock recoge las ventas de todos ellos. Rellénalo con el Id exacto de este local — punto B de la sección anterior.

La conexión funciona pero no llega ninguna venta

Revisa el ID del local: si tiene cualquier cosa que no sea el Id numérico exacto de tu local, Agora no devuelve ninguna venta aunque la conexión sea correcta. Con un solo local, el campo debe estar vacío.

Los totales de ventas en haddock no coinciden exactamente con los informes de Ágora

Esto puede ocurrir en los cambios de mes. Ágora agrupa los tickets en "jornadas de trabajo" que pueden abarcar varios días naturales (por ejemplo, el servicio de un viernes puede incluir tickets emitidos el sábado de madrugada, o un periodo festivo puede agrupar varios días en una sola jornada).

• haddock agrupa las ventas por jornada de trabajo, que es el criterio que usa la API de Ágora.
• Los informes internos de Ágora suelen agrupar por fecha de emisión del ticket.

Esto puede causar que algunos tickets emitidos a principio o final de mes se contabilicen en meses distintos según el sistema. No hay datos perdidos: si se suman dos meses consecutivos en ambos sistemas, los totales coinciden.

Actualizado el: 28/08/2026