convertBNP

Description

Convertisseur de relevés de comptes BNP du format PDF vers le formats CSV et XLSX.

Ce script Python lit les relevés bancaires fournis par la banque BNP Paribas en PDF pour en générer des fichiers tableurs. Le format CSV (fichiers textes avec valeur séparés par des points-virgules) est reconnu par excel ou n'importe quel autre tableur. Les format XLSX ne requiert pas de conversion des données.

Les fichiers analysés ont un nom formatté comme suit : 'RCHQ_101_3000412345678_20180109.pdf' ou 'RCHQ_101_3000412345678_20180109_2244.pdf'. Le quatrième champs est la date de calcul; le troisième est le préfixe du compte. C'est ce troisième champs qui est utilisé pour identifier les fichiers contenant le relevé des opérations. Les fichiers commencant par "FRAIS_101" ne sont pas analysés.

La conversion des fichiers pdf en fichiers txt peut se faire de plusieurs façons :

via le module Python pdftotext. Ce module est detecté et utilisé si présent.
via le programme pdftotext.
- Linux-(Fedora, CentOS, RedHat, Debian, Alpine) : poppler-utils. Linux-Arch : poppler
- Mac OS X : avec brew, voir ici
- Windows + Cygwin : paquet poppler disponible depuis 2012
- Windows : télécharger les "Xpdf Tools". Ce script utilise le fichier pdftotext.exe en version 3.03. Il ne fonctionne pas avec la version 3.04. La version 4.0 n'a pas été testée.

Au moins une de ces approches doit être disponible, sans quoi le script s'arrête directement.

Versions

Il y a quatre variantes :

convertBNP : script original créé le 10/11/2013 pour python3 sur Windows, suppose une mise en forme bien précise, utilisée autour de 2013.
convertBNP_4col.py : créé à la demande d'un utilisateur, sépare les débits et crédits en 2 colonnes distinctes. Mêmes restrictions de mise en forme.
convertBNP_5col.py : ajoute une date des opérations, si elle est différente de la date du mouvement. Compatible avec les mises en formes utilisées de 2012 à 2018 (et au-delà ...).
convertBNP_9col.py : ajoute 4 champs supplémentaires: "Net", un nombre signé; "Rubrique" pour mettre une étiquette, "Dépenses" si le mouvement correspond à un paiement et "Remb." s'il s'agit d'un remboursement.
les fichiers de sortie sont de la forme 'Relevé BNP YYYY-MM' sous Windows et 'Relevé_BNP_YYYY-MM' ailleurs.

Installation dans un environnement virtuel

Cette méthode est particulièrement utile quand il y a plusieurs versions de Python installées, ou que l'on ne peut/veut pas modifier les modules installés au niveau du système.

Pré-requis : python3 et un répertoire de travail généré à partir du dépôt GitHub.
Créer un environnement virtuel :

2.1 en ligne de commande, à partir de ce répertoire :
```
    $ python3 -mvenv .
```
2.2 en mode graphique : créer un environnement virtuel, choisir comme répertoire de destination celui créé à partir de GitHub
activer cet environnement et installer les module python "XlsxWriter" et "pdftotext" via pip :
```
    $ source bin/activate
    $ pip3 install XslxWriter pdftotext
```
le script comprend à présent 3 arguments :
- --verbosity : 1 pour afficher chaque ligne analysée, 2 pour entrer en mode pas-à-pas à certains endroits critiques du traitement
- --prefixe : une sous-chaine qui se trouve dans les noms des fichiers pdf à analyser. Le préfixe peut aussi être lu via un fichier "prefixe_compte.txt" dans le même répertoire que le script python, dont le contenu, en une seule ligne, correspond à la partie fixe des relevés :
```
300040012300001234567
```
- --dir : un spécificateur relatif ou absolu du répertoire contenant les fichiers à transformer. Les fichiers générés seront stockés dans le même répertoire.

Installation (méthode originale)

