Saldos — Tokenización
Requisitos previos de acceso
- Permiso (módulo):
manageCorporateAccount - Licencia/Feature: Ninguna.
- Contenedor del menú: GENERAL → grupo Dashboard → Saldos (pestaña Tokenización)
Qué es / cuándo usar
Pestaña del panel de Saldos dedicada a los tokens emitidos por la plataforma (tokens de tokenización, distintos de los criptoactivos de mercado). Muestra cuántos usuarios son tenedores de cada token, el total en unidades, el equivalente en moneda fiduciaria y el movimiento mensual — la visión patrimonial de "cuánto de la casa está representado en tokens emitidos".
Filtros y columnas
Pantalla de visualización — sin campos editables.
| Indicador / Gráfico | Qué muestra | Origen del dato |
|---|---|---|
| Cantidad de tenedores | N.º de usuarios con posesión del token | numberUsersInPossession (sumado por token) |
| Total en tokens | Suma de las unidades emitidas en posesión | totalInCrypto por token |
| Total en fiduciario | Equivalente en fiat (unidades × cotización USD) | totalInCrypto × quotations.amountUsd |
| Movimiento mensual | Monto movido por mes, por token | monthlyMovement × cotización; serie en allTokensMovementsByMonth |
| Tenedores por token | Distribución de tenedores entre los tokens | agregación por activo |
Reglas de negocio / consideraciones
Atención
- El total en fiduciario usa cotización USD. Sin cotización registrada para el token, el multiplicador cae a 1 y el "total en fiduciario" queda igual al total en unidades — lo que distorsiona el consolidado. Verifique siempre las cotizaciones vigentes.
- El saldo nunca es cero por defecto: ausencia de valor = estado de carga o error del servicio, no saldo real igual a cero.
- Valores financieros: todas las multiplicaciones por cotización y sumas se realizan en
BigNumber, sin redondeo intermedio. Verifique los decimales por token.