Importer un CSV bancaire dans GnuCash : champs et rapprochements

Pour importer un CSV bancaire dans GnuCash 5.17 sous Windows, utilisez File → Import → Import Transactions from CSV, choisissez le compte bancaire, associez les colonnes et examinez chaque correspondance proposée avant de confirmer. Ce guide suit le manuel de la version 5 : un compte courant ou d’épargne dans une seule devise, une transaction par ligne CSV et deux répartitions comptables par transaction.

Utilisez d’abord un export bancaire natif adapté. Si vous ne disposez que d’un PDF, LocalExtract peut préparer un CSV localement ; le choix des comptes GnuCash et la vérification de l’import restent des tâches distinctes.

Choisir l’import de transactions et le compte de base

GnuCash distingue l’import de transactions de celui d’un plan de comptes. Importer une liste de comptes ne transforme pas des lignes bancaires en transactions. Pour un premier essai, ouvrez une copie de sauvegarde de votre comptabilité et choisissez l’entrée de transactions indiquée ci-dessus. Les instructions d’import de la version 5 distinguent aperçu, association des comptes et recherche de correspondances.

Déterminez le compte d’actif existant qui recevra les mouvements bancaires. Ce compte de base, par exemple votre compte courant, diffère du compte de charges, de produits ou de transfert utilisé en contrepartie. Vérifiez sa devise avec le relevé. Ne mélangez pas un autre compte ou une autre devise à cet import sous prétexte que les colonnes CSV se ressemblent.

Si le fichier ne comporte pas de colonne de compte, sélectionnez le compte de base dans le contrôle Account de l’aperçu. Sinon, associez la colonne fournie puis vérifiez sa correspondance avec le plan de comptes à l’étape d’association. Un nom similaire ne justifie pas d’accepter un mauvais compte.

Laissez Multi-split désactivé pour cette tâche à une ligne et deux répartitions. Le manuel qualifie d’expérimentaux les imports à répartitions multiples impliquant plusieurs devises ou des titres. Ce guide ne couvre ni ces cas ni les conventions de signe des comptes de passif de cartes de crédit.

Associer un montant signé sans en perdre le sens

Après avoir choisi le CSV, examinez Import Preview. Réglez le séparateur et l’encodage selon le fichier réel, ignorez sa ligne d’en-tête et choisissez explicitement Date Format et Currency Format. Le manuel précise que le réglage de date ne reprend pas simplement les paramètres régionaux. Un aperçu lisible ne prouve pas que dates et montants sont correctement interprétés.

L’association Deposit accepte des augmentations positives et des diminutions négatives pour un compte bancaire d’actif. Withdrawal inverse ce sens. Avec deux colonnes d’encaissements et de décaissements, associez Deposit et Withdrawal puis vérifiez chaque sens avec le relevé ; n’associez pas simultanément deux représentations du montant du même événement.

En cas de colonnes mal lues ou de nombres ambigus, utilisez le guide des dates et séparateurs décimaux CSV avant de revenir à l’import. Il traite les corrections générales de format ; cette page concerne les comptes et les décisions de correspondance dans GnuCash.

Essayer une association contrôlée sur trois lignes

Cet exemple synthétique définit un compte courant fictif en EUR, avec encaissements positifs et paiements négatifs. Les libellés anglais suivants sont des données de test identiques dans chaque version linguistique, pas des transactions réelles.

date,description,amount
2026-10-01,Synthetic receipt,120.00
2026-10-02,Synthetic supplies,-25.00
2026-10-03,Synthetic bank fee,-5.00

Avec le montant signé associé à Deposit, les trois mouvements bancaires doivent être +120,00, −25,00 et −5,00 EUR, soit une augmentation nette de 90,00 EUR. Associer la même colonne à Withdrawal inverserait les trois signes et produirait −90,00 EUR : c’est un contrôle négatif utile, pas un autre résultat acceptable.

Le fichier à trois champs ne contient aucun compte de contrepartie. Dans l’exercice, associez l’encaissement à un compte de produits approprié, les fournitures à un compte de charges et les frais à un compte de frais bancaires, dans une copie de travail jetable. Ces choix illustrent les deux côtés ; ce ne sont pas des imputations à recopier dans une comptabilité d’entreprise réelle. S’il s’agit d’un transfert, choisissez le véritable compte de transfert plutôt que de forcer une charge.

Téléchargez les cas synthétiques d’association pour examiner le CSV, les mouvements attendus et le contrôle aux signes inversés. L’analyse CSV en Python et l’arithmétique Decimal vérifient ces données pédagogiques. Elles n’exécutent pas GnuCash et ne certifient pas un import.

Examiner les correspondances avant d’accepter les modifications

Passez par l’association des comptes et Transaction Information jusqu’à Match Transactions. N’utilisez pas Skip Errors pour faire disparaître une ligne manquante inexpliquée. Revenez à l’aperçu et résolvez d’abord l’interprétation des champs.

La documentation du moteur de correspondance décrit trois actions : A ajoute une transaction ; U+C met à jour une correspondance existante et la marque « cleared » ; C marque une correspondance existante « cleared » sans ajouter de transaction. Examinez date, montant et libellé avant d’accepter une proposition. Une correspondance proposée reste une décision à vérifier, pas la preuve que deux paiements ressemblants constituent le même événement.

Contrôlez aussi le compte de contrepartie attribué. Un double-clic sur une nouvelle ligne ouvre le choix de contrepartie ; sur une ligne associée, il ouvre le choix de correspondance. Sans contrepartie attribuée, GnuCash peut placer l’autre côté dans un compte Imbalance. Résolvez cette destination avant l’import plutôt que de considérer cette écriture d’équilibrage comme une imputation terminée.

Pour les exports sources qui se chevauchent, utilisez avant import le processus de vérification des doublons par leurs sources. Il ne remplace pas la vérification des lignes déjà présentes dans ce fichier GnuCash. Une ligne source approuvée peut encore correspondre à une transaction comptable existante.

Contrôler le registre après l’import

Ne confirmez que lorsque compte de base, actions proposées et comptes de contrepartie sont corrects. Lisez le récapitulatif d’import, puis comparez le registre aux lignes sources sélectionnées. Dans l’exercice synthétique, vérifiez les trois signes et la variation nette de 90,00 EUR ; un total correct ne détecterait pas des erreurs qui se compensent.

Le statut d’import cleared de GnuCash est distinct d’un rapprochement terminé avec un relevé bancaire externe. Examinez les écritures Imbalance non résolues et effectuez séparément le rapprochement du relevé lorsque nécessaire. Si l’essai donne un résultat erroné, revenez à la copie intacte et recherchez la cause avant de modifier des écritures réelles.

LocalExtract traite un PDF à la fois ; analyse et OCR s’exécutent sur l’appareil. Il exporte un CSV date,description,amount. Il n’y a pas de file de traitement par lots sur ordinateur ni de synchronisation GnuCash automatique. Vérifiez les lignes extraites et préparez vous-même la copie d’import. La conversion ne téléverse pas le PDF ; accès au compte et vérification périodique Pro nécessitent un réseau. Télécharger LocalExtract pour une source PDF.

Instructions officielles de la version 5 et publication de GnuCash 5.17 vérifiées le 15 octobre 2026. Les menus indiqués suivent l’interface Windows en anglais.