PI Electronique Conector (Elyx) ✨ Nuevo y recomendado

⭐ Método recomendado para conectar PI Electronique (Elyx) con haddock

haddock Conector es un pequeño programa que se instala en el ordenador de tu restaurante y envía automáticamente las ventas de PI Electronique a haddock. Una vez configurado, funciona solo y no tienes que hacer nada más.

¿Qué necesito antes de empezar?

• El ordenador donde tienes instalado PI Electronique debe estar encendido y con PI Electronique funcionando.
• Necesitas acceso a ese ordenador para instalar el programa. Si no estás físicamente en el local, puedes pedirle a alguien que esté allí que te dé acceso remoto con AnyDesk o TeamViewer — son programas gratuitos que permiten ver y controlar el ordenador desde otro lugar.
• Ten a mano la API Key de PI Electronique (te la proporciona tu distribuidor de PI Electronique) y el Código de autenticación de haddock (lo encontrarás en la webapp de haddock, en Configuración del restaurante > Mis integraciones > PI Electronique Conector (Elyx)).

💡 Consejo: Si no tienes todos los datos o no te sientes seguro haciendo la instalación, lo más cómodo es enviárselo todo a tu distribuidor o informático de PI Electronique. Compártele el Código de autenticación de haddock — ellos podrán hacer la instalación y configuración en remoto sin que tengas que hacer nada técnico.

Paso 1 — Descarga e instalación

1. En el ordenador donde está PI Electronique, descarga el instalador de haddock Conector.
2. Abre el archivo descargado. Si Windows te pide permiso (pantalla de protección de Windows), haz clic en "Más información" y luego en "Ejecutar de todas formas".

   
   

   
   

   
   

   
   
3. Sigue los pasos del instalador:
4. • Pantalla de bienvenida:

• Selecciona la carpeta de destino:

• Asegúrate de que la opción "Crear un acceso directo en el escritorio" (Create a desktop shortcut) esté marcada.

• Revisa el resumen y haz clic en "Instalar".

4. Al terminar la instalación, asegúrate de marcar "Launch haddock Conector" y haz clic en "Finalizar". El programa se abrirá automáticamente.

   
   

   
   

Paso 2 — Configuración

Cuando el programa se abra, verás una pantalla con varios campos para rellenar:

1. POS System (Sistema TPV):
Selecciona Pi Electronique en el menú desplegable.

2. Pi Electronique Connection (Conexión con Pi Electronique):

• API Key: Una clave que te da PI Electronique para identificarte. Pídesela a tu distribuidor de PI Electronique.
• Load Pi Electronique locals (Cargar locales de Pi Electronique): Tras introducir la API Key, pulsa este botón para que el conector recupere la lista de locales disponibles en PI Electronique. Los elegirás al configurar cada propiedad más abajo.
• Advanced settings (Ajustes avanzados): Al desplegar esta opción podrás configurar el puerto (por defecto 8082) y otros ajustes adicionales.

3. Properties (Propiedades):

Añade cada local/propiedad que quieras sincronizar, con su propio código de autenticación y sus locales de PI Electronique. Si solo tienes un local, basta con una propiedad.

• Property name (Nombre de la propiedad): Un nombre para identificar el local (por ejemplo Restaurante 1).
• Authentication Code (Código de autenticación): Entra en la webapp de haddock, ve a Configuración del restaurante > Mis integraciones > PI Electronique Conector (Elyx) y copia el código de 10 dígitos que aparece allí. Pégalo en este campo. Cada propiedad tiene su propio código.
• Pi Electronique locals (Locales de Pi Electronique): Los IDs de local de PI Electronique que pertenecen a esta propiedad. Pulsa Load Pi Electronique locals arriba y selecciónalos de la lista, o escribe los IDs numéricos manualmente.
• + Add property (Añadir propiedad): Si gestionas varios locales desde el mismo ordenador, pulsa aquí para añadir otro bloque de propiedad y repite los pasos anteriores.

4. Sync Settings (Sincronización):

