🔗 Nexus

← Volver a notas
17 KB 13/10/2026 22:16
🔗

Hoseg Rewards — Diferenciación de créditos: compra vs reciclaje ♻️

🔤 NOMBRE OFICIAL (Cindy, 2026-09-23 20:47): los créditos obtenidos por donar una casaca se llaman "Créditos Recidar" (150 por mes). ❌ NO llamarlos "créditos por reciclaje". En este doc, donde diga "créditos de reciclaje" léase "Créditos Recidar".

✏️ ACLARACIÓN (Daniel, 2026-10-13): el donativo es cualquier casaca (no necesariamente de marca Hoseg). Corregido en el flujo de la PPT del equipo.

Origen: pedido de Cindy Verde (WhatsApp, 2026-09-23 12:26, audio).
Alcance pedido: analizar alternativas y medir viabilidad SIN mover nada en programación. Reunión hoy 5:00 pm.
Doc padre: wiki/proyectos/hoseg-cash.md

1. El requerimiento (lo que pidió Cindy)

2. Estado actual del sistema (base técnica real)

Consecuencia: hoy los créditos no distinguen origen. Agregar la distinción es un cambio acotado y no destructivo (todo pasa por el ledger propio).

3. Opciones de diseño

🥇 Opción A — Etiqueta de origen en el ledger (credit_type) + saldo con desglose

Opción B — Dos programas / dos tarjetas separadas

🥈 Opción C — Bolsillos formales con reglas propias cada uno

Opción D — Créditos de reciclaje como cupón/voucher aparte (fuera del wallet)

🏁 Recomendación

4. Cómo se generarían los créditos de reciclaje (a definir con Cindy)

Posibles mecanismos (no excluyentes):
1. Por peso (kg de prenda/textil reciclado) → tasa de conversión.
2. Por prenda (unidad entregada).
3. Por valor/monto (equivalente al ticket).
4. Por evento (jornada de reciclaje, kiosco, campaña con fecha).

Registro de la entrega:
- Staff desde panel/POS escaneando el QR del cliente (igual que hoy en tienda) → más control, menos fricción para el cliente.
- Autoservicio (QR + formulario) → más escalable, pero requiere validación de la entrega.

5. Preguntas de negocio para la reunión de las 5:00 pm ⏰

  1. Tasa del reciclaje: ¿por kg, por prenda, por monto o por evento? ¿Cuánto vale?
  2. ¿Mismo saldo o restringido? ¿Los créditos de reciclaje se suman al saldo general o tienen reglas de canje propias (solo ciertos productos, no combinables)?
  3. Caducidad: ¿los créditos de reciclaje caducan? ¿Y los de compra?
  4. Niveles: ¿los créditos de reciclaje cuentan para subir de nivel (Changemaker/Heart Warmer) o solo los de compra?
  5. Prioridad de consumo al canjear: ¿primero compra, primero reciclaje, o FIFO?
  6. Canal online: ¿aplica también en Shopify o solo tienda física?
  7. Nombre visible para el cliente (p. ej. "Créditos Hoseg ♻️ Reciclaje").
  8. KPIs a medir: créditos otorgados vs canjeados por origen, clientes que reciclan, frecuencia, ticket posterior.

6. Estimación (post-decisión)

Escenario Esfuerzo Notas
Opción A (etiqueta + desglose, canje priorizado simple) ~1 día dev + pruebas Recomendado para el piloto
Opción C (caducidad/restricciones por bolsillo + reportes) ~2–3 días dev + pruebas Si se exige control total desde el inicio
Opción D (campaña puntual con vouchers) Horas Solo si es temporal

⚠️ El esfuerzo real depende de las respuestas a las preguntas del §5 (canje restrictivo y caducidad son los que más agregan).

7. 📩 Aclaración de Cindy (2026-09-23 12:46) — la dinámica concreta

"Por cada casaca antigua pero utilizable que deje el cliente en Hoseg para revisar, Hoseg le da 150 créditos Hoseg para que compre una casaca Hoseg. ¿Por qué separarlo de los demás créditos? Para evitar que usen esos 150 soles en otros productos."

Conclusión clave: NO es solo trazabilidad/desglose — el reciclaje debe ser un crédito RESTRINGIDO a catálogo (casacas). Esto descarta la Opción A "simple" y apunta directo a la Opción C (bolsillos con reglas propias).

Parámetros confirmados / por confirmar

Parámetro Valor Estado
Tasa 150 créditos por casaca entregada (1:1 con soles, asumido) ✅ dicho por Cindy
Restricción Solo compra de casaca Hoseg (no otros productos) ✅ dicho por Cindy
Trigger Cliente deja casaca antigua utilizable para revisión ✅ dicho por Cindy
¿Combina con créditos normales en una casaca? — ❓ por confirmar
¿Qué pasa si la casaca cuesta < 150? (¿sobra o se pierde?) — ❓ por confirmar
¿Sirve cualquier casaca Hoseg o solo una línea? — ❓ por confirmar
¿Aplica online (Shopify) o solo tiendas? — ❓ por confirmar
¿Caduca / cuenta para nivel? — ❓ por confirmar

8. Implicancia técnica de la restricción (lo importante)

Hoy el canje en tienda es ciego al producto: el vendedor escanea el QR e ingresa un monto, sin detalle de ítems. Para restringir a casacas hace falta que el canje sepa qué se está comprando.

Impacto en la estimación


Creado: 2026-09-23 · Actualizado 12:50 con la dinámica de Cindy · Nexus · Sin cambios en código.

9. ✅ Requerimiento CERRADO (Cindy, 2026-09-23) — con corrección 13:00

⚠️ Ojo: Cindy primero dijo "no se combinan", pero a las 13:00 envió una corrección de la política (ver §10). Manda la versión de §10. Confirmada por Cindy a las 13:14 ("Correcto").

# Definición Respuesta
1 ¿Combina reciclaje + créditos normales? ⚠️ CORREGIDO 13:00: SÍ se acumulan/combinan, pero SOLO cuando la compra es una casaca.
2 ¿Qué pasa si la casaca cuesta menos de 150? No aplica: no hay casacas bajo S/150, así que no queda saldo huérfano.
3 ¿Aplica online (Shopify)? NO — solo puntos de venta físicos. Se elimina la necesidad de validar carrito en Shopify.
4 ¿Y si un cliente compra casaca sin donar? Puede usar sus créditos normales con normalidad (los normales sirven para cualquier producto, incluidas casacas).

10. 🔁 CORRECCIÓN DE LA POLÍTICA (Cindy, 2026-09-23 13:00, audio)

"El cliente que deja una casaca para reciclar tiene el crédito Hoseg reciclaje de 150, pero si ya tiene créditos Hoseg sí puede acumularlos. Ejemplo: el cliente que tiene 100 soles en créditos y dona una casaca (150) → al llevar su casaca se le aplica los 150 + los 100 que tenía acumulados. Pero esto únicamente si lleva una casaca. Si compra otros productos, solo puede redimir de los créditos Hoseg anteriores (los normales). Los 150 soles son únicamente para redimirse con la compra de una casaca."

Regla definitiva

Situación Créditos normales Créditos de reciclaje (150)
Compra de casaca ✅ aplica ✅ aplica
Compra de casaca con ambos ✅ se suman (100 + 150 = 250) ✅
Compra de producto NO casaca ✅ aplica ❌ bloqueado
- Los créditos de reciclaje nunca salen del catálogo casacas.
- Los créditos normales sirven para todo (incluidas casacas).
- En compra de casaca con bolsillos se suman (se eliminó la exclusividad).
- Acumulables por varias casacas donadas (2 → 300).

🏁 Diseño final — Opción C (bolsillo restringido, combinable en casaca)

Cambios técnicos (para cuando se autorice):
1. transactions.credit_type → 'compra' | 'reciclaje' (default compra para el histórico).
2. Saldo con dos bolsillos: saldo_compra y saldo_reciclaje (total = suma).
3. Nuevo origen de earn reciclaje (app/panel vendedor: escanear QR + registrar entrega de casaca → +150).
4. Canje en app vendedor: paso obligatorio de categoría de producto.
- Ítem = casaca → aplica normal + reciclaje (sumados).
- Ítem ≠ casaca → solo normal; el bolsillo de reciclaje queda bloqueado.
5. Wallet del cliente: mostrar desglose ("Créditos por compras" / "♻️ Créditos por reciclaje — solo casacas").
6. Reportes: otorgados vs canjeados por origen; casacas recibidas; clientes que reciclan.

Estimación: ~2 días dev + pruebas (combinación en casaca es más simple que la exclusividad; el paso de categoría sigue siendo necesario para bloquear el bolsillo en otros productos).

Pendientes menores para la reunión (no bloquean):
- ¿Tope de acumulación por varias casacas?
- ¿Caducan los créditos de reciclaje? ¿Cuentan para nivel?
- ¿La "revisión" de la casaca es inmediata o acredita tras validación?
- ¿Quién registra la entrega? (vendedor en tienda)

11. ✅ RESPUESTAS FINALES (Cindy, 2026-09-23 19:48) — requerimiento COMPLETO

  1. Tope: máximo 150 créditos de reciclaje por mes, sin importar cuántas casacas se donen (1 o 10 = 150). Para sumar otro 150 hay que volver el mes siguiente y donar otra casaca.
  2. Caducidad: 6 meses, igual que el programa regular. (Confirmación adicional: los créditos normales también caducan a los 6 meses.)
  3. Nivel: Sí cuentan para subir de nivel (Changemaker / Heart Warmer) — es una acción que haría un Heart Warmer.
  4. Acreditación: el vendedor revisa la casaca y verifica que cumpla los estándares de calidad que definirá Recidar; si cumple, se acreditan.
  5. Registro: el vendedor recibe la donación, la revisa, registra los créditos y cierra la venta en el mismo momento si el cliente quiere usarlos ese día (un solo flujo).

Regla consolidada (definitiva)

Punto Definición
Earn 150 créditos de reciclaje por donativo · máx. 150/mes
Acumulación Mes a mes (los no usados se suman)
Caducidad 6 meses (igual que los créditos normales)
Uso Solo en compra de casaca; se suman con los normales en esa misma compra
Otros productos Los 150 quedan bloqueados
Nivel Los donativos cuentan para el nivel
Canal Solo tienda física
Operador Vendedor (revisa + registra + cobra)

Impacto en implementación (para cuando se autorice)


Creado: 2026-09-23 · Actualizado 19:50 — requerimiento cerrado y confirmado por Cindy · Nexus · Sin cambios en código.

12. 🚀 IMPLEMENTADO Y DESPLEGADO (2026-09-23 21:00)

Autorización: Cindy (WhatsApp 20:52), con backup previo.

Backup previo

Cambios (Zeta, contenedor hoseg-cash, commit b5ce03b pusheado a dannyelito/hoseg-cash)

Pruebas realizadas (en producción, con cliente de prueba luego eliminado) ✅

Pendiente / a decidir

13. 📲 Actualización en Google Wallet / Apple Wallet / wallet web (2026-09-23 21:15)

Pedido de Cindy: que el saldo de Créditos Recidar se refleje en las tres billeteras. Commit b2ec168 (pusheado).