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.
• Las tarjetas que empiezan con un cupón de bienvenida también ganan, desde la primera venta, como la tarjeta de sellos, de puntos o de niveles en la que se convierten. Holded no tiene recompensas en caja, así que tu equipo sigue dando el regalo de bienvenida con la app Passtastic Scanner, como hasta ahora.
• Los demás 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 y escritura
• Desarrolladores: Completo

Paso 2 — Conecta Holded con Passtastic

1. En tu panel de Passtastic, abre Ajustes y luego Integraciones, dentro de 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.

Paso 4 — Los miembros aparecen automáticamente en tus contactos de Holded

Tus miembros aparecen en Holded por sí solos. Cuando alguien se une, Passtastic lo añade a tus contactos de Holded (nombre, email, teléfono), para que en caja tu equipo busque una vez y lo ponga en el ticket. Los miembros que se unieron antes de conectar se van añadiendo durante los días siguientes, hasta 200 al día, para que un programa grande no agote de golpe tu cuota de la API de Holded. Si Holded ya tiene a alguien con el mismo email o teléfono, vinculamos ese contacto en lugar de crear uno nuevo.

Puedes desactivar esto en cualquier momento con Añadir miembros a mis contactos de Holded automáticamente en la página de Holded en Passtastic. Los contactos ya creados se quedan en Holded, y eliminar un miembro en Passtastic nunca elimina su contacto de Holded.

*Detalles:* los contactos se guardan como clientes, se etiquetan como passtastic y llevan el código de referencia PT-…; la sincronización usa unas dos llamadas por miembro de la cuota mensual de la API de tu plan de Holded.

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.

Devoluciones

Cuando haces una devolución desde el TPV de Holded, Holded crea un ticket rectificativo con importe negativo, vinculado a la venta original. Passtastic aplica tu regla de puntos al importe devuelto y resta esos puntos, así que una devolución parcial solo quita parte de los puntos. Una tarjeta nunca baja de cero: si el cliente ya ha usado los puntos, se queda en 0. Cancelar o eliminar un ticket también resta sus puntos. Las tarjetas de sellos solo pierden un sello cuando un ticket se cancela o se elimina, no con una devolución. Puedes desactivarlo con Restar puntos en las devoluciones en la página de Holded en Passtastic.

Solución de problemas

Nada gana, y la página dice Conectado · sin acumular. Ninguna tarjeta está activada. Activa el interruptor de una tarjeta en Tus tarjetas de fidelidad. Si mientras tanto llegó una venta, la página muestra la fecha de esa venta: no ganó nada, y no se añade más tarde.

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 escritura 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.

"Tu clave de Holded no puede crear contactos." Tu token de API no tiene el permiso Contactos: Escritura, así que Passtastic puede vincular contactos existentes pero no puede crear otros nuevos. Crea un nuevo token de API en Holded con Ventas: Lectura, Contactos: Lectura y escritura y Desarrolladores: Completo, haz clic en Pegar una clave nueva en el banner y pégalo. Mientras tanto, la acumulación sigue funcionando mediante la coincidencia de email y teléfono.

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.