Conecta Holded TPV

Qué hace esto

Conecta tu cuenta de Holded y tu programa de fidelidad empezará a acumular directamente desde tu TPV de Holded. Cuando tu equipo cobra una venta con un cliente asignado, Passtastic lo detecta automáticamente — sin necesidad de otro dispositivo para ganar. Para dar una recompensa, tu equipo la sigue confirmando con un escaneo rápido en la app Passtastic Scanner, igual que en cualquier otro punto de venta.

Qué tarjetas pueden ganar con las ventas de Holded

• Tarjetas de puntos y de niveles ganan según tus reglas de puntos — la regla de acumulación asignada a la tarjeta decide cuánto vale una venta. Si una tarjeta aún no tiene ninguna regla asignada, no ganará hasta que configures una.
• Tarjetas de sellos ganan 1 sello por cada venta cobrada — no necesitan ninguna regla.
• Cupones, bonos (sellos prepago / puntos prepago) y membresías no pueden ganar con las ventas de Holded. Estos tipos de tarjeta no tienen forma de acumular desde una transacción de TPV, por lo que no aparecerán en la lista de tarjetas que puedes activar.

Antes de empezar

• Acceso a tu cuenta de Holded con permiso para crear credenciales de API.
• Al menos una tarjeta de fidelidad publicada en Passtastic que pueda ganar (una tarjeta de puntos, de niveles o de sellos). Si aún no tienes una, créala primero desde Programs → Create New Program (Programas → Crear nuevo programa).
• La app Passtastic Scanner gratuita en un teléfono o tablet — seguirás necesitándola para canjear recompensas.

Paso 1 — Obtén tu clave API de Holded

1. En Holded, abre Ajustes.

2. Ve a Desarrolladores.

3. Abre Credenciales.

4. Toca Nuevo token de API.

5. Selecciona exactamente estos permisos:

• Ventas: Lectura
• Contactos: Lectura
• Desarrolladores: Completo

Paso 2 — Conecta Holded con Passtastic

1. En tu panel de Passtastic, abre Settings (Ajustes) y luego Integrations (Integraciones), dentro de Business (Negocio).

2. Busca Holded TPV.

3. Pega la clave API que copiaste y haz clic en Conectar Holded.

Paso 3 — Elige qué tarjetas ganan

Una vez conectado, verás Tus tarjetas de fidelidad — todas las tarjetas de puntos, niveles y sellos de tu cuenta. Activa una tarjeta para empezar a acumular con las ventas de Holded.

• Para las tarjetas de puntos y de niveles, asegúrate de que tienen una regla de acumulación asignada — las tarjetas solo acumulan cuando tienen una regla de puntos asignada. Si aún no tienen ninguna, usa Configura tus reglas de puntos en la misma página.
• Las tarjetas de sellos no necesitan ninguna regla — con activarlas basta; suman 1 sello por cada venta cobrada.

La página de conexión muestra N de M tarjetas acumulando para que veas de un vistazo cuántas de tus tarjetas con capacidad de ganar están activadas.

El hábito que más importa: asigna el cliente a la venta

Los puntos y sellos solo se añaden cuando tu equipo asigna el cliente al ticket en Holded — igual que al añadir un cliente a cualquier venta. Si una venta se cobra sin ningún cliente asignado, no se acredita nada automáticamente.

Aun así, no se pierde necesariamente: una venta hecha sin cliente se puede atribuir a él más tarde, ese mismo día, si el ticket se actualiza con el cliente antes de que cierre el día. Pasado ese margen, la venta ya no se puede vincular.

Cómo tu equipo canjea una recompensa

Holded no muestra el estado de recompensa de un cliente en el TPV, así que canjear sigue usando un escaneo rápido, igual que en cualquier programa de fidelidad de Passtastic:

1. Cuando un cliente dice que su recompensa está lista, tu equipo abre la app Passtastic Scanner y escanea el pase de wallet del cliente. Esto confirma que la recompensa es real y está lista.

2. Tu equipo aplica la recompensa al cobrar, como haría normalmente (descuento, artículo gratis, etc.).

Ese es el único lugar donde sigues usando el escáner — ganar es automático con las ventas de Holded.

Solución de problemas

Mi clave API no se aceptó. Esa clave no se aceptó. Comprueba que hayas creado un token de API de Holded genuino (no una contraseña de acceso ni otro tipo de clave) y que hayas copiado la cadena completa. Crea un token nuevo en Holded → Ajustes → Desarrolladores → Credenciales y pégalo de nuevo.

Error "Añade el permiso Ventas: Lectura / Desarrolladores: Completo". Al token le falta uno de los tres permisos necesarios. Vuelve a Holded, crea un nuevo token de API y selecciona los tres: Ventas: Lectura, Contactos: Lectura y Desarrolladores: Completo — luego pega ese en Passtastic.

"No se pudo registrar el webhook de ventas en Holded." Holded solo permite un webhook de ventas por cuenta. Si otra herramienta ya está registrada para recibir tus notificaciones de ventas de Holded, Holded rechazará un segundo registro. Desconecta o reconfigura el webhook de la otra herramienta en Holded y vuelve a intentar conectar Passtastic.

Mi conexión necesita una clave nueva después de regenerar una en Holded. Tu conexión con Holded necesita una clave API nueva. Regenerar o revocar una clave en Holded invalida la que Passtastic está usando, así que la conexión deja de funcionar hasta que vuelvas a conectarte. Crea un token de API nuevo en Holded (con los mismos permisos de arriba) y pégalo en la página de la integración de Holded para reconectar — la configuración de tus tarjetas se mantiene.

Una venta no se está vinculando al cliente correcto. Comprueba que el permiso Contactos: Lectura siga activo en tu clave API — sin él, Passtastic no puede vincular las ventas con tus clientes. Si falta, añádelo a tu token actual o crea uno nuevo con los tres permisos.

Para gestionar la fidelidad sin un POS, o conectar otras herramientas, consulta Sistemas POS e integraciones.