Reporte Financiero del Token
Requisitos de acceso
- Permiso (módulo):
manageToken - Licencia/Feature:
MANAGE_TOKENS - Contenedor del menú: TOKENIZACIÓN → grupo Tokenización → Gestionar Tokens → ícono Reporte financiero en la fila
Qué es / cuándo usar
Muestra el resumen de ventas de un token en un período: cantidad vendida y monto vendido, separados por compras manuales y compras automáticas, con desglose por forma de pago. Úselo para conciliación financiera, seguimiento de captación y cierre contable de un token específico.
Requisitos previos
- Permiso:
manageToken(doble — enum CPM + módulo en la BD). - Licencia/Feature:
MANAGE_TOKENS.
Paso a paso
- En Gestionar Tokens, haga clic en el ícono Reporte financiero en la fila del token.
- Elija el tipo de período: por mes (mes + año) o por intervalo de fechas (inicio/fin).
- Haga clic en Aplicar filtros para cargar (
getTokenFinancialReport).
Filtros y columnas
| Filtro / Columna | Qué muestra | Origen del dato |
|---|---|---|
| Tipo de período | "Mes" o "Intervalo" | Selección local |
| Mes / Año | Período mensual (años desde 2020) | selectedMonthNumber / selectedYear |
| Inicio / Fin | Intervalo personalizado | rangeStart / rangeEnd (ISO) |
| Forma de pago | Medio usado en la compra | Reporte (TokenController + FMS) |
| Cantidad vendida | Cantidad de tokens vendida | quantitySold |
| Monto vendido | Valor financiero vendido | amountSold |
| Totales | Suma de manual + automático | getTotalSoldQuantity / getTotalSoldAmount |
Reglas de negocio / consideraciones
Atención
- El reporte separa compras manuales (registradas por el operador) de compras automáticas (flujo de checkout). Los totales suman ambas.
- La moneda del reporte sigue la configuración del token: usa el código ISO de la moneda (símbolo cuando el ISO es conocido, código cuando es no-ISO) — derivada de
reportCurrencyo delpairdel token.
- Valores financieros: cantidades y montos son tratados con precisión (BigNumber) — sin redondeo; el reporte es de solo lectura y no recalcula liquidaciones.