Calculateur salaire-heures

Un taux horaire négatif est rejeté avec une erreur claire invalid_input, car un salaire négatif ne décrit pas un calcul de brut valide.

Entrées : heures travaillées, taux horaire, multiplicateur extra et seuil optionnel

Les décomptes d'heures négatifs, les multiplicateurs négatifs et les seuils négatifs sont aussi rejetés afin qu'une inversion accidentelle de signe échoue bruyamment au lieu d'inventer des négatifs absurdes sur un bulletin. Toute la validation a lieu avant toute mathématique monétaire, si bien que les requêtes incorrectes ne produisent jamais de lignes de paie à moitié remplies. Vous envoyez le total d'heures, non une scission préalable du régulier versus l'extra : le calculateur opère cette scission à partir du seuil que vous avez choisi ou de la valeur par défaut de quarante. Envoyez un corps JSON avec trois champs obligatoires et un plafond optionnel. hours_worked est le temps total à l'horloge de la fenêtre de paie, nombre fini non négatif ou chaîne numérique ; les alias hours, hrs, total_hours et weekly_hours sont acceptés lorsque votre client nomme déjà le champ autrement. hourly_rate est le salaire de base par heure, nombre fini non négatif ou chaîne numérique ; les alias rate, wage, hourly et pay_rate se mappent sur la même valeur afin que les constructeurs de formulaires conservent des libellés familiers. overtime_multiplier est la prime exprimée comme un multiple du taux de base —par exemple 1.5 signifie temps et demi et 2 signifie double temps—, non un pourcentage du salaire ; les alias multiplier, ot_multiplier, ot_rate et premium se mappent sur le même champ. overtime_threshold est optionnel et vaut quarante heures par défaut, le plafond hebdomadaire courant du temps de base ; les alias threshold, ot_threshold, regular_limit et cutoff vous laissent nommer une règle quotidienne de huit heures ou un plafond hebdomadaire local sans changer le reste du contrat. Les taux horaires négatifs échouent à la validation avec invalid_input parce qu'ils ne décrivent pas une fiche de paie normale. Les taux, totaux d'heures, multiplicateurs ou seuils extrêmement grands sont plafonnés pour que la mathématique du Worker isolate reste bornée. L'absence de tout champ obligatoire échoue avec invalid_input en nommant la clé manquante.

Comment les heures extra, la paie extra et le brut sont calculés

Les formules centrales sont celles que l'on utilise déjà à la main sur une feuille de temps, sauf que la scission des heures extra est faite pour vous. Le brut est la somme de ces deux lignes. Les produits intermédiaires utilisent l'arithmétique flottante ordinaire ; ensuite chaque champ monétaire est arrondi half-up à deux décimales pour que les résultats ressemblent à de la monnaie sur un bulletin plutôt qu'à de longues fractions binaires. Exemple : un taux de vingt, quarante-huit heures travaillées, un multiplicateur de 1.5 et le seuil par défaut de quarante donnent quarante heures régulières, huit extra, huit cents de paie régulière, deux cent quarante d'extra, un taux extra effectif de trente et un brut de mille quarante après arrondi. Si les heures restent au seuil ou en dessous, les heures extra et la paie extra valent zéro et le brut est simplement le taux fois les heures. Une mathématique égale pour toute juridiction est un périmètre de produit volontaire : tables légales, règles du septième jour et retenue fiscale seraient d'autres intentions de recherche et d'autres contrats. Les heures régulières égalent le plus petit entre hours_worked et overtime_threshold. Les heures extra égalent le plus grand entre hours_worked moins le seuil et zéro. La paie régulière égale hourly_rate fois les heures régulières. La paie extra égale hourly_rate fois overtime_multiplier fois les heures extra. La réponse renvoie aussi ot_hourly_rate comme hourly_rate fois le multiplicateur afin que les interfaces montrent le salaire extra effectif à côté du taux de base. La réponse répète le taux horaire normalisé, hours_worked, overtime_threshold et overtime_multiplier, puis renvoie les heures régulières, les heures extra, ot_hourly_rate, regular_pay, overtime_pay et gross_pay, plus currency_decimals égal à deux et method égal à hours_pay_gross pour un branchement client stable. Des entrées identiques produisent toujours un JSON identique, car le chemin est de l'arithmétique pure sans réseau, sans graine aléatoire et sans horloge murale.

Usage de l'API, tarification, flux de travail et limites pratiques

Utilisez l'API prépayée lorsqu'un bot RH, un tableau de freelancing, un portail de personnel ou un aide-feuille de temps a besoin d'un contrat KIT stable à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde après le rejet du moteur. Les auteurs qui livrent des SDK peuvent mapper regular_pay, overtime_pay et gross_pay directement dans des interfaces de bulletin et des messages d'estimation. Lorsque vous citez le prix de l'API dans le texte produit, utilisez l'espace réservé de catalogue $0.002 afin que les pages publiées restent alignées sur le plancher de prix en direct.