Réconciliation des primes
Maintient les lignes de primes des relevés ouverts en accord avec la configuration des primes actuellement en vigueur.
Vue d’ensemble
Les lignes de primes — les enregistrements automatiques produits par les politiques de primes et par l’activité horaire des conditions d’emploi — sont normalement écrites lorsqu’un jour (ou sa semaine) est saisi ou modifié. Une modification de la configuration ne réécrit pas les jours déjà passés : changer une prime en cours de période laissait donc la période à moitié remplie — les jours antérieurs au changement conservaient leurs anciennes lignes, les jours suivants n’en recevaient aucune, et le reste ne se mettait à jour que si quelqu’un les modifiait par hasard.
Approuver une telle période figeait un total ne correspondant ni à l’ancienne ni à la nouvelle configuration — et pour une activité de prime qui alimente la paie, c’est ce total qui est versé.
Ce travail supprime cet écart. Il recalcule les lignes de primes de chaque relevé encore ouvert, de sorte qu’une modification faite aujourd’hui apparaisse aussi sur les jours déjà saisis de la période en cours.
Fonctionnement
- Sélectionne les candidats — les relevés encore ouverts (en attente, prêt ou en retard) dont la période a commencé. Les espaces de travail sans aucune activité de prime sont ignorés d’emblée.
- Ignore les non concernés — un employé sans politique de primes applicable, sans activité horaire sur ses conditions et sans ligne de prime existante dans la période n’a rien à réconcilier et est ignoré sans traitement supplémentaire.
- Réévalue les jours — chaque jour restant est recalculé exactement comme si l’employé le modifiait, de sorte que les politiques de primes (règles et compteurs) et l’activité horaire des conditions se comportent de la même manière.
- N’écrit que ce qui a changé — les jours dont le résultat est identique ne sont pas touchés : une exécution sur un système inchangé n’écrit donc rien du tout.
Les suppressions comme les ajouts sont pris en charge : une prime qui ne s’applique plus voit ses lignes supprimées, et une prime réactivée voit ses lignes manquantes créées sur toute la période ouverte.
Seuls les jours appartenant à un relevé ouvert sont réconciliés. Les employés dont les conditions d’emploi n’utilisent pas l’approbation des relevés n’ont aucun relevé : leurs lignes de primes ne sont donc pas couvertes par ce travail.
Les relevés soumis et approuvés ne sont jamais touchés
Le travail n’écrit que dans les relevés encore ouverts. Un relevé soumis ou approuvé conserve les totaux figés au moment de sa remise — le travail ne les réécrit jamais et ne réouvre jamais un relevé. Il en va de même jour par jour : dans une semaine à cheval sur deux périodes, seuls les jours de la période ouverte sont recalculés.
Si une prime est corrigée après qu’un employé a déjà soumis, ce relevé conserve ses chiffres figés. Réouvrez-le si la correction doit s’appliquer : l’exécution suivante le réconcilie, et une nouvelle approbation enregistre l’ajustement.
Quand il s’exécute
Le travail s’exécute chaque jour pour chaque espace de travail ayant des relevés ouverts et au moins une activité de prime. Il est en outre déclenché immédiatement lorsqu’une modification de la configuration des primes a lieu, de sorte qu’une correction s’applique en quelques minutes au lieu d’attendre la nuit :
| Modification | Ce qui est réconcilié |
|---|---|
| Une politique de primes est créée, modifiée, supprimée ou restaurée | Les employés concernés par la politique — avant comme après la modification |
| L’activité horaire de conditions d’emploi est modifiée | Toutes les personnes employées sous ces conditions |
| Une modification planifiée de prime ou de conditions atteint sa date d’effet | Les mêmes ensembles, dans le cadre du cycle nocturne |
Modifier des conditions d’emploi sans toucher à leur activité horaire ne déclenche aucune exécution. Lorsque plusieurs modifications sont faites coup sur coup, elles partagent l’exécution déjà en file d’attente.
L’exécution quotidienne est le filet de sécurité pour tout ce que les déclencheurs immédiats ne voient pas — un employé changeant d’unité organisationnelle, un emploi modifié ou des normes republiées.
Paramètres
| Paramètre | Description |
|---|---|
| ID d’employés | ID d’employés séparés par des virgules auxquels limiter l’exécution. Vide signifie que chaque relevé ouvert de l’espace de travail est vérifié |
| ID de politiques de primes | ID de politiques de primes séparés par des virgules. L’exécution couvre les employés auxquels ces politiques s’appliquent actuellement |
Les deux sont normalement laissés vides — c’est ce que les déclencheurs automatiques utilisent pour restreindre une exécution. Renseignez-les manuellement pour revérifier un seul employé ou une seule politique.
Résultats du travail
| Métrique | Description |
|---|---|
processed | Relevés ouverts examinés par le travail |
emitted_days | Jours dont les lignes de primes ont été réécrites |
skipped | Relevés ignorés parce que l’employé n’a rien lié aux primes dans la période |
errors | Jours n’ayant pu être évalués (le reste de l’exécution continue) |
scope_employees | Employés auxquels l’exécution était limitée, lorsqu’elle a été déclenchée par une modification de configuration |
Une exécution saine sur un système inchangé indique emitted_days: 0.
Dépannage
| Problème | Solution |
|---|---|
| Une modification de prime n’apparaît pas sur la période en cours | Vérifiez que le relevé est encore ouvert — les relevés soumis et approuvés conservent leurs totaux figés jusqu’à réouverture. Exécutez ensuite le travail pour cet employé |
| Des lignes manquent uniquement pour les premiers jours d’une période | C’est précisément ce que ce travail répare. Exécutez-le, ou attendez l’exécution nocturne |
| Une prime apparaît encore après la suppression de sa politique | Exécutez le travail ; l’exécution déclenchée par la suppression a peut-être échoué. Vérifiez les erreurs de cette exécution |
| Des lignes apparaissent pour un employé qui ne devrait pas avoir la prime | Vérifiez la portée de disponibilité de la politique et l’activité horaire des conditions de l’employé — le travail reproduit ce que la configuration résout actuellement |
errors est supérieur à zéro | Ouvrez l’exécution et lisez les messages. Une règle de prime mal formée peut empêcher l’évaluation d’un jour ; les autres jours sont tout de même réconciliés |