Calculadora de necesidades de seguro de vida

Qué significa la estimación de cobertura estilo DIME

Muchos hogares ya mantienen un único total de deudas pendientes que agrupa hipoteca y préstamos educativos en una sola partida, por lo que esta capacidad usa un contrato simplificado: annual_income, years_of_replacement y outstanding_debts. Los años de reposición deben ser estrictamente positivos: cero o negativos no definen un horizonte significativo y se rechazan como invalid_input. En caso de éxito la respuesta repite las tres entradas, informa income_replacement y recommended_coverage redondeados a dos decimales para comparaciones estables de tipo moneda, e incluye una etiqueta de método y una cadena de fórmula que puede mostrar junto a la respuesta.

Contrato de entrada, forma de la respuesta y errores

Ejemplo: setenta y cinco mil de ingreso anual, diez años de reposición y cincuenta mil de deudas dan setecientos cincuenta mil de reposición de ingresos y ochocientos mil de cobertura recomendada. La validación fallida no se factura. Envíe por POST un cuerpo JSON con tres números finitos obligatorios. annual_income es el ingreso bruto anual a reponer; se aceptan los alias income, yearly_income y salary para que formularios y hojas reutilicen nombres de columna habituales. years_of_replacement es el horizonte en años; los alias years, replacement_years e income_years mapean al mismo campo, y el valor debe ser mayor que cero o la tarea falla con invalid_input nombrando years_of_replacement. outstanding_debts es la suma de obligaciones que desea que la póliza liquide —resto de hipoteca, préstamos de auto, tarjetas, préstamos personales— con alias debts, total_debt y debt. Cada campo puede llegar como número JSON o cadena numérica; campos ausentes, cadenas vacías y valores no finitos fallan con invalid_input. annual_income u outstanding_debts negativos se rechazan porque en este modelo la estimación de cobertura no puede partir de una base de ingresos o de deudas negativa. Cuando la validación pasa, el cuerpo devuelve annual_income, years_of_replacement, outstanding_debts, income_replacement (ingresos por años), recommended_coverage (income_replacement más deudas), method con etiqueta estilo DIME y formula que reexpresa la forma cerrada. La ruta parse pura nunca llama a una API de aseguradora, no muestrea aleatoriedad y no depende del reloj del sistema, de modo que los goldens y las pruebas de cliente comparan byte a byte entre runtimes cuando fijan las mismas tres entradas.

Dónde aporta valor una API de necesidades de seguro de vida

Los hogares usan una calculadora de necesidades de seguro de vida cuando un salario nuevo, la compra de una vivienda o un hijo obligan a la primera conversación sobre cuánta cobertura mantendría enteros a los dependientes si cesaran los ingresos. Coaches y formadores financieros necesitan un oráculo determinista que marque como inválidos los años de reposición no positivos en lugar de devolver en silencio cobertura cero que un formulario defectuoso podría tratar como éxito. Los equipos de producto integran el mismo contrato en asistentes de alta para que el usuario vea un capital asegurado inicial antes de que un suscriptor o agente lo refine. Como la implementación es parse pura de tier A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente. Mantenga las peticiones pequeñas, fije en las pruebas los valores redondeados de recommended_coverage y obtendrá estimaciones reproducibles para hojas, plugins LMS y workers de borde sin montar infraestructura actuarial propia. Cuando más adelante añada costes educativos o un campo hipotecario separado en una hoja, incluya esos saldos en outstanding_debts aquí para que el total estilo DIME siga alineado con el mnemotécnico completo mientras la superficie de la API sigue siendo de tres campos.