Relevé bancaire → fichier EBICS (CFONB 120)

Objectif : produire un fichier de relevé de compte CFONB 120 caractères — le format des relevés télétransmis par EBICS — identique à ce qu'aurait envoyé la banque, pour import automatique dans le logiciel comptable. Le fichier généré doit être irréprochable : un montant mal signé ou un solde faux fausse le rapprochement bancaire du dossier client.

Les deux scripts du skill (Python 3, sans dépendance) font le travail normatif :

• scripts/genere_cfonb120.py : JSON d'opérations → fichier CFONB 120.
• scripts/verifie_cfonb120.py : contrôle indépendant + décodage lisible.

Le travail intelligent — lire le relevé sans rien perdre — reste à ta charge.

Étape 1 — Lire le relevé source

• PDF texte (e-relevé) : pdftotext -layout releve.pdf sortie.txt puis lire la sortie. L'option -layout préserve les colonnes Débit/Crédit, qui ne se distinguent souvent QUE par la position horizontale du montant.
• Scan / photo : lire le document visuellement, page par page, ligne par ligne. Ne jamais échantillonner : chaque opération compte.
• Excel / CSV : lire avec pandas ou openpyxl ; repérer colonnes date, libellé, débit, crédit (ou montant signé).

Étape 2 — Extraire et structurer en JSON

Construire un fichier JSON conforme au schéma documenté en tête de genere_cfonb120.py :

{
  "compte": {"iban": "FR76 1120 6200 0400 8857 8241 828", "devise": "EUR"},
  "solde_initial": {"date": "31/12/2023", "montant": 130.57},
  "solde_final":   {"date": "31/01/2024", "montant": 267.04},
  "operations": [
    {"date": "05/01/2024", "libelle": "PRLV SOLOCAL SA-SOLOCAL", "montant": -66.00,
     "libelles_complementaires": ["SLMP020539383002 FR31ZZZ117501 Core"]}
  ]
}

Règles d'extraction :

• Coordonnées bancaires : IBAN français = FR + clé (2) + banque (5) + guichet (5) + n° de compte (11) + clé RIB (2) ; le script décompose l'IBAN seul. Sans IBAN ni RIB sur le relevé, demander à l'utilisateur — ne pas inventer.
• Signes : point de vue du relevé. Colonne Crédit (entrée d'argent) → montant positif ; colonne Débit → négatif. Solde « créditeur » → positif, « débiteur » → négatif. Idem pour les soldes.
• Libellés : la 1re ligne de l'opération = libelle ; les lignes de détail en dessous (mandats, références, mentions) = libelles_complementaires, dans l'ordre. Tout conserver : ces détails permettent de lettrer côté compta.
• Dates : si le relevé distingue date d'opération et date de valeur, renseigner les deux (date, date_valeur). Dates « JJ.MM » sans année : déduire l'année de la période du relevé (attention aux relevés à cheval sur deux années, ex. décembre → janvier).
• date de valeur et import : l'intégrateur comptable date les écritures sur la zone date de valeur (positions 43-48). Si l'utilisateur veut les écritures à la date d'opération, omettre date_valeur.

Pièges fréquents (vus sur relevés réels) :

• Les lignes « Ancien solde », « Nouveau solde », « Total des opérations », « Report page précédente » ne sont pas des opérations : elles servent aux contrôles, jamais dans operations.
• Relevé multi-pages : reprendre toutes les pages, raccorder les reports.
• Montants français : espaces (insécables) de milliers, virgule décimale ; « 1 234,56 » = 1234.56.
• Symboles décoratifs (**, þ, ¨, puces) : les ignorer, ne pas les mettre dans les libellés.
• Une opération dont le libellé continue sur la page suivante reste UNE opération.

Étape 3 — Générer le fichier

python3 scripts/genere_cfonb120.py operations.json
# ou : -o EBICS_1120620004_00885782418_20240131.txt

Le script trie par date, code les montants (dernier caractère : crédit {,A-I / débit },J-R), choisit un code opération interbancaire plausible (virement 05/06, prélèvement B1, frais 62, défaut 91 — surchargeable par opération via "cib"), et refuse de générer si :

• ancien solde + somme des mouvements ≠ nouveau solde (équation de la norme) ;
• une opération sort de la période du relevé.

Dans ces deux cas, l'erreur vient presque toujours de l'extraction : opération oubliée ou lue deux fois, sens débit/crédit inversé, solde mal lu. Relire le relevé source et corriger le JSON. Ne jamais équilibrer en inventant une opération d'ajustement ni en modifiant un solde : si le relevé lui-même semble incohérent, le signaler à l'utilisateur.

Plusieurs relevés (plusieurs mois ou plusieurs comptes) peuvent aller dans un même fichier : {"releves": [ ... ]}.

Étape 4 — Vérifier (systématique)

python3 scripts/verifie_cfonb120.py EBICS_....txt

Le vérificateur relit le fichier comme le ferait l'intégrateur et affiche les mouvements décodés. Confronter ce décodage au relevé source : nombre d'opérations, total débits, total crédits, soldes, libellés. Ne livrer que si la sortie se termine par « CONFORME ». Ce script sert aussi à inspecter un fichier EBICS reçu d'une banque.

Étape 5 — Livrer

Livrer le fichier .txt (nommage EBICS_<banque><guichet>_<compte>_<AAAAMMJJ du nouveau solde>.txt) avec un résumé bref : période, nombre d'écritures, total débits/crédits, soldes. Pas de roman : le rapport de contrôle dit tout.

Dépannage import

Symptôme dans le logiciel comptable	Correction
Libellés complémentaires précédés de « LIB »	régénérer avec --qualifiant aucun
Fichier refusé (séparateurs de lignes)	--fin-ligne lf ou --fin-ligne aucun (flux continu de 120 c.)
Écritures datées à la date de valeur au lieu de la date d'opération	omettre date_valeur dans le JSON
Compte non reconnu	vérifier banque/guichet/n° de compte contre le paramétrage du dossier

Référence

Positions exactes des enregistrements 01/04/05/07, table de codage des montants, jeu de caractères, codes opérations interbancaires : references/norme-cfonb120.md (source : brochures CFONB juillet 2004 et V5.0 novembre 2018). À consulter en cas de doute sur une zone, ou si un importeur signale une non-conformité.