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.
Lancer gratuitement
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.
Cas d’usage
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.
Questions fréquentes
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.
Pour les développeurs — accès API
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.
Endpoint
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é.
Appeler depuis votre stack
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}'const res = await fetch("https://api.kit.forhosting.com/biz/pto-accrual-calc", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"accrual_rate": 3.5,
"pay_periods_elapsed": 12
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/biz/pto-accrual-calc",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"accrual_rate": 3.5,
"pay_periods_elapsed": 12
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/pto-accrual-calc", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"accrual_rate":3.5,"pay_periods_elapsed":12}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"accrual_rate":3.5,"pay_periods_elapsed":12}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/pto-accrual-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"accrual_rate": 3.5,
"pay_periods_elapsed": 12
}Exemple de réponse
{
"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.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |