Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Start Date

1 Nov 2023

Epic

Bolsa de puntos - modelo de asignación y seguimiento de puntos B2B2C

Document status

DRAFT

Document owner

Hector Gutierrez

Designer

Hector Gutierrez

Solution Architech

Angel Cruz

Head of Engineer

Jose Pardo

Tech lead

Artemio Estrella

Technical writers

QA

Angel Ortiz, Saul Garcia

Indice

Table of Contents

Problem or Opportunity

Los negocios B2B tienen la necesidad de ofrecer puntos premia para poder diferenciarse de su competencia directa, para poder realizar esta asignación de forma ordenada y sin generar problemas extra de fraude se ha considerado que el B2B o “Dueño” compre una bolsa con puntos para la acumulación de sus clientes, esta bolsa debe tener además una vigencia, ya que debe de respetar un ciclo donde el Dueño renueve su suscripción cada cierto tiempo.

...

  • Los dueños tienen deseo de participar en un sistema de lealtad a nivel nacional

  • Los dueños tendrán al menos un 10% de sus ventas mensuales con un Ticket Promedio de $120 que con una generosidad del 20% la bolsa estándar de 1,000 puntos es suficiente para cubrir el 50% de las necesidades de sus consumidores por un mes, con lo cual deberían estar comprando puntos adicionales

Solution Scope

Definition of main entities

Catálogo de tipos bolsas de puntos

Para poder comprar una bolsa de puntos, el sistema deberá contar con un catálogo de tipos de bolsas de puntos con las siguientes características

  1. ID de catálogo de bolsa de puntos

  2. Número de puntos que incluye

  3. Nombre del tipo de bolsa

  4. Descripción de tipo de bolsa

  5. Vigencia de bolsa de puntos en meses

  6. Precio final de bolsa de puntos

  7. Descripción de costo de bolsa de puntos (texto)

Bolsa de puntos para acumulación

Un bolsa de puntos cuenta con:

  1. Número de puntos incluidos en la bolsa

  2. Puntos disponibles (no entregados)

  3. Fecha de vigencia de bolsa de puntos (día natural sin hora)

  4. Fecha de activación de bolsa de puntos (día natural sin hora)

  5. Status de bolsa de puntos

    1. Activa: Definida como Fecha de vigencia >= Fecha de activación && Fecha de vigencia >= Hoy() && Puntos disponibles > 0

    2. Agotada: Definida como Puntos disponibles < 0

    3. Vencida: Definida como Fecha de vigencia <Hoy()

  6. Negocio asignado a bolsa de puntos: Negocio definido en el PRD https://digitalfemsa.atlassian.net/wiki/spaces/TITDikki/pages/509280522/Membresias+y+Onboarding#Solution-Experience

  7. Id de bolsa de puntos

  8. Id de tipo de bolsa de puntos

Bolsa de puntos para redención

La bolsa de puntos de redención es una bolsa estándar de SpinPremia consumidor, es decir, son puntos acumulados en un consumidor, en el caso de SpinPremia negocios, esta bolsa recibirá los puntos de los consumidores B2B2C y podrá redimirlos en cualquiera de los aliados del grupo, incluyo otros usuarios B2B que acepten puntos en sus comercios.

Tenemos el assumption de que no necesitamos cambiar el tipo de bolsa estándar de consumidor para lograr esto.

Historial de transacciones de B2B2C

Cada asignación de puntos de B2B2C debe contener lo siguiente

  1. Número de puntos asignados al consumidor

  2. Fecha y hora de la transacción

  3. Monto total del ticket en el que fue asignado al consumidor

  4. FemsaID del consumidor al que fue asignado

  5. Identificador de bolsa de puntos de la que fueron asignados los puntos

  6. Status de la transacción:

    1. Successful: Cuando los puntos fueron entregados con éxito al consumidor

    2. Cancelled: Cuando los puntos fueron cancelados o existió un error en el sistema que no permitió la asignación de puntos

    3. Validating: Estado transicional cuando se esté realizando la operación de transferencia de puntos de bolsa a consumidor

  7. Fecha y hora de última actualización de la transacción

  8. Id de transacción

Membresia activa:

Para poder tener activas las funcionalidades de Cobro rapido y Dar puntos premia se necesita:

  • Documentacion validada

  • Ultimo pago validado

  • Puntos para acumular vigentes

Historias de Usuarios y Requerimientos

...

debo poder visualizar la bolsa de puntos que compre para que mis clientes puedan acumular y al dar clic ir al flujo para comprar más7

ID

User Story

Requirement

ImportancePrioridad

Jira Issue

Notes

0

Bolsas y Puntos

