Helpcentrum

CSV-kolommen toewijzen: importeer elke export met de kolom-mapper

Heb je een CSV-export die niet ons standaardformaat volgt? Met de kolom-mapper koppel je je eigen kolommen aan de velden van Cryptotax, zonder je bestand om te bouwen.

4 min leestijd
TL;DR

Heb je een CSV-export die niet ons standaardformaat volgt? Met de kolom-mapper koppel je je eigen kolommen aan de velden van Cryptotax, zonder je bestand om te bouwen.

Laatste update: juni 2026

Heb je een CSV-export van een exchange of wallet die nog niet automatisch wordt herkend, en wil je je transacties niet eerst overtypen in ons sjabloon? Met de kolom-mapper upload je je bestand in zijn eigen formaat en koppel je zelf de kolommen aan de velden die Cryptotax verwacht. Je mapping wordt onthouden, zodat een volgende export van hetzelfde formaat meteen wordt verwerkt.

Dit is het verschil met het vaste Custom CSV-sjabloon: bij het sjabloon pas jij je data aan ons formaat aan. Met de kolom-mapper laat je je bestand zoals het is en vertel je Cryptotax eenmalig hoe het te lezen.

Gebruik de kolom-mapper voor:

  • Een exchange of broker die nog niet automatisch wordt ondersteund
  • Een export uit een andere belastingtool met andere kolomnamen
  • Een eigen administratie (Excel, Google Sheets) die je niet wil ombouwen

Hoe het werkt

  1. Log in op Cryptotax → Account toevoegenCSV ImportCustom CSV.
  2. Upload je bestand zoals je het van je exchange of tool kreeg.
  3. Herkent Cryptotax de kolomnamen niet, dan word je automatisch naar de kolom-mapper geleid. Herkent het de kolommen wel, dan wordt je bestand meteen geïmporteerd en hoef je niets te mappen.
  4. Doorloop de mapper (zie hieronder) en bevestig.
  5. Controleer het resultaat in je transactie-overzicht.

De volgende keer dat je een export met dezelfde kolomstructuur uploadt, herkent Cryptotax het formaat aan je eerdere mapping en verwerkt het bestand automatisch. Je hoeft de stappen dan niet opnieuw te doen.

De kolom-mapper, stap voor stap

1. Kolommen toewijzen

Je ziet de eerste rijen uit je bestand als voorbeeld. Voor elk veld dat Cryptotax nodig heeft, kies je welke kolom uit je bestand erbij hoort. De velden zijn dezelfde als in het Custom CSV-formaat:

VeldVerplichtBeschrijving
dateJaHet tijdstip van de transactie
typeJaHet transactietype (koop, verkoop, swap, ...)
assetJaDe ticker van de cryptomunt
amountJaDe hoeveelheid
price_eurNeeEUR-prijs per eenheid. Niet gemapt? Dan zoekt Cryptotax de prijs automatisch op.
fee_amountNeeBetaalde kost (commissie)
fee_assetNeeHet asset waarmee de kost is betaald
exchangeNeeNaam van de exchange of bron
tx_idNeeUnieke transactie-ID voor deduplicatie en voor het koppelen van swap-benen
notesNeeVrije notitie (verschijnt in het boekhoudrapport)

Je moet minstens date, type, asset en amount toewijzen. De optionele velden laat je gewoon leeg als je bestand ze niet bevat.

2. Transactietypes toewijzen

Elke exchange noemt transacties anders. Cryptotax toont de ruwe waarden die in jouw type-kolom voorkomen (bijvoorbeeld Buy, Aankoop, Deposit, Reward), en jij koppelt ze aan een van de standaardtypes:

TypeFiscale behandeling
BUYVerwerving (aankoop met EUR)
SELLVervreemding (belastbaar event)
TRADECrypto-naar-crypto swap (vervreemding + verwerving)
DEPOSITOntvangen van externe bron (interne transfer)
WITHDRAWALVerstuurd naar extern adres (interne transfer)
INCOMEStaking, mining, airdrops (belastbaar inkomen)
GIFT_INOntvangen als gift
GIFT_OUTWeggegeven als gift
LOSTVerloren, gestolen of gehackt
FEELosstaande kost

Een ruwe waarde die je niet toewijst, wordt geïmporteerd als onbekend (UNCLASSIFIED). De transactie gaat niet verloren: ze verschijnt in je overzicht zodat je het type later met de hand kan zetten. Zo blijft de kostenbasis van je portefeuille intact, ook als één type-waarde nog niet duidelijk is.

3. Notatie-instellingen

Hier vertel je Cryptotax hoe de getallen en datums in jouw bestand zijn genoteerd:

  • Datumformaat: laat leeg om automatisch te herkennen (ISO 8601). Wijkt je bestand af, geef dan het patroon op, bijvoorbeeld dd/MM/yyyy HH:mm.
  • Tijdzone: de zone waarin de datums in het bestand staan. Cryptotax rekent intern alles om naar UTC.
  • Decimaalteken: punt (1234.56) of komma (1.234,56). Belangrijk voor exports uit Europese tools.

Je kan de mapping ook een naam geven (bijvoorbeeld "MijnExchange export"), zodat je ze later makkelijk herkent.

4. Controleren en importeren

Voor je importeert, toont Cryptotax een voorbeeld van het resultaat en markeert het de rijen met problemen. Die worden overgeslagen of als onbekend geïmporteerd, zodat één foute regel je hele upload niet blokkeert. Klopt alles, dan bevestig je met Importeren.

Swaps en crypto-naar-crypto

Een crypto-naar-crypto swap bestaat uit twee regels met hetzelfde tx_id: het uitgaande been (wat je verkoopt) en het inkomende been (wat je ontvangt). Zorg dus dat je de tx_id-kolom mapt als je bestand swaps bevat, anders worden de twee benen niet aan elkaar gekoppeld. Meer uitleg vind je op de pagina Custom CSV importeren.

Veelgestelde vragen

Moet ik mijn bestand nog aanpassen?

Nee. Dat is net het verschil met het vaste sjabloon: je upload je export zoals je hem kreeg en mapt de kolommen in de wizard.

Wat als ik een kolom verkeerd heb toegewezen?

Verwijder het CSV-account en upload het bestand opnieuw. Je doorloopt de mapper dan opnieuw en kan de toewijzing corrigeren.

Wordt mijn mapping bewaard?

Ja. Cryptotax onthoudt je mapping per kolomstructuur. Een volgende export van hetzelfde formaat wordt automatisch verwerkt, zonder dat je opnieuw hoeft te mappen.

Wat als mijn export wel wordt herkend?

Dan sla je de mapper helemaal over: je bestand wordt meteen geïmporteerd. De kolom-mapper verschijnt alleen wanneer Cryptotax de kolomnamen niet herkent.

Gerelateerd

Geen individueel fiscaal advies Dit artikel is een leesgids op basis van publieke bronnen. Voor een persoonlijke situatie raadpleeg je accountant.

Accountant? Sluit je aan bij ons partnerprogramma.

Klaar voor de deadline?

Klaar om je crypto correct aan te geven?

Importeer je wallets en exchanges en ontvang direct een overzicht van je winsten, verliezen en belastbaar inkomen in EUR.

Read-only API Geen creditcard nodig GDPR Belgisch bedrijf