Fichiers CFONB 120 et 240 : lecture et intégration

Le CFONB 120 : le relevé de compte

Un relevé CFONB 120 se lit ligne par ligne. Chaque compte et chaque journée forment un bloc : un solde d'ouverture, les opérations de la journée et leurs détails, puis un solde de clôture.

Les zones sont à positions fixes : le code banque occupe les caractères 3 à 7, le numéro de compte les caractères 22 à 32, la date d'opération les caractères 35 à 40, le libellé les caractères 49 à 79 et le montant les caractères 91 à 104. Le code opération, sur les caractères 33 et 34, dit de quoi il s'agit : chèque, virement reçu, prélèvement, frais, rejet…

Le CFONB 240 : les lots de virements

Le CFONB 240 ne décrit pas un compte, mais des ordres de paiement. Chaque lot commence par un en-tête 31, contient un enregistrement 34 par virement et se termine par un total 39. Les montants sont exprimés en centimes, sur 12 chiffres, sans signe.

Les pièges d'un fichier CFONB

Des montants signés par une lettre

Dans un relevé CFONB 120, un montant tient sur 14 caractères : 13 chiffres et un caractère qui porte à la fois le dernier chiffre et le signe. { et A à I valent 0 à 9 pour un crédit, } et J à R valent 0 à 9 pour un débit. Le nombre de décimales est donné à part, au caractère 20. Ainsi 0000000166956E avec 2 décimales vaut 16 695,65 €, et 0000000000227R vaut −22,79 €.

Des dates sur six chiffres

Les dates sont écrites JJMMAA. Certaines banques remplissent de zéros une date qu'elles n'ont pas, y compris la date de valeur, pourtant obligatoire : un lecteur trop tolérant en fait un 30 novembre 1999 au lieu de signaler l'erreur.

Des fichiers mal découpés

Selon la banque et le canal, les lignes se terminent par \n, \r\n, \r, ou ne sont pas séparées du tout. L'ordre des enregistrements compte aussi : une opération sans solde d'ouverture, ou un bloc sans solde de clôture, signale un fichier tronqué.

Des rejets à interpréter

Un prélèvement rejeté revient dans le relevé avec un code motif, sur les caractères 41 et 42 de l'opération : provision insuffisante, compte clos, mandat révoqué… C'est ce code qui doit décider de la suite : relance, nouvelle présentation ou clôture du mandat.

Intégrer des fichiers CFONB à votre application

Lire le fichier n'est que la première étape. Une intégration complète :

1. récupère les fichiers automatiquement chaque jour, via EBICS ou depuis un dépôt ;
2. vérifie leur structure et refuse un fichier incomplet plutôt que d'importer des données fausses ;
3. importe les opérations sans doublon, même quand un relevé est reçu deux fois ;
4. lettre chaque opération avec la facture, le contrat ou le loyer qu'elle règle ;
5. traite les rejets selon leur code motif et alerte quand une opération reste sans correspondance.

C'est ce que nous avons mis en place sur InvestLease, où les relevés CFONB 120 alimentent un moteur de lettrage avec les contrats de location, et sur Solution SEPA, qui rapproche automatiquement les transactions des virements et prélèvements émis. Ces fichiers s'inscrivent dans une intégration bancaire plus large : envoi des virements et prélèvements SEPA, fichiers CAF, échanges EBICS.

Un lecteur CFONB open source

Nous avons publié notre lecteur, CFONB Parser, sous licence MIT : une bibliothèque PHP sans dépendance qui transforme les fichiers CFONB 120 et 240 en objets typés, décode les montants signés et les dates, et lève une erreur explicite sur un fichier mal formé. Sa documentation détaille chaque zone et chaque code opération.