• Sync interval: Cada cuántos minutos se enviarán las ventas a haddock. Puedes dejar el valor por defecto (30 minutos).

5. Sync Dates (Fechas de sincronización):

• Start / End: El periodo de tiempo del cual quieres importar el historial de ventas. Por defecto recuperará el historial del último año.

Paso 3 — Conectar

Haz clic en el botón azul "Connect". El programa hará una serie de comprobaciones y las irá mostrando como una lista de puntos que pasan a verde uno a uno:

1. POS accesible — el conector encuentra PI Electronique en este ordenador (o en la IP que hayas indicado).
2. Credenciales POS válidas — PI Electronique acepta la API Key.
3. Licencia API activa — el servicio REST de PI Electronique responde correctamente.
4. Nube de haddock — hay conexión con los servidores de haddock.
5. Código de haddock válido — tu código de autenticación es correcto.

Cuando todos están en verde, la conexión está lista y las ventas empezarán a sincronizarse. Si un punto aparece en rojo, ese es el origen del problema: busca el mensaje que muestra el conector en la sección Errores y soluciones de abajo.

¿Cómo sé que está funcionando?

Una vez conectado, verás el panel de estado con información en tiempo real: cuándo fue la última sincronización de ventas, cuántas sincronizaciones se han hecho y un registro de actividad reciente. Si quieres sincronizar en ese momento sin esperar, pulsa el botón "Sync Now".

Uso del día a día

• El programa funciona en segundo plano — no necesitas tenerlo abierto. Al cerrar la ventana, se minimiza al área de notificaciones (abajo a la derecha del escritorio de Windows) y sigue trabajando.
• Para abrirlo de nuevo, haz clic en el icono del área de notificaciones.
• Se actualiza y se reinicia solo si hay algún problema — no tienes que preocuparte de nada.

🔧 Errores y soluciones

Si una comprobación aparece en rojo al conectar, el conector muestra un mensaje. Búscalo aquí para ver qué hacer:

🚨 "API no accesible en localhost:8082. Asegúrate de que PI Electronique está funcionando en esta máquina."

(Comprobación 1 — POS accesible)

✅ PI Electronique no está abierto, está en otro ordenador, el puerto no es correcto, o un firewall/antivirus bloquea el puerto. Comprueba que:

• PI Electronique está abierto y funcionando en el ordenador correcto.
• El puerto en Ajustes avanzados es 8082 (el valor por defecto). Si PI Electronique está en otro equipo, indica su IP de servidor en la configuración.
• Si al abrir http://localhost:8082 en el navegador de ese equipo no carga nada, la API de PI Electronique no está escuchando ahí: contacta con tu distribuidor de PI Electronique.

🚨 "El servidor PI Electronique es accesible pero la API Key fue rechazada."

(Comprobación 2 — Credenciales)

✅ La API Key es incorrecta o no está activa. Pide a tu distribuidor de PI Electronique la clave correcta y que confirme que está activa.

🚨 "La API de PI Electronique respondió con un error al comprobar /api/Locales."

(Comprobación 3 — Licencia API)

✅ El servicio REST de PI Electronique está fallando. Pide a tu distribuidor de PI Electronique que verifique que el servicio REST está funcionando.

🚨 "No se puede conectar con la nube de haddock."

(Comprobación 4 — Nube de haddock)

✅ El equipo no tiene salida a internet, o un firewall/proxy/antivirus bloquea la conexión segura (HTTPS) con haddock. Revisa la conexión a internet del equipo y que el firewall o antivirus permita el tráfico HTTPS saliente hacia haddock. Si el mensaje dice que la nube «es accesible pero rechazó la solicitud», es un fallo temporal: reinténtalo en unos minutos.

🚨 "El código de autenticación no es válido" / "Formato de código de autenticación inválido."

(Comprobación 5 — Código de haddock)

✅ El código está mal copiado o ha caducado. Ve a la webapp de haddock (Configuración del restaurante > Mis integraciones > PI Electronique Conector (Elyx)), genera uno nuevo y pégalo completo. Los códigos caducan si no se usan.

