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:
- Contacta con tu proveedor de TPV y solicítale que integre haddock.
- El proveedor implementa la conexión utilizando nuestra API.
- Tú activas la integración desde haddock en Configuración del restaurante > Mis integraciones > API genérica para sistemas de TPV. Activar la integración en haddock es gratuito.
- 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, Fourvenues, Haleteo, ICG Frontrest, Intersoft, Madisa, OfiBarman, OptiRest, Platomico, Techni-Web, Turbopos 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:
- Catálogo: artículos, categorías, menús y grupos de modificadores. Es recomendable enviar el catálogo antes que las ventas.
- 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.
El catálogo (artículos, categorías, menús y grupos de modificadores) se envía por la conexión principal y haddock lo aplica a todos los establecimientos relacionados. El venueID solo se usa para enrutar pedidos.
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: 15/05/2026
¡Gracias!