Comment importer vos transactions à partir d'un fichier CSV

Si votre courtier n'est pas directement pris en charge par OnePortfolio, vous pouvez toujours importer votre historique de transactions à l'aide d'un fichier CSV personnalisé. Ce guide explique le format requis et vous guide à travers le processus d'importation. Le format est flexible et prend en charge tous les types de transactions nécessaires.

1. Types de Transactions

Buy

Achat de titres.

Sell

Vente de titres.

Deposit

Dépôts en espèces sur votre compte.

Withdrawal

Retraits en espèces de votre compte.

Fee

Diverses commissions du courtier.

Tax

Frais liés aux impôts comme l'impôt sur les dividendes.

Dividend

Paiements de dividendes.

Exchange

Transactions de change de devises.

Interest

Intérêts gagnés ou payés.

2. Champs Obligatoires

Votre fichier CSV doit inclure les champs obligatoires suivants :

TransactionType

Le type de transaction de la liste ci-dessus (Buy, Sell, Deposit, etc.).

Symbol/ISIN

L'identifiant de sécurité - soit ISIN soit symbole. Si tu connais la bourse dans laquelle tu as acheté ou vendu ton actif, nous te recommandons vivement d'ajouter l'extension Cotation multiple. Laisse vide pour les transactions en espèces comme les dépôts et les retraits.

DateTime

Date et heure de la transaction au format ISO 8601. Prend en charge divers formats de fuseau horaire, y compris UTC, décalages explicites et fuseaux horaires nommés.

Currency

Code de devise à trois lettres ISO 4217 (par exemple, USD, EUR, CHF).

Quantity

Le nombre d'unités impliquées dans la transaction. Si vous avez acheté ou vendu 10 actions, vous devez spécifier 10 dans ce champ. Dans le cas des opérations Dividend, Withdrawal, Interest, Tax et Exchange, ce champ sera utilisé comme chiffre final. Si vous déposez 1000 USD, vous devez utiliser ce champ pour ce montant. À l'exception de Interest (payé/gagné), il n'est pas nécessaire de spécifier le signe.

FinalAmount*

Il s'agit d'un champ obligatoire qui s'applique uniquement aux opérations Exchange. Ce champ est utilisé pour décrire le montant final converti. Pas besoin de signe.

3. Champs Optionnels

Ces champs peuvent être inclus pour des détails supplémentaires sur la transaction. Dans le cas du prix unitaire et du montant final, vous devez fournir l'un des deux (voir ci-dessous) afin de calculer les valeurs de la transaction.

UnitPrice

Prix par unité dans la devise spécifiée. Nous recommandons de fournir ce chiffre pour la précision des données, mais comme certains courtiers peuvent ne pas fournir le prix unitaire payé dans leurs rapports, vous pouvez le laisser vide et fournir le montant final (voir ci-dessous), qui sera calculé en utilisant la quantité et le montant final. Pas besoin de signe.

FinalAmount

Le montant final payé. Selon votre courtier, ce montant peut inclure des frais ou non. Si vous disposez de ce chiffre, nous vous recommandons de le fournir, mais s'il est plus facile pour vous de ne fournir que la quantité et le prix unitaire, le montant final sera calculé. Pas besoin de signe.

Fee

Montant des frais de transaction dans la devise des frais. Pas besoin de signe.

FeeCurrency

Code de devise à trois lettres ISO 4217 pour les frais.

ExchangeTargetCurrency

Devise cible pour les transactions de change (par exemple, USD lors d'un échange de CHF vers USD).

BrokerTradeId

Identifiant unique de votre courtier pour la transaction.

Comments

Notes supplémentaires ou description de la transaction.

5. Remarques Importantes

Lors de la préparation de votre fichier CSV, gardez à l'esprit :
• Incluez toujours l'en-tête comme première ligne (voir l'exemple CSV à la fin de ce guide).
• Les champs sont séparés par des virgules, pas des points-virgules.
• Les champs vides ou optionnels ne doivent pas avoir de valeur ni d'espaces entre les virgules.
• Les champs de données ne doivent pas être entre guillemets.
• Le champ DateTime prend en charge divers formats ISO 8601, y compris différentes notations de fuseau horaire.

6. Processus d'Importation

Pour importer votre fichier CSV :
1. Connectez-vous à votre compte OnePortfolio.
2. Naviguez vers la section Transactions.
3. Cliquez sur 'Importer des Transactions'.
4. Glissez-déposez votre fichier CSV ou cliquez pour le sélectionner.
5. Confirmez l'actif si nécessaire.

4. Exemple CSV

Voici un exemple de fichier CSV montrant différents types de transactions avec différents formats de date et fuseaux horaires :

En-têtes

TransactionType,Symbol/ISIN,DateTime,Currency,Quantity,UnitPrice,FinalAmount,Fee,FeeCurrency,ExchangeTargetCurrency,BrokerTradeId,Comments

Exemples de Transactions avec Prix Unitaires

Deposit,,2024-02-22 00:00:00,CHF,10000,,,,,,Deposit in CHF Exchange,,2024-03-04 15:50:16,CHF,7007.92,0.8849,8000,,,USD,,CHF - USD Exchange Buy,WSML.L,2024-07-16 05:20:05,USD,1,7.468,,1.909678139,USD,,,ISHARES MSCI WLD SMALL CAP Buy,WSML.L,2024-07-16 05:20:05,USD,333,7.468,,0.0666,USD,,,ISHARES MSCI WLD SMALL CAP Tax,WSML.L,2024-09-05 00:00:00,USD,0.18,,,,,,,WSML.L(IE00BF4RFH31) CASH DIVIDEND USD 0.18 PER SHARE - US TAX Dividend,WSML.L,2024-12-27 00:00:00,USD,18.03,0.7894,,,,,,WSML.L(IE00BF4RFH31) CASH DIVIDEND USD 0.7894 PER SHARE (Ordinary Dividend) Sell,WSML.L,2025-03-04 03:20:33,USD,920,7.443,,3.60778,USD,,,ISHARES MSCI WLD SMALL CAP Sell,WSML.L,2025-03-04 03:20:33,USD,0.072,7.443,,0.000282348,USD,,,ISHARES MSCI WLD SMALL CAP Withdrawal,,2025-03-18 00:00:00,CHF,100,,,,,,,Withdrawal CHF Interest,,2025-04-01 00:00:00,CHF,-0.09,,,,,,,Interest Paid Interest,,2025-04-01 00:00:00,CHF,0.02,,,,,,,Interest Earned

Exemples de Transactions sans Prix Unitaires (avec FinalAmount)

Deposit,,2024-02-22 00:00:00,CHF,10000,,,,,,,Deposit in CHF Exchange,,2024-03-04 15:50:16,CHF,7007.92,,8000,,,USD,,CHF - USD Exchange Buy,WSML.L,2024-07-16 05:20:05,USD,1,,7.468,1.909678139,USD,,,ISHARES MSCI WLD SMALL CAP Buy,WSML.L,2024-07-16 05:20:05,USD,333,,2486.844,0.0666,USD,,,ISHARES MSCI WLD SMALL CAP Tax,WSML.L,2024-09-05 00:00:00,USD,0.36,,,,,,WSML.L(IE00BF4RFH31) CASH DIVIDEND USD 0.18 PER SHARE - US TAX Dividend,WSML.L,2024-12-27 00:00:00,USD,18.03,,,,,,WSML.L(IE00BF4RFH31) CASH DIVIDEND USD 0.7894 PER SHARE (Ordinary Dividend) Sell,WSML.L,2025-03-04 03:20:33,USD,920,,6847.56,3.60778,USD,,,ISHARES MSCI WLD SMALL CAP Sell,WSML.L,2025-03-04 03:20:33,USD,0.072,,0.535896,0.000282348,USD,,,ISHARES MSCI WLD SMALL CAP Withdrawal,,2025-03-18 00:00:00,CHF,100,,,,,,,Withdrawal CHF Interest,,2025-04-01 00:00:00,CHF,-0.09,,,,,,,Interest Paid Interest,,2025-04-01 00:00:00,CHF,0.02,,,,,,,Interest Earned