🚨 No tengo la API Key de PI Electronique

✅ Pídesela a tu distribuidor de PI Electronique. Es un dato que ellos gestionan y te lo deben proporcionar al activar la integración.

🚨 Todo aparece en verde y conectado, pero no llegan ventas a haddock

(Las 5 comprobaciones están en verde, pero los locales de Pi Electronique de una propiedad son incorrectos)

✅ Cuando la conexión aparece como conectada y las sincronizaciones se ejecutan, pero no aparece ninguna venta en haddock, casi siempre se debe a los locales de Pi Electronique asignados a una propiedad en el Paso 2 — Configuración.

Cada propiedad le indica al conector de qué locales de PI Electronique proceden sus ventas. Como la API Key, la licencia y la conexión son válidas, las cinco comprobaciones pasan a verde y el conector parece estar funcionando — pero si una propiedad no tiene locales asignados, o contiene un ID de local incorrecto o inexistente (un número que no corresponde a un local real, o texto sobrante como local1 o test), PI Electronique no devuelve facturas para él y no llega nada a haddock.

• Pulsa "Load Pi Electronique locals" y luego abre el campo Pi Electronique locals de cada propiedad para asegurarte de que los IDs seleccionados corresponden a los locales reales del establecimiento en PI Electronique.
• Si escribiste los IDs manualmente, comprueba que son los IDs numéricos exactos (tu distribuidor de PI Electronique puede confirmártelos). Un número equivocado significa que no llegará ninguna venta, aunque la conexión esté en verde.
• Si gestionas varios locales, comprueba que cada propiedad tiene los locales correctos — una propiedad mal configurada dejará de recibir, de forma silenciosa, las ventas de ese local.

Tras corregirlo, pulsa "Connect" de nuevo y luego "Sync Now" para forzar una sincronización.

El conector estaba funcionando y ahora falla

• No veo las ventas justo después de conectar: la primera sincronización puede tardar si hay mucho historial. Pulsa "Sync Now" en el panel de estado para forzarla.
• Si ves el aviso "La sincronización falla — revisa tu configuración" con un botón Reconfigurar, púlsalo y revisa con la lista de arriba qué comprobación está en rojo.
• El conector también muestra avisos en el área de notificaciones de Windows (abajo a la derecha) cuando lleva un rato sin poder conectar con el TPV o con haddock.
• Comprueba que el ordenador del TPV está encendido y que PI Electronique sigue funcionando.

¿Sigue sin funcionar tras revisar esto? Consulta Cómo solucionar los problemas de conexión con mi TPV o contacta con el chat de soporte de haddock.

Mis artículos aparecen mal o faltan en haddock

El conector envía automáticamente tanto las ventas como el catálogo de artículos (el catálogo cada ~15 minutos por defecto). Si el catálogo sigue viéndose mal — nombres incorrectos, precios incorrectos o artículos que faltan — puedes forzar una actualización inmediata desde la webapp de haddock:

1. Ve a Configuración del restaurante > Mis integraciones > PI Electronique Conector (Elyx).
2. Haz clic en "Actualizar".

Esto pone en cola una resincronización de ventas y una resincronización del catálogo que el conector recogerá en su siguiente latido (normalmente en menos de un minuto). El botón está limitado a una vez cada 24 h por integración.

ℹ️ Varios locales: la lista de artículos de PI Electronique es por local, así que el mismo código de artículo puede tener un nombre o un precio distinto en cada uno. Cuando varios locales comparten un código, el conector conserva el nombre y el precio del primer local — por eso, si un artículo muestra el nombre o el precio equivocado, comprueba que ese mismo código no esté definido de forma distinta en otro local.

Si tras actualizar el catálogo sigue viéndose mal, contacta con soporte — el problema está en el lado del conector / PI Electronique y necesita investigación.

Las integraciones pueden incluir costes adicionales no soportados por haddock.

Actualizado el: 17/07/2026