Salaire minimum réel

Ce que mesure le salaire minimum réel et comment la formule d’IPC fonctionne

Un salaire minimum publié est un chiffre nominal : c’est le nombre écrit sur une loi, un arrêté salarial ou une fiche de paie.

Contrat d’entrée, statut optionnel de l’année de base et règles de validation

Chaque salaire et chaque IPC doit être strictement supérieur à zéro : un indice de prix nul ou négatif rendrait le salaire réel indéfini ou sans sens, et un salaire légal non positif est rejeté pour le même domaine pédagogique. Omettez le salaire de base optionnel et ces quatre clés de comparaison sont omises, jamais null. Envoyez en POST un corps JSON avec trois nombres finis obligatoires : nominal_wage (le plancher légal ou publié de l’année du salaire), cpi (l’indice des prix à la consommation de cette même année) et cpi_base (l’indice des prix à la consommation de l’année aux prix de laquelle vous voulez exprimer le salaire). Envoyez éventuellement base_nominal_wage comme le statut publié à l’année de base — même monnaie et même période de paie que nominal_wage — et decimals comme entier de zéro à douze (défaut six) pour contrôler l’arrondi half-up sur chaque champ calculé. Les champs manquants, les chaînes vides, les valeurs non finies et les decimals non entiers hors plage échouent avec invalid_input et ne sont pas facturés. Les alias courants sont acceptés : wage, minimum_wage, nominal ou hourly_wage pour nominal_wage ; cpi_current, price_index ou cpi_wage pour cpi ; base_cpi, cpi_reference ou reference_cpi pour cpi_base ; base_wage ou reference_wage pour base_nominal_wage. En cas de succès le corps renvoie les entrées en écho (arrondies), inflation_factor comme cpi sur cpi_base, price_ratio comme cpi_base sur cpi, real_wage comme le nominal multiplié par ce rapport, purchasing_power_index comme cent fois le rapport, purchasing_power_change_percent comme l’écart en pourcentage entre le salaire réel et la valeur faciale, purchasing_power_band comme eroded, unchanged ou increased, et formula. Lorsque base_nominal_wage est présent, le corps inclut aussi cet ancien statut, real_change_amount, real_change_percent par rapport à l’ancien statut, et real_wage_band comme real_gain, real_unchanged ou real_loss. Exemple : nominal dix, cpi cent vingt et cpi_base cent donne real_wage huit et un tiers et purchasing_power_band eroded. Ajoutez base_nominal_wage huit et le statut montre encore un gain réel même si les prix ont monté.

Où une API de salaire minimum réel justifie son usage

Les cours d’économie du travail et de finances publiques utilisent un calculateur du salaire minimum réel pour que les étudiants convertissent tout plancher légal valide et une paire d’IPC en pouvoir d’achat à prix constants sans emprunter un taux d’inflation composé qu’on ne leur a jamais donné et sans confondre l’identité avec un déflateur du PIB ou un convertisseur heure–salaire. Les générateurs d’examens et les plugins LMS ont besoin d’un oracle déterministe qui rejette les indices nuls ou négatifs au lieu d’inventer un salaire réel creux qu’un correcteur buggé pourrait traiter comme inchangé. Une validation en échec ne consomme pas de solde. Les tableaux de bord pédagogiques et les carnets reconstruisent souvent de longues histoires légales à partir d’arrêtés salariaux publiés et d’un IPC national ; figer l’arithmétique dans une petite API parse évite la dérive des tableurs dans la colonne de salaire réel et rend la bande optionnelle de gain réel vérifiable en intégration continue. 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. Gardez les requêtes petites, figez dans les tests le real_wage arrondi et, lorsque vous envoyez un statut d’année de base, real_change_percent, et vous obtenez des planchers à prix constants reproductibles pour les devoirs, les plugins LMS et les workers en périphérie sans monter vous-même un pipeline complet de millésimes d’IPC.