Engagement (engagement) · Demo: /demo/loyalty · Modo de acceso recomendado: publico (versión con la marca y las recompensas del prospecto por solicitud) · Prioridad: P2 · Esfuerzo total: XL (≈ 3–4 semanas de 1 dev senior para dejar demo y landing vendibles; el producto real se estima aparte)

Captura actual de /demo/loyalty (pestaña Vista cliente). Ver también Sistema de demos, Catálogo de productos y Roadmap. Productos relacionados: POS retail, Tienda en línea, App de delivery y CRM con IA.

Contexto de posicionamiento: con el reposicionamiento de Koptup en sistemas RAG (ver Visión de producto), este producto queda dentro de "Otras soluciones a medida". Es, sin embargo, buen candidato a segundo producto SaaS después del chatbot RAG (ver Producto real).

Problema: muchos comercios colombianos piden la cédula o el celular en caja y no hacen nada con ese dato. Usan tarjetas de sellos en papel o descuentos genéricos que regalan margen a quien igual iba a comprar, y no saben qué clientes dejaron de volver.

Para quién (cliente ideal en Colombia/LATAM):

• Cadenas de droguerías y farmacias de barrio con 3–50 puntos de venta.
• Supermercados y autoservicios regionales.
• Marcas de moda, calzado y cosmética con tiendas propias y tienda en línea.
• Restaurantes y cafeterías con varias sedes.
• Estaciones de servicio, tiendas de mascotas y veterinarias, ópticas.
• Cooperativas y cajas de compensación que quieren premiar el uso de sus servicios.

Propuesta de valor: "Tu propio club de clientes, con tu marca: puntos por compra en caja y en línea, niveles, canjes y campañas por WhatsApp. Los datos son tuyos y no de una coalición, y sabes cuánto te cuesta el programa antes de lanzarlo."

Lo que hace bien: es visualmente atractiva (tarjeta con gradiente por nivel, wallet pass que gira y muestra código de barras), cubre todas las mecánicas que un comprador espera ver (puntos, niveles, misiones, referidos, cashback, sorteos), los controles deslizantes de las reglas responden, el catálogo deshabilita los canjes sin saldo suficiente y la separación "lo que ve el cliente / lo que configura la empresa / lo que mide la gerencia" está bien planteada.

1. Marcas de terceros como recompensas y aliados: Starbucks, Amazon, Netflix, Spotify, Uber, LiveNation y UNICEF en RewardsCatalog, y Starbucks, Avianca, Falabella, Rappi y Movistar como "Coaliciones de partners" en Coalitions. Sugiere alianzas que no existen y es un riesgo de marca.
2. Moneda y escala de EE. UU.: gift cards de "$10/$25", cashback "$48,210" y la regla base "1 punto por cada $1 gastado" (admin.programs.points.baseHelp). En pesos eso equivale a devolver el 100 % de la compra; lo usual en Colombia es 1 punto por cada $1.000.
3. El canje no descuenta puntos: points es una constante (12.480) en MemberView. Al canjear, el botón cambia a "¡Canjeado!" pero el saldo no baja.
4. Botones sin acción: "Reclamar regalo" (cumpleaños), "Reclamar" en misiones, Apple/Google Wallet, los 3 íconos de compartir referidos (sin etiqueta), "Añadir partner" y "Revisar" en fraude. El botón de copiar enlace cambia el ícono pero no copia al portapapeles.
5. Filtro vacío: la categoría "Productos" no tiene ninguna recompensa (todas son gift cards, experiencias o donaciones).
6. Números incoherentes: los niveles suman 29.200 miembros (ProgramTiers, TierDonut), pero "Miembros activos" dice 84.210 y la campaña "Double Points Weekend" apunta a 125k. "Top 10 del mes" muestra 7 filas, y la racha de 14 días pinta todas las barras iguales.
7. Configuración sin efecto visible: los controles de puntos, los umbrales de nivel (se pueden cruzar: Plata por encima de Oro) y los meses de degradación no muestran ninguna simulación. Referidos, Cashback y Sorteos son solo cifras, sin nada que configurar.
8. Persona y marca fijas: el saludo, el banner de cumpleaños, la tarjeta y el ranking usan un mismo nombre propio fijo; el wallet pass dice "KopTup" y " Member" (debería mostrar la marca del cliente) y el enlace de referidos usa el dominio de Koptup.
9. Spanglish: "Loyalty — Fidelización Omnicanal", "Tiers", "Wallet Pass", "Earning Rules", "Completion", "Uplift", "Breakage", "AOV", "LTV", "Engagement", "Double Points Weekend", "Birthday Auto-Trigger", "Point farming", "Multi-account", además de los textos fijos en inglés citados en la tabla.
10. Falta el flujo más importante en Colombia: acumular en caja. No hay vista de caja ni inscripción del cliente con autorización de tratamiento de datos (Ley 1581). Sin eso, el comprador no ve cómo funcionaría en su punto de venta.
11. Promesas difíciles de sostener: "Personalización con ML", "Detección de fraude en tiempo real", A/B testing y "Sorteos" sin advertencia (en Colombia los sorteos promocionales requieren autorización de Coljuegos).
12. Textos del catálogo (apps/web/messages/offerings/loyalty-fidelizacion.es.json): voseo ("Premiá", "Comprala", "pagá", "por vos"); descripción de plantilla ("Implementación a medida o suscripción SaaS mensual del producto…"); bullets genéricos ("POS retail", "Email basic"); "Reportes mensuales del tier" 1 vez en Profesional, 2 en Avanzado y 2 en Enterprise (relleno para cuadrar incluyeCount); costoNote dice USD 30–25.000/mes y el catálogo, 80–25.000.

