> ## 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). # BDP Conector ✨ Nuevo y recomendado > ⭐ **Método recomendado para conectar BDP 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 BDP a haddock. Una vez configurado, funciona solo y no tienes que hacer nada más. [📄 Descargar guía completa en PDF](https://storage.googleapis.com/haddock-connector/haddock-connector-latest-install-guide-bdp.pdf) --- ## ¿Qué necesito antes de empezar? - El ordenador donde tienes instalado BDP debe estar **encendido y con BDP 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 el **usuario y contraseña de BDP** y el **número de perfil de exportación**: no existen por defecto, se crean en la sección **«Antes de instalar — preparar BDP»** (normalmente lo hace tu distribuidor o informático de BDP). - Y el **Código de autenticación de haddock** (lo encontrarás en la webapp de haddock, en **Configuración del restaurante** > **Mis integraciones** > BDP Conector). > 💡 **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 BDP**. Compártele la [guía en PDF](https://storage.googleapis.com/haddock-connector/haddock-connector-latest-install-guide-bdp.pdf) y 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. --- ## Antes de instalar — preparar BDP El conector lee las ventas a través de la API local de BDP, **WebLinkRestAPI**. Antes de instalarlo hay que activar esa API, crear un usuario para haddock y un perfil de exportación — normalmente lo hace **tu distribuidor o informático de BDP**. De ahí salen los tres datos que pedirá el conector: **Nombre usuario**, **Contraseña** y **Perfiles de exportación**. > ✅ **Si un punto ya está configurado, no lo cambies:** apunta el dato y pasa al siguiente. Reconfigurar algo que ya funcionaba puede romper otra integración. > > 📌 Las capturas son de BDP.NET 33.2 y 38.5; en otras versiones algún menú puede estar en otro sitio. ### A — Activar la licencia WebLinkRestAPI Es una **suscripción gratuita** para la integración con haddock; la pide el distribuidor a BDP. 1. En **[portal.bdpcenter.com](https://portal.bdpcenter.com)** (con las credenciales del distribuidor), ve a **ADMINISTRACIÓN DE LICENCIAS > SUSCRIPCIONES > LISTAR SUSCRIPCIONES**. Debe aparecer una suscripción **WEBLINK REST API**. ![Listado de suscripciones en el portal de BDP con la suscripción WEBLINK REST API](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-01-bdp-portal-subscriptions-weblinkrestapi.png) 2. Actívala dentro de BDP, en **Utilidades > Control de Licencias > Subscripciones Extendidas**. ![Menú Utilidades > Control de Licencias > Subscripciones Extendidas en BDP](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-02-bdp-license-control-extended-subscriptions-menu.png) 3. Rellena el formulario con el **número de suscripción** y el **nombre de cliente** que ves en el detalle de la suscripción del portal. Si es correcto, aparece un mensaje **verde**. ![Detalle de la suscripción con el número y el nombre de cliente](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-03-bdp-subscription-number-and-client-name.png) > **¿Ya está hecho?** Si la suscripción ya aparece en el portal y en BDP existe la opción **Utilidades > Configuración Servicios Web**, pasa al punto B. ### B — Configurar el servicio (login y comandos) 1. Ve a **Utilidades > Configuración Servicios Web**. Si esta opción no aparece, la suscripción del punto A no está bien activada. ![Menú Utilidades > Configuración Servicios Web en BDP](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-04-bdp-configure-web-services-menu.png) 2. En la pestaña **WebLinkRestApi**, crea una línea con **Activo** y **Login Obligatorio** marcados, **IP Address** `Any`, **IP Port** `5555` y una **Clave de Encriptación** larga y aleatoria. La clave que aparece en las capturas es solo un ejemplo; no la reutilices. > **Deja la casilla «Conexión Segura» desmarcada.** Desplaza la barra horizontal hacia la derecha para encontrarla. ![Configuración WebLinkRestApi con Activo y Login Obligatorio marcados y puerto 5555](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-05a-bdp-weblinkrestapi-service-settings.png) ![Configuración WebLinkRestApi desplazada a la derecha con Conexión Segura desmarcada](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-05b-bdp-weblinkrestapi-secure-connection-unchecked.png) 3. Vuelve a desplazar la barra horizontal hacia la izquierda y pulsa **`+` a la izquierda de la línea del servicio** para desplegar los campos **Login** y **Password**. Rellénalos con las credenciales que introducirás en el Paso 2 del conector. Después, pulsa **`+` a la izquierda de la línea del login** para mostrar los comandos y activa los **3 comandos** que necesita haddock: *Perfiles de exportación: Exportar Documentos*, *Perfiles de exportación: Exportar Ventas detalladas* y *Listar artículos*. Si falta alguno, el conector conectará pero no llegarán las ventas o los artículos. > 🔒 Usa una contraseña larga y única: da acceso a las ventas y a los artículos del TPV. El `test1234` de la captura es solo un ejemplo; no lo reutilices. ![Línea WebLinkRestApi desplegada con Login, Password y los tres comandos necesarios](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-05-bdp-weblinkrestapi-login-password-and-commands.png) 4. Guarda los cambios. > **¿Ya está hecho?** Si ya hay una línea activa en el puerto 5555 con Login y Password, **no los cambies** (puede haber otra integración usándolos): apúntalos tal cual y comprueba los 3 comandos y que **Conexión Segura esté desmarcada**. > 💡 **Firewall:** si el conector se instala en el **mismo ordenador** que BDP (lo recomendado), no hay que tocar el firewall ni el router. Si BDP está en **otro ordenador**, abre el puerto **5555** en el *Firewall de Windows* con una regla de entrada **TCP** y **Permitir la conexión** — limitada a la IP del conector, si tu firewall o router lo permiten. ### C — Crear el perfil de exportación 1. Ve a **Utilidades > Importación/Exportación de Datos > Parámetros de Exportación**. ![Menú Utilidades > Importación/Exportación de Datos > Parámetros de Exportación](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-06-bdp-export-parameters-menu.png) 2. Rellena el formulario: - **Código:** un número libre, por ejemplo `1234`. ⚠️ **Es el número que debes introducir en «Perfiles de exportación» del Conector.** - **Descripción:** libre, por ejemplo «exportación ventas haddock». - **Terminal Inicial / Terminal Final:** con un solo terminal, el mismo número en los dos campos; con varios, se exportan todos los del rango (de `1` a `4` exporta los terminales 1, 2, 3 y 4). - **Tipo Exportación:** **WebLink**. - **Datos de Venta a Exportar:** **Fra. Simpl. Barra** y **Fra. Simpl. Mesa**. ![Formulario de exportación con el código, tipo WebLink y las facturas simplificadas de barra y mesa](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-07-bdp-export-profile-general-tab.png) 3. Al marcarlas aparecen dos pestañas nuevas (**Fra. Simpl. Barra** y **Fra. Simpl. Mesa**). En **cada una**, marca **todas** las casillas de las tres columnas: si dejas campos sin marcar, las ventas llegarán incompletas a haddock. ![Las tres columnas de campos con todas las casillas marcadas](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/pos-setup-08-bdp-export-profile-all-fields-selected.png) 4. Guarda con **F5**. > **¿Ya está hecho?** Si ya existe un perfil con **Tipo Exportación: WebLink**, reutilízalo: apunta su **Código** y comprueba que tenga marcadas Barra y Mesa con todos los campos de las tres columnas. --- ## Paso 1 — Descarga e instalación 1. En el ordenador donde está BDP, 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/bdp-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/bdp-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/bdp-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/bdp-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/bdp-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/bdp-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/bdp-connector-new-and-recommended/images/07-haddock-connector-installer-finish-and-launch-application.png) --- ## Paso 2 — Configuración Al abrir haddock Conector, completarás dos pantallas: primero conectarás BDP y después vincularás tu restaurante de haddock. **1. Conecta tu TPV** - En la pantalla **¿Qué TPV utilizas?**, selecciona **BDP**. - En **Nombre usuario** y **Contraseña**, introduce los datos del usuario creado en el punto **B** de «Antes de instalar — preparar BDP». - Si necesitas cambiar el puerto o indicar otro ordenador, despliega **Ajustes de conexión**. El puerto por defecto es **5555**. En **IP del servidor BDP**, introduce la IP del equipo donde está BDP si es distinto de este. Si dejas la IP vacía, el Conector buscará BDP en este mismo ordenador. - Pulsa **Continuar**. ![Selección de BDP y campos de usuario y contraseña en Conecta tu TPV](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/08-haddock-connector-app-connect-bdp.png) **2. Vincula un restaurante** - **Nombre del restaurante (opcional):** escribe un nombre para identificarlo en el Conector. - **Código de autenticación:** entra en haddock y ve a **Configuración del restaurante > Mis integraciones > BDP Conector**. Copia el código de 10 caracteres que aparece allí y pégalo aquí. Cada restaurante tiene su **propio** código. - **Perfiles de exportación:** introduce el **Código** del perfil creado en el punto **C** (por ejemplo, `1234`). Para varios perfiles, sepáralos por comas: `3,7`. ⚠️ **No lo dejes vacío:** un campo vacío utiliza el perfil **0**, no todos los perfiles. ![Vinculación del restaurante con Código de autenticación y Perfiles de exportación](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/09-haddock-connector-app-link-restaurant.png) **3. Preferencias de importación y sincronización** Puedes mantener los valores predeterminados o desplegar esta sección para cambiarlos: - **Historial de ventas a importar:** por defecto, **Últimos 180 días**. También puedes seleccionar **Último año** o **Elegir fechas**. - **Intervalo de sincronización:** por defecto, **30 minutos**. --- ## Paso 3 — Conectar Pulsa **Conectar restaurante**. El Conector comprobará la conexión con BDP, el usuario y la contraseña, el acceso a la API y la conexión con haddock. También revisará el código de autenticación. Si todo es correcto, se guardará la configuración y accederás a la pantalla **Conexiones**, donde podrás seguir la sincronización de las ventas. Si hay algún problema, el Conector señalará el campo que debes corregir o mostrará un mensaje con el motivo. Revisa la sección **Errores y soluciones** de esta guía. > 💡 La comprobación inicial no verifica que el perfil de exportación exista ni que incluya los terminales correctos. Revisa su configuración en el punto **C** de «Antes de instalar — preparar BDP». --- ## ¿Cómo sé que está funcionando? En la pantalla **Conexiones** verás los restaurantes vinculados, su estado y la **última sincronización** de cada uno. Durante la primera importación aparecerá el mensaje **«Importando el historial de ventas»**, junto con su progreso. Puede tardar si hay mucho historial. ![Pantalla Conexiones de BDP durante la importación del historial de ventas](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/10-haddock-connector-app-importing-sales-history.png) Cuando la sincronización termine correctamente, el restaurante aparecerá **«Al día»** y se actualizará la hora de su última sincronización. ![Restaurante BDP al día con la última sincronización y el botón Sincronizar ahora](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/bdp-connector-new-and-recommended/images/11-haddock-connector-app-up-to-date.png) En **Funciona automáticamente** podrás consultar cada cuánto se sincronizan las ventas. Para iniciar una sincronización manual, pulsa **Sincronizar ahora**. Este botón no aparece mientras se importa el historial y estará deshabilitado si ya hay una sincronización en curso. --- ## 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 hay un problema al conectar, el Conector señalará el campo que debes corregir o mostrará un mensaje con el motivo. Búscalo aquí para ver qué hacer: ### 🚨 "API no accesible en localhost:5555. Asegúrate de que BDP está funcionando en esta máquina." ✅ BDP no está abierto, está en otro ordenador, el puerto no es correcto, o un firewall/antivirus bloquea el puerto. Comprueba que: - BDP está **abierto y funcionando** en el ordenador correcto. - El puerto en *Ajustes de conexión* es **5555** (el valor por defecto). Si BDP está en otro equipo, indica su IP en **IP del servidor BDP**, dentro de **Ajustes de conexión**. - Si al abrir **[http://localhost:5555](http://localhost:5555)** en el navegador de ese equipo no carga nada, la API de BDP no está escuchando ahí: contacta con tu distribuidor de BDP. ### 🚨 "El servidor BDP es accesible pero el login ha fallado." ✅ El usuario o la contraseña no son correctos. Verifícalos con tu distribuidor o informático de BDP. ### 🚨 "La licencia de BDP no está activada o las credenciales son inválidas." ✅ El módulo de integración de BDP no está habilitado. Pide a tu distribuidor de BDP que lo habilite y confirme tu usuario, contraseña y número de perfil de exportación. ### 🚨 "No se puede conectar con la 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." ✅ El código está mal copiado o ha caducado. Ve a la webapp de haddock (**Configuración del restaurante** > **Mis integraciones** > **BDP Conector**), genera uno nuevo y pégalo completo. Los códigos caducan si no se usan. ### 🚨 No tengo el usuario, contraseña o número de perfil de exportación ✅ No vienen de fábrica: se crean en BDP antes de instalar el conector. Pídeselos a tu distribuidor o informático de BDP y compártele la sección **«Antes de instalar — preparar BDP»** de este artículo, que tiene los pasos exactos. ### 🚨 La sincronización termina, pero no veo ventas ✅ Comprueba que estás consultando el restaurante y las fechas correctas en haddock, que hay ventas en BDP para ese periodo y que esas fechas están incluidas en el historial que has importado. Revisa también el campo **Perfiles de exportación**: ve a **Conexiones**, selecciona el restaurante y pulsa **Editar configuración**. Los números deben coincidir con el **Código** de los perfiles creados en BDP. Un campo vacío utiliza el perfil **0**, no todos los perfiles. En BDP, abre **Utilidades > Importación/Exportación de Datos > Parámetros de Exportación** y comprueba que cada perfil: - Existe y tiene **Tipo Exportación: WebLink**. - Incluye los terminales correctos en **Terminal Inicial / Terminal Final**. - Tiene seleccionadas **Fra. Simpl. Barra** y **Fra. Simpl. Mesa**, con todos los campos de las tres columnas marcados en ambas pestañas. La comprobación inicial de conexión no valida estos perfiles: una conexión correcta no garantiza que estés exportando las ventas del restaurante adecuado. Tras corregir los datos del Conector, pulsa **Guardar configuración**. Cuando no haya una importación del historial ni una sincronización en curso, puedes pulsar **Sincronizar ahora** en **Conexiones**. Si siguen faltando ventas de fechas anteriores, contacta con soporte para revisar la importación de ese periodo. --- ## El conector estaba funcionando y ahora falla - **No veo las ventas justo después de conectar:** la primera importación puede tardar si hay mucho historial. Consulta su progreso en **Conexiones** y espera a que termine. Durante la importación no aparece el botón **Sincronizar ahora**. - Si ves el aviso **«La sincronización se ha retrasado»**, el Conector volverá a intentarlo automáticamente. Pulsa **Ver detalles** para consultar el problema y revisa la sección **Errores y soluciones** de esta guía. - 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 BDP 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. --- ## Los artículos se ven mal o faltan en haddock El conector envía automáticamente tanto las **ventas** como el **catálogo de artículos** (catálogo cada **6 horas** por defecto). Si el catálogo sigue viéndose mal — nombres incorrectos, modificadores/combinados que faltan, o nombres acumulados estilo "BARCELO & COCA COLA \| BARCELO & KAS LIMON \| …" en un mismo artículo — puedes solicitar una actualización desde la webapp de haddock: 1. Ve a **Configuración del restaurante** > **Mis integraciones** > **BDP Conector**. 2. Pulsa **"Actualizar"**. Esto solicita una resincronización de ventas y una **resincronización del catálogo**. El Conector recogerá la solicitud cuando vuelva a comunicarse con haddock; la actualización puede tardar y requiere que el equipo esté encendido, conectado a internet y con el Conector funcionando. El botón está limitado a una pulsación cada 12 h por integración. Si tras actualizar el catálogo sigue viéndose mal, contacta con soporte — el problema está en el lado del conector / BDP y necesita investigación. *Las integraciones pueden incluir costes adicionales no soportados por haddock.*