HomeBank CSV : vérifier les codes de paiement et virements internes

Le manuel public appartient actuellement à la documentation HomeBank 5.10. La spécification CSV et le guide de l’assistant d’import distinguent ce format particulier du fichier natif d’une banque. Préférez une source OFX/QFX prise en charge si elle convient ; pour une adaptation CSV, travaillez sur une copie séparée.

Les applications exportent la date, la description et le montant en CSV. Ouvrez ce CSV dans Excel pour enregistrer un classeur XLSX. Vérifiez le résultat avec votre PDF : la compatibilité dépend du format du relevé.

Garder les huit champs dans l’ordre documenté

Le format d’import est date, payment, number, payee, memo, amount, category, tags. Cette liste sépare les noms par des virgules ; HomeBank documente le point-virgule comme séparateur par défaut. Il est modifiable dans les versions qui proposent cette option. Contrôlez ensemble séparateur, dates et décimales.

Champ	Décision avant import
date	Garder la date source et choisir une interprétation prise en charge
payment	Utiliser le sens HomeBank, pas la ressemblance numérique avec le code bancaire
number / payee / memo	Conserver chaque position, même si number reste vide
amount	Garder le sens et vérifier une entrée et une sortie connues
category / tags	Garder les deux positions ; une valeur vide ne doit rien décaler

Un export HomeBank peut comporter une colonne de compte supplémentaire en tête, un statut C/R ou des lignes détaillant une ventilation selon les options choisies. Ces ajouts ne font pas automatiquement partie des huit champs de cet import. Ne présumez pas qu’un registre exporté se réimporte sans adaptation.

Choisir les codes selon leur sens

Code HomeBank	Signification documentée
0	Aucun
1 / 6	Carte de crédit / carte de débit
2 / 3	Chèque / espèces
4	Virement bancaire
5	Virement interne, mais importé comme code 4 par CSV
7 / 8	Ordre permanent / paiement électronique
9 / 10 / 11	Dépôt / frais d’établissement financier / prélèvement

Le lexique des paiements distingue le virement interne, qui relie des comptes. La spécification indique que le CSV transforme le code 5 en code 4 car ce parcours ne représente pas plusieurs comptes. Écrire 5 ne crée donc pas à lui seul une contrepartie correctement reliée.

Examiner une petite copie de travail

Ces deux lignes sans en-tête sont des exemples synthétiques de positionnement, pas un export bancaire ni un import HomeBank démontré. Le texte anglais reste identique dans les données fixes :

2026-09-12;6;;Example shop;Synthetic debit card;-24.50;Food;review
2026-09-13;10;;Example bank;Synthetic fee;-2.00;Bank fees;review

Les deux montants sont négatifs, mais le scénario donne des significations distinctes : carte de débit et frais bancaires. Si la source dit seulement « sortie », aucun de ces codes précis ne peut en être déduit. Gardez le sens non résolu plutôt que de l’inventer à partir du signe.

Ouvrez File → Import et examinez compte cible, opérations et synthèse finale dans une copie de test avant d’accepter des données réelles. Contrôlez positions et sens des montants. Un contrôle structurel local compte huit champs, mais ne certifie ni l’interprétation du logiciel ni celle des codes bancaires.

Conservez original, table de correspondance des significations et exceptions de virements. Le livrable est un fichier de travail vérifiable pour HomeBank, pas un rapprochement automatique entre deux comptes ni une compatibilité garantie pour tout CSV bancaire.

Reproduire le contrôle de structure avant HomeBank

Cette partie s’adresse à la personne qui adapte son CSV bancaire personnel au format de transactions HomeBank. Le fichier de travail fictif reprend les deux lignes ci-dessus et ajoute une troisième avec payment 5, une catégorie vide et le champ tags conservé. Ce n’est ni un export bancaire ni la preuve d’un import HomeBank réussi.

import csv
from pathlib import Path
with Path("tp-205-working-example.csv").open(encoding="utf-8", newline="") as source:
    rows = list(csv.reader(source, delimiter=";"))
assert all(len(row) == 8 for row in rows)
print([row[1] for row in rows])
print([row[5] for row in rows])

L’exécution Python renvoie les chaînes payment ['6', '10', '5'] et amount ['-24.50', '-2.00', '-50.00']. Chaque ligne contient huit champs et conserve la position number vide. Contre-exemples exécutés : une lecture du même contenu avec une virgule donne un seul champ par ligne ; supprimer le dernier champ de la première ligne fait échouer le contrôle des huit champs. Ce sont des résultats de structure, pas une interprétation par l’application.

Gardez le sens du moyen de paiement bancaire à côté du code HomeBank envisagé ; une signification inconnue reste à clarifier.
Vérifiez les huit positions, valeurs vides comprises, avec le séparateur choisi.
Signalez tout code 5 proposé en raison de la limite CSV documentée. La conservation de 5 par Python ne prouve pas la création d’un virement interne lié dans HomeBank.
Vérifiez le véritable compte destinataire et l’aperçu de l’assistant dans une copie jetable avant d’accepter des données réelles. Arrêtez si les montants, les positions ou le compte ne concordent pas.

Cas de contrôle synthétique. Les valeurs sont pédagogiques, pas un export du fournisseur ni un fichier à importer.

Pour une source bancaire disponible seulement en PDF, téléchargez LocalExtract. Il traite un PDF localement en CSV date,description,amount ; contrôlez et adaptez les lignes à la destination réelle.

Guide associé : Importer un CSV bancaire dans GnuCash : champs et rapprochements.

Documentation de la tâche ajoutée vérifiée le 16 octobre 2026.