Doublons et réimport

Réimporter un fichier que vous avez déjà importé ne crée pas de transactions en double. Chaque ligne d'un import est comparée à ce qui figure déjà dans votre projet, et les répétitions sont marquées Doublon et ignorées. Les plages de dates qui se chevauchent ne posent aucun problème, un même fichier peut être importé deux fois, et le rythme habituel — exporter depuis votre courtier chaque semaine ou chaque mois et déposer le fichier entier — ne demande aucun rognage manuel.

Cet article explique ce que l'importateur compare réellement, à quoi sert chaque statut de ligne, comment forcer des valeurs corrigées sur des transactions que vous avez déjà, et ce qu'il advient des lignes qui n'ont pas pu être importées.

Ce que l'importateur compare

Deux comparaisons différentes, selon le fichier. Si les données comportent une référence de transaction — un identifiant unique attribué par le courtier à chaque opération — Capitally fait la correspondance sur l'actif, le compte et la référence, si bien que la quantité, le prix et même la date peuvent avoir changé et la ligne sera toujours reconnue comme celle que vous avez déjà. En l'absence de référence, il se rabat sur l'actif, le compte, le type de transaction, la date et la quantité arrondie à deux décimales. Le type de transaction doit correspondre dans les deux cas.

La quantité n'entre en compte que pour les types qui en ont une : achats, ventes, transferts, soldes de comptes et conversions. Pour un dividende, des frais ou un paiement d'intérêts sans référence, l'actif, le compte, le type et la date constituent l'ensemble de la clé — deux paiements de montants différents, sur le même actif et le même jour, apparaissent identiques à l'importateur.

La correspondance par référence est la plus précise, et elle est disponible pour les courtiers qui publient des identifiants uniques dans leurs exports. La référence est une propriété de transaction classique, si bien qu'un préréglage personnalisé peut aussi la mapper — voir la référence des propriétés de transaction, où elle figure sous le nom Référence. Certains préréglages intégrés le font déjà lorsque le courtier ne publie aucun identifiant : le préréglage Goldman Sachs TFI, par exemple, compose une référence à partir du type de transaction, de la date et du nombre d'unités, si bien que ses conversions sont dédupliquées avec la même précision qu'une transaction IBKR.

Interactive Brokers en est l'exemple le plus clair : chaque ligne d'une Flex Query porte l'un des identifiants propres à IBKR, si bien que chaque transaction qui en est importée possède une référence. Les trades prennent le TradeID, les transactions cash prennent le TransactionID, et les dividendes prennent l'ActionID — c'est aussi ce qui regroupe dans Capitally un dividende payé sur plusieurs lignes en une seule transaction plutôt qu'en cinq. Puisque la déduplication s'appuie sur la référence, vous pouvez modifier à la main une transaction IBKR importée, changer sa date par exemple, et réimporter une plage qui se chevauche ne la dupliquera pas pour autant.

Doublon, Mise à jour et les lignes ignorées

Chaque ligne du tableau de revue d'import porte un statut. Doublon signifie que la transaction est déjà dans votre projet : la ligne est ignorée et rien ne change. Créer signifie qu'elle sera ajoutée. Mise à jour écrit les valeurs de la ligne sur la transaction que vous avez déjà. Exclue marque une ligne que l'importateur n'a pas pu convertir en transaction, généralement parce que son actif ou son type de transaction n'a pas pu être résolu, et échec marque une ligne qui a rencontré une erreur. Survolez l'icône d'information à côté d'un statut pour en voir la raison.

Vous pouvez modifier le statut de n'importe quelle ligne. Le menu déroulant propose créer et ignorer, plus mettre à jour partout où une transaction existante a été appariée — si bien qu'une ligne marquée Doublon peut être passée en mise à jour, ou forcée en tant que deuxième transaction distincte avec créer. Pour modifier plusieurs lignes à la fois, sélectionnez-les et définissez la valeur sur l'une d'elles ; le changement s'applique à toute la sélection. Cliquer sur un en-tête de colonne trie le tableau, et trier par Statut regroupe aussi les lignes sous un en-tête par statut, ce qui rend la revue d'un long import bien plus rapide.

Les dividendes automatiques se comportent légèrement différemment. Lorsque vous téléversez des données de courtier, Capitally supprime ses propres prévisions de dividendes pour la période, si bien qu'importer les dividendes de votre courtier est la bonne chose à faire. L'exception est une prévision que vous avez modifiée ou confirmée vous-même : celle-ci est conservée, et la ligne entrante est marquée comme doublon à la place. La règle distincte qui empêche la création de dividendes automatiques à côté d'un dividende manuel est décrite dans Suivi des dividendes — c'est un mécanisme différent de la correspondance de transactions décrite ici.

Forcer une mise à jour sur des transactions déjà importées

Faites passer le statut des lignes concernées de Doublon à Mise à jour. Les lignes Doublon sont ignorées, si bien qu'une valeur corrigée dans un nouvel export — un montant de retenue à la source, des frais, un dividende révisé — n'atteint jamais la transaction existante tant que vous n'avez pas changé le statut. La mise à jour réécrit les valeurs sur la transaction que vous avez déjà plutôt que d'en ajouter une seconde.

1. Relancez l'import avec le dernier export en date de votre courtier.
2. Sur l'écran de revue, cliquez sur l'en-tête de la colonne Statut pour trier par statut, afin que toutes les lignes Doublon se retrouvent regroupées sous un même en-tête de groupe.
3. Sélectionnez tout le groupe à l'aide de la case à cocher de l'en-tête de groupe.
4. Sur l'une des lignes sélectionnées, changez le statut en Mise à jour. Le changement s'applique à toutes les lignes sélectionnées.
5. Poursuivez jusqu'à l'étape Résumé, où les soldes finaux de chaque position que vous importez sont affichés, puis confirmez l'import.

C'est aussi la réponse après que nous avons corrigé un préréglage d'import : vous n'avez rien à supprimer ni à démarrer un nouveau projet pour bénéficier du correctif. Réimportez le même fichier et passez les lignes Doublon en Mise à jour.

Quand une vraie transaction est signalée comme doublon

Passez le statut de cette ligne à créer avant de confirmer l'import. La déduplication s'applique à chaque import et aucun réglage ne permet de la désactiver ; le levier dont vous disposez est le statut de la ligne, et créer l'importe comme une nouvelle transaction supplémentaire au lieu de l'ignorer.

Mieux vaut s'en assurer d'abord. Ignorer volontairement une ligne qui est vraiment un doublon ne coûte rien, tandis que forcer une ligne qui avait été correctement signalée enregistre deux fois la même transaction.

Faux doublons entre deux comptes chez un même courtier

Passez les lignes signalées à tort en créer avant de confirmer, puis séparez les deux comptes pour que cela ne se reproduise plus. Deux comptes chez le même courtier importés dans un seul compte Capitally entrent en collision dès qu'un frais ou une transaction partage la même date, le même actif et le même type dans les deux. Le second est ignoré, et le solde de ce compte se retrouve amputé d'exactement ce montant.

La même chose se produit lors d'un premier import depuis une source dont l'export unique couvre deux comptes — un fichier Robinhood contenant à la fois le brokerage account et le Roth IRA, par exemple.

Il n'existe pas d'interrupteur pour désactiver la correspondance, si bien que le correctif permanent consiste à modifier l'un des trois éléments que l'importateur compare avant la date et la quantité : le compte, l'actif ou la référence.

• Le compte. Gardez un compte Capitally par compte réel — voir Organiser son portefeuille. Une fois que les deux ensembles de lignes arrivent dans des comptes différents, ils cessent complètement d'entrer en collision. Attribuez à chaque compte sa propre variante de préréglage et la séparation se fait à chaque import ultérieur sans que vous ayez à y penser — les variantes de préréglage sont abordées dans Importer depuis un courtier ou une application.
• L'actif. Si vous préférez conserver les deux comptes réels sous un seul compte Capitally, attribuez à chacun son propre actif cash — deux actifs cash EUR plutôt qu'un seul partagé. L'actif est comparé avant tout le reste, si bien que les deux ensembles de frais cessent de paraître identiques. Voir Suivi de trésorerie.
• La référence. Dans un préréglage enregistré, mappez la propriété Référence sur quelque chose qui diffère entre les deux comptes — une colonne de numéro de compte, ou une formule la combinant avec la date. Lorsque les deux côtés portent une référence, c'est la référence qui décide, si bien que deux références distinctes n'entrent jamais en collision. Voir Importer en mode avancé.

Lignes avec un type de transaction non pris en charge

Un avertissement indiquant qu'un type de transaction n'est pas pris en charge signifie que le préréglage n'a pas encore rencontré ce type dans un fichier d'échantillon — non pas que Capitally soit incapable de le modéliser. Cette ligne est ignorée et toutes les autres lignes du fichier sont malgré tout importées, si bien que l'import n'est pas perdu. Rien n'est stocké pour une ligne ignorée, ce qui explique pourquoi réimporter le même fichier plus tard est sans risque.

Que faire de ces lignes :

1. Notez le type mentionné dans l'avertissement sur l'écran de revue — le message le cite, comme dans « Les transactions cash de type X ne sont actuellement pas prises en charge » — et envoyez le fichier par e-mail à support@mycapitally.com, en précisant votre courtier. Si le fichier contient des données que vous préférez ne pas envoyer, utilisez l'export anonymisé décrit dans Obtenir de l'aide.
2. Nous ajoutons généralement la prise en charge d'un nouveau type en quelques jours.
3. Réimportez le même fichier. Seules les lignes précédemment manquantes sont ajoutées ; tout le reste revient en Doublon et est ignoré.

Il en va de même pour les lignes que vous ignorez délibérément, ou que vous marquez comme ignorées pendant l'import : elles n'existent qu'à l'intérieur de cette session d'import et ne sont jamais stockées. Une fois ce qui les bloquait résolu — un actif ajouté à notre base de données, le suivi de trésorerie activé sur le compte — réimportez le fichier et elles rentrent.

Quand un correctif ne semble pas prendre effet

Deux causes, dans cet ordre. Votre application fonctionne peut-être encore sur une version antérieure à celle qui embarque le correctif. Si la version est à jour, vous êtes très probablement en train de poursuivre une session d'import démarrée avant la mise en production du correctif, si bien qu'elle exécute encore l'ancienne logique de préréglage du début à la fin.

1. Vérifiez la version de l'application dans le menu en haut à droite. Si elle est antérieure à celle contenant le correctif, patientez un peu et rafraîchissez.
2. Abandonnez l'import en cours.
3. Démarrez un tout nouvel import de zéro, avec un export récent de votre courtier, afin que le préréglage mis à jour soit appliqué dès la première ligne.
4. Si les données incorrectes sont déjà présentes dans votre projet, réimportez-les et basculez les lignes en doublon (Duplicate) sur Mettre à jour, comme décrit ci-dessus, afin que les valeurs corrigées écrasent celles existantes.

Vous trouverez plus d'informations sur les contrôles de version et l'actualisation de l'application dans Dépannage de l'application.

Importer plusieurs fichiers dans l'ordre

Importez le fichier le plus ancien en premier, puis avancez chronologiquement. Il n'est pas nécessaire de combiner les fichiers : importez-les individuellement, dans l'ordre chronologique, et laissez les plages se chevaucher si nécessaire. Les exports d'Interactive Brokers étant limités à une année maximum, un historique de dix ans se présentera sous la forme de dix fichiers plutôt qu'un seul.

Une fois l'historique chargé, réexportez et importez vos données dès que vous avez effectué des transactions ; une fréquence hebdomadaire ou mensuelle est habituelle. Les prix des actifs cotés s'actualisent automatiquement ; une importation n'est donc nécessaire que lorsque des transactions ont eu lieu. La configuration de la Flex Query elle-même est décrite sur l'écran d'importation, à côté du préréglage IBKR ; Interactive Brokers explique les problèmes potentiels liés aux exports qu'ils produisent.

Annuler une importation

Chaque importation peut être entièrement annulée. Immédiatement après l'opération, utilisez la notification qui apparaît à l'écran. Plus tard, ouvrez l'Historique depuis le menu en haut à droite : toutes les modifications liées à une même importation sont regroupées dans une seule entrée, que vous pouvez développer pour visualiser les changements individuels effectués.

À partir de là, vous pouvez sélectionner l'intégralité du groupe pour le supprimer, ou ne choisir que certaines modifications ; tout ce que vous supprimez peut être restauré depuis ce même écran. Les détails sont disponibles dans Historique des changements. Si vous préférez repartir sur des bases saines, créez un nouveau projet et recommencez l'importation depuis zéro ; cela est recommandé lorsque vous prévoyez d'importer une grande quantité de données provenant des mêmes courtiers.