Une prime à la prochaine paie

Le chantier est livré à temps, et vous avez promis une prime à l'équipe. Dans Acomba, ajouter un montant ponctuel à la prochaine paie de dix employés, c'est ouvrir dix inscriptions de paie et y saisir la ligne à la main, sans oublier personne. Et quand la prime vient d'une autre application (un tableau de suivi de chantier, un système de primes), il faut tout ressaisir.

Dans cette recette, nous allons préparer la prime directement dans la prochaine paie de chaque employé, grâce à la paie temporaire d'Acomba : un gabarit que l'inscription de paie reprend automatiquement. Nous ajouterons la prime à une liste d'employés, en respectant ce qui est déjà préparé pour eux.

Ce que vous allez apprendre

ce qu'est une paie temporaire dans Acomba, et quand elle s'applique ;

créer le gabarit d'un employé avec une ligne de prime ;

compléter un gabarit existant sans écraser ce qu'il contient ;

relire, corriger ou retirer une prime avant l'inscription de la paie.

Avant de commencer

une clé API en écriture ;

le module Paie actif ;

le code de paie de la prime, en $ par paie (ici 125 « Boni ») : GET /api/payroll/pay-codes, section des gains ;

la liste des employés, avec la fonction qui portera la prime et le montant ;

un dossier de test pour le premier essai : cette recette écrit dans Acomba.

La paie temporaire, un gabarit pour la prochaine paie

Avant d'écrire, voyons ce que nous allons créer. Une paie temporaire d'Acomba n'est pas une paie : c'est un gabarit attaché à l'employé, que l'inscription de sa prochaine paie reprend comme valeurs de départ. Il n'a donc ni période, ni dates, ni salaire net ; Acomba calcule tout à l'inscription. Un employé n'a qu'un gabarit : le créer à nouveau le remplace.

Le gabarit contient des salaires, un par fonction, chacun avec ses lignes de paie. Une ligne en $ par paie, comme une prime, se donne par son montant (total).

Étape 1 : choisir la fonction qui porte la prime

Commençons par l'employé. La prime s'inscrit dans le salaire d'une de ses fonctions ; la liste des fonctions donne leur rang, leur état et les codes de paie qu'elles utilisent.

cURL

Réponse 200 (extrait)

Acomba n'affiche à l'inscription que les lignes que la fonction utilise. Si le code de la prime n'est pas dans rates, vérifiez la ligne à l'inscription, ou ajoutez le code à la fonction (voir Embaucher un travailleur de la construction).

Étape 2 : créer le gabarit avec la prime

L'employé n'a pas encore de gabarit (GET /api/payroll/trans-pa?employee_code=1094&is_temporary=true répond une liste vide) : créons-le avec la ligne de prime.

cURL

Réponse 201 (extrait)

readback_warnings liste les valeurs qu'Acomba n'a pas conservées : vide, la prime est écrite telle quelle. period_number: 0 est normal, un gabarit n'a pas de période.

Étape 3 : compléter un gabarit existant

Un employé peut déjà avoir un gabarit, préparé dans Acomba ou par une autre intégration : un nouveau POST l'écraserait. Complétons-le plutôt. Relisons-le d'abord pour connaître le rang de chaque salaire.

cURL

Réponse 200 (extrait)

La modification adresse les salaires par rang, dans l'ordre envoyé, et n'écrit que les lignes envoyées : les 40 heures et la répartition par projet restent.

cURL

Réponse 200 (extrait)

Pour corriger le montant, renvoyez la ligne avec le bon total ; pour retirer la prime seulement, mettez total à 0 ; pour abandonner tout le gabarit, DELETE /api/payroll/temporary-pays/1978.

Le script complet

Assemblons la préparation des primes : pour chaque employé de la liste, ce script vérifie la fonction, crée le gabarit ou le complète au bon rang, et affiche ce qu'Acomba a conservé.

Python

JavaScript (Node.js)

Exemple de sortie :

1094 Bergeron Simon : prime de 750.00 $ (created, gabarit 1976) — OK (le code 125 n'est pas dans la fonction « Plâtrier commercial 3e » : vérifiez l'inscription)
1123 Lavoie Benoît : prime de 500.00 $ (updated, gabarit 1978) — OK

Bon à savoir

Elle s'applique à la prochaine inscription. Le gabarit est repris quand vous inscrivez la prochaine paie de l'employé dans Acomba ; vérifiez la ligne à ce moment-là, puis calculez la paie comme d'habitude.

Un seul gabarit par employé. Un POST remplace le gabarit entier ; pour ajouter une prime à un gabarit existant, relisez-le et modifiez-le au bon rang, comme le script.

Le boni de la paie (bonus_amount) n'est pas modifiable : Acomba ne le conserve pas. Utilisez une ligne de gains en $ par paie, avec son montant.

Une fiche ouverte dans Acomba est verrouillée. Si l'inscription de paie de l'employé est ouverte à l'écran, l'écriture répond 409 : fermez l'écran et relancez.

Pas de doublon en cas de reprise. Relancer le script réécrit le même montant sur la même ligne : il n'y a pas de cumul.

Codes d'erreur : voir Codes d'erreur.

Et voilà

Vos primes sont prêtes pour la prochaine paie : préparées dans le gabarit de chaque employé, ajoutées sans écraser ce qui y était déjà, relues pour confirmer qu'Acomba les a conservées. Vous savez aussi ce qu'est une paie temporaire, pourquoi elle n'a pas de période, et comment la corriger ou la retirer avant l'inscription.

Pour aller plus loin

Vérifier une paie avant de la fermer : repérer la prime et ses effets dans la paie calculée.

Coût de la main-d'œuvre par chantier : imputer la prime au bon chantier avec la répartition par projet.

Vérification des DAS : les retenues sur la prime dans la remise du mois.

La paie temporaire, un gabarit pour la prochaine paie#

Étape 1 : choisir la fonction qui porte la prime#

Étape 2 : créer le gabarit avec la prime#

Étape 3 : compléter un gabarit existant#

Le script complet#

Bon à savoir#

Et voilà#

La paie temporaire, un gabarit pour la prochaine paie

Étape 1 : choisir la fonction qui porte la prime

Étape 2 : créer le gabarit avec la prime

Étape 3 : compléter un gabarit existant

Le script complet

Bon à savoir

Et voilà