Configuración de comisiones
Requisitos previos de acceso
- Permiso (módulo):
manageCommissions(la pantalla es visible conviewCommissionsOmanageCommissions; para crear/eliminar es necesario el módulo de gestión) - Licencia/Feature: Ninguna
- Contenedor del menú: GENERAL → grupo Comisiones y Recompensas
Qué es / cuándo usar
Esta pantalla define la tabla de comisiones multinivel de la plataforma: para cada nivel de la cadena de referidos se registra un valor (en porcentaje) que se distribuirá automáticamente cuando un usuario final ejecute una acción generadora de comisión (depósito, compra, orden, etc.).
El modelo funciona en cascada: el nivel 1 es el referido directo del usuario que ejecutó la acción; el nivel 2 es quien refirió a ese referido; y así sucesivamente. Cada nivel tiene su propio porcentaje. Use esta pantalla cuando necesite crear la estructura de bonificación por referidos o ajustar los porcentajes de cada peldaño.
Requisitos previos
- Permiso:
manageCommissionsregistrado para el rol del operador (recordar: el permiso es doble — enum CPM en el backend + módulo dinámico en la BD). Sin el módulo de gestión, la pantalla se abre en modo lectura y los botones de crear/eliminar no aparecen. - Licencia/Feature: Ninguna específica.
- Dependencias de otras pantallas: la cadena de referidos se forma cuando los usuarios se registran usando el código de referido de otro usuario. La configuración de niveles aquí solo tiene efecto práctico si existen cadenas de referidos reales.
Paso a paso
- Acceda al menú Comisiones y Recompensas → Configuración de comisiones (
/manage-commissions). - La tabla lista los niveles ya configurados (ordenados por número de nivel) con las columnas Nivel y Valor.
- Haga clic en Nuevo para abrir el modal de creación de nivel.
- Ingrese el Nivel (entero ≥ 1) y el Valor (porcentaje > 0) y confirme.
- Para eliminar un nivel, use el ícono de papelera en la fila correspondiente y confirme en el pie.
Campos
| Campo | Qué es | ¿Obligatorio? | Efecto en el sistema/backend |
|---|---|---|---|
Nivel (level_id) | Posición en la cadena de referidos (1 = referido directo, 2 = referido del referido, …) | Sí | Clave de configuración en CustomerProfileService (CPM). Es la PK lógica del nivel — crear un nivel ya existente actualiza/colisiona; la eliminación usa este número. El modal valida level >= 1. |
Valor (amount) | Porcentaje de comisión pagado a los usuarios de ese nivel | Sí | Porcentaje absoluto aplicado sobre la base de cálculo de la operación generadora. El modal valida, mediante BigNumber, que el valor sea mayor que 0. Se persiste como configuración de nivel en el CPM y es consumido por el motor de comisiones multinivel al procesar una acción. |
Acciones y modales
- Nuevo: abre el modal
Crear comisión. Requiere Nivel y Valor completados; el botón de confirmar solo se habilita cuandolevelestá definido yamount > 0(validación BigNumber). Al guardar, llama acreateCommissionsConfigurationy recarga la lista. - Eliminar (papelera): abre una hoja de confirmación (bottom-sheet). Al confirmar, llama a
deleteCommissionConfiguration(level_id)y recarga la lista.
Reglas de negocio / consideraciones
Atención
- El valor es un porcentaje, no un monto monetario fijo. Se aplica sobre la base de la operación que dispara la comisión.
- El número de nivel es la identidad del registro: registrar un nivel duplicado puede sobrescribir la configuración existente. Mantenga la secuencia (1, 2, 3, …) sin huecos para que la cascada funcione como se espera.
- Esta tabla no paga comisiones por sí sola — solo define los porcentajes. La generación efectiva ocurre cuando una acción del usuario final dispara el motor multinivel; los asientos resultantes aparecen en Pago de comisiones.
- Valores financieros: el porcentaje y los valores derivados se tratan como BigNumber — sin redondeo en la interfaz; verifique los decimales al auditar pagos.
- Interacción con el spread de la casa: en operaciones de mercado, la comisión multinivel coexiste con el spread/ingreso de la casa. El costo de la comisión debe dimensionarse considerando el margen de la operación para no comprometer el ingreso.