Cas d'usage métiers · Mécanisme
Quand l'export de la banque change de format : erreur ou total faux
Un traitement qui lit un export par position s'arrête ou se trompe sans le dire. Test sur 9 changements de format d'un export bancaire inventé : ce que la structure voit.
Par Yaniv Benichou Publié le 11 min de lecture
En bref
Quand la banque change le format de son export, un traitement qui lit le fichier par position fait l’une de trois choses : il s’arrête sur une erreur, il se trompe sans le dire, ou il reste juste. Sur un export synthétique de 300 lignes et 9 changements de format, il s’est arrêté 4 fois, s’est trompé en silence 3 fois et est resté juste 2 fois. Comparer la structure du fichier à celle de référence avant l’exécution a signalé 8 changements sur 9 ; elle ne distingue pas l’inversion du jour et du mois, qui demande une personne ou un contrôle sur les valeurs.
Que se passe-t-il quand la banque change le format de son export ?
Un service comptable traite chaque mois l’export bancaire d’une entreprise et en tire les totaux de débits et de crédits. Un matin, la banque a changé son export. Les pages d’aide de logiciels comptables que nous avons lues répondent à une autre question : pourquoi mon import échoue-t-il ?
La page d’aide de QuickBooks Online (version canadienne en français, mise à jour le 22 septembre 2026) [1] parcourt les erreurs d’import une à une. Elle demande de vérifier que le format de la date correspond à celui choisi au mappage, et de copier le CSV dans un tableur vierge pour repérer les problèmes de formatage. Sage Accounting (Canada) consacre une page à l’erreur « Wrong date format selected » [2] : le format de date choisi au téléversement ne correspond pas à celui du fichier. Zoho Books demande de faire correspondre l’encodage et le type de colonnes de montants à ceux du relevé [3].
Dans ces trois pages, c’est une personne qui règle le format au moment de l’import. Aucune de ces trois pages ne décrit un format qui change d’un mois à l’autre, ni une comparaison avec l’export précédent. C’est le cas d’un traitement automatisé : il a figé ces réglages, et s’il ne rencontre pas d’erreur, rien dans le traitement lui-même ne signale que le fichier a changé. Nous avons testé ce qui se passe alors.
Ce qu’un traitement par position suppose, et ce qui arrive quand l’export change
Nous appelons structure d’un fichier ce qui se décrit sans lire ses lignes : l’encodage, le séparateur, le nombre, les noms et l’ordre des colonnes, et le gabarit des valeurs de chaque colonne, où chaque chiffre devient 9 (la date 15/01/2026 donne 99/99/9999). C’est la notion de notre article sur ce que reçoit le modèle quand il construit un agent, appliquée à un fichier qui change.
Un fichier CSV déclare peu de chose de cette structure. La RFC 4180 note qu’il n’existe pas de spécification formelle du format, retient la virgule comme séparateur de champs, prévoit un en-tête facultatif et ne définit ni le format des dates ni le séparateur décimal [4]. Un traitement par position (colonne 1 = date, colonne 3 = débit, colonne 4 = crédit) fige donc cinq hypothèses : l’encodage, le séparateur de champs, l’ordre des colonnes, l’ordre jour/mois des dates et la notation des montants.
Quand la banque change l’une de ces conventions, trois issues sont possibles. Une valeur ne se convertit plus (du texte à la place d’un nombre) : l’exécution s’arrête sur une erreur, pénible mais visible. Les valeurs se convertissent quand même, parce que deux nombres restent deux nombres : le total est faux, sans message. Ou le changement ne concerne pas ce que le lecteur utilise : le total reste juste.
Le test : neuf changements sur un export synthétique
Nous avons fabriqué un export bancaire inventé : 300 lignes de janvier à juin 2026, cinq colonnes (date, libellé, débit, crédit, solde), des libellés fictifs, ni IBAN ni nom réel. Sa référence : séparateur point-virgule (la virgule y sert de séparateur décimal), UTF-8, dates JJ/MM/AAAA. Un lecteur par position, écrit pour ce format, calcule les totaux mensuels de débits et de crédits ; un second contrôle en plus ses dates avec un calendrier. Pour neuf changements appliqués un à la fois, nous avons comparé les totaux obtenus aux totaux attendus (calculés en centimes sur les données d’origine), puis la structure du fichier à celle de la référence.
Les deux lecteurs et la comparaison sont des scripts écrits pour cette démonstration, pas le code de Nestor ; aucun modèle n’est appelé ; mesures du 4 novembre 2026. KastorLab a un intérêt dans ce sujet : Nestor, que nous proposons, compare la structure des fichiers avant l’exécution. Le test dit donc aussi ce que notre comparaison de démonstration ne voit pas.
| Changement | Lecteur par position | Comparaison de structure |
|---|---|---|
| Colonne « Libellé » renommée | Juste | Signalé |
| Débit et crédit permutés | Faux, sans message | Signalé |
| Colonne « Référence » (texte) ajoutée en tête | Erreur | Signalé |
| Colonne « N° opération » (nombre) avant les montants | Faux, sans message | Signalé |
| Séparateur « ; » devenu « , » | Erreur | Signalé |
| Dates MM/JJ/AAAA au lieu de JJ/MM/AAAA | Faux, sans message | Non vu |
| Décimale au point, sans séparateur de milliers | Juste | Signalé |
| Décimale au point, milliers par virgule | Erreur | Signalé |
| Encodage Windows-1252 au lieu d’UTF-8 | Erreur | Signalé |
Un fichier témoin, de même format et limité à juin, donne le bon résultat aux deux lecteurs, et la comparaison n’y voit aucune différence.
Sur les neuf changements, le lecteur par position s’arrête quatre fois, se trompe trois fois sans message et reste juste deux fois. Avec les débits et les crédits permutés, ou avec une colonne « N° opération » avant les montants, aucun des 6 totaux mensuels n’est juste. Avec des dates MM/JJ/AAAA, le lecteur range les montants sous 31 « mois » numérotés de 1 à 31, dont 25 hors de la période de l’export, et aucun des 6 totaux attendus n’est juste non plus.
La comparaison de structure signale 8 changements sur 9, et 2 des 3 résultats faux sans message. Elle signale aussi le renommage de « Libellé » et la décimale au point, après lesquels le lecteur par position restait juste : elle arrête alors une exécution qui aurait donné le bon total. C’est le prix d’une comparaison qui ne regarde pas ce que le traitement utilise.
Le second lecteur, qui contrôle ses dates, s’arrête sur le fichier aux dates inversées, parce que 192 lignes sur 300 ont un jour supérieur à 12 et donc un « mois » impossible. Sur un export partiel du 1er au 10 juin (14 lignes), il se trompe sans message comme le premier, et la comparaison de structure ne voit rien non plus.
Ce que la comparaison de structure ne voit pas
L’inversion du jour et du mois garde le même gabarit, 99/99/9999 : ni les noms, ni le nombre de colonnes, ni le séparateur ne changent. La structure dit à quoi ressemble une colonne, pas ce qu’elle veut dire : un changement qui ne touche ni les noms, ni l’ordre, ni la forme des valeurs lui échappe.
Deux contrôles sur les valeurs, ajoutés au lab, en rattrapent une partie. Le premier vérifie que le mois de chaque date est compris entre 1 et 12 : il signale le fichier aux dates inversées (192 lignes sur 300). Le second vérifie que le solde de chaque ligne est celui de la précédente plus le crédit moins le débit : il signale les colonnes permutées et la colonne ajoutée avant les montants (299 lignes sur 299 ne s’accordent pas avec la précédente). Chacun des neuf changements déclenche au moins l’un de ces trois contrôles, structure comprise. L’export partiel du 1er au 10 juin n’en déclenche aucun : le lecteur y annonce huit mois pour dix jours d’opérations, ce qu’une personne qui lit les totaux peut voir.
À vérifier chez votre fournisseur
Cinq questions à poser à l’éditeur ou à l’intégrateur qui traite vos exports, avec ce qu’une bonne réponse contient.
- Que se passe-t-il quand le format d’un export change ? Une bonne réponse dit que le traitement s’arrête avant de produire un résultat et nomme ce qui diffère. Si elle ne distingue pas l’erreur du résultat faux, demandez ce qui arrive à deux colonnes de montants permutées.
- Contre quoi la structure est-elle comparée : le fichier d’origine, le dernier fichier accepté, autre chose ? Une bonne réponse nomme la référence et dit quand elle change : c’est ce qui décide si un changement passé inaperçu un mois est encore signalé le mois suivant.
- Que regarde la comparaison, et que ne voit-elle pas ? Une bonne réponse liste ce qui est comparé et ce qui ne l’est pas, comme l’ordre jour/mois, et prévoit un contrôle des valeurs en complément.
- Qui approuve un correctif, et peut-on l’essayer sur les mois passés avant ? Une bonne réponse nomme une personne autre que l’auteur, et un essai sur chaque période passée conservée qui liste les résultats qui changent.
- Que reçoit le modèle pour proposer un correctif ? Une bonne réponse dit que c’est la différence de structure et non les lignes de vos fichiers, et que ce qui part laisse une trace.
Comment Nestor y répond
Avant une exécution, Nestor compare la structure des fichiers à celle de référence, celle de la construction ou de la dernière exécution réussie. Si elle a changé, l’exécution s’arrête et explique.
L’explication est donnée en mots simples. Pour les agents d’une seule étape écrits par Nestor, un correctif relu peut être proposé ; il est construit à partir de la seule différence de structure, et il est à approuver. L’auteur d’un agent ou d’une modification ne peut pas l’approuver. Les réparations, comme les modifications et les adaptateurs, rappellent un modèle.
Nestor garde un historique de versions par agent. Une modification peut être rejouée sur les fichiers, avant et après, avant son approbation, ce qui est facultatif ; elle est essayée sur chaque période passée conservée, avec un résumé pour l’approbateur. Le programme, lui, est testé : il tourne sur le serveur, et son résultat est comparé cellule par cellule à celui de l’équipe, avec jusqu’à 3 essais.
La comptabilité n’est ici qu’un exemple. Les cas d’usage par métier, étape par étape, sont sur la page Cas d’usage.
Limites
Le test porte sur un seul fichier synthétique de 300 lignes et sur neuf changements choisis par nous, un à la fois, à partir d’un seul format de référence. Les comptes (4, 3 et 2 sur 9 ; 8 sur 9) dépendent du lecteur et de la comparaison que nous avons écrits : avec le second lecteur, on obtient 5 erreurs, 2 silences et 2 résultats justes. « 8 sur 9 » mesure la couverture des dimensions où nous avons injecté les changements, pas une capacité générale, et aucun de ces comptes ne dit à quelle fréquence les exports réels changent. Nous n’avons pas testé les changements combinés, l’indicateur d’ordre des octets (BOM), les fins de ligne, les lignes de total, les montants négatifs, ni les formats Excel, PDF et OFX. Au 4 novembre 2026, la documentation d’Odoo 20 liste en premier le format CAMT.053, décrit comme le format recommandé par SEPA [5] ; nous ne l’avons pas essayé. Les trois pages d’aide ne sont pas un audit des éditeurs.
Les lecteurs et la comparaison sont des scripts de démonstration, pas le code de Nestor : le test ne dit rien de ce que voit la comparaison de Nestor, ni de son rejeu sur un correctif de dérive. La réparation ne couvre que les agents d’une seule étape écrits par Nestor. Nous n’avons appelé aucun modèle : la qualité d’un correctif proposé n’est pas mesurée.
Suites possibles : comment une personne qui n’est pas développeuse relit un correctif ; le rejeu sur les mois passés avant l’approbation.
Mesures faites sur un MacBook (Apple Silicon, macOS 14.6), avec Python 3.12.7 et sa bibliothèque standard. Les scripts sont déterministes (graine fixe) ; ils ont été relancés pendant la mise au point, et les chiffres publiés sont ceux de la dernière exécution.
Sources
- Erreurs courantes liées à l’importation d’opérations bancaires au format CSV dans QuickBooks en ligne, QuickBooks Online (Canada), Intuit, dernière mise à jour affichée le 22 septembre 2026, consultée le 4 novembre 2026.
- Sage Accounting (Canada), erreur « Wrong date format selected » à l’import d’un relevé bancaire, Sage, base de connaissances, article modifié le 23 août 2023, consultée le 4 novembre 2026.
- Error while importing bank statement, Zoho Books, base de connaissances, sans date affichée, consultée le 4 novembre 2026.
- RFC 4180, Common Format and MIME Type for Comma-Separated Values (CSV) Files, IETF, octobre 2005, consultée le 4 novembre 2026.
- Documentation d’Odoo 20, Transactions, Odoo, sans date affichée, consultée le 4 novembre 2026.