Firefly III : configuration CSV et détection des doublons

Une configuration du Data Importer de Firefly III est liée à une structure de fichier et à une installation, pas seulement à une banque. Modifier les rôles des colonnes ou la correspondance des comptes peut aussi changer la détection des doublons. Vérifiez les deux avant l’envoi du prochain relevé.

Pour une source PDF, LocalExtract exporte localement un CSV. Il ne crée ni identifiants de comptes Firefly, ni configuration JSON du Data Importer, ni import validé. Les colonnes du CSV sont date,description,amount.

Lier la configuration au véritable fichier

La référence officielle de configuration décrit le schéma version 3. Comparez séparateur, présence d’en-tête, dates, roles, do_mapping, mapping et default_account au fichier concerné. Les indices commencent à zéro : ajouter une colonne initiale peut invalider une configuration familière.

Identifiants et correspondances de noms appartiennent à l’installation cible. Une configuration bancaire partagée constitue une piste, pas la preuve que vos colonnes et comptes correspondent. Protégez votre configuration privée : elle peut contenir noms de comptes et identifiants financiers. Ne publiez pas un véritable fichier de configuration pour illustrer un problème.

Distinguer les trois modes de doublons

La référence de détection sépare none, classic et cell. ignore_duplicate_lines constitue un contrôle supplémentaire des lignes sources, pas un autre nom pour tous les contrôles en base.

Classic calcule une empreinte des données après application des rôles et correspondances, avant leur import. Les règles, webhooks et modifications ultérieurs ne recalculent pas cette empreinte initiale. Un changement de rôles ou de correspondances peut donc changer la représentation comparée d’un même événement bancaire.

Cell utilise unique_column_index et unique_column_type. Vérifiez que la colonne choisie contient réellement des identifiants uniques et stables. Date, montant ou bénéficiaire récurrent ne sont pas automatiquement uniques. Deux paiements réels de même montant restent distincts.

Valider avant l’étape d’envoi

Le processus par fichier distingue conversion/validation et envoi à Firefly III. Contrôlez compte, date, signe et identifiant dans l’aperçu. Un aperçu réussi ne prouve pas l’enregistrement des opérations. Si la configuration saute un formulaire, l’étape masquée ne constitue pas une nouvelle validation.

Le fichier fictif contient Date, Reference, Amount. Ajouter Account au début déplace Reference de l’indice 1 à 2. La fiche synthétique structure/identité contrôle ce déplacement et conserve deux paiements égaux portant des identifiants différents. Elle modélise la sélection des champs, sans exécuter Firefly ou son algorithme de doublons.

Gardez ensemble structure contrôlée, configuration et résultat réel. Si la détection change, comparez-les avant d’affaiblir les contrôles. Le guide des chevauchements CSV traite les sources ; ici, configuration et détection du Data Importer sont étudiées ensemble. Préparer un PDF localement, puis vérifier les champs pour la destination réelle.

Documentation officielle Firefly III vérifiée le 16 octobre 2026.