• La caja: una vista donde el cajero busca al cliente por celular o cédula, lo inscribe con su autorización y registra la compra; los puntos llegan a la app del miembro.
• Un saldo que se mueva: compra → puntos → canje → saldo menor, coherente en todas las pestañas.
• Recompensas propias del comercio (bonos, productos, domicilio gratis), sin marcas de terceros.
• Pesos colombianos y escala real (1 punto por cada $1.000; valor del punto en pesos).
• Simulador de costo del programa: la primera pregunta de un gerente es "¿cuánto me cuesta?". Ver Landing.
• Cumplimiento visible: Ley 1581 (autorización), Ley 2300 de 2023 (horarios de mensajes comerciales), términos y condiciones del programa, Coljuegos para sorteos y tratamiento contable de los puntos (NIIF 15).
• La marca del cliente en la tarjeta y el wallet pass: es el "momento wow" de la demo personalizada.
• Recorrido guiado de 5 pasos, badges "Incluido desde plan X" y CTA contextual.
• Capturas y video de 60–90 s.

Sigue la estructura común de Landing de producto:

1. Hero: "Tu club de clientes con tu marca: puntos en caja, en línea y por WhatsApp". Subtítulo: "Haz que tus clientes vuelvan y mide cuánto más compran los miembros. Sin pagar por pertenecer a una coalición." CTA principal "Solicitar demo", secundario "Agendar llamada" y enlace "Probar la demo interactiva" (/demo/loyalty).
2. Problemas que resuelve (3 tarjetas): clientes que no vuelven y nadie lo nota; descuentos que regalan margen a todos; datos de clientes que no se usan.
3. Cómo funciona (4 pasos): el cajero inscribe al cliente con su celular → cada compra suma puntos → el cliente recibe un WhatsApp con su saldo y canjea → tú ves quién vuelve y cuánto más compra.
4. Simulador de costo del programa (calculadora en la página): ventas mensuales, % de ventas hechas por miembros, regla de acumulación, valor del punto y % de puntos que vencen sin usarse → costo mensual estimado y pasivo por puntos. Ejemplo: $400 M de ventas a miembros, 1 punto por cada $1.000 y punto de $10 → $4 M/mes (1 % de devolución); si vence el 20 %, el costo efectivo es $3,2 M.
5. Capturas (Caja, App del miembro, Configuración, Resultados) y video de 60–90 s con locución en español.
6. Módulos y plan en el que se incluyen (tabla Básico / Profesional / Avanzado / Enterprise).
7. Integraciones: el POS del cliente por API o el POS retail de Koptup; Tienda en línea, Shopify, WooCommerce o VTEX; WhatsApp Business (API oficial); SMS y correo; Apple Wallet y Google Wallet; CRM (HubSpot en Profesional, CRM con IA).
8. Cumplimiento: autorización de tratamiento de datos (Ley 1581) en la inscripción; mensajes comerciales solo en los horarios que permite la Ley 2300 de 2023; términos y condiciones del programa (vigencia y vencimiento de puntos); sorteos con autorización de Coljuegos; reporte del pasivo por puntos para el contador (NIIF 15).
9. Planes y precios: "Compra / a medida" en COP (y USD de referencia con TRM_REFERENCIA = 3.300); SaaS como "Lista de espera" (DECISIÓN 7).
10. Preguntas frecuentes: ¿Cuánto me cuesta el programa? · ¿Funciona con mi POS actual? · ¿El cliente tiene que descargar una app? (No: WhatsApp, web y wallet) · ¿Los datos son míos? · ¿Cómo evito el fraude de puntos? · ¿Cuánto tarda? (2–5 semanas en Básico) · ¿Puedo empezar con una sola sede?
11. CTA final con el formulario "Solicitar demo" con loyalty-fidelizacion preseleccionado.

