NC
Pourquoi j'ai codé un parser IA
Par Nicolas Caetano — fondateur de Kapi

Au début, Kapi supportait seulement 5 formats de courtiers. Les utilisateurs m'envoyaient des CSV bizarres tous les jours : un export Excel personnalisé, un PDF converti, un mix de 3 comptes. J'ai fini par coder un parser IA qui devine la structure de n'importe quel fichier. C'est ce que décrit ce guide.

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 Kapi serait fastidieux, chronophage et source d'erreurs. C'est précisément pour cela que l'import CSV est entièrement piloté par intelligence artificielle : vous glissez un fichier, l'IA en extrait les transactions, vous validez.

Comment ça marche

Contrairement à la plupart des outils, Kapi ne vous demande pas de sélectionner le format de votre courtier. Que le fichier vienne de Boursorama, Trade Republic, Degiro, Fortuneo, ou d'un export Excel personnalisé que vous tenez à jour depuis 5 ans, le même parser IA s'adapte.

Concrètement, quand vous chargez un fichier, Kapi effectue dans l'ordre :

  1. Parsing structurel : l'IA identifie quelle colonne contient la date, le nom de l'action, la quantité, le prix, les frais, le type d'opération.
  2. Résolution des actions : pour chaque ligne, Kapi cherche l'ISIN canonique de l'action en priorisant la base de données locale, puis une recherche Web d'autorité si nécessaire.
  3. Affectation du compte : PEA, CTO, PEA-PME, ou répartition automatique si vous avez un fichier mixte.
  4. Aperçu interactif : vous pouvez modifier, supprimer ou réaffecter chaque ligne avant de confirmer l'import.

Les prérequis par ligne

L'IA est robuste face aux formats exotiques, mais elle a besoin d'un minimum d'informations par transaction pour la reconstituer correctement. Avant d'importer, vérifiez que chaque ligne de votre CSV contient :

⚠️ Cryptomonnaies non prises en charge

L'import CSV est réservé aux actions et ETF. Les lignes crypto (BTC, ETH…) seront ignorées ou mal identifiées — utilisez le suivi crypto natif de Kapi pour ces actifs.

Étape 1 : ouvrir l'import

Dans l'application, allez dans votre profil puis cliquez sur « Importer un fichier CSV ». Un écran s'ouvre avec :

Plus besoin de choisir votre courtier, ni le type de compte : ces deux étapes arrivent après le parsing, quand vous avez une vue claire de ce qui a été lu.

Étape 2 : l'aperçu et le choix du compte

Une fois le CSV chargé, Kapi vous présente l'aperçu complet de ce qu'il a compris. En haut de l'écran, vous choisissez le compte de destination :

Le mode Mixte est le plus pratique si votre CSV contient plusieurs comptes (par exemple un export bancaire consolidé). Dans ce mode, l'aperçu affiche trois onglets — PEA, CTO, PEA-PME — avec le compteur de transactions dans chacun. Chaque ligne porte un petit badge avec une flèche de permutation : vous pouvez taper dessus pour déplacer manuellement une transaction d'un compte à l'autre si l'auto-routage s'est trompé.

Étape 3 : les avertissements non-bloquants

Avant d'importer, Kapi vous signale les points d'attention sans jamais bloquer l'import. Trois types d'alertes peuvent apparaître :

Actions non éligibles au PEA

Si vous avez sélectionné PEA mais que certaines lignes ont un ISIN non européen (US, UK, CH…), une alerte rouge liste les tickers concernés. Votre courtier les rejettera à l'import réel : vous êtes prévenu en amont.

Solde d'approvisionnement négatif

Kapi calcule achats + frais moins ventes + dividendes + approvisionnements. Si le solde est négatif — ce qui signifie que vous avez acheté plus que l'argent versé sur le compte — une alerte orange vous propose un bouton « Ajouter approvisionnement ». Vous pouvez ajouter plusieurs versements datés pour équilibrer, ou importer tel quel et compléter plus tard dans l'app.

ISIN manquant

Pour chaque ligne où Kapi n'a pas pu déterminer l'ISIN canonique, un badge orange « ISIN manquant » s'affiche et la ligne est surlignée. En pratique ça arrive rarement (<2 % des imports dans mes tests), mais quand ça arrive c'est souvent un OPC exotique ou un ETF récent.

Étape 4 : éditer ou supprimer une transaction

Chaque transaction de l'aperçu est interactive.

Modifier une action

Tapez sur une ligne pour ouvrir une feuille d'édition. Vous pouvez changer l'action associée en tapant sur la carte du haut : cela ouvre l'explorateur Kapi avec le logo, le nom, le ticker et l'ISIN officiels. Sélectionnez la bonne action, ajustez la quantité, le prix unitaire ou les frais, puis validez. En mode Mixte, si vous changez l'ISIN, le compte de destination est réaffecté automatiquement selon le nouveau pays.

Supprimer une transaction

Deux manières : glissez la ligne vers la gauche (swipe), ou tapez sur l'icône corbeille à droite. Une confirmation vous demande de valider avant que la ligne soit retirée de l'import. Cette action est réversible uniquement en relançant l'import depuis zéro.

Étape 5 : confirmer l'import

En bas de l'écran, le bouton vert « Importer N transactions » valide définitivement. Kapi crée alors toutes les transactions dans votre portefeuille, calcule vos PRMP, met à jour vos positions ouvertes et recharge automatiquement les prix en temps réel.

ⓘ Attention au mode remplacement

Pour éviter les doublons quand vous ré-importez un CSV mis à jour, Kapi supprime les transactions existantes des comptes cibles avant d'importer les nouvelles. Cela garantit un état cohérent, mais signifie qu'un import partiel remplace tout. Si vous voulez seulement ajouter quelques transactions, utilisez plutôt le bouton « Ajouter une transaction » manuel dans l'app.

Où trouver son CSV chez les principaux courtiers

Chaque courtier a sa propre interface. Voici les chemins les plus courants :

Questions fréquentes

L'IA se trompe sur une action. Que faire ?

Ouvrez la ligne concernée dans l'aperçu, tapez sur la carte action, et sélectionnez la bonne via l'explorateur. Si l'ISIN a changé, le compte Mixte est réaffecté automatiquement.

Mon CSV contient 500 lignes, ça va marcher ?

Oui. Le parser traite les fichiers jusqu'à 150 lignes dans une passe unique et tronque poliment au-delà. Pour des imports très volumineux, coupez le fichier en plusieurs tranches (par année par exemple).

Est-ce que mes données sont envoyées à des tiers ?

Le contenu du CSV est envoyé à l'API Gemini de Google (le modèle qui fait le parsing) puis à Supabase (pour stocker les transactions de votre compte Kapi). Aucun tiers autre que ces deux prestataires n'a accès aux données. Voir la politique de confidentialité pour le détail.

Combien de temps ça prend ?

Entre 5 et 15 secondes pour un CSV typique de 20-50 lignes. Le temps varie selon le nombre d'actions à résoudre via recherche Web.

En résumé

L'import CSV de Kapi est conçu pour accepter n'importe quel format sans configuration préalable. L'IA fait le gros du travail, l'aperçu interactif vous donne le contrôle final, et les avertissements non-bloquants vous signalent les problèmes éventuels sans vous bloquer. En quelques minutes, vous passez d'un fichier brut à un portefeuille complet dans Kapi, avec vos PRMP calculés et vos positions consolidées.