Artículos sobre: Integraciones

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 del restaurante > Mis integraciones > API genérica para sistemas de TPV. 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 Clicktom, 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:


  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


Devoluciones y anulaciones


La API no tiene un endpoint específico para devoluciones. Hay dos formas de enviarlas, según el día en que deban contar.


Opción 1: sobrescribir el pedido original con los importes a 0. Reenvía el pedido original con el mismo ID externo y la misma fecha, con las cantidades e importes de los artículos y pagos a 0, y sin los campos de mesas (tickets) ni comensales (seats): si los dejas, el pedido anulado sigue contando como una mesa con sus comensales, y si los pones a 0 la petición se rechaza. La venta original se sustituye: su importe y sus comensales dejan de contar en el día en que se hizo, aunque el pedido se queda como un ticket de 0 €, así que sigue contando en el número de tickets y baja el ticket medio de ese día. Para una devolución parcial, reenvía el pedido solo con lo que finalmente se cobró y, en este caso, mantén los campos de mesas y comensales tal como los enviaste: la venta sí ocurrió, y si los quitas desaparecen su mesa y sus comensales. Usa esta opción cuando el pedido se anula antes de cerrar el día: si el día ya está cerrado, sus cifras cambiarán.


Opción 2: enviar un pedido nuevo con importes negativos. El pedido original no se toca y la devolución se envía como un pedido nuevo:


  • Con su propio ID externo (por ejemplo, el número de la factura rectificativa). Si reutilizas el ID del pedido original, lo estás sobrescribiendo (opción 1).
  • La fecha del pedido es la de la devolución, no la de la venta original, para que la devolución reste en el día en que se hizo.
  • Los artículos llevan la cantidad y el total en negativo. El precio unitario se mantiene en positivo.
  • El pago lleva la base, el impuesto y el total en negativo, con el método de pago con el que se devolvió el dinero.
  • Sin los campos de mesas (tickets) ni comensales (seats), para que la devolución no sume mesas ni comensales. En el historial de ventas aparece como un ticket de devolución, así que cuenta en el número de tickets y baja el ticket medio del día de la devolución.


Usa esta opción para devoluciones hechas otro día o cuando tu TPV emite facturas rectificativas.


En la documentación de la API tienes un ejemplo completo de cada opción.



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: 07/11/2026

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!