Programa de Referencia — Historial de comisiones
Requisitos de acceso
- Permiso (módulo):
viewIndicationProgram - Licencia/Feature: Ninguna
- Contenedor del menú: GENERAL → grupo Programa de Referencia
Qué es / cuándo usarlo
Pantalla de auditoría de las comisiones de referencia generadas. Cada fila es una comisión (multilevel_commissions) con sus pagos (multilevel_commissions_payments) y el estado de procesamiento. Hay filtros por estado (todas / procesadas / pendientes) y búsqueda por usuario, motivo o moneda, además de contadores de procesadas y pendientes.
Úselo para verificar lo que fue generado por los Programas de Referencia, identificar pendencias y validar la liquidación.
Requisitos previos
- Permiso:
viewIndicationProgram(permiso doble: enum CPM + módulo dinámico en la BD). - Licencia/Feature: Ninguna.
- Dependencias de otras pantallas: las comisiones solo existen si hay programas activos y acciones de referidos que disparen los eventos cubiertos.
Paso a paso
- Acceda al menú Programa de Referencia → Historial de comisiones (
/indication-program/commissions). - Use los filtros de estado (Todas / Procesadas / Pendientes) y la búsqueda (usuario, motivo, moneda).
- Haga clic en una fila para expandirla y ver los pagos que componen la comisión.
Filtros y columnas
| Filtro / Columna | Qué muestra | Origen del dato |
|---|---|---|
| Estado (Todas/Procesadas/Pendientes) | Filtra por wasProcessed | Filtro client-side |
| Búsqueda | userId, reason o unit_of_money | Filtro client-side |
Usuario (userId) | Beneficiario de la comisión | multilevel_commissions.userId |
Monto (amount) | Valor de la comisión | multilevel_commissions.amount (string BigNumber) |
Moneda (unit_of_money) | Asset acreditado | multilevel_commissions.unit_of_money |
Motivo (reason) | Origen/descripción de la comisión | multilevel_commissions.reason |
Fecha (when) | Cuándo fue generada | multilevel_commissions.when |
Procesada (wasProcessed) | Si ya fue liquidada | flag en el registro |
Pagos (payments[]) | Desglose por pago (fecha/estado) | multilevel_commissions_payments |
Acciones y modales
- Expandir/contraer fila: muestra los pagos de la comisión. Solo lectura.
- Contadores: "procesadas" y "pendientes" agregan el total cargado.
Reglas de negocio / precauciones
Atención
wasProcessed = falseindica una comisión pendiente de liquidación — no asuma que el usuario fue acreditado antes del procesamiento.- Esta pantalla comparte las mismas entidades de comisión que la pantalla Pago de comisiones; la diferencia es el recorte de auditoría por programa de referencia.
- Idempotencia: la liquidación vía FinLib es idempotente por
externalId;E00021("already processed") es éxito, no un error. - Valores financieros: valores como string BigNumber — sin redondeo.