> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.haddock.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Ágora - Conectar TPV

> ✨ **Método recomendado:** Usa el [Agora Conector](https://support.haddock.app/es/article/agora-conector-nuevo-y-recomendado-7f8f6v/). 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**.

   ![Ventana Activar Módulos Adicionales de Agora](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connect-pos/images/pos-setup-01-agora-activate-additional-modules-window.png)

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

   ![Detalle de la casilla Activar Módulo de Servicios de Integración](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connect-pos/images/pos-setup-02-agora-integration-services-module-checkbox.png)

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`.

![Listado de Locales en la administración de Agora con la columna Id](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connect-pos/images/pos-setup-03-agora-admin-locales-id-column.png)

> 🚨 **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`.

![Listado de Puntos de Venta en la administración de Agora con la columna Id](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connect-pos/images/pos-setup-04-agora-admin-points-of-sale-id-column.png)

> ⚠️ **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](https://support.haddock.app/es/article/agora-conector-nuevo-y-recomendado-7f8f6v/) 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ú.**

![](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connect-pos/images/01-agora-connect-pos.png)

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

![](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connect-pos/images/02-agora-connect-pos.png)

3. En la sección **Integraciones**, busca **Agora**.

4. Rellena los datos que has reunido en la sección anterior:

   * **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.