Royaltyoverzichten exporteren naar CSV

Download je royaltyoverzichten als CSV-bestand om je inkomsten in een spreadsheet te analyseren, je voor te bereiden op het belastingseizoen of een gedetailleerde financiële administratie bij te houden.

Voordat je begint

Je hebt minstens één uitbetaald royaltyoverzicht nodig (overzichten verschijnen zodra je eerste uitbetaling is verwerkt)
Een spreadsheetprogramma zoals Excel, Google Sheets of Numbers om het CSV-bestand te openen

Een overzicht downloaden

Ga via het hoofdmenu naar Royalties
Ga naar het tabblad Statements
Zoek de overzichtsperiode die je wilt downloaden
Klik op de downloadknop (pijlicoon) naast het overzicht

Het systeem genereert je CSV-bestand. Bij kleinere overzichten begint de download meteen. Bij grotere overzichten zie je een voortgangsindicator terwijl het bestand wordt klaargezet.

Wat er gebeurt tijdens het exporteren

Directe downloads

Voor de meeste overzichten is de CSV meteen klaar. Er verschijnt een venster met een knop Download om het bestand op te slaan.

Verwerking van grote overzichten

Bij overzichten met veel regels verwerkt het systeem de export op de achtergrond:

Er verschijnt een venster met de melding “Preparing Export”
Het systeem genereert het bestand (dit kan even duren)
Zodra het klaar is, verschijnt er een knop Download
Klik op Download om het bestand op te slaan

Overzicht van CSV-kolommen

Elke rij in de CSV staat voor één regel uit je royaltyoverzicht. Hieronder lees je wat elke kolom betekent.

Basiskolommen

Kolom	Omschrijving	Voorbeeld
`pay_period`	Betalingsperiode in JJJJMM-formaat	`202601`
`label`	Je labelnaam	`Midnight Records`
`retailer`	Naam van het platform	`Spotify`
`territory`	Land- of regiocode	`US`, `GB`, `DE`
`type`	Soort transactie	`Stream`, `Download`, `UGC`
`cat`	Catalogusnummer	`MR-2026-001`
`upc`	UPC-barcode van de release	`840123456789`
`release`	Titel van de release	`Neon Skyline`
`isrc`	ISRC-code van de track (een unieke aanduiding per track)	`USRC12400001`
`track_artist`	Naam van de artiest	`Luna Rivera`
`track_title`	Titel van de track	`Golden Hour`
`track_version`	Versie- of remixinformatie (leeg als die er niet is)	`Acoustic Version`
`track_count`	Aantal tracks	`1`
`purchase_qty`	Aantal streams of verkopen	`4523`
`dsp_transaction_date`	Transactiedatum van het platform	`2026-01-15`
`dsp_statement_id`	Referentie-ID van het overzicht	`SP-2026-0001`

Omzetkolommen

Kolom	Omschrijving	Voorbeeld
`gross_usd`	Bruto-omzet in USD (na aftrek van de kosten van de overzichtsleverancier)	`18.09000000`

Kolommen met LabelGrid-kosten

Kolom	Omschrijving	Voorbeeld
`platform_fee_rate`	Tarief van de LabelGrid-platformkosten op basis van je abonnement	`0.05000000` (5%)
`platform_fee_usd`	Bedrag aan LabelGrid-platformkosten (weergegeven als negatieve waarde)	`-0.90450000`
`ugc_fee_rate`	Tarief van de UGC-kosten (User-Generated Content) voor UGC-platforms	`0.20000000` (20%)
`ugc_fee_usd`	Bedrag aan UGC-platformkosten (weergegeven als negatieve waarde)	`-1.74400000`
`total_labelgrid_fee`	Totaal van alle LabelGrid-kosten (negatieve waarde)	`-2.18000000`
`net_revenue_usd`	Je uiteindelijke inkomsten na alle kosten	`17.18550000`

Technische specificatie

Wil je deze CSV koppelen aan je boekhoudsoftware of een financieel backend? Hieronder vind je de precieze details van het formaat.

Eigenschap	Waarde
Codering	UTF-8
Scheidingsteken	Komma (`,`)
Aanhalingsteken	Dubbel aanhalingsteken (`"`)
Escape-teken	Backslash (`\`)
Regeleinde	LF (`\n`)
Kopregel	Altijd aanwezig als eerste rij
Aantal kolommen	23 (vaste volgorde, zie het kolomoverzicht hierboven)

Datatypen en precisie

Kolomgroep	Type	Precisie
`pay_period`	String	`JJJJMM` (6 tekens)
`dsp_transaction_date`	String	`JJJJ-MM-DD` (10 tekens)
`purchase_qty`	Integer	Geheel getal
`gross_usd`, `*_fee_usd`, `net_revenue_usd`	Decimaal	Tot 8 decimalen
`platform_fee_rate`, `ugc_fee_rate`	Decimaal	Tot 8 decimalen (bijv. `0.05000000` = 5%)
Alle overige kolommen	String	Variabele lengte

Omzetformules

platform_fee_usd  = -1 × platform_fee_rate × gross_usd
ugc_fee_usd       = -1 × ugc_fee_rate × gross_usd
total_labelgrid_fee = platform_fee_usd + ugc_fee_usd
net_revenue_usd   = gross_usd + total_labelgrid_fee

Aandachtspunten voor automatische verwerking

Lege velden: track_version en cat kunnen leeg zijn (twee komma’s na elkaar)
Tekst tussen aanhalingstekens: Velden met komma’s of aanhalingstekens staan tussen dubbele aanhalingstekens. Dubbele aanhalingstekens binnen een veldwaarde worden bij de export verwijderd.
Grote exports: Exports van meer dan 150 MB worden opgesplitst in meerdere CSV-bestanden (elk met een eigen kopregel) en als ZIP-archief geleverd
Sortering: De rijen zijn aflopend gesorteerd op pay_period en vervolgens aflopend op dsp_transaction_date

Inzicht in de kosten in de CSV

Hoe de netto-omzet wordt berekend

net_revenue_usd = gross_usd + total_labelgrid_fee

Omdat de kosten negatieve waarden zijn, verlagen ze je brutobedrag. Een voorbeeld:

	Bedrag
Bruto-omzet	$18.09000000
Platformkosten (5%)	-$0.90450000
UGC-kosten	$0.00000000
Netto-omzet	$17.18550000

UGC-platformkosten

De UGC-kosten gelden alleen voor User-Generated Content-platforms zoals YouTube, TikTok en SoundCloud. Voor gewone streamingplatforms zoals Spotify of Apple Music staat in de kolommen ugc_fee_rate en ugc_fee_usd de waarde 0.00.

Melding over opname van kosten

De kosten zijn opgenomen in de CSV-exports vanaf de overzichtsperiode oktober 2024. Bij eerdere overzichten staan de omzetgegevens zonder de kolommen met de kostenuitsplitsing.

Een voorbeeld-CSV downloaden

Wil je zien hoe de export eruitziet voordat je je eigen bestand downloadt? Download ons voorbeeldbestand:

Voorbeeld-CSV downloaden

Het voorbeeld bevat fictieve gegevens met typische regels van verschillende platforms en regio’s.

Tips om met de gegevens te werken

Openen in Google Sheets

Ga naar Google Sheets
Klik op Bestand → Importeren
Upload je CSV-bestand
Kies “Komma” als scheidingsteken
Klik op Gegevens importeren

Openen in Excel

Open Excel
Klik op Bestand → Openen en selecteer het CSV-bestand
Excel herkent het komma-gescheiden formaat automatisch

Veelgebruikte analyses

Filter op retailer om je inkomsten per platform te zien
Maak een draaitabel op territory om je sterkste markten te vinden
Tel net_revenue_usd op om het totaalbedrag van je overzicht te controleren
Sorteer op purchase_qty om je meest gestreamde tracks te vinden
Groepeer op release om de prestaties van albums te vergelijken

Problemen oplossen

De export duurt te lang

Grote overzichten met veel regels kunnen langer duren om te genereren. Het systeem wacht maximaal 5 minuten. Verloopt de export in een time-out:

Sluit het venster
Wacht een paar minuten
Probeer opnieuw te downloaden

Foutmelding “Export in Progress”

Er kan maar één export tegelijk worden verwerkt. Wacht tot een lopende export klaar is en probeer het dan opnieuw.

De CSV bevat onverwachte tekens

Zorg dat je spreadsheetprogramma bij het importeren op UTF-8-codering staat. Zo worden artiestennamen en tracktitels met bijzondere tekens correct weergegeven.

Ontbrekende kostenkolommen

De kostenkolommen (platform_fee_rate, platform_fee_usd enzovoort) zijn alleen beschikbaar voor overzichtsperiodes vanaf oktober 2024. Bij eerdere periodes staan de omzetgegevens zonder de kostenuitsplitsing.

Verwante gidsen

Royaltyrapportages begrijpen - Hoe je je royaltygegevens leest
Uitbetalingsschema - Wanneer royalty’s worden uitbetaald
Belastinggegevens - Exportgegevens gebruiken voor je belastingaangifte

Hulp nodig bij je export? Neem contact op met ons supportteam.

Gebruik je LabelGrid nog niet?

Alles wat je net hebt gelezen, kun je gebruiken op ons platform.

Ontdek wat LabelGrid kan →