Coût de la main-d’œuvre par chantier

Sur un chantier, la main-d'œuvre est souvent le poste qui dérape en silence. Les heures s'accumulent semaine après semaine, mais le coût réel n'apparaît qu'une fois les paies calculées et le mois fermé, quand il est trop tard pour réagir. Savoir chaque lundi combien le chantier a déjà consommé de son budget change tout : on ajuste l'équipe, on prévient le client d'un supplément, on évite la mauvaise surprise de fin de projet.

Dans cette recette, nous allons ouvrir un chantier dans Acomba avec son budget de main-d'œuvre, puis produire chaque semaine le coût engagé : les heures saisies sur le chantier, valorisées au coût horaire réel de chaque travailleur, et comparées au budget.

Ce que vous allez apprendre

créer un chantier dans un dossier à projets segmentés, et lui inscrire un budget ;

retrouver les heures saisies sur un chantier dans les feuilles de temps ;

valoriser ces heures au coût horaire d'Acomba, heures supplémentaires comprises ;

suivre la part du budget consommée, avant même la paie.

Avant de commencer

une clé API en écriture pour ouvrir le chantier et inscrire son budget ; le rapport lui-même ne fait que lire ;

les modules Paie et Coût de projets actifs ;

des heures saisies par chantier dans les feuilles de temps (voir Import de feuilles de temps) ;

les fonctions de vos travailleurs à jour : le coût horaire part de leurs taux.

Comment Acomba suit un chantier

Avant de commencer, voyons où vivent les données. Un chantier est un projet d'Acomba. Dans beaucoup de dossiers de la construction, les numéros de projet sont segmentés : le numéro est formé de segments, eux-mêmes des fiches (par exemple un segment de 11 chiffres pour le chantier, suivi d'un segment de 3 chiffres pour la phase). Chaque projet a trois colonnes de budget, de 14 cases chacune : la case 0 est le solde d'ouverture, les cases 1 à 13 les périodes de l'exercice.

Les heures arrivent par les feuilles de temps : chaque ligne porte l'employé, sa fonction, le chantier, le code de paie (102 régulier, 103 temps et demi, 104 temps double) et les heures. Le coût d'une heure, lui, se calcule avec la fonction du travailleur, exactement comme dans ses paies.

Étape 1 : ouvrir le chantier

Commençons par le chantier lui-même. Dans un dossier segmenté, créez d'abord le segment qui identifie le chantier (project_type_id: 1), puis le projet à partir de ses segments : son numéro est composé automatiquement.

cURL

Réponses 200

Le projet porte le numéro 00000002614000. Les segments existants se listent par rang : GET /api/customers/projects?project_type=2 pour le segment de phase. Dans un dossier sans segments, créez simplement le projet avec son code.

Inscrivons maintenant le budget de main-d'œuvre. Il s'écrit dans la forme où il se lit ; seules les cases envoyées changent.

cURL

Réponse 200

warnings liste les cases qu'Acomba n'aurait pas conservées : relues après l'écriture, elles sont vides ici. Choisissez une colonne de budget et tenez-vous-y : leurs titres sont définis dans la configuration du grand livre d'Acomba.

Étape 2 : retrouver les heures du chantier

Le chantier est ouvert et les équipes saisissent leurs heures. Lisons les lignes de temps de la semaine ; chacune indique son chantier.

cURL

Réponse 200 (extrait)

Regroupez les lignes du chantier par employé et par fonction, en séparant les codes 102, 103 et 104 : c'est ce mélange qui détermine le coût horaire. La liste n'a pas de filtre par chantier ; gardez les lignes dont project.number est le vôtre.

Étape 3 : valoriser les heures au coût réel

Les heures sont regroupées ; mettons-leur un prix. Le coût horaire d'Acomba demande le rang de la fonction dans la fiche de l'employé (index dans GET /api/payroll/employees/by-id/{id}/functions) et le mélange d'heures de la semaine.

cURL

Réponse 200 (extrait)

Ces 40 heures coûtent donc 40 × 59,29 au chantier, charges de l'employeur comprises. Répétez pour chaque employé et chaque fonction du chantier, puis additionnez.

Étape 4 : comparer au budget

Reste la question qui compte : où en est le chantier ? Lisez le budget du projet et additionnez la colonne choisie.

cURL

Réponse 200 (extrait)

Le script complet

Assemblons le suivi hebdomadaire : ce script lit le budget du chantier et les lignes de temps de la période, valorise les heures de chaque employé à son coût horaire réel et affiche la part du budget consommée.

Python

JavaScript (Node.js)

Exemple de sortie :

Chantier 00000002614000 — Résidence Lavoie — construction, du 2026-10-04 au 2026-10-10

  1042 Charp Léger 3e           32.00 h ×   60.19 $ =   1,926.03 $
  1064 Peintre Léger 3e         40.00 h ×   59.29 $ =   2,371.66 $

  Main-d'œuvre engagée : 72.00 h, 4,297.69 $
  Budget : 6,000.00 $ — consommé à 72%, reste 1,702.31 $

Bon à savoir

Coût engagé, pas coût payé. Le rapport valorise les heures saisies au coût horaire actuel des fonctions. Une fois la paie calculée, chaque salaire porte sa répartition par projet (projects dans GET /api/payroll/pays/by-id/{id}/salaries, et project_id par code de paie avec include_line_totals=true) : c'est le coût réellement payé.

Le mélange d'heures compte. Le coût par heure varie avec le volume et les heures supplémentaires : calculez-le avec les heures réelles de chaque employé, comme le fait le script.

Lignes déjà payées. Par défaut, la liste rend les lignes non encore intégrées à une paie et celles déjà payées (assignment=all) ; pour un chantier en cours, c'est ce que l'on veut.

Numéro de projet refusé. Un numéro qui ne respecte pas les segments du dossier répond 422 invalid_project_number ; un segment inexistant, 422 invalid_segment.

Budgets sur les projets seulement. Un segment n'a pas de budget (422 budgets_not_applicable).

Codes d'erreur : voir Codes d'erreur.

Et voilà

Votre chantier a maintenant son tableau de bord hebdomadaire : ouvert dans Acomba avec son budget de main-d'œuvre, ses heures retrouvées dans les feuilles de temps, valorisées au coût réel de chaque travailleur, et la part du budget consommée affichée bien avant la fin du mois. Vous savez aussi comment Acomba compose les numéros de projets segmentés, et où trouver ensuite le coût réellement payé.

Pour aller plus loin

Import de feuilles de temps : faire entrer les heures du chantier depuis votre application de pointage.

Le vrai coût horaire dans vos soumissions : chiffrer le prochain chantier au même coût réel.

Rapport mensuel CCQ : les mêmes heures, au grain du rapport à la CCQ.

Coût de la main-d’œuvre par chantier

Comment Acomba suit un chantier#

Étape 1 : ouvrir le chantier#

Étape 2 : retrouver les heures du chantier#

Étape 3 : valoriser les heures au coût réel#

Étape 4 : comparer au budget#

Le script complet#

Bon à savoir#

Et voilà#

Comment Acomba suit un chantier

Étape 1 : ouvrir le chantier

Étape 2 : retrouver les heures du chantier

Étape 3 : valoriser les heures au coût réel

Étape 4 : comparer au budget

Le script complet

Bon à savoir

Et voilà