thomas@hammoudi:~/dev$

Les comptes d'une commune, extraits des PDF et recoupés au centime

Je passe les comptes administratifs d'une commune de PDF en tableurs, puis je les recoupe avec les balances de l'État. L'outil marche pour toute commune.

en service · 5 années sur 6 sans écart ; la 6e a révélé une erreur de lecture · mis à jour en

Avant
Un montant lu par reconnaissance de texte dans un PDF peut être faux sans que rien ne le montre.
Maintenant
Sur 6 années recoupées, 5 sans écart au centime, et 1 erreur de lecture trouvée.

Utile si vous voulez vérifier des chiffres de comptes communaux, extraits d'un PDF, contre une source indépendante.

# stack

En 3 étapes

  1. J'extrais le texte des comptes administratifs en PDF, avec une reconnaissance de caractères (OCR) pour les scans.
  2. Je télécharge les balances de la DGFiP (les comptes tenus par l'État), une par année, et je les mets en tableur.
  3. Je compare compte par compte au centime, et je note les années où le PDF ou la balance est incomplet.
terminal~/Développement
$ python3 scripts/recoupe_comptes.py --config exemple/recoupe-exemple.json recouper --tableau exemple/tableau-exemple.csv | head -9
exercice | compte | tableau | balance DGFiP | écart | statut
2020 | 60612 | 1 200,50 | 1 200,50 | 0,00 | OK
2020 | 6411 | 50 000,00 | 50 000,00 | 0,00 | OK
2020 | 6574 | 3 000,00 | 3 000,00 | 0,00 | OK
2020 | 73111 | 80 000,00 | 80 000,00 | 0,00 | OK
2022 | 6574 | 3 100,00 | 3 100,00 | 0,00 | OK
2022 | 60612 | 1 450,00 | 1 500,00 | -50,00 | ÉCART
2022 | 74111 | 19 000,00 | 19 000,00 | 0,00 | OK
2021 | 60612 | 1 300,00 |  |  | SANS BALANCE

Pourquoi je l'ai fait

En octobre 2026, j’ai aidé un collectif citoyen dont je fais partie à lire les comptes de sa commune, de 2008 à 2025. La commune les publie en PDF, parfois scannés. Avant de s’appuyer sur un montant, il fallait être sûr de l’avoir bien lu. Je cherchais donc une seconde source, indépendante de la commune : la balance de la DGFiP, tenue par le comptable public.

Ce que ça fait, concrètement

L’outil télécharge les balances d’une commune, une par année, à partir de son code INSEE. Puis il compare vos montants aux siens, compte par compte, et classe chaque ligne : concordante au centime, en écart, ou introuvable. Il dit aussi quelles années sont sans balance, ou avec une balance trop courte pour être complète.

Pour la commune du collectif, j’ai recoupé neuf comptes, dont l’énergie, les rémunérations et les impôts locaux. Pour 2010 (un scan), 2015, 2018, 2021 et 2023, tous les comptes comparés concordent, soit 5 exercices sur 6. Pour 2024, un impôt local lu par OCR avait un chiffre faux. La balance l’a montré : l’erreur venait de l’OCR.

Comment ça marche, en détail

Fabrication : 19 tests hors ligne, essai sur 3 années de 3 formats de jeux

Un montant lu dans un PDF ne vaut que s’il a été confronté à la balance.

Extraire : du texte natif ou de l’OCR, page par page

Un PDF natif se lit directement. Les scans passent par l’OCR, et une page illisible est relue sous plusieurs orientations, car beaucoup de tableaux sont en paysage ou tête-bêche. Les années 2008 à 2010 sont des scans : j’y relis un montant sur l’image avant de le citer.

Recouper : la balance comme référence

Pour une charge, je lis le montant net au débit de la balance, pour un produit au crédit. Je le compare au réalisé du compte administratif, c’est-à-dire aux montants émis plus les rattachements. Un compte qui change de numéro avec la nomenclature de 2022 est apparié à son équivalent.

Signaler les années incomplètes

Pour deux années, la commune ne publie pas le détail de son budget principal : seule la balance le donne. L’année 2011 n’a qu’une balance, sans compte administratif. L’outil le dit au lieu de passer sous silence ce qu’il ne peut pas contrôler.

Ce que vous pouvez récupérer

Le paquet complet : l’outil Python 3, sans aucune bibliothèque à installer, ses 19 tests hors ligne, un jeu d’exemple fictif pour essayer sans réseau et le guide. Aucun compte ni aucune clé : les balances de la DGFiP sont publiques. L’outil a été essayé sur une petite commune sans lien avec le collectif, pour trois années aux formats différents. Les autres années et la Corse ne sont pas essayées.

Récupérer ce modèlegratuit

De quoi télécharger les balances de l'État d'une commune par son code INSEE et les recouper avec vos tableaux : l'outil Python complet, 19 tests hors ligne, un jeu d'exemple fictif et le guide pas à pas.

Il vous faut

  • Python 3, sans bibliothèque à installer
  • Le code INSEE de votre commune
  • Vos comptes en tableau CSV

# En vous inscrivant, vous recevez aussi « Ça marche chez moi ». Une lettre quand un outil tourne chez moi, au plus une par semaine. Désinscription en un clic.

Ce que j'en retiens

Une extraction qui a l’air propre peut contenir un chiffre faux, et seule une seconde source le montre. L’erreur trouvée en 2024 le prouve. Je garde aussi la liste de ce que je n’ai pas pu contrôler : elle compte autant que la liste de ce qui concorde.

tous les projets