Módulo de Finanzas
Todo lo que necesitas saber para registrar ingresos, reconciliar payouts a brokers, revisar el desempeño mensual y enviar reportes con branding Hero.
Bienvenida
El módulo de Finanzas es el reemplazo digital del Excel de ingresos que Gilbana mantenía a mano. Centraliza:
- Captura de ingresos con cálculo automático de la ganancia.
- Reconciliación de payouts a brokers (los pagos que Hero reparte a socios externos).
- Dashboard con indicadores clave y gráficos.
- Comparativas mes a mes, por tipo de pago y por broker.
- Exportación a CSV y reporte ejecutivo imprimible.
- Envío de reportes por email a brokers con plantilla Hero Light.
¿Quién puede usarlo?
Solo cuentas con rol finanzas o admin. Actualmente:
- Gilbana Barroso — Finance Support (captura principal)
- Aurys Rodríguez — CFO
- Samuel Ortiz
- Ramón Portillo — Broker Support
- Administradores de IT
Acceso al módulo
- Entra al Hero Hub con tu cuenta corporativa (
@heroinsuranceusa.com). - En la pantalla principal, busca la tarjeta FINANZAS. Si no la ves, tu cuenta no tiene el rol asignado — contacta a IT.
- Haz clic en la tarjeta y llegarás al Dashboard del módulo.
hub.heroinsuranceusa.com/finanzas.html. Igual necesitas iniciar sesión.La pantalla principal
El módulo tiene 6 secciones, accesibles desde el menú lateral izquierdo:
Elementos del encabezado
- Volver al Hub (arriba a la derecha) — regresa al dashboard principal.
- Toggle Día/Noche — cambia entre modo claro y oscuro. Tu preferencia queda guardada.
Registrar un ingreso
Un ingreso representa un depósito de comisión recibido por Hero (típicamente de un carrier). Cada ingreso puede repartirse en uno o varios payouts a brokers externos.
Paso a paso
- Entra a la pestaña Ingresos desde el menú lateral.
- Haz clic en Nuevo ingreso arriba a la derecha.
- Se abre un modal. Completa los campos (ver tabla abajo).
- Agrega los payouts a brokers si corresponden (categoría COMISSION u OVERRIDES).
- Verifica el resumen en tiempo real: Bruto − Pagado = Ganancia.
- Guarda con el botón Guardar ingreso.
Campos del modal
| Campo | Descripción |
|---|---|
| Fecha | Cuándo se recibió el depósito. El "Mes" se auto-calcula. |
| Tipo de pago | LIFE, SUPP, ACA, MEDICARE u OTROS. |
| Categoría | COMISSION (comisión estándar), OVERRIDES (bono) o HERO (queda 100% en Hero). |
| Monto ($) | Monto bruto recibido. |
| Descripción depósito | Nombre del carrier (dropdown editable con opción "+ Agregar nuevo"). |
| Descripción transacción | Referencia del banco. Opcional. |
| Archivo original (URL de Drive) | Link al PDF/reporte que envió el carrier. Opcional. |
| Payouts | Uno por cada broker que recibe una parte. Cada payout: broker, reporte, saldo. |
| Notas | Comentarios internos. Opcional. |
Editar o eliminar un ingreso
- Haz clic en cualquier fila para abrir el modal en modo edición.
- Usa el botón ✎ a la derecha para editar sin abrir la fila.
- Usa el botón ✕ para eliminar (pide confirmación).
Filtros de la lista
Arriba de la tabla puedes filtrar por:
- Periodo: este mes, mes pasado, año actual, año anterior, todo, o rango personalizado.
- Tipo de pago y Categoría.
- Broker: muestra solo los ingresos con payout a ese broker.
- Texto libre: busca en descripción, transacción y notas.
El resumen abajo de la tabla se actualiza automáticamente con los filtros aplicados.
Gestionar Brokers
Los brokers son las personas o entidades externas que reciben payouts. Registrar sus datos aquí facilita:
- Seleccionarlos rápido en el modal de nuevo ingreso.
- Pre-llenar su email al enviarles el reporte.
- Filtrar ingresos por broker.
Agregar un broker
- Ve a la pestaña Brokers.
- Haz clic en Agregar broker.
- Completa nombre (obligatorio), email, teléfono y notas.
- Guarda.
Editar o eliminar
Igual que en Ingresos: click en fila para editar, botón ✕ para eliminar. Eliminar un broker no borra los ingresos históricos que lo referenciaban — el nombre queda como texto en esos payouts.
Tabla de Comisiones
Esta tabla es una referencia de las tasas de comisión que Hero cobra por cada combinación de carrier, origen y agente. Sirve para consulta rápida y verificación cuando se recibe un depósito.
No afecta cálculos automáticos: los ingresos se capturan con el monto real recibido. La tabla es puramente informativa.
Campos
| Carrier | Aseguradora que paga la comisión. |
| Origen | HERO, FRIENDS o AGENTES (fuente de la producción). |
| Agente | Nombre del agente si el origen es AGENTES. |
| Tasa | Porcentaje como decimal. Ej: 1.15 = 115%. |
| Notas | Comentarios de referencia. Opcional. |
Dashboard
Es la primera pantalla al entrar a Finanzas. Da una vista rápida de cómo va el mes/año.
KPIs (los 4 cuadros de arriba)
- Bruto: total de ingresos recibidos en el periodo.
- Pagado: suma de payouts a brokers en el periodo.
- Ganancia: Bruto − Pagado.
- # Ingresos: cantidad de registros.
Gráficos
- Bruto vs Ganancia por mes (líneas) — evolución mensual.
- Distribución por categoría (donut) — cuánto va a COMISSION, OVERRIDES o HERO.
- Top 10 carriers por monto (barra horizontal) — quiénes aportan más.
- Top brokers por payouts (donut) — a quién le pagamos más.
Selector de periodo
Arriba a la derecha puedes elegir: Año actual, Este mes, Mes pasado, Año anterior, Todo o Personalizado (te habilita dos date pickers para elegir rango exacto).
Comparativas
Tres gráficos pensados para análisis más profundo. Cada uno responde una pregunta:
- Bar agrupado Bruto / Pagado / Ganancia por mes — "¿Cómo se comparan mes a mes?"
- Líneas por tipo de pago — "¿Qué producto está creciendo? ¿ACA sube y LIFE baja?"
- Stacked bar de payouts por broker — "¿Qué brokers pesan más en cada mes?"
Todos aceptan el selector de periodo con la opción "Personalizado" para rangos exactos.
Exportar
Tres formas de sacar los datos afuera de la aplicación:
CSV de Ingresos
13 columnas con toda la info de cada ingreso. Se abre en Excel/Google Sheets. Incluye BOM UTF-8 para que las tildes se vean bien.
CSV de Payouts
8 columnas, una fila por cada payout. Útil para cruzar contra los reportes que envían los brokers.
Reporte ejecutivo
Abre una vista optimizada para imprimir o guardar como PDF (desde Archivo → Imprimir → Guardar como PDF). Incluye KPIs + tabla mes a mes con branding Hero Light.
Enviar reportes por email a brokers
El módulo permite enviar el detalle del payout directamente al broker desde la Lista de Ingresos. El email se envía desde Hero Finanzas <financesupport@heroinsuranceusa.com> con plantilla Hero Light.
Dónde está el botón
En la Lista de Ingresos, columna de acciones a la derecha. Si el ingreso tiene payouts, verás el botón ✉ junto a ✎ y ✕.
Caso 1: el ingreso tiene UN solo payout
- Click en ✉ → se abre un mini-diálogo.
- Muestra: descripción del ingreso, broker, monto del payout.
- Un campo "Enviar a" pre-llenado con el email del broker (si existe). Puedes cambiarlo.
- Click en Enviar → el email sale.
- Verás un mensaje verde de éxito y el modal se cierra solo.
Caso 2: el ingreso tiene 2 o más payouts
- Click en ✉ → se abre un modal grande con todos los payouts listados.
- Cada fila muestra: broker, input editable de email, monto, estado, botón Enviar.
- Envías uno a la vez. Cada envío es independiente.
- Los payouts ya enviados quedan marcados con "Enviado · fecha". El botón cambia a "Reenviar".
¿A qué email va?
El email destinatario es siempre lo que esté escrito en el campo "Enviar a" al momento del envío. Puedes:
- Dejarlo tal cual si el broker está registrado y el email es correcto.
- Cambiarlo si quieres enviarlo a otro destinatario (por ejemplo, al asistente del broker, o a tu propio correo para revisarlo primero).
- Escribirlo desde cero si el broker no tiene email registrado.
El email que uses queda registrado en el payout como emailSentTo, así puedes ver a quién le enviaste efectivamente.
¿Qué contiene el email?
Plantilla con branding Hero Light:
- Logo y encabezado cyan.
- Saludo con el nombre del broker.
- Detalle de la comisión (fecha, tipo, categoría, monto total).
- Bloque destacado con el monto de su payout.
- Archivo de reporte mencionado (si estaba registrado).
- Firma indicando quién lo envió.
¿Puedo reenviar?
Sí. Un payout marcado como enviado sigue permitiendo reenvíos — el botón cambia a "Reenviar". Cada reenvío queda registrado en el audit log con su fecha.
Rastro y auditoría
Cada envío queda registrado en dos lugares:
- En el ingreso mismo: se marca
emailSentAtyemailSentToen el payout enviado. - En el audit log del Hub: acción
finanzas.email.send, incluye quién envió, a qué broker, en qué ingreso.
Preguntas frecuentes
El broker no tiene email registrado. ¿Puedo enviarle el reporte igual?
El email no llegó al broker. ¿Qué hago?
- ¿Está bien escrito el email? (revisa mayúsculas, puntos, dominio).
- ¿El broker revisó su carpeta de spam?
- ¿Recibiste tú un mensaje de error en el modal al enviar?
Ya envié un reporte y me di cuenta de que estaba mal. ¿Puedo corregirlo?
- Editar el ingreso o el broker con la información correcta.
- Reenviar el reporte al mismo destinatario (el botón se llamará "Reenviar").
- Opcionalmente, mandarle un email manual al broker explicando el ajuste.
No aparece el botón ✉ en un ingreso.
El botón ✉ está verde en algunos ingresos. ¿Qué significa?
¿Los cambios se guardan automáticamente?
¿Puedo trabajar dos personas al mismo tiempo?
Estoy en modo oscuro y no me gusta. ¿Cómo lo cambio?
¿Se puede recuperar un ingreso que borré por error?
¿Qué pasa si me quedo sin internet mientras registro un ingreso?
Contacto
Si algo no funciona como esperas, si necesitas que se agregue una función, o si simplemente tienes una duda: