Plan Financiero
Un plan financiero es el mapa de ruta personalizado de Ozzie para un usuario. Responde la pregunta: "Dado lo que gano, lo que gasto y lo que quiero — ¿cómo llego allí y cuánto tiempo tomará?"
Entradas
El plan se calcula a partir de tres fuentes:
| Entrada | Fuente | Requerido |
|---|---|---|
| Ingresos y gastos mensuales | POST /financial-intake | ✅ Sí |
| Objetivo financiero (tipo + monto) | POST /goals | ✅ Sí |
| Perfil de personalidad | POST /personality | Opcional (mejora la calidad) |
Debes enviar el intake financiero antes de generar un plan. Si falta el intake, la API devuelve INTAKE_REQUIRED.
Qué contiene un plan
{
"timeline_months": 14,
"allocations": {
"needs": 0.60,
"wants": 0.20,
"savings": 0.15,
"debt": 0.05
},
"key_metrics": {
"monthly_savings_target": 750,
"projected_goal_date": "2025-07-01",
"savings_rate_pct": 15
},
"action_items": [
"Reduce las comidas fuera de casa para liberar $120/mes",
"Configura transferencia automática de $750 el día de pago",
"Construye un fondo de emergencia de 3 meses antes de invertir"
]
}
timeline_months
Cuántos meses hasta que el usuario alcance su meta a la tasa actual de ahorro/pago.
allocations
Un desglose porcentual de cómo debe distribuirse el ingreso del usuario entre cuatro grupos. Estos son objetivos — no restricciones.
| Grupo | Significado |
|---|---|
needs | Gastos fijos no negociables (alquiler, servicios, comida) |
wants | Gastos discrecionales (entretenimiento, comer fuera) |
savings | Yendo hacia la meta |
debt | Pagos mínimos + extra de deuda |
key_metrics
Proyecciones calculadas: meta de ahorro mensual, fecha estimada de cumplimiento de la meta, tasa de ahorro actual, etc.
action_items
Recomendaciones específicas y priorizadas generadas por la IA de Ozzie basadas en los números reales del usuario.
Cuándo regenerar un plan
Regenera el plan cuando:
- El usuario envíe un nuevo intake financiero (ingreso cambió, se agregó un gasto importante)
- El usuario cambie su meta
- El usuario complete su evaluación de personalidad
- Ha pasado tiempo significativo (actualización mensual es un buen estándar)
Simplemente llama a POST /plan de nuevo — siempre usa el intake y la meta más recientes.
Plan vs realidad
El plan es el objetivo. Las transacciones revelan el comportamiento real. Con el tiempo, el coach de chat los compara:
"Tu plan dice gastar $800 en comida este mes. Has registrado $1.200 en transacciones de comida hasta ahora."
Esta comparación solo funciona si alimentas transacciones regularmente — por eso el endpoint de Transacciones es tan importante junto con el plan.