Vérifier une paie avant de la fermer

Jeudi matin, la paie part ce soir. Un employé oublié, des heures supplémentaires saisies deux fois, un taux mal copié : une fois les dépôts envoyés, chaque erreur se corrige à la main, avec un employé mécontent ou une paie en trop à récupérer. La vérification se fait souvent en parcourant le journal de paie ligne par ligne, quand on a le temps.

Dans cette recette, nous allons automatiser cette relecture : comparer la paie calculée à la précédente, employé par employé, signaler les absences, les nouveaux, les nets qui varient fortement et les heures supplémentaires en hausse, puis vérifier que les paiements correspondent au net, au cent près.

Ce que vous allez apprendre

comparer deux périodes de paie employé par employé avec le journal de vérification ;

repérer les employés absents ou nouveaux, et les variations de net qui méritent un regard ;

vérifier le net recalculé et rapprocher les paiements de la période ;

lire les paiements annulés pour un audit.

Avant de commencer

une clé API en lecture : cette recette n'écrit rien dans Acomba ;

le module Paie actif ;

les paies de la période calculées dans Acomba (avant ou après l'impression des chèques et l'envoi des dépôts) ;

le numéro de la période à vérifier et celui de la période de référence (GET /api/payroll/periods).

Ce que compare la recette

Avant de lancer les contrôles, voyons d'où viennent les chiffres. Chaque paie d'Acomba se compose de salaires (un par fonction payée) qui portent leurs montants par code de paie : heures régulières (102), temps et demi (103), temps double (104), vacances, retenues, cotisations. Le journal de vérification de la paie additionne ces salaires par employé, pour deux périodes côte à côte, avec l'écart de chaque code et du net. Les paiements de paie (chèques, dépôts directs) sont lus à part.

Étape 1 : comparer la paie à la précédente

Commençons par la vue d'ensemble. Le journal de vérification en mode compare met la période de référence (A) et la période à vérifier (B) côte à côte, par employé.

cURL

Réponse 200 (extrait)

Trois lectures suffisent pour chaque employé :

salaries_count : b à 0, l'employé n'est pas payé cette fois ; a à 0, il est nouveau.

net : l'écart (delta, delta_pct) entre les deux paies ; au-delà de votre seuil, un regard s'impose.

by_code : le détail par code de paie ; pour 103 et 104, quantity donne les heures supplémentaires de chaque période.

Les écarts ne sont pas des erreurs en soi : un chantier qui se termine ou une semaine de pluie font varier les heures. La recette les met sous vos yeux avant l'envoi des paiements.

Étape 2 : contrôler le net

Les variations sont repérées ; vérifions maintenant le calcul. Pour chaque salaire, le journal recalcule le net à partir des codes (gains − retenues) et le compare au net enregistré par Acomba. verification.outliers liste les salaires en écart : il doit être vide.

Un écart signale un code de paie mal rattaché à une section, ou un salaire modifié à la main après le calcul.

Étape 3 : rapprocher les paiements

Le net est juste ; reste à vérifier ce qui sort réellement du compte de banque. La somme des paiements de la période doit égaler le net de la période.

cURL

Réponse 200 (extrait)

Un écart entre les paiements et le net désigne une paie sans paiement (dépôt pas encore produit) ou un paiement en trop. Les paiements annulés sont exclus par défaut ; pour un audit, consultez-les à part.

cURL

Réponse 200 (extrait)

À l'annulation, Acomba remet le montant à 0 et détache le paiement de sa paie : la liste sert à retrouver quels numéros de chèque ou de dépôt ont été annulés, et quand.

Le script complet

Assemblons la vérification : ce script compare la paie à la précédente, classe les points à vérifier par catégorie, contrôle le net et rapproche les paiements.

Python

JavaScript (Node.js)

Exemple de sortie :

Paie 2026-30 : net 27,001.63 $ (période 29 : 34,746.29 $, -22.3 %)

Pas payés cette fois : 2
  - 1294 Pinsonneault Jérôme (net précédent 571.75 $)
  - 1355 Tremblay Michel (net précédent 2,608.09 $)
Nouveaux cette paie : 2
  - 1331 Fortin Magali (828.55 $)
  - 1348 Dubé Rosalie (990.98 $)
Net très différent : 2
  - 1361 Bernier Jacob : 477.19 → 109.02 $ (-77 %)
  - 1370 Chabot Carl : 1,900.82 → 3,090.82 $ (+63 %)
Heures supplémentaires en hausse : aucun
Contrôles du net et des paiements : aucun

Paiements de la période : 27,001.63 $ (Dépôt direct 27,001.63 $)

Bon à savoir

Choisissez la bonne référence. Comparez à la paie précédente du même département et de la même fréquence ; avec plusieurs fréquences de paie, vérifiez chaque groupe de périodes séparément.

Un écart n'est pas une erreur. La recette signale ; c'est votre connaissance des chantiers qui tranche. Ajustez SEUIL_NET à votre réalité.

Taux et pourcentages. Pour un code en pourcentage (vacances, CNESST), quantity est le taux ; il n'est donné que s'il est le même sur toutes les lignes regroupées.

Coordonnées bancaires. Les numéros de banque des paiements ne sont rendus qu'à une clé autorisée aux données sensibles de paie.

Après une correction de paie, ajoutez force_refresh=true au journal : il est gardé en cache 4 heures pour l'année courante.

Codes d'erreur : voir Codes d'erreur.

Et voilà

Votre paie est maintenant relue avant de partir : comparée à la précédente employé par employé, les absents, les nouveaux et les grosses variations sous vos yeux, le net recalculé au cent près et les paiements rapprochés du net. Vous savez aussi pourquoi un paiement annulé affiche 0 $, et où retrouver le détail de chaque code.

Pour aller plus loin

Vérification des DAS : les remises du mois, recoupées avec les mêmes paies.

Rapport mensuel CCQ : les heures du mois au grain de la CCQ.

Import de feuilles de temps : des heures justes avant même le calcul de la paie.

Ce que compare la recette#

Étape 1 : comparer la paie à la précédente#

Étape 2 : contrôler le net#

Étape 3 : rapprocher les paiements#

Le script complet#

Bon à savoir#

Et voilà#

Ce que compare la recette

Étape 1 : comparer la paie à la précédente

Étape 2 : contrôler le net

Étape 3 : rapprocher les paiements

Le script complet

Bon à savoir

Et voilà