> ## 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). # 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 desde **[bit.ly/haddockconector](https://bit.ly/haddockconector)**. 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"**. ![Advertencia de Windows Defender](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/elyx-connector-new-and-recommended/images/01-windows-defender-smartscreen-warning.png) ![Ejecutar de todas formas](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/elyx-connector-new-and-recommended/images/02-windows-defender-smartscreen-run-anyway.png) 3. Sigue los pasos del instalador: * Pantalla de bienvenida: ![Bienvenida del instalador](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/elyx-connector-new-and-recommended/images/03-haddock-connector-installer-welcome-screen.png) * Selecciona la carpeta de destino: ![Carpeta de destino](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/elyx-connector-new-and-recommended/images/04-haddock-connector-installer-select-destination-folder.png) * Asegúrate de que la opción **"Crear un acceso directo en el escritorio"** (Create a desktop shortcut) esté marcada. ![Tareas adicionales](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/elyx-connector-new-and-recommended/images/05-haddock-connector-installer-select-additional-tasks-desktop-shortcut.png) * Revisa el resumen y haz clic en **"Instalar"**. ![Listo para instalar](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/elyx-connector-new-and-recommended/images/06-haddock-connector-installer-progress.png) 4. Al terminar la instalación, asegúrate de marcar **"Launch haddock Conector"** y haz clic en **"Finalizar"**. El programa se abrirá automáticamente. ![Finalizar instalación](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/elyx-connector-new-and-recommended/images/07-haddock-connector-installer-finish-and-launch-application.png) --- ## Paso 2 — Configuración Cuando el programa se abra, verás una pantalla con varios campos para rellenar: ![Configuración de haddock Conector para PI Electronique](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/elyx-connector-new-and-recommended/images/08-haddock-connector-app-setup-form-elyx-connection.png) **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 (Configuración avanzada):** 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"**. ![Estado de la conexión](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/elyx-connector-new-and-recommended/images/09-haddock-connector-app-status-connected-and-syncing.png) --- ## 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 *Configuración avanzada* 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](https://support.haddock.app/es/article/como-solucionar-los-problemas-de-conexion-con-mi-tpv-x9w7m2/)** 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 12 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.*