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
Section titled “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
Section titled “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
Section titled “Wat er gebeurt tijdens het exporteren”Directe downloads
Section titled “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
Section titled “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
Wat je krijgt
Section titled “Wat je krijgt”De download is een ZIP-archief met daarin:
- het CSV-bestand (of meerdere CSV-bestanden, als de export zo groot was dat hij is opgesplitst)
COLUMNS.txt, een tekstbestand waarin elke kolom van het bestand wordt beschreven
Elke gegenereerde export blijft 24 uur bewaard. Vraag je binnen die 24 uur opnieuw dezelfde combinatie van account, periode en groepering op, dan krijg je het bestand dat al gemaakt is in plaats van een nieuw bestand.
Overzicht van CSV-kolommen
Section titled “Overzicht van CSV-kolommen”Elke rij in de CSV staat voor één regel uit je royaltyoverzicht. Hieronder lees je wat elke kolom betekent.
Basiskolommen
Section titled “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
Section titled “Omzetkolommen”De voorbeelden hieronder tonen een gewone streamingregel en een UGC-regel.
| Kolom | Omschrijving | Streamingregel | UGC-regel |
|---|---|---|---|
gross_usd | Bruto-omzet in USD voor die regel, vóór de LabelGrid-kosten | 18.09000000 | 4.63000000 |
Kolommen met LabelGrid-kosten
Section titled “Kolommen met LabelGrid-kosten”| Kolom | Omschrijving | Streamingregel | UGC-regel |
|---|---|---|---|
platform_fee_rate | Tarief voor platformkosten van je abonnement | 0.05000000 (5%) | 0.00000000 |
platform_fee_usd | Bedrag aan platformkosten (weergegeven als negatieve waarde) | -0.90450000 | 0.00000000 |
ugc_fee_rate | Tarief voor UGC-/Content ID-kosten van je abonnement | 0.00000000 | 0.20000000 (20%) |
ugc_fee_usd | Bedrag aan UGC-/Content ID-kosten (weergegeven als negatieve waarde) | 0.00000000 | -0.92600000 |
total_labelgrid_fee | De twee kostenposten bij elkaar opgeteld (negatieve waarde) | -0.90450000 | -0.92600000 |
net_revenue_usd | Je uiteindelijke inkomsten na alle LabelGrid-kosten | 17.18550000 | 3.70400000 |
Technische specificatie
Section titled “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) |
| Levering | ZIP-archief met het CSV-bestand plus een referentiebestand COLUMNS.txt |
Datatypen en precisie
Section titled “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
Section titled “Omzetformules”total_labelgrid_fee = platform_fee_usd + ugc_fee_usdnet_revenue_usd = gross_usd + total_labelgrid_feeAandachtspunten voor automatische verwerking
Section titled “Aandachtspunten voor automatische verwerking”- Lege velden:
track_versionencatkunnen 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_perioden vervolgens aflopend opdsp_transaction_date
Inzicht in de kosten in de CSV
Section titled “Inzicht in de kosten in de CSV”Hoe de netto-omzet wordt berekend
Section titled “Hoe de netto-omzet wordt berekend”net_revenue_usd = gross_usd + total_labelgrid_feeOmdat de kosten negatieve waarden zijn, verlagen ze je brutobedrag. Hieronder staat een volledige streamingregel uit het voorbeeldbestand, met 5% platformkosten:
| Bedrag | |
|---|---|
Bruto-omzet (gross_usd) | $18.09000000 |
| Platformkosten (5%) | -$0.90450000 |
| UGC-/Content ID-kosten | $0.00000000 |
| Netto-omzet | $17.18550000 |
Platformkosten en UGC-kosten zijn aparte categorieën en worden niet over elkaar heen berekend
Section titled “Platformkosten en UGC-kosten zijn aparte categorieën en worden niet over elkaar heen berekend”Bouw je een grootboek op basis van deze export, dan is dit het onderdeel dat kloppend moet zijn.
- Beide tarieven worden berekend over hetzelfde bedrag.
- Geen van beide kostenposten wordt berekend over de uitkomst van de andere. De UGC-kosten gaan niet over wat er na de platformkosten overblijft, en de platformkosten gaan niet over wat er na de UGC-kosten overblijft.
- De twee bedragen worden opgeteld:
total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.
Hieronder een uitgewerkt voorbeeld van een regel op een overzicht met beide soorten kosten: een platformtarief van 5% en een UGC-tarief van 20% over hetzelfde bedrag van $100.00000000.
| Berekening | Correct (opgeteld) | Onjuist (gestapeld) |
|---|---|---|
| Platformkosten | -$5.00000000 | -$5.00000000 |
| UGC-/Content ID-kosten | -$20.00000000 (20% van $100.00) | -$19.00000000 (20% van $95.00) |
| Totaal LabelGrid-kosten | -$25.00000000 | -$24.00000000 |
De linkerkolom klopt met je administratie. Een platformtarief van 5% en een UGC-tarief van 20% komen samen uit op een inhouding van 25% over dat bedrag, en niet op de 24% die je krijgt als je het ene tarief toepast op wat er na het andere overblijft.
Wanneer welke kosten verschijnen
Section titled “Wanneer welke kosten verschijnen”De UGC-/Content ID-kosten gelden voor inkomsten uit User-Generated Content op platforms als YouTube, TikTok en SoundCloud. Op regels van gewone streamingplatforms als Spotify of Apple Music staat in ugc_fee_rate en ugc_fee_usd de waarde 0.00.
Omdat tarieven per overzicht worden bepaald, is op de meeste regels één tarief ingevuld en staat het andere op nul: een overzicht bevat meestal maar één soort inkomsten. Bevat een overzicht toch allebei, dan staan beide tarieven op elke regel van dat overzicht en geldt de optelregel hierboven. Ga er dus niet van uit dat er altijd precies één van de twee tariefkolommen gevuld is. Kijk welke kolommen gevuld zijn en tel die bij elkaar op.
Melding over opname van kosten
Section titled “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.
Kosten in de overzichten-API
Section titled “Kosten in de overzichten-API”Lees je overzichten via de publieke API in plaats van via de CSV-export, dan geven de overzicht-endpoints dezelfde uitsplitsing terug in drie extra velden:
| Veld | Omschrijving |
|---|---|
platform_fee_usd | Standaard distributiekosten die op het overzicht in rekening zijn gebracht |
ugc_fee_usd | UGC-/Content ID-kosten die op het overzicht in rekening zijn gebracht |
labelgrid_ugc_rate | Het UGC-/Content ID-percentage dat gold toen het overzicht werd gemaakt |
Beide bedragen zijn negatief en komen samen uit op labelgrid_fee. Kosten worden berekend over het volledige bedrag dat op het overzicht wordt afgerekend, inclusief een eventueel saldo dat is doorgeschoven uit eerdere periodes, dus een percentage vermenigvuldigd met alleen de inkomsten van die periode komt niet altijd uit op het bedrag — de bedragen zijn leidend.
Alle drie de velden zijn null bij overzichten die zijn gemaakt voordat de uitsplitsing werd vastgelegd. Behandel null als ‘niet uitgesplitst’ en niet als nul, en blijf labelgrid_fee in alle gevallen als kostentotaal gebruiken.
Een voorbeeld-CSV downloaden
Section titled “Een voorbeeld-CSV downloaden”Wil je zien hoe de export eruitziet voordat je je eigen bestand downloadt? Download ons voorbeeldbestand:
Het voorbeeld bevat fictieve gegevens met typische regels van verschillende platforms en regio’s, in de indeling met 23 kolommen, zoals hierboven beschreven. Elke rij voldoet aan de formules in dit artikel, dus je kunt het bestand als testbestand gebruiken bij het bouwen van een parser.
Tips om met de gegevens te werken
Section titled “Tips om met de gegevens te werken”Openen in Google Sheets
Section titled “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
Section titled “Openen in Excel”- Open Excel
- Klik op Bestand → Openen en selecteer het CSV-bestand
- Excel herkent het komma-gescheiden formaat automatisch
Veelgebruikte analyses
Section titled “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
Section titled “Problemen oplossen”De export duurt te lang
Section titled “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”
Section titled “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
Section titled “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
Section titled “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
Section titled “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 →