Rapport de trésorerie

Chaque lundi, la même question : aurons-nous assez d'argent pour la paie de jeudi et les fournisseurs de la fin du mois ? Pour y répondre, il faut ouvrir les soldes bancaires, l'âge des comptes clients, les factures fournisseurs et le registre de paie, puis tout recopier dans un tableur. Le temps de le faire, les chiffres ont déjà changé.

Dans cette recette, nous allons produire ce rapport automatiquement : l'encaisse d'aujourd'hui, puis, semaine par semaine, les encaissements attendus, les paiements fournisseurs et la paie, jusqu'au solde projeté de chaque semaine, avec ce qui est en retard et les taxes à remettre.

Ce que vous allez apprendre

lire l'encaisse de vos comptes de banque ;

obtenir une prévision semaine par semaine, paie comprise ;

calculer le solde projeté et repérer les semaines à risque ;

compléter le rapport avec les retards et les taxes à remettre.

Avant de commencer

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

les modules Grand livre, Clients et Fournisseurs actifs dans votre dossier Acomba (Paie, si vous voulez la paie dans la prévision) ;

les écritures de la semaine reportées au grand livre, pour des soldes bancaires à jour.

Ce que le rapport assemble

Avant d'écrire le script, voyons d'où vient chaque chiffre. Cinq routes suffisent, toutes en lecture :

Dans le rapport	Route	Champ
Encaisse d'aujourd'hui	`GET /api/cashflow/bank-accounts`	`accounts[].current_balance`
Encaissements, paiements fournisseurs et paie par semaine	`GET /api/cashflow/forecast`	`buckets[]`
Déjà en retard, à relancer ou à planifier	`GET /api/cashflow/forecast`	`overdue.ar`, `overdue.ap`
Total à encaisser et à payer	`GET /api/receivables/to-collect`, `GET /api/payables/to-pay`	`summary`
Taxes à remettre	`GET /api/cashflow/taxes-owed`	`summary.total_net_owed`

Étape 1 : partir de l'encaisse

Commençons par l'argent disponible aujourd'hui. La liste des comptes de la catégorie Banque donne le solde de chacun.

cURL

Réponse 200 (extrait)

Le solde ne compte que les écritures reportées au grand livre : un chèque fait aujourd'hui et pas encore reporté n'y est pas. Une marge de crédit apparaît avec un solde négatif.

Étape 2 : obtenir la prévision

L'encaisse est connue ; regardons maintenant ce qui va entrer et sortir. La prévision découpe l'horizon en semaines (du lundi au dimanche) et donne pour chacune les encaissements clients attendus, les factures fournisseurs à payer et la paie.

cURL

Réponse 200 (extrait)

La première semaine va de la date de référence au dimanche suivant : un lundi, elle est complète ; un autre jour, elle est partielle.

mode=treasury place chaque facture à la date où le client (ou vous) paie d'habitude, d'après les 12 derniers mois. Sans ce paramètre, la prévision suit les dates d'échéance, plus optimistes.

net_with_payroll : entrées − fournisseurs − paie de la semaine. La paie comprend les salaires nets et les charges patronales à verser.

overdue : ce qui aurait déjà dû être payé. Côté clients, c'est de l'argent à relancer ; côté fournisseurs, des paiements à planifier, qui ne sont pas dans les semaines.

metadata.ar_beyond_horizon_amount : les encaissements attendus après l'horizon. Les trois parts (semaines, retard, au-delà) font ensemble le total à encaisser de GET /api/receivables/to-collect.

Étape 3 : calculer le solde projeté

Il reste à additionner. Partez de l'encaisse et ajoutez le net_with_payroll de chaque semaine : le solde projeté de la semaine est celui de la précédente plus son net.

Semaine	Entrées	Fournisseurs	Paie	Net	Solde projeté
Aujourd'hui					84 250,40
12 au 18 oct.	14 416,61	9 840,00	46 608,98	−42 032,37	42 218,03
19 au 25 oct.	3 854,43	2 120,00	46 608,98	−44 874,55	−2 656,52

