Estimación simplificada del salario neto

Si los tres porcentajes suman más del cien por ciento, la solicitud falla con invalid_input en lugar de inventar una nómina negativa. La misma aritmética pura alimenta la herramienta gratuita del navegador y la ruta API de pago, de modo que las vistas previas de la landing y las automatizaciones de producción nunca discrepan en un neto a dos decimales.

Qué significa el neto simplificado y cómo funciona el cálculo

Esta capacidad implementa exactamente ese modelo simplificado: trata cada entrada como un porcentaje del bruto, convierte cada porcentaje en un importe monetario, suma los importes en total_withheld y define net_pay como gross_pay menos total_withheld. De forma equivalente, net_pay es el bruto multiplicado por uno menos total_withholding_pct entre cien. La respuesta repite cada entrada, informa total_withholding_pct, los tres importes de línea, total_withheld, net_pay y un take_home_ratio entre cero y uno para que los gráficos muestren la parte retenida sin dividir de nuevo.

Contrato de entrada, forma de la respuesta y errores

Ejemplo: bruto cinco mil, impuestos veinte, jubilación cinco, seguros tres produce retención total del veintiocho por ciento, impuestos mil, jubilación doscientos cincuenta, seguros ciento cincuenta, total retenido mil cuatrocientos y neto tres mil seiscientos. Combine el desglose con su propio motor de impuestos progresivos si necesita retenciones legales; comience aquí cuando la pregunta de producto sea una estimación transparente a tasa plana para demos de UI, hojas de coaching o calculadoras de ofertas. Envíe por POST un cuerpo JSON con cuatro números finitos obligatorios: gross_pay (unidades monetarias del período de pago, mayor o igual que cero; alias gross, salary, pay), tax_pct (porcentaje plano de impuestos, por ejemplo veinte para el veinte por ciento; alias tax, tax_percent, tax_rate), retirement_pct (porcentaje de aportación a la jubilación; alias retirement, retirement_percent, pension_pct) e insurance_pct (porcentaje de retención de seguros; alias insurance, insurance_percent, health_pct). Cada campo puede llegar como número JSON o como cadena numérica. Campos ausentes, cadenas vacías, valores no finitos y negativos fallan con invalid_input nombrando el campo y no se facturan. Tras el análisis, el manejador suma los tres porcentajes; si esa suma supera el cien por ciento, falla con un mensaje de que los porcentajes de retención superan el cien por ciento—de nuevo invalid_input, no un éxito con neto negativo. En caso de éxito el cuerpo incluye gross_pay, tax_pct, retirement_pct, insurance_pct, total_withholding_pct, tax_amount, retirement_amount, insurance_amount, total_withheld, net_pay, take_home_ratio y una cadena de fórmula breve que reexpresa el modelo.

Dónde una API de estimación de salario neto aporta valor

HH. y los generadores de cartas de oferta pueden llamar al mismo módulo puro desde el navegador para previsualizaciones gratuitas y desde la API al guardar escenarios, garantizando que el neto que un candidato vio en la landing coincida con el neto almacenado tras guardar el escenario. Como la implementación es parse pura de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente.