Vous avez déjà un historique de transactions chez votre courtier — des achats, des ventes, peut-être des dividendes accumulés au fil des mois ou des années. Tout ressaisir manuellement dans une nouvelle application serait fastidieux, chronophage et source d'erreurs. C'est précisément pour cela que Kapi intègre un système d'import CSV intelligent.

En quelques clics, vous pouvez transférer l'intégralité de votre historique de transactions dans Kapi. L'application détecte automatiquement votre courtier, parse les données et vous présente une prévisualisation avant l'import définitif. Fini la saisie manuelle, bonjour l'efficacité. Ce guide vous accompagne pas à pas dans le processus.

Courtiers supportés

Kapi prend actuellement en charge cinq courtiers, couvrant les plateformes les plus utilisées par les investisseurs particuliers en France et en Europe. Le système de détection automatique analyse la structure de votre fichier CSV et identifie le courtier sans aucune intervention de votre part.

Courtier Format Détection auto Particularité
Kapi CSV natif Oui Format de référence, export/import parfait
Degiro CSV export Oui Séparateur point-virgule, montants en EUR
Trade Republic CSV / PDF Oui Export CSV si disponible, sinon conversion PDF
Boursorama CSV export Oui Inclut les frais dans une colonne dédiée
Fortuneo CSV export Oui Export depuis l'historique des ordres

Si votre courtier ne figure pas dans cette liste, pas de panique. Vous pouvez utiliser le format Kapi universel (détaillé plus bas) pour importer manuellement vos transactions depuis n'importe quel courtier. C'est un format CSV simple que vous pouvez créer dans Excel ou Google Sheets.

Comment exporter depuis votre courtier

Chaque courtier propose une interface différente pour exporter vos données. Voici les étapes détaillées pour chacun d'entre eux. L'objectif est toujours le même : obtenir un fichier CSV contenant l'historique complet de vos transactions.

Degiro

  1. Connectez-vous à votre compte Degiro sur le site web.
  2. Rendez-vous dans Activité → Transactions.
  3. Sélectionnez la période souhaitée (choisissez la plus large possible).
  4. Cliquez sur Exporter et choisissez le format CSV.
  5. Enregistrez le fichier sur votre appareil.

Trade Republic

  1. Ouvrez l'application Trade Republic ou connectez-vous sur le site.
  2. Allez dans Paramètres → Exporter les données.
  3. Sélectionnez Transactions et la période souhaitée.
  4. Si le format CSV est proposé, choisissez-le directement.
  5. Sinon, exportez en PDF et utilisez un convertisseur PDF vers CSV en ligne.

Boursorama

  1. Connectez-vous à votre espace client Boursorama.
  2. Accédez à Portefeuille → Historique.
  3. Filtrez par période pour couvrir tout votre historique.
  4. Cliquez sur Exporter et sélectionnez le format CSV.

Fortuneo

  1. Connectez-vous sur votre espace Fortuneo.
  2. Rendez-vous dans Portefeuille → Historique des ordres.
  3. Définissez la période d'export (sélectionnez la plus large).
  4. Cliquez sur Télécharger pour obtenir le fichier CSV.

Astuce : Exportez toujours la période la plus large possible pour obtenir un historique complet. Un import partiel faussera les calculs de performance, de PRMP et de plus-values dans Kapi.

Importer dans Kapi

Une fois votre fichier CSV en main, l'import dans Kapi se fait en quatre étapes simples. Le processus est conçu pour être intuitif, avec une prévisualisation complète avant tout enregistrement définitif.

1 📤

Exporter

Téléchargez le CSV depuis votre courtier

2 📥

Importer

Chargez le fichier dans Kapi

3 🔎

Prévisualiser

Vérifiez les transactions détectées

4 ✅

Valider

Confirmez et importez définitivement

Détail du processus :

  1. Accédez à l'import : Dans Kapi, rendez-vous sur la page Transactions et appuyez sur le bouton Import (icône en haut à droite).
  2. Sélectionnez votre fichier : Glissez-déposez votre fichier CSV ou utilisez le sélecteur de fichiers pour le choisir sur votre appareil.
  3. Détection automatique : Kapi analyse la structure du fichier et identifie automatiquement le courtier. Aucune configuration nécessaire de votre part.
  4. Prévisualisation : Toutes les transactions détectées s'affichent dans un tableau récapitulatif. Vérifiez les dates, les types (achat, vente, dividende), les montants et les frais.
  5. Validation : Si tout est correct, confirmez l'import. Les transactions sont enregistrées et vos positions sont recalculées automatiquement.

Gestion intelligente des doublons : si vous importez un fichier contenant des transactions déjà présentes dans Kapi, le système les détecte et les ignore automatiquement. Vous pouvez donc réimporter un fichier mis à jour sans risquer de créer des doublons.

Attention : Vérifiez soigneusement la prévisualisation avant de valider. Assurez-vous que les frais et les dividendes sont correctement détectés. En cas de doute, vous pouvez annuler et ajuster votre fichier avant de réessayer.

Format Kapi (import manuel)

Si votre courtier n'est pas encore supporté nativement, ou si vous souhaitez importer des transactions depuis une source particulière (tableur personnel, autre application), vous pouvez utiliser le format CSV Kapi. Il s'agit d'un format simple et standardisé que vous pouvez créer facilement dans Excel, Google Sheets ou tout éditeur de texte.

Voici les colonnes attendues :

format-kapi.csv 
Date;Type;Ticker;Quantite;Prix;Frais;Compte
15/01/2025;achat;MC.PA;5;850.20;1.50;PEA
22/03/2025;achat;AAPL;10;178.50;0.99;CTO
10/06/2025;dividende;MC.PA;5;12.00;0;PEA
05/09/2025;vente;AAPL;5;195.30;0.99;CTO

Le séparateur accepté est le point-virgule (standard français) ou la virgule (standard international). Kapi détecte automatiquement le séparateur utilisé. Assurez-vous que l'encodage du fichier est en UTF-8 pour éviter les problèmes de caractères spéciaux.

Astuce : Créez votre fichier dans Google Sheets ou Excel, puis exportez-le en CSV (UTF-8). Cela garantit un formatage correct et évite les erreurs de séparateurs ou d'encodage.

Résolution de problèmes

Il arrive parfois que l'import ne se passe pas comme prévu. Voici les problèmes les plus courants et leurs solutions :

« Mon fichier n'est pas reconnu »

Vérifiez que votre fichier est bien au format CSV (et non XLS ou XLSX). Assurez-vous également que l'encodage est en UTF-8. Dans Excel, lors de l'enregistrement, choisissez explicitement « CSV UTF-8 (délimité par des virgules) ». Si le problème persiste, essayez d'ouvrir le fichier dans un éditeur de texte (Bloc-notes, VS Code) pour vérifier sa structure.

« Des transactions manquent »

Vérifiez la période d'export chez votre courtier. Certains courtiers limitent l'export à une année par défaut. Sélectionnez manuellement la période la plus large possible, idéalement depuis l'ouverture de votre compte. Pensez également à vérifier que les dividendes et les opérations sur titres sont inclus dans l'export.

« Les montants sont incorrects »

Ce problème vient généralement du séparateur décimal. En France, on utilise la virgule (12,50), tandis que le format international utilise le point (12.50). Si vos montants semblent multipliés par 100 ou tronqués, vérifiez ce point dans votre fichier. Kapi gère les deux formats, mais le fichier doit être cohérent.

« Le courtier n'est pas détecté »

Si Kapi ne reconnaît pas automatiquement votre courtier, vous pouvez reformater vos données en utilisant le format Kapi décrit ci-dessus. Cela prend généralement quelques minutes dans un tableur. N'hésitez pas à nous contacter à [email protected] pour demander l'ajout de votre courtier.

Besoin d'aide ? Si vous rencontrez un problème non listé ici, contactez-nous à [email protected] en joignant votre fichier CSV (anonymisé si nécessaire). Nous vous aiderons à le rendre compatible avec Kapi.

Conclusion

L'import CSV est la manière la plus rapide de démarrer avec Kapi lorsque vous avez déjà un historique chez un courtier. En quelques minutes, vous récupérez des mois ou des années de transactions, et toutes les analyses de Kapi — PRMP, plus-values, dividendes, performance — sont immédiatement disponibles.

Le processus est conçu pour être simple et sûr : détection automatique du courtier, prévisualisation avant import, gestion des doublons. Et si votre courtier n'est pas encore supporté, le format Kapi universel vous permet d'importer depuis n'importe quelle source. Votre portefeuille complet dans Kapi, c'est à un fichier CSV près.