ForHosting KIT · Outils pour développeurs

Calcul du solde de congés acquis avec plafond

Ce calculateur transforme un taux d'acquisition par période de paie en solde actuel de congés.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez la quantité acquise à chaque période et le nombre de périodes achevées. Si votre politique limite le solde conservé, indiquez ce plafond. La réponse présente aussi le montant sans plafond et précise si la limite a modifié le solde final, afin que vous puissiez expliquer, contrôler et réutiliser facilement le calcul.

Traduisez la politique d'acquisition en données fiables

Commencez par le taux indiqué dans la politique de congés. Il peut être exprimé en heures par semaine, quinzaine, demi-mois ou mois, ou en jours si l'organisation suit toujours les absences en jours. Saisissez ce taux, puis comptez uniquement les périodes réellement achevées à la date étudiée. Le calculateur multiplie ces valeurs : elles doivent donc reposer sur la même périodicité. Un taux bimensuel doit être associé à des périodes bimensuelles, et non à des mois civils. Les fractions sont admises lorsqu'une règle prévoit un prorata, mais elles doivent provenir de cette règle officielle. Ne mélangez pas heures et jours, car le résultat conserve l'unité du taux. L'outil ne déduit ni calendrier, ni date d'embauche, ni cycle de paie. Les hypothèses restent ainsi visibles et les équipes RH ou paie fournissent le décompte reconnu par la politique.

Interprétez les soldes plafonné et non plafonné

Le solde non plafonné est le taux multiplié par les périodes écoulées. Sans maximum, ce produit constitue également le solde acquis et l'indicateur de plafond reste faux. Si vous indiquez un maximum, le calculateur compare les deux montants. Lorsque le produit est supérieur, le solde final est ramené au plafond et l'indicateur devient vrai. Le montant initial demeure dans la réponse afin de montrer ce qui aurait été acquis sans restriction. Si le produit égale exactement le maximum, aucune réduction n'a eu lieu : l'indicateur reste donc faux, même si la limite est atteinte. Un plafond nul est valable, comme un taux ou un nombre de périodes nul. Seul le bruit numérique insignifiant est supprimé ; aucune règle d'arrondi propre à la paie n'est imposée. Appliquez la règle de votre organisation avant l'envoi ou après réception.

Intégrez le résultat aux processus de paie

Considérez le solde acquis comme un point de contrôle, et non comme un registre complet. Un véritable registre peut aussi nécessiter un solde initial, les congés consommés, des corrections, des reports, des délais de carence et des interruptions d'acquisition. Cette capacité ne les invente pas : elle répond à une question précise, à savoir combien un taux fixe produit sur un nombre donné de périodes, sous réserve d'un plafond facultatif. Elle convient aux feuilles de calcul, estimations d'embauche, rapprochements de paie, comparaisons de politiques et audits automatisés. Conservez les entrées avec le résultat pour permettre sa reproduction et la vérification de la version de la politique. Chaque requête automatisée coûte $0.002. Les taux négatifs sont refusés ; comptabilisez séparément les consommations et corrections. En cas de changement de taux, calculez chaque segment puis combinez-les selon la politique.

Contrôler l'acquisition actuelle

Multipliez le taux par les périodes achevées et vérifiez si le maximum limite le résultat.

Rapprocher les calculs de paie

Comparez la paie avec le montant non plafonné, le solde final et l'indicateur de limite.

Modéliser une politique de congés

Testez des taux et plafonds sur un nombre choisi de périodes sans créer de formule de tableur.

Quel est le coût du calcul ?

Chaque requête API coûte $0.002. Une requête correspond à un élément.

Quelle unité le résultat utilise-t-il ?

Il conserve l'unité du taux : des heures produisent des heures et des jours produisent des jours.

Que se passe-t-il si le plafond est dépassé ?

Le solde final prend la valeur maximale, cap_applied devient vrai et uncapped_balance conserve le produit initial.

Le taux peut-il être négatif ?

Non. Un taux négatif produit une erreur de saisie. Enregistrez les consommations dans une opération distincte.

Les fractions de période sont-elles admises ?

Oui, si la politique applique un prorata et si la fraction respecte sa règle.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/biz/pto-accrual-calc

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/biz/pto-accrual-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accrual_rate":3.5,"pay_periods_elapsed":12}'
{
  "accrual_rate": 3.5,
  "pay_periods_elapsed": 12
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.pto_accrual_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →