Fr

Comment mapper votre CSV

Importer un fichier CSV et mapper ses colonnes pour que Hostfolio puisse catégoriser et analyser vos transactions.

Le mapping indique à Hostfolio quelle colonne du CSV correspond à la date, au montant, à la description, etc. Une fois mappé, Hostfolio peut parser les transactions, les catégoriser (avec vos règles) et calculer les indicateurs.

Étape 1 : Préparer le CSV

  • Où l'obtenir — Export depuis le site ou l'app de votre banque (« Exporter en CSV », « Télécharger les relevés »). Certains outils de gestion ou comptables exportent aussi en CSV.
  • Garder la ligne d'en-tête — La première ligne doit contenir les noms des colonnes. Hostfolio s'en sert pour proposer les rôles.
  • Une ligne par transaction — Chaque ligne après l'en-tête = une transaction.
  • Au minimum date et montant — Il faut une colonne date et soit une colonne montant (positif/négatif), soit des colonnes crédit et débit séparées.

Formats supportés : séparateur virgule (,) ou point-virgule (;) ; dates courantes (JJ/MM/AAAA, AAAA-MM-JJ, MM/JJ/AAAA) ; montants avec décimales . ou ,, ou deux colonnes crédit/débit.

Étape 2 : Importer le fichier

  1. Dans Gérer les propriétés, sélectionnez le bien concerné.
  2. Cliquez sur Importer un CSV et choisissez le fichier.
  3. Si le bien a déjà des CSV : Importer comme nouveau ou Remplacer un CSV existant.
  4. Hostfolio ouvre le mapper de colonnes et affiche un aperçu.

Étape 3 : Mapper les colonnes

Pour chaque champ Hostfolio, choisissez la colonne CSV correspondante :

ChampÀ choisir
DateColonne de la date de transaction. Si demandé, sélectionnez le format (ex. JJ/MM/AAAA).
MontantSoit une colonne avec montants signés (positif = revenu, négatif = charge), soit laissez « Montant » vide et utilisez Crédit et Débit.
CréditColonne des revenus / crédits (si colonnes crédit/débit séparées).
DébitColonne des dépenses / débits (si colonnes crédit/débit séparées).
DescriptionColonne libellé / mémo (utilisée pour la catégorisation et la recherche).
  • Mode montant — « Une colonne (signée) », « Colonnes crédit et débit », ou « Crédit uniquement ». Le mapper tente une détection automatique.
  • Optionnel : Année — Si le fichier concerne une année précise.
  • Optionnel : Libellé — Nom court pour ce CSV (ex. « Banque X 2024 »).

Cliquez sur Confirmer pour lancer l'import. Hostfolio parse toutes les lignes et applique vos règles de catégorisation.

Étape 4 : Après l'import

  • Les transactions apparaissent dans l'onglet Transactions et dans Catégorisation.
  • Dans Catégorisation, affectez les catégories par description ; ajoutez des règles dans Configuration → Catégories et règles pour que le prochain import soit auto-catégorisé.
  • Entrées personnalisées : vous pouvez ajouter des revenus ou dépenses manuels (ex. loyer en espèces) dans l'onglet Entrées personnalisées.

Réutiliser un mapping

Pour un autre fichier de la même banque (même structure), Hostfolio peut proposer de réutiliser le dernier mapping. Vous n'avez qu'à ajuster si besoin (ex. format de date).

Problèmes courants

  • « Aucune transaction valide » ou liste vide — Vérifiez que Date et Montant (ou Crédit/Débit) sont bien mappés et que le format de date est correct. Si les montants sont en deux colonnes, utilisez Crédit et Débit.
  • Montants faux (zéro ou doublés) — N'utilisez pas à la fois une colonne « Montant » et Crédit/Débit. Vérifiez quelle colonne est vraiment revenu vs dépense.
  • Dates ou année incorrectes — Ajustez le format de date et l’option Année si disponible.
  • Encodage — Enregistrez le CSV en UTF-8 si vous voyez des caractères bizarres.

Suite : Catégorisation et Export.