Estimation simplifiée du salaire net

Si les trois pourcentages dépassent cent pour cent, la requête échoue avec invalid_input au lieu d'inventer une fiche de paie négative. La même arithmétique pure alimente l'outil gratuit du navigateur et le chemin API payant, de sorte que les aperçus de landing et les automatisations de production ne divergent jamais sur un net à deux décimales.

Ce que signifie le net simplifié et comment le calcul fonctionne

Cette capacité met en œuvre exactement ce modèle simplifié : traiter chaque entrée comme un pourcentage du brut, convertir chaque pourcentage en montant monétaire, sommer les montants dans total_withheld et fixer net_pay égal à gross_pay moins total_withheld. De façon équivalente, net_pay égale le brut multiplié par un moins total_withholding_pct sur cent. La réponse reprend chaque entrée, rapporte total_withholding_pct, les trois montants de ligne, total_withheld, net_pay et un take_home_ratio entre zéro et un pour que les graphiques montrent la part conservée sans diviser à nouveau.

Contrat d'entrée, forme de la réponse et erreurs

Exemple : brut cinq mille, impôt vingt, retraite cinq, assurance trois produit une retenue totale de vingt-huit pour cent, impôt mille, retraite deux cent cinquante, assurance cent cinquante, total retenu mille quatre cents et net trois mille six cents. Associez la répartition à votre propre moteur d'impôt progressif si vous avez besoin de retenues légales ; commencez ici lorsque la question produit est une estimation transparente à taux plat pour démos d'UI, fiches de coaching ou calculateurs d'offre. Envoyez en POST un corps JSON avec quatre nombres finis obligatoires : gross_pay (unités monétaires de la période de paie, supérieur ou égal à zéro ; alias gross, salary, pay), tax_pct (pourcentage d'impôt plat, par exemple vingt pour vingt pour cent ; alias tax, tax_percent, tax_rate), retirement_pct (pourcentage de cotisation retraite ; alias retirement, retirement_percent, pension_pct) et insurance_pct (pourcentage de retenue d'assurance ; alias insurance, insurance_percent, health_pct). Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique. Champs manquants, chaînes vides, valeurs non finies et négatifs échouent avec invalid_input en nommant le champ et ne sont pas facturés. Après analyse, le gestionnaire additionne les trois pourcentages ; si cette somme dépasse cent pour cent, il échoue avec un message indiquant que les pourcentages de retenue dépassent cent pour cent—encore invalid_input, pas un succès avec un net négatif. En cas de succès le corps inclut gross_pay, tax_pct, retirement_pct, insurance_pct, total_withholding_pct, tax_amount, retirement_amount, insurance_amount, total_withheld, net_pay, take_home_ratio et une courte chaîne de formule qui reformule le modèle.

Où une API d'estimation du salaire net apporte de la valeur

Les outils d'intégration RH et les générateurs de lettres d'offre peuvent appeler le même module pur depuis le navigateur pour des aperçus gratuits et depuis l'API lors de l'enregistrement de scénarios, garantissant que le net vu par un candidat sur la landing coïncide avec le net stocké après sauvegarde. Comme l'implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.