Apporte ton historique dans Topf

Topf lit le CSV, un format de tableau courant. Si ta banque ou ton app propose le CSV parmi ses formats d’export, choisis-le. Les colonnes peuvent être séparées par des virgules, des points-virgules ou des tabulations, Topf le détecte.

• Excel : « Fichier », « Enregistrer sous », format CSV UTF-8.
• Numbers : « Fichier », « Exporter vers », CSV.
• Google Sheets : « Fichier », « Télécharger », format CSV.

Un fichier peut compter jusqu’à 50 000 lignes et 20 Mo. Un tableau plus grand se découpe mieux en plusieurs fichiers, par année par exemple.

Si des lettres se changent en signes bizarres, le fichier n’est pas en UTF-8 mais dans un encodage plus ancien. Topf ne devine pas : il montre comment les mots de ton fichier se lisent dans cinq encodages, et tu choisis celui où ils sont justes.

Au-dessus du tableau d’un relevé, il y a souvent quelques lignes sur le compte. Topf trouve la ligne des noms de colonnes ; s’il s’est trompé, ouvre le menu sous le nom du fichier et choisis une autre ligne, ou indique qu’il n’y a pas d’en-têtes.

Chaque champ d’une opération reçoit une colonne du fichier. Seuls la date et le montant sont obligatoires ; sans les autres, voici ce qui se passe :

• Compte : tu en choisis un pour tout le fichier à l’étape suivante.
• Catégorie : les dépenses vont dans « Autres dépenses », les revenus dans « Autres revenus ».
• Note : aucune.
• Devise : celle du compte.
• Heure : celle de la date, ou midi.

Topf ne remplit un champ tout seul que s’il en est sûr : une colonne nommée exactement comme le champ, dont toutes les valeurs sont reconnues. Un fichier exporté par Topf est reconnu en entier, dans toutes les langues de Topf. Ce que tu choisis toi-même reste choisi.

Les fichiers écrivent les montants de trois façons, et le menu du montant les connaît toutes :

• « Une colonne avec un signe » : dépenses avec un moins, revenus sans. Rien à faire.
• « Dépenses sans signe moins » : pour les fichiers où les dépenses sont positives. Sans cela, tes dépenses arriveraient comme des revenus.
• « Dépenses et revenus dans des colonnes séparées » : pour les relevés avec une colonne débit et une colonne crédit. Choisis les deux.

Un montant écrit 1,234 vaut 1234 si la virgule sépare les milliers, et un virgule deux cent trente-quatre si la virgule est le séparateur décimal. Quand une colonne se lit des deux façons, Topf demande et montre comment une valeur se lit dans chaque cas.

Une date comme 05/04/2026 est le 5 avril dans un pays et le 4 mai dans un autre. Topf tranche sur toute la colonne : si chaque valeur se lit des deux façons, il demande et montre les deux lectures.

Une opération sans heure arrive à midi ; celle d’aujourd’hui, pas plus tard que la minute en cours. Les dates à venir ne sont pas importées.

À l’étape « Comptes et catégories », chaque compte et chaque catégorie du fichier a sa ligne, et tu dis où ils vont : vers un compte ou une catégorie de ton livre, vers de nouveaux, ou « Ne pas importer ».

Topf n’associe tout seul que lorsqu’il n’y a qu’une réponse : le même compte par nom et devise, la même catégorie par nom et type, ou ce que le dernier import de ce fichier a créé. Si plusieurs conviennent, la ligne te demande de choisir, et le bouton attend.

Un nouveau compte commence avec un solde nul, et son solde devient la somme de ses opérations : un fichier CSV n’a pas de solde de départ. Tu peux le corriger ensuite dans le compte.

Dans la version gratuite, l’import crée autant de nouveaux comptes qu’elle le permet ; les autres restent sur « Ne pas importer » avec Plus à côté. Les catégories n’ont pas de limite.

Un fichier exporté par Topf est reconnu en entier : ses colonnes sont associées toutes seules, et comptes et catégories sont retrouvés par leur ID. C’est ainsi qu’on déplace des opérations vers un autre compte utilisateur ou qu’on récupère ce qu’on a exporté. Le fichier ne contient que des opérations : budgets, opérations récurrentes et soldes de départ ne le suivent pas, et les montants dans la devise principale ne sont pas lus, car le taux est repris pour chaque date.

Dans un export de tous les comptes, un virement figure sur deux lignes, et Topf le reconstitue en un seul virement. L’export d’un seul compte ne contient que son côté, qui devient un virement si l’autre compte est déjà dans le livre avec la même devise. Les fichiers des banques et des autres apps n’ont pas ces paires : chaque ligne devient une dépense ou un revenu, car apparier des lignes par date et montant serait une supposition.

Importer deux fois le même fichier dans le même compte n’ajoute rien la seconde fois. Des relevés qui se chevauchent, comme deux mois avec quelques jours communs, ajoutent chaque opération une seule fois. Dans un autre compte, le même fichier s’ajoute de nouveau. Même chose pour un import fait sans compte utilisateur Topf : une fois que tu te connectes à ton compte Topf, le même fichier peut ajouter ses lignes une seconde fois.

Topf reconnaît une ligne à son contenu complet. Si une banque renumérote ou modifie ses lignes à chaque relevé, ces lignes peuvent s’ajouter une seconde fois. Avant l’import, vérifie combien d’opérations la ligne du haut de « Comptes et catégories » annonce ; si le résultat est faux, annule tout l’import.

Une opération que tu as supprimée dans Topf ne revient pas avec un nouvel import : l’import fait entrer des données, il ne restaure pas une sauvegarde.

Topf ne devine pas une ligne qu’il ne peut pas lire exactement. La ligne du haut de « Comptes et catégories » compte ces lignes ; « Détails » indique le numéro de chacune et la raison pour laquelle elle n’a pas été importée :

• pas de date ou pas de montant, ou une date qui n’existe pas ;
• une date à venir, ou un montant nul ;
• plus de décimales que la devise n’en a ;
• une devise non reconnue ou différente de celle du compte ;
• une note de plus de 280 caractères.

La devise peut s’écrire avec un code comme EUR ou un signe comme €. Les signes $ et ¥ appartiennent à plusieurs devises, il leur faut un code.

Rouvre l’import, touche « Annuler l’import » sous « Dernier import » et confirme. Les opérations de cet import quittent le livre, même celles modifiées depuis ; les comptes et catégories qu’il a créés aussi, sauf si autre chose les utilise encore.

L’annulation reste disponible sur cet appareil jusqu’à l’import suivant. Elle n’existe pas sur tes autres appareils, et un import fait sans compte utilisateur Topf ne peut plus être annulé dès que tu te connectes à ton compte Topf. Après une annulation, le même fichier peut être importé de nouveau, avec n’importe quels choix.

Si Topf a été fermé en plein import, ce qui a été écrit reste dans le livre et s’annule de la même façon : l’écran d’import indique le nombre d’opérations enregistrées et le nombre total prévu.

L’import est gratuit. Chaque opération arrive dans la devise de son compte, et le taux vers ta devise principale est celui de la date de l’opération, comme quand tu en ajoutes une pour un jour passé.