Une semaine sous zéro, c'est le signal : relancer les clients en retard, étaler un paiement fournisseur ou prévoir la marge de crédit.

Étape 4 : ajouter les taxes à remettre

Dernier élément du rapport : la TPS et la TVQ perçues que vous devrez remettre.

cURL

Réponse 200 (extrait)

Acomba ne connaît pas vos dates de remise : ajoutez ce montant à la semaine où vous remettez, selon votre fréquence (mensuelle, trimestrielle…). Un montant négatif (is_refund_expected: true) est un remboursement attendu.

Le script complet

Assemblons le rapport : ce script lit les cinq sources et affiche l'encaisse, le solde projeté semaine par semaine, les retards et les taxes.

Python

JavaScript (Node.js)

Exemple de sortie :

Trésorerie au 2026-10-11
  1050 Caisse populaire — opérations         79 118,15
  1060 Banque — épargne                       5 132,25
  Encaisse                                   84 250,40

  Semaine                        Entrées   Fournisseurs           Paie  Solde projeté
  2026-10-11 au 10-11                0,00           0,00           0,00      84 250,40
  2026-10-12 au 10-18           14 416,61       9 840,00      46 608,98      42 218,03
  2026-10-19 au 10-25            3 854,43       2 120,00      46 608,98      -2 656,52  ← sous zéro
  …

  Clients en retard (à relancer)              61 240,55
  Fournisseurs en retard (à planifier)        18 310,20
  Encaissements après l'horizon               20 398,06
  Total à encaisser                           95 638,61
  Total à payer                               28 150,20
  Taxes à remettre (TPS, TVQ)                  7 412,85

Bon à savoir

Rien n'est écrit. Une clé en lecture suffit, et vous pouvez lancer le rapport aussi souvent que vous le voulez.

Les résultats sont gardés en cache : 1 heure pour les soldes bancaires et les taxes, 4 heures pour la prévision et les totaux à encaisser et à payer. Ajoutez force_refresh=true à une route pour forcer le recalcul, par exemple juste après un report au grand livre.

Encaisse et écritures non reportées : les soldes bancaires et les taxes ne comptent que ce qui est reporté au grand livre. Reportez avant de lancer le rapport.

La paie prévue vient de l'historique des paies d'Acomba. Si le module Paie est inactif ou sans historique, metadata.payroll_skipped vaut true et la paie est à zéro.

Mode treasury ou échéances : treasury est plus réaliste pour la trésorerie ; sans mode, la prévision suit les dates d'échéance contractuelles. Comparez les deux la première fois.

Par mois plutôt que par semaine : group_by=month découpe l'horizon en mois civils.

Codes d'erreur : voir Codes d'erreur pour savoir quand réessayer.

Et voilà

Votre rapport de trésorerie se produit maintenant en quelques secondes : l'encaisse, le solde projeté de chaque semaine paie comprise, les retards à relancer ou à planifier, et les taxes à remettre. Vous savez lire la prévision, choisir entre les dates d'échéance et les délais de paiement observés, et repérer d'avance la semaine où il manquera de l'argent.

Pour aller plus loin

Relances de recouvrement : transformez les clients en retard en argent encaissé.

Lot de paiements fournisseurs : payez les fournisseurs à planifier.

Tableaux de bord et analyses : les conventions communes (cache, périodes, soldes nets).

Ce que le rapport assemble#

Étape 1 : partir de l'encaisse#

Étape 2 : obtenir la prévision#

Étape 3 : calculer le solde projeté#

Étape 4 : ajouter les taxes à remettre#

Le script complet#

Bon à savoir#

Et voilà#

Ce que le rapport assemble

Étape 1 : partir de l'encaisse

Étape 2 : obtenir la prévision

Étape 3 : calculer le solde projeté

Étape 4 : ajouter les taxes à remettre

Le script complet

Bon à savoir

Et voilà