Recorrido guiado (5 pasos, menos de 3 minutos):

flowchart LR
  A["1. Caja: inscribir y registrar compra"] --> B["2. App del miembro: llegan los puntos"]
  B --> C["3. Canjear recompensa"]
  C --> D["4. Configuración: doble puntos los martes"]
  D --> E["5. Resultados: ticket de miembros y costo"]
  E --> F["CTA: Solicitar demo guiada o propuesta"]

Ver diagrama como imagen

1. Caja: la cajera busca el celular de una clienta nueva, la inscribe con su autorización y registra una compra de $185.000 en Cuidado personal: +370 puntos (doble puntos de martes).
2. App del miembro: llega el WhatsApp "Ganaste 370 puntos en Club "; el saldo sube y la barra de progreso hacia Oro avanza.
3. Canje: canjear "Domicilio gratis" (600 puntos); el saldo baja y aparece el cupón con código.
4. Configuración: cambiar la regla a "triple puntos los martes" y ver en el simulador cuántos puntos daría la misma compra y cuánto subiría el costo del programa.
5. Resultados: los miembros compran $68.000 por ticket frente a $41.000 de los no miembros; tasa de canje 31 %; pasivo por puntos de $96 M. Cierre con CTA "Solicitar demo guiada" / "Solicitar propuesta".

• Modo recomendado: publico. La demo corre en el navegador sin costo de IA ni datos reales, se entiende sin explicación (cualquier persona ha usado un programa de puntos) y la vista del miembro es muy visual, así que funciona bien como imán de leads. Muestra el banner "Solicita tu demo guiada" (DECISIÓN 1).
• Qué ve el visitante sin solicitar: la landing con el simulador de costo, capturas y video de 60–90 s, y la demo completa con el preset "Droguería" y el recorrido guiado.
• Qué obtiene al solicitar (flujo de Sistema de demos): sesión guiada de 30 min en la que se llena el simulador con sus cifras, y una versión con su marca (logo y colores en la tarjeta y el wallet pass, nombre del club, sus recompensas) mediante un DemoGrant de 14 días, extensible 7 días más.
• Prospecto aprobado (Portal › Mis demos, ver Portal del cliente): tarjeta "Club — demo personalizada", días restantes y botones "Abrir demo", "Agendar llamada" y "Solicitar propuesta".
• Eventos DemoEvent: abrió la demo, pestañas visitadas, pasos del tour completados, compra simulada en Caja, canje realizado, uso del simulador, tiempo en la demo y clic en cada CTA.

Sin código, desde Admin › Solicitudes de demo › Aprobar (o Admin › Demos › Personalizar). Se guarda en el DemoGrant (campo personalizacion). Ver Panel de administración.

Implementación: mover los datos de page.tsx, AdminView.tsx y AnalyticsView.tsx a fixtures/<sector>.ts (se pueden reutilizar los nombres colombianos de apps/backend/src/modules/loyalty/loyalty.data.ts (retirado del repositorio en octubre de 2026: está en el historial de git)). La página lee la configuración de GET /api/demo-access/loyalty (DECISIÓN 3) y en modo público usa el preset por defecto. Imágenes en almacenamiento de objetos, nunca en el disco del servidor.

Alcance MVP — modalidad compra (Básico/Profesional, 4–8 semanas):

• Inscripción de miembros por celular o cédula (en caja, web o WhatsApp) con registro de la autorización de tratamiento de datos y baja de comunicaciones.
• Libro de puntos inmutable: cada movimiento (acumular, canjear, vencer, ajustar, reversar) es una transacción con referencia a la venta; el saldo se calcula de ahí. El módulo actual solo guarda el saldo en el miembro, así que este es el cambio de modelo principal.
• Reglas de acumulación por monto, categoría, canal y campaña; niveles con subida y bajada; vencimiento de puntos.
• Catálogo de recompensas (bonos, productos, descuentos) y canje en caja con código o QR.
• API para el POS con llaves por sede e idempotencia (que una venta reenviada no sume dos veces), y conector para la tienda en línea.
• Portal web del miembro (PWA), wallet pass de Apple y Google, notificaciones por WhatsApp Business (plantillas aprobadas) y correo.
• Campañas segmentadas respetando los horarios de la Ley 2300 de 2023.
• Panel de administración, reportes (miembros activos, tasa de canje, ticket de miembros vs no miembros, puntos vencidos) y reporte de pasivo por puntos para la contabilidad (NIIF 15).
• Antifraude por reglas (acumulación anómala, cuentas duplicadas) y auditoría de ajustes manuales.
• Autenticación y autorización en servidor, roles por sede.
• Integraciones típicas en Colombia: POS del cliente o POS retail; Tienda en línea, Shopify o WooCommerce; WhatsApp Business; SMS; HubSpot (Profesional). Los sorteos (Avanzado) solo con la autorización de Coljuegos tramitada por el cliente.
• Base técnica: reutilizar tipos y reglas de apps/backend/src/modules/loyalty/ (retirado del repositorio en octubre de 2026, está en el historial de git; Member, Reward, TIER_THRESHOLDS, validación de saldo en redeem) migrándolos a Mongoose, con PointsTransaction, autenticación, autorización y tenantId.

SaaS (DECISIÓN 7): hoy no hay base multi-tenant ni cobro recurrente, así que se muestra "SaaS: lista de espera". Fidelización es un buen candidato a segundo producto SaaS después del chatbot RAG (Fase 4): el libro de puntos es fácil de aislar por cliente, el valor es recurrente y se puede cobrar por miembros activos. Requisitos: core multi-tenant compartido con el chatbot RAG, cobro recurrente con Wompi/PayU (COP) y Stripe (USD), aprovisionamiento automático (club, marca, llaves de API), medición de miembros y transacciones contra los límites del plan, copias de seguridad por cliente y acuerdo de encargo de tratamiento de datos.

Paquetes sugeridos: "Suite retail" (con Tienda en línea y POS retail) y "Suite restaurantes" (con App de delivery, cuyo plan Avanzado ya promete "Loyalty/cashback integrado").

Precios actuales del catálogo (apps/web/src/lib/services-catalog.ts, entrada loyalty-fidelizacion; COP):

Horas de evolutivos incluidas por mes: 5 / 12 / 25 / 50. Soporte: correo 24 h hábiles / correo + WhatsApp 4 h / + Slack Connect 2 h / tickets con SLA 1 h. USD de referencia (TRM 3.300): setup Básico ≈ USD 10.610.

Recomendaciones de claridad:

1. Bullets en lenguaje de cliente y sin relleno. Hoy: "POS retail", "Email basic", "Reportes mensuales del tier" repetido. Propuesta: Básico "1–3 sedes y hasta 5.000 miembros · Puntos por compra en caja · Catálogo de recompensas · WhatsApp y correo con el saldo · Reporte mensual". Profesional "+ Varias sedes · Conexión con tu tienda en línea · Campañas por WhatsApp · Integración con HubSpot · Wallet de Apple y Google". Avanzado "+ Niveles y misiones · Segmentos sugeridos · Campañas automáticas · Predicción de clientes en riesgo · Sorteos (con autorización de Coljuegos)". Enterprise "+ Coalición de varias marcas · CDP y CRM corporativos · Gerente de proyecto dedicado".
2. Descripción específica en lugar de "Implementación a medida o suscripción SaaS mensual del producto…", y tuteo en vez de voseo.
3. costoNote coherente con el catálogo: USD 80–25.000/mes (hoy dice 30–25.000).
4. Mantenimiento de compra incoherente: 12 × $3,2 M = $38,4 M al año (110 % del setup Básico) y 2,7 veces la cuota SaaS ($1,19 M). Decisión común en Catálogo de productos.
5. SaaS → "Lista de espera" hasta la Fase 4; anunciarlo como "próximamente en suscripción" porque es candidato real.
6. Enterprise SaaS setup: mostrar "Incluido" o "A convenir" en vez de "Personalizado" (hoy sale de formatCOP(0)).
7. Piloto pagado (decisión del dueño): "Piloto de 60 días en 1–2 sedes" con precio de referencia similar al Piloto RAG (COP 3.900.000), descontable del setup si contratan en 30 días. Baja la barrera de entrada para cadenas que quieren probar.
8. Mostrar en la landing el costo total a 12 meses de Básico y Profesional junto al resultado del simulador de costo del programa.

Detalle de la política comercial común en Catálogo de productos y Comercial, marketing y legal.

Son metas iniciales a validar con datos reales; no son resultados actuales.

• Conversión landing → solicitud de demo ≥ 3 %.
• ≥ 40 % de los visitantes de la landing usan el simulador de costo (evento propio).
• ≥ 60 % de los visitantes de la demo pública registran una compra en Caja y hacen un canje (medido con DemoEvent).
• ≥ 70 % de los prospectos aprobados abren su demo personalizada en las primeras 72 h.
• ≥ 25 % de las demos guiadas terminan en propuesta o piloto en ≤ 14 días.
• Primer piloto de 60 días firmado en los 4 meses siguientes a la Fase 2.
• 0 marcas de terceros y 0 botones sin acción en la demo publicada.