Si la plateforme que vous utilisez n’est pas encore gérée par notre application, ou si des opérations sont manquantes malgré une connexion à l’un de vos comptes par clés API, notez qu’il est toujours possible d’ajouter vos données de transactions grâce à notre système d’import par fichier CSV.
Pour cela, vous devez suivre les instructions suivantes afin de créer un fichier CSV au format attendu avant de pouvoir l’importer dans l’application ComptaCrypto
Principe #
1) Téléchargez le template #
Nous avons crée un modèle de fichier CSV à télécharger. Celui-ci contient des exemples de données qui vont vous permettre de comprendre facilement le format attendu.
Vous trouverez plus d’informations sur les pré-requis de ce format dans la suite de cette documentation, dans la partie “Format du fichier CSV”.
Vous pouvez télécharger le fichier template directement depuis l’application Comptacrypto.
2) Importez vos transactions #
Après avoir téléchargé le modèle, modifiez-le avec vos propres données. Puis, importez votre fichier dans Comptes -> Connecter un compte -> CSV (voir démonstration ci-dessous).
Format du fichier CSV #
Remarques générales #
Le fichier attendu est un CSV avec virgule comme séparateur. Il doit obligatoirement contenir les colonnes suivantes dans l’ordre suivant, même si celles-ci sont vides :
- Timestamp
- Operation Type
- Operation Sub Type *
- Base Amount
- Base Currency
- Quote Amount (obligatoire pour les opérations de type trade, ignoré pour les autres opérations.)
- Quote Currency (obligatoire pour les opérations de type trade, ignoré pour les autres opérations.)
- Fee Amount *
- Fee Currency *
- Notes *
* optionnel
Tous les montants contenus dans le fichier CSV sont exprimés positivement. Seuls les types d'opérations énumérés dans la liste ci-dessous peuvent être inscrits dans le fichier CSV. Seuls les sous-types d'opérations énumérés dans la liste ci-dessous peuvent être inscrits et doivent respecter le type d'opération choisi.
Description des colonnes #
Le timestamp peut être exprimé en 2 formats différents :
1 : Comme une chaîne de caractères respectant le format utc datetime
Exemple :
“2022-09-22T14:34:40+07:00” sera converti en 2022-09-22 07:34:40 UTC
Si la chaîne de caractères ne contient pas d’information sur la zone temporelle, la date sera considérée comme une date UTC.
2 : Comme un entier de type unix timestamp (nombre de secondes écoulées depuis le 1er janvier 1970 à minuit UTC)
Exemple :
1663832080 sera converti en 2022-09-22 07:34:40 UTC
Pour plus d’informations sur le format : https://www.w3.org/TR/NOTE-datetime
Les différents types d’opérations attendus sont :
- deposit
- withdrawal
- trade
En fonction du type d’opérations, un sous-type non-obligatoire peut être donné dans le but de qualifier l’opération de façon plus précise.
Deposit / Withdrawal
Les types d’opération “deposit” / “withdrawal” sont à utiliser pour toute opération ayant une influence positive / négative sur votre portefeuille.
Pour ce type d’opérations, les colonnes “quote amount” et “quote currency” seront ignorées.
Si une commission est appliquée sur l’opération, veuillez ne pas inclure le montant de la commission dans le montant de base (base amount) mais renseignez-le dans la colonne commission (fee amount).
Si l’opération représente seulement une commission, veuillez remplir uniquement la colonne “montant de base” en sélectionnant le sous-type “commission”. Ne remplissez pas les colonnes “fee amount” / “fee currency”, sinon celles-ci seront comptées 2 fois.
Sous types attendus :
realized_pnl
Revenu ou perte realisée
capital_gain_loss
Ecart de conversion
yield_farming_reward
Le yield farming, également appelé “agriculture de rendement”, fait référence à une pratique dans le domaine des crypto-monnaies où les détenteurs de tokens fournissent leurs fonds à des protocoles DeFi (Finance décentralisée) afin de générer des rendements élevés. Les utilisateurs peuvent gagner des récompenses, sous la forme de tokens ou de frais, en fournissant des liquidités ou en effectuant des transactions sur ces protocoles. Le yield farming implique souvent des stratégies complexes telles que le prêt, le staking ou le stacking de tokens pour optimiser les rendements potentiels.
dividend
Gains sur produits financiers par tiers
delivered_settlement
Règlement livré
airdrop
Un airdrop crypto est une distribution gratuite de tokens ou de crypto-actifs à une communauté spécifique. Les airdrops sont généralement réalisés par des projets blockchain dans le but de promouvoir leur crypto-monnaie, d’encourager la participation à leur réseau ou de récompenser leurs détenteurs de tokens existants. Les tokens airdropés sont souvent distribués aux détenteurs de certaines crypto-monnaies déjà en leur possession ou aux participants qui remplissent certaines conditions spécifiques définies par le projet.
referral_kickback
Récompense de parrainage welcome_bonus Bonus de bienvenue
insurance_clear
Règlement d’assurance
contest_reward
Récompense de jeu concours
mining_reward
Récompense de minage de crypto-actifs
funding_payment
Paiement de financement
speculation_nft_buy
Paiement d’un NFT acheté à but spéculatif
speculation_nft_sell
Paiement d’un NFT vendu à but spéculatif
service_nft_sell
Paiement d’un NFT vendu en prestation de service
service_nft_buy
Paiement d’un NFT acheté en prestation de service
service_nft_sell_get_no_invoice
Paiement d’un NFT vendu en prestation de service sans facture
service_nft_buy_send_no_invoice
Paiement d’un NFT acheté en prestation de service sans facture
nft_mint
Commission de mint NFT royalties Revenu de royalties
margin_loan
Margin loan margin_repay
Margin repay margin_repay_interest
Margin repay interest customer_payment
Customer payment supplier_payment
Supplier payment borrow Borrow lending Lending
internal_transfer
Flux partant d’un des comptes de votre société vers un autre compte de votre société
commission
Frais de transactions
future_commission
Commission sur contrat a terme
funding_fee
Frais de financement
commission_rebate
Remboursement de commission
deducted_fee
Commission deduite
token_emit
Emission de token
ico
ICO
investment
Investissement
other
Autres (sans facture)
staking_reward
Le staking est le processus de blocage de crypto-actifs dans un portefeuille ou un compte spécifique afin de participer au fonctionnement et à la sécurisation d’un réseau blockchain. En échange de la mise en jeu de ces actifs, les détenteurs sont récompensés par des intérêts. Le staking contribue à la délégation des droits de vote, à la validation des transactions et au maintien de la sécurité du réseau.
masternode_reward
Un masternode est un nœud (node) dans un réseau blockchain qui possède une certaine quantité de crypto-actifs et qui offre des services avancés au réseau. Les masternodes fournissent des fonctionnalités supplémentaires, telles que la validation des transactions, l’amélioration de la sécurité et la gouvernance du réseau. En échange de ces services, les opérateurs de masternode sont récompensés avec des revenus supplémentaires en crypto-monnaie.
debt
Dette crypto
Trade
Le type d’opération “trade” est à utiliser pour tout échange (Swap) réalisé sur votre compte.
Le montant de base de l’opération (excluant le montant d’une potentielle commission)
“Base Currency” correspond à la devise dans laquelle s’exprime l’opération. Si l’opération est un trade, le “base currency” correspond à la devise achetée.
Par exemple, si vous achetez du BTC contre de l’USD, la “base currency” sera BTC.
“Quote amount” correspond au montant de l’unité vendue lors d’un trade, excluant le montant d’une potentielle commission.
Cette colonne est à remplir uniquement pour les opérations de type trade
“Quote Currency” représente l’unité vendue lors d’un trade.
Par exemple, si vous achetez du BTC contre de l’USD, la “quote currency” sera USD.
Cette colonne est à remplir uniquement pour les opérations de type trade
“Fee Amount” correspond au montant de la commission associée à l’opération.
(optionnel)
“Fee Currency” correspond à l’unité de la commission associée à l’opération.
(optionnel)
Toute information associée à l’opération peut être stockée dans la colonne “notes”.
(optionnel)