Integración Genérica para TPVs

La Integración Genérica para TPVs permite conectar cualquier TPV con haddock a través de una API estándar. Con esta integración, las ventas y el catálogo de productos se sincronizan automáticamente, sin necesidad de introducir datos manualmente.

Es la solución ideal para TPVs que no tienen una integración nativa con haddock.

Para restaurantes: cómo beneficiarte

Si tu TPV no aparece en la lista de integraciones nativas de haddock, puedes pedirle a tu proveedor de TPV o distribuidor que implemente la conexión a través de nuestra Integración Genérica.

El proceso es sencillo:

1. Contacta con tu proveedor de TPV y solicítale que integre haddock.
2. El proveedor implementa la conexión utilizando nuestra API.
3. Tú activas la integración desde haddock en Configuración > Integraciones > API genérica para TPVs. Activar la integración en haddock es gratuito.
4. Las ventas y el catálogo se sincronizan automáticamente.

Tu proveedor puede ponerse en contacto con nosotros para recibir la documentación técnica y un entorno de pruebas gratuito.

TPVs ya integrados con la Integración Genérica

Varios sistemas TPV ya utilizan la Integración Genérica de haddock para sincronizar datos de ventas. Entre ellos se encuentran DSTnet, Ofibarman, Haleteo, Fourvenues, Madisa y otros.

Si tu TPV ya es compatible, solo necesitas activar la integración desde haddock.

Para TPVs que quieran integrarse

Si eres un proveedor de TPV y quieres ofrecer la integración con haddock a tus clientes, contacta con nosotros. Te proporcionamos:

• Una cuenta de pruebas gratuita con un entorno configurado para desarrollo.
• Credenciales de acceso a la API.
• Documentación técnica completa.

Detalles técnicos

La API utiliza autenticación Basic HTTP. Las credenciales (usuario y contraseña) se generan desde la configuración de integraciones de haddock.

La integración permite sincronizar dos tipos de datos:

1. Catálogo: artículos, categorías, menús y grupos de modificadores. Es recomendable enviar el catálogo antes que las ventas.
2. Ventas: pedidos con sus pagos y artículos. Los pedidos se almacenan por su ID externo, por lo que si se envía el mismo pedido dos veces, se actualiza en lugar de duplicarse. Se recomienda enviarlos en lotes.

La documentación completa de la API, con ejemplos y todos los campos disponibles, está en:

👉 https://pos-api.haddock.app/docs

Gestión multi-establecimiento

Si tu TPV gestiona varios establecimientos, hay dos formas de enviar los datos a haddock:

Opción 1: Credenciales separadas

Cada establecimiento tiene su propia propiedad en haddock con sus propias credenciales de API. El TPV envía los datos de cada establecimiento por separado a sus credenciales correspondientes.

Es la opción más sencilla y no requiere configuración adicional.

Opción 2: Enrutamiento por venueID

Una sola conexión autenticada puede distribuir los pedidos a varios establecimientos. Cada pedido incluye un campo venueID que indica a qué establecimiento pertenece, y haddock lo enruta automáticamente a la propiedad correspondiente.

Esta opción es útil cuando el TPV gestiona múltiples establecimientos desde un único sistema. Contacta con nosotros para configurarla.

¿Necesitas ayuda?

Si tienes dudas sobre cómo configurar la integración, escríbenos por el chat de soporte y te ayudamos.

Tu proveedor de TPV o distribuidor puede cobrar por sus servicios de integración o por módulos adicionales necesarios. Estos costes son ajenos a haddock.

Actualizado el: 10/04/2026