Installer Python 3.x.x
Extraire pdftotext.exe et convertBNP.py dans le répertoire des relevés de compte PDF.
créer un fichier "prefixe_compte.txt" avec le Bloc-Notes, en y mettant votre numéro de compte (voir le nom de vos fichiers PDF). cette ligne sert à identifier les fichiers du compte bancaire à convertir. Exemple de contenu en une seule ligne :
```
     300040012300001234567
```
Lancer le script en double-cliquant sur le fichier convertBNP.py ou avec la ligne de commande suivante (il faut être dans le dossier) : "python convertBNP.py"

Changements majeurs

au fil du temps (2012 -- 2018), il y a eu des changements de mise en forme dans les fichiers pdf. Ce script identifie à présent la pagination pour aller chercher les bons champs aux bons endroits.
les fichiers sont exportés au format csv et xlsx (Exell / Libreoffice).
Prend en compte les "locales" pour déterminer le type de séparateur décimal.
Génère une colonne complémentaire avec la date du mouvement. Par exemple, pour un retrait par carte, on peut avoir une date pour le retrait (un samedi), une date pour l'opération (le lundi suivant) et une date valeur (en fin du mois).
La somme des mouvements de type débit et crédit est comparée aux données en fin de tableau. En cas de différence, cela est considéré comme une condition d'erreur et il n'y a pas de fichier de sortie généré.

Utilisation

(en ligne de commande, environnement "convertBNP")

      $ (convertBNP) python3  convertBNP_5col.py --verbosity 1 --dir "~/Document/Comptes/BNP"

(dans emacs, avec gud et deboguage : cliquer sur "Python", "debugger")

      Run pdb (like this): python3 -mpdb convertBNP_5col.py --dir "../BNP FR"

Script en action (exemple)

******************************************************
*   Convertisseur de relevés bancaires BNP Paribas   *
********************  PDF -> CSV/XLSX  ***************

Relevés disponibles:
2011:             05 06 07 08 09 10 11 12
2012: 01 02 03 04 05 06 07 08 09 10 11 12
2013: 01 02 03 04 05 06 07 08 09 10 11 12
2014: 01 02 03 04 05 06 07 08 09 10 11 12

[pdf->txt ] Conversion : RCHQ_101_300040012300001234567_20140926_2226.pdf
[pdf->txt ] Conversion : RCHQ_101_300040012300001234567_20141026_2239.pdf
[pdf->txt ] Conversion : RCHQ_101_300040012300001234567_20141126_2218.pdf
[pdf->txt ] Conversion : RCHQ_101_300040012300001234567_20141226_2224.pdf

[txt->    ] Lecture    : RCHQ_101_300040012300001234567_20140926_2226.txt
[   ->csv ] Export     : Relevé BNP 2014-09.csv
[   ->xlsx] Export     : Relevé BNP 2014-09.xlsx
[txt->    ] Lecture    : RCHQ_101_300040012300001234567_20141026_2239.txt
[   ->csv ] Export     : Relevé BNP 2014-10.csv
[   ->xlsx] Export     : Relevé BNP 2014-10.xlsx
[txt->    ] Lecture    : RCHQ_101_300040012300001234567_20141126_2218.txt
[   ->csv ] Export     : Relevé BNP 2014-11.csv
[   ->xlsx] Export     : Relevé BNP 2014-11.xlsx
[txt->    ] Lecture    : RCHQ_101_300040012300001234567_20141226_2224.txt
[   ->csv ] Export     : Relevé BNP 2014-12.csv
[   ->xlsx] Export     : Relevé BNP 2014-12.xlsx  
[txt-> x  ] Nettoyage

4 relevés de comptes convertis.
Terminé.

Script en erreur (exemple)

******************************************************
*   Convertisseur de relevés bancaires BNP Paribas   *
********************  PDF -> CSV/XLSX  ***************

Il n'y a pas de relevés de compte en PDF dans le répertoire
/home/user/Documents/Comptes/BNP FR

contenant 123456789 avant le champs 'date'

Il faut placer les fichiers convertBNP.py et pdftotext.exe
à côté des fichiers de relevé de compte en PDF et adapter
la ligne 48 (PREFIXE_COMPTE = XXXXX) du fichier convertBNP.py
pour la faire correspondre à votre numéro de compte.

Bye bye :(

Ce message d'erreur indique le répertoire analysé ainsi que le préfixe recherché ('12345678').

bobmorane06/convertBNP