Yo como usuario Dueño quiero tener mis puntos premia en diferentes bolsas PARA poder usarlos segun la ocasion: darlos a mis clientes al usar el cobro rapido o usarlos para mis compras dentro del ecosistema.

  • El usuario puede ver una bolsa de puntos

1

Ver puntos para acumular

  • Yo como usuario Dueño quiero visualizar el total saldo de puntos para acumular que tengo actualmente PARA saber que mis clientes puedan acumular tengo activos mis beneficios/funcionalidades

  • El usuario al realizar una compra exitosa de una bolsa de puntos se considera con una “membresia activa”puede ver su saldo de puntos para acumular desde el home

  • El usuario puede ingresar a la sección de “Puntos Premia”.

    • En esta sección el usuario puede visualizar los puntos disponibles vigentes que tiene en su membresia cuenta para que sus clientes acumulen en sus compras.

  • El usuario despues de finalizar correctamente el proceso de compra y validacion de pago de la bolsa de puntos:

    • Puede ver el total de puntos que incluye las cantidades de:

      • la cantidad bolsa de puntos que seleccionó

      • la cantidad de puntos incluida en la membresía

  • El usuario puede visualizar:

    • la vigencia de sus puntos (día natural sin hora)

    • Número de puntos incluidos en la bolsa

    • Fecha de activación de bolsa de puntos (día natural sin hora)

  • Puntos disponibles (no entregados)

2

Ver puntos redimidos por consumidores

  • Yo como usuario Dueño quiero visualizar saber la bolsa/cantidad de puntos redimidos en mi negocio PARA saber si tengo e incentivarme a pagar algo con ellos dentro del ecosistema.

  • El usuario puede ingresar a la sección de “Puntos Premia”

    • En esta sección el usuario visualiza los puntos disponibles vigentes obtenidos de las transacciones donde clientes redimen sus puntos premia en el negocio.

    • Esta cantidad/bolsa crecerá siempre que mis consumidores rediman sus puntos en mi negocio siguiendo el proceso de premia para redención durante el “cobro rapido”

3

Seleccion y detalles de bolsas de puntos para acumular

  • Yo como usuario quiero poder seleccionar la bolsa que quiero comprar y ver todos los detalles de la bolsa de puntos seleccionada antes de de proceder al proceso de pago PARA estar seguro que elegi la correcta y no cometer errores.

  • El usuario puede ingresa a la sección dentro de “account” donde visualiza las bolsas de puntos disponibles para comprar.

  • Cada bolsa tiene un nombre y una descripción breve.

  • El usuario puede ver el detalle de las bolsas que incluye esta informacion:

    • ID de catálogo de bolsa de puntos

    • Número de puntos que incluye

    • Nombre del tipo de bolsa

    • Descripción de tipo de bolsa

    • Vigencia de bolsa de puntos en meses

    • Precio final de bolsa de puntos

    • Descripción de costo de bolsa de puntos (texto)

  • El usuario puede pasar de la selección de una bolsa de puntos a otra sin que esto sea considerada una selección final

  • El usuario necesita dar clic en confirmar en la selección de la bolsa de puntos para poder avanzar a las instrucciones de pago

4

Confirmacion e instrucciones para comprar bolsas en efvo/pago con referencia en banco

  • Yo como usuario Dueño quiero leer instrucciones y visualizar los pasos para comprar una bolsa de puntos para mi negocio con una transferencia o en efectivo para poder empezar a operar con puntos nueva activaPARA poder tener habilitadas las funcionalidades de “Cobro rapido” y “Dar puntos”

  • El usuario visualiza los conceptos de pago, cantidades e informacion relacionada a la bolsa de puntos seleccionada.

  • El usuario despues de confirmar su eleccion entra a la pantalla que le da las instrucciones para activar su bolsa de puntos.

5

Estatus de pago de bolsa

  • Yo como usuario quiero visualizar si mi compra de bolsa de puntos: está pendiente de validación o fue no existosa PARA poder realizar las acciones necesarias para resolver el problema.

  • El usuario puede acceder a ver el estatus del pago de la membresia desde un apartado de “account” o desde “home”

  • Los estatus que puede ver son:

    • En proceso

    • Pagado

6

Catálogo de bolsas con base de datos

Yo como usuario

  • El usuario ingresa a la sección de puntos Premia y puede comprar mas aunque no se hayan terminado los que tiene en su bolsa.

de Operaciones necesito un catálogo de bolsas en donde se puede definir precio, descripción, cantidad de puntos, nombre, vigencia e imagen base de datos

7

Freeze de cuenta

Yo como usuario administrador puedo “desactivar” a un usuario B2B cuando el usuario B2B no tenga puntos para acumular vigentes

8

Comprar bolsas adicionales

  • Yo como usuario quiero comprar mas puntos porque se me acabaron PARA poder seguir acumulando a mis clientes

  • El usuario necesita llamar a servicio al cliente para iniciar el proceso para comprar otra bolsa de puntos adicional.

9

Historial de compra de bolsas de puntos con detalles.

  • Yo como usuario Dueño quiero ver los detalles de cada una de las compras de bolsas de puntos que he hecho PARA poder entender mi frecuencia de compra, la vigencia de mis bolsas y cuantos puntos tengo.

  • El usuario puede ver:

    • todos los puntos que he comprado

    • la cantidad de puntos que tengo disponible

    • la fecha de compra de puntos

    • fecha de vigencia de puntos.

810

Movimientos de redenciones y acumulaciones con detalles.

  • Yo como usuario quiero ver los detalles de cada una de las transacciones que acumularon o redimieron puntos a traves de “cobro rapido” PARA poder tener a la mano los detalles por si surje un problema con el usuario y asi identificar la transaccion rapidamente y compartir la informacion con soporte.

El usuario puede acceder a un apartado en “account” donde puede ver por cada transacccion con puntos premia los siguientes datos:

  1. Número de puntos asignados al consumidor

  2. Fecha y hora de la transacción

  3. Monto total del ticket en el que fue asignado al consumidor

  4. FemsaID del consumidor al que fue asignado

  5. Identificador de bolsa de puntos de la que fueron asignados los puntos

  6. Estatus

de la transacción:
  • Successful: Cuando los puntos fueron entregados con éxito al consumidor

  • Cancelled: Cuando los puntos fueron cancelados o existió un error en el sistema que no permitió la asignación de puntos

  • Validating: Estado transicional cuando se esté realizando la operación de transferencia de puntos de bolsa a consumidor

  • Fecha y hora de última actualización de la transacción

  • Id de transacción

  • Definition of main entities

    Catálogo de tipos bolsas de puntos

    Para poder comprar una bolsa de puntos, el sistema deberá contar con un catálogo de tipos de bolsas de puntos con las siguientes características

    1. ID de catálogo de bolsa de puntos

    2. Número de puntos que incluye

    3. Nombre del tipo de bolsa

    4. Descripción de tipo de bolsa

    5. Vigencia de bolsa de puntos en meses

    6. Precio final de bolsa de puntos

    7. Descripción de costo de bolsa de puntos (texto)

    Bolsa de puntos para acumulación

    Un bolsa de puntos cuenta con:

    1. Número de puntos incluidos en la bolsa

    2. Puntos disponibles (no entregados)

    3. Fecha de vigencia de bolsa de puntos (día natural sin hora)

    4. Fecha de activación de bolsa de puntos (día natural sin hora)

    5. Status de bolsa de puntos

      1. Activa: Definida como Fecha de vigencia >= Fecha de activación && Fecha de vigencia >= Hoy() && Puntos disponibles > 0

      2. Agotada: Definida como Puntos disponibles < 0

      3. Vencida: Definida como Fecha de vigencia <Hoy()

    6. Negocio asignado a bolsa de puntos: Negocio definido en el PRD https://digitalfemsa.atlassian.net/wiki/spaces/TITDikki/pages/509280522/Membresias+y+Onboarding#Solution-Experience

    7. Id de bolsa de puntos

    8. Id de tipo de bolsa de puntos

    Bolsa de puntos para redención

    La bolsa de puntos de redención es una bolsa estándar de SpinPremia consumidor, es decir, son puntos acumulados en un consumidor, en el caso de SpinPremia negocios, esta bolsa recibirá los puntos de los consumidores B2B2C y podrá redimirlos en cualquiera de los aliados del grupo, incluyo otros usuarios B2B que acepten puntos en sus comercios.

    Tenemos el assumption de que no necesitamos cambiar el tipo de bolsa estándar de consumidor para lograr esto.

    Historial de transacciones de B2B2C

    Cada asignación de puntos de B2B2C debe contener lo siguiente

    ...

    Número de puntos asignados al consumidor

    ...

    Fecha y hora de la transacción

    ...

    Monto total del ticket en el que fue asignado al consumidor

    ...

    FemsaID del consumidor al que fue asignado

    ...

    Identificador de bolsa de puntos de la que fueron asignados los puntos

    1. de la transacción:

      1. Successful: Cuando los puntos fueron entregados con éxito al consumidor

      2. Cancelled: Cuando los puntos fueron cancelados o existió un error en el sistema que no permitió la asignación de puntos

      3. Validating: Estado transicional cuando se esté realizando la operación de transferencia de puntos de bolsa a consumidor

    2. Fecha y hora de última actualización de la transacción

    3. Id de transacción

    Success metrics

    Lista de métricas para juzgar el éxito del proyecto

    ...