Puntos / fidelización
Videos tutoriales
Los videos se reproducen si la carpeta media/ está disponible en el servidor.
¿Para qué sirve este módulo?
El módulo Puntos / fidelización administra el programa de recompensas por compras: los clientes acumulan puntos según el valor de sus pedidos y el saldo queda registrado en un historial auditable.
- Configurar reglas de acumulación (cuántos pesos equivalen a 1 punto, cuándo acumular, canales de venta).
- Consultar el dashboard con clientes activos, puntos en circulación y movimientos recientes.
- Ver el listado de clientes con saldo mayor a cero.
- Revisar el detalle por cliente: saldo, movimientos, puntos próximos a vencer.
- Acumulación y reversión automáticas al facturar, pagar, anular, devolver o aplicar nota crédito (según configuración).
Relación con otros módulos
| Acción | Módulo |
|---|---|
| Saldo e historial del cliente | Clientes → ficha → icono estrella Puntos |
| Acumulación al facturar | Pedidos / Facturación |
| Acumulación al pagar (modo «Al pagar») | Recibo de caja, abonos, cruce de saldos, cambio forma de pago |
| Reversión por anulación | Facturas → anular pedido / factura |
| Reversión por devolución | Devoluciones (venta con factura) |
| Reversión por nota crédito | Notas crédito vinculadas a la venta |
| Canales que acumulan | Catálogo canales_venta (mismo que en pedidos) |
| Acceso alternativo a configuración | Configuración del sistema → abre la pantalla de Configuración de este módulo |
Inicio rápido
- Configuración → marque Módulo activo → defina pesos por punto y cuándo acumular → Guardar.
- Dashboard → verifique estado Activo y tasa de canje (si aplica).
- Facture o cobre pedidos con cliente identificado; los puntos se registran solos.
- Clientes con puntos → revise saldos → botón Movimientos o Detalle.
- Desde la ficha del cliente (icono estrella) consulte historial y puntos por vencer.
Conceptos clave
- Saldo de puntos
- Total disponible del cliente en el módulo. Se actualiza con cada movimiento.
- historial de movimientos / movimiento
- Cada suma o resta queda en historial de movimientos del cliente con tipo, fecha, pedido, referencia y nota.
- Pesos por punto (acumulación)
- Cuántos COP de total del pedido equivalen a 1 punto ganado. Ej.: 1000 = 1 punto por cada $1.000.
- COP por punto (canje)
- Valor en pesos de cada punto al pagar o descontar. Ej.: 50 = cada punto vale $50 al canjear. 0 = sin canje configurado.
- Momento de acumulación
- Al pagar (default): cuando estado pagado. Al vender: al facturar, aunque sea a crédito.
- Canal de venta
- Campo el módulo. Puede limitarse a ciertos canales en configuración.
- Idempotencia
- Un mismo pedido no genera dos acumulaciones; las reversiones tampoco se duplican.
Cómo se calculan los puntos
Fórmula base sobre el total del pedido (total del pedido) al momento de acumular:
puntos = redondeo( total del pedido ÷ pesos por punto )
Redondeo configurable:
- Hacia abajo (piso) — default; conservador para la empresa.
- Redondeo — al entero más cercano.
- Hacia arriba (techo) — más favorable al cliente.
Ejemplo: pesos_por_punto = 1000, total_pedido = $45.800, redondeo piso → 45 puntos.
Si el resultado es 0 puntos, no se crea movimiento. Pedidos anulados (estado pagado) no acumulan.
Dashboard
En esta pantalla — tarjetas principales:
- Clientes con saldo > 0 — cuántos clientes tienen puntos disponibles.
- Puntos en circulación — suma de saldos positivos; muestra equivalencia en COP de canje si está configurada.
- Movimientos (30 días) — actividad reciente del historial de movimientos.
- Módulo — Activo/Inactivo y texto «Acumula al facturar» o «Acumula al pagar».
Tabla Top 10 por saldo con enlace Detalle a la ficha de puntos del cliente. Panel lateral con accesos a Configuración y listado completo.
Clientes con puntos
En esta pantalla — todos los clientes con saldo > 0 (hasta 5.000 registros).
Columnas: # · Cliente · Documento · Puntos · Equiv. canje (si hay tasa) · acción Movimientos.
Tabla con DataTables (orden por puntos descendente, 25 por página). Badge con total de registros.
Botón Movimientos → ficha del cliente → icono Puntos.
Detalle por cliente
Pantalla Puntos del cliente (acceso desde listado, dashboard o ficha del cliente — icono estrella amarillo).
Tarjetas superiores
- Puntos totales (saldo) — saldo actual y equivalencia en COP de canje.
- Próximos a vencer (30 días) — suma de acumulaciones con fecha límite en la ventana (si vencimiento activo).
- Módulo puntos — estado Activo/Inactivo y reglas vigentes.
Tabla de puntos por vencer
Visible si hay acumulaciones con vencimiento entre hoy y +30 días: fecha vence, puntos, pedido, tipo, nota.
Historial de movimientos
Columnas: Fecha · Tipo · Puntos (+ verde / − rojo) · Pedido · Ref. · Vencimiento · Nota. Hasta 500 movimientos más recientes.
Tipos de movimiento
| Tipo | Etiqueta en pantalla | Efecto |
|---|---|---|
| Acumulación | Acumulación | Suma puntos por venta/pago. |
| Reversión | Reversión (anulación factura) | Resta el neto de puntos del pedido anulado. |
| Reversión | Reversión (nota crédito) | Resta proporcional al valor de la NC. |
| Reversión | Reversión (devolución) | Resta proporcional al valor devuelto. |
| Compensación por anulación de devolución | Compensación (anulación devolución) | Devuelve puntos si se anula una devolución previa. |
| Ajuste manual | Ajuste manual | Reservado / administración (sin pantalla estándar). |
| Canje | Canje | Reservado para pago con puntos (fase futura). |
Cuándo se acumulan puntos
Requisitos comunes:
- Módulo activo en configuración.
- Pedido con cliente identificado (cliente), salvo opción «Acumular sin cliente».
- Pedido no anulado.
- Canal de venta permitido según configuración.
- Una sola acumulación por pedido.
Modo «Al pagar» (default)
Puntos cuando el pedido queda pagado (estado pagado): recibo de caja, abonos, cruce de saldos, etc. Ventas a crédito acumulan al liquidarse.
Modo «Al vender (al facturar)»
Puntos al crear la factura, aunque el pedido siga pendiente de pago.
También aplica en facturación de órdenes de servicio cuando el flujo llama al mismo servicio de acumulación.
Cuándo se revierten puntos
- Anulación de factura — revierte el saldo neto de puntos de ese pedido (una sola vez).
- Devolución de venta — resta puntos proporcionales al valor devuelto, sin superar el neto aún atribuible al pedido.
- Nota crédito — resta proporcional; si ya hubo reversión por devolución, evita doble descuento.
- Anulación de devolución — compensación que devuelve puntos previamente restados.
Los cambios de configuración (pesos por punto, etc.) solo afectan operaciones nuevas; el historial de movimientos no se recalcula.
Configuración
En esta pantalla — formulario Reglas de acumulación:
| Campo | Descripción |
|---|---|
| Módulo activo | Interruptor maestro. Sin esto, no hay acumulación ni reversión. |
| Cuándo acumular | Al vender (facturar) o Al pagar (estado pagado). |
| Canales de venta | Todos los canales, o solo los marcados en la lista (canales de venta). |
| Pesos (COP) por 1 punto | Regla para ganar puntos. Default: 1000. |
| COP que vale 1 punto al canjear | Regla para usar puntos. 0 = sin canje. |
| Redondeo | Piso, redondeo o techo al calcular puntos. |
| Acumular sin cliente | Permite acumular con cliente (poco habitual). |
| Los puntos vencen | Activa fecha de vencimiento por acumulación. |
| Días hasta vencimiento | Ej.: 365 — contados desde la fecha del movimiento. |
Botón Guardar persiste en configuración del programa. También accesible desde menú global de configuración del sistema.
Vencimiento de puntos
Si activa Los puntos vencen, cada acumulación positiva guarda fecha de vencimiento = fecha del movimiento + días configurados.
En la ficha del cliente se muestra:
- Total de puntos que vencen en los próximos 30 días.
- Detalle por movimiento con fecha de vencimiento, pedido y nota.
El descuento automático de puntos vencidos del saldo puede implementarse aparte; la configuración ya registra las fechas para alertas y reportes.
Canje (pago con puntos)
Campo COP que vale 1 punto al canjear define cuánto descuenta cada punto al pagar (ej.: 50 → 100 puntos = $5.000).
El dashboard y listados muestran Equiv. canje cuando la tasa es mayor a 0.
La aplicación del descuento en caja o pedido es una fase opcional del sistema; configure la tasa aquí para que reportes y equivalencias sean coherentes cuando se habilite el canje en ventas.
Preguntas frecuentes
Ejemplos prácticos
Ejemplo 1 — Programa estándar
- Configuración: activo, 1000 COP/punto, al pagar, redondeo piso, canje $50/punto.
- Cliente compra $120.000 y paga → 120 puntos (≈ $6.000 canje).
- Dashboard muestra +1 cliente y puntos en circulación.
Ejemplo 2 — Solo tienda física
- Configuración → desmarque «Todos los canales» → seleccione canal «Tienda».
- Pedidos de e-commerce no acumulan; los de tienda sí.
Ejemplo 3 — Devolución parcial
- Venta $100.000 → 100 puntos.
- Devolución $25.000 → reversión ~25 puntos (proporcional, tope al neto del pedido).
- Historial del cliente muestra acumulación y reversión con referencia al pedido.
Buenas prácticas
- Active el módulo solo cuando las reglas estén definidas y comunicadas al equipo de ventas.
- Use «Al pagar» si vende a crédito y desea premiar al cobrar.
- Documente la tasa de acumulación y canje en material para clientes.
- Revise el dashboard semanalmente y el detalle de puntos por vencer si activó expiración.
- Antes de cambiar pesos por punto, informe que solo aplica a ventas futuras.
- Restrinja canales solo si el programa aplica a parte del negocio.
- Ante reclamos, consulte el historial de movimientos del cliente antes de escalar.