Hoppa till innehåll
Support

Exportera royaltyutdrag till CSV

Ladda ner dina royaltyutdrag som CSV-filer för att analysera intäkterna i ett kalkylprogram, förbereda dig inför deklarationen eller spara detaljerade bokföringsunderlag.

  • Du behöver ha minst ett utbetalt royaltyutdrag (utdragen visas efter att din första utbetalning har behandlats)
  • Ett kalkylprogram som Excel, Google Sheets eller Numbers för att öppna CSV-filen

  1. Gå till Royalties i huvudmenyn
  2. Öppna fliken Utdrag
  3. Leta upp den utdragsperiod du vill ladda ner
  4. Klicka på nedladdningsknappen (pilikonen) bredvid utdraget

Systemet genererar din CSV-fil. För mindre utdrag startar nedladdningen direkt. För större utdrag visas en förloppsindikator medan filen förbereds.


För de flesta utdrag är CSV-filen klar direkt. Det dyker upp en dialogruta med en Ladda ner-knapp för att spara filen.

För utdrag med många rader behandlar systemet exporten i bakgrunden:

  1. En dialogruta med texten “Förbereder export” visas
  2. Systemet genererar filen (det kan ta en liten stund)
  3. När den är klar visas en Ladda ner-knapp
  4. Klicka på Ladda ner för att spara filen

Nedladdningen är ett ZIP-arkiv som innehåller:

  • CSV-filen (eller flera CSV-filer, om exporten var så stor att den delades upp)
  • COLUMNS.txt, en referensfil i vanlig text som beskriver varje kolumn i exporten

Varje genererad export sparas i 24 timmar. Begär du en ny export för samma konto, datumintervall och gruppering inom den tiden får du tillbaka den redan byggda filen i stället för att den byggs om.


Varje rad i CSV-filen motsvarar en enskild rad i ditt royaltyutdrag. Här är vad varje kolumn betyder.

KolumnBeskrivningExempel
pay_periodUtbetalningsperiod i formatet ÅÅÅÅMM202601
labelDitt skivbolagsnamnMidnight Records
retailerPlattformens namnSpotify
territoryLands- eller regionskodUS, GB, DE
typeTransaktionstypStream, Download, UGC
catKatalognummerMR-2026-001
upcReleasens UPC-streckkod840123456789
releaseReleasens titelNeon Skyline
isrcSpårets ISRC-kod (en unik identifierare för varje spår)USRC12400001
track_artistArtistnamnLuna Rivera
track_titleSpårets titelGolden Hour
track_versionVersions- eller remixuppgift (tomt om ingen finns)Acoustic Version
track_countAntal spår1
purchase_qtyAntal streams eller försäljningar4523
dsp_transaction_dateTransaktionsdatum från plattformen2026-01-15
dsp_statement_idUtdragets referens-IDSP-2026-0001

Exemplen nedan visar en vanlig streamingrad och en UGC-rad.

KolumnBeskrivningStreamingradUGC-rad
gross_usdBruttointäkt i USD för raden, före LabelGrids avgifter18.090000004.63000000
KolumnBeskrivningStreamingradUGC-rad
platform_fee_ratePlattformsavgiftssatsen för ditt abonnemang0.05000000 (5 %)0.00000000
platform_fee_usdPlattformsavgiften i belopp (visas som ett negativt värde)-0.904500000.00000000
ugc_fee_rateDitt abonnemangs UGC-/Content ID-avgiftssats0.000000000.20000000 (20 %)
ugc_fee_usdUGC-/Content ID-avgiften i belopp (visas som ett negativt värde)0.00000000-0.92600000
total_labelgrid_feeDe två avgifterna sammanlagda (negativt värde)-0.90450000-0.92600000
net_revenue_usdDin slutliga intäkt efter alla LabelGrid-avgifter17.185500003.70400000

Om du ska integrera den här CSV-filen i ett bokföringsprogram eller en ekonomilösning hittar du de exakta formatuppgifterna här.

EgenskapVärde
TeckenkodningUTF-8
AvgränsareKommatecken (,)
CitationsteckenDubbelt citationstecken (")
Escape-teckenOmvänt snedstreck (\)
RadslutLF (\n)
RubrikradFinns alltid som första rad
Antal kolumner23 (fast ordning, se kolumnförklaringen ovan)
LeveransZIP-arkiv som innehåller CSV-filen plus referensfilen COLUMNS.txt
KolumngruppTypPrecision
pay_periodSträngÅÅÅÅMM (6 tecken)
dsp_transaction_dateSträngÅÅÅÅ-MM-DD (10 tecken)
purchase_qtyHeltalHeltal
gross_usd, *_fee_usd, net_revenue_usdDecimaltalUpp till 8 decimaler
platform_fee_rate, ugc_fee_rateDecimaltalUpp till 8 decimaler (t.ex. 0.05000000 = 5 %)
Övriga kolumnerSträngVariabel längd
total_labelgrid_fee = platform_fee_usd + ugc_fee_usd
net_revenue_usd = gross_usd + total_labelgrid_fee
  • Tomma fält: track_version och cat kan vara tomma (två kommatecken i följd)
  • Citering av text: Fält som innehåller kommatecken eller citationstecken omges av dubbla citationstecken. Dubbla citationstecken inuti fältvärden tas bort vid exporten.
  • Stora exporter: Exporter över 150 MB delas upp i flera CSV-filer (var och en med en egen rubrikrad) och levereras som ett ZIP-arkiv
  • Sortering: Raderna sorteras fallande efter pay_period och därefter fallande efter dsp_transaction_date

net_revenue_usd = gross_usd + total_labelgrid_fee

Eftersom avgifterna är negativa värden minskar de ditt bruttobelopp. Här är en komplett streamingrad från exempelfilen, med 5 % i plattformsavgift:

Belopp
Bruttointäkt (gross_usd)$18.09000000
Plattformsavgift (5 %)-$0.90450000
UGC-/Content ID-avgift$0.00000000
Nettointäkt$17.18550000

Plattformsavgiften och UGC-avgiften är separata kategorier som inte räknas på varandra

Section titled “Plattformsavgiften och UGC-avgiften är separata kategorier som inte räknas på varandra”

Det här är det viktigaste att få rätt om du bygger din bokföring utifrån den här exporten.

  • Båda satserna tas ut på samma belopp.
  • Ingen av avgifterna beräknas på beloppet efter den andra. UGC-avgiften läggs inte på det som återstår efter plattformsavgiften, och plattformsavgiften läggs inte på det som återstår efter UGC-avgiften.
  • De två beloppen adderas: total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.

Ett räkneexempel för en rad där ett utdrag bär båda avgiftstyperna, med 5 % plattformssats och 20 % UGC-sats på samma belopp, $100.00000000:

BeräkningRätt (avgifterna adderas)Fel (avgifterna räknas på varandra)
Plattformsavgift-$5.00000000-$5.00000000
UGC-/Content ID-avgift-$20.00000000 (20 % av $100.00)-$19.00000000 (20 % av $95.00)
Total LabelGrid-avgift-$25.00000000-$24.00000000

Det är den vänstra kolumnen som stämmer vid avstämning. En plattformssats på 5 % och en UGC-sats på 20 % ger ett avdrag på 25 % av det beloppet, inte de 24 % du får om du tillämpar den ena satsen på det som återstår efter den andra.

UGC-/Content ID-avgiften gäller intäkter från användargenererat innehåll (User-Generated Content) på plattformar som YouTube, TikTok och SoundCloud. På rader från vanliga streamingplattformar som Spotify eller Apple Music visar ugc_fee_rate och ugc_fee_usd värdet 0.00.

Eftersom satserna bestäms per utdrag har de flesta rader en ifylld sats och en nolla: ett utdrag innehåller oftast bara en sorts intäkt. Om ett utdrag ändå innehåller båda sorterna syns båda satserna på varje rad i det utdraget, och då gäller den additiva regeln ovan. Utgå inte från att exakt en av de två satskolumnerna är skild från noll. Läs av de kolumner som är ifyllda och lägg ihop dem.

Avgifter ingår i CSV-exporterna från och med utdragsperioden oktober 2024. Tidigare utdrag visar intäktsdata utan kolumnerna för avgiftsuppdelning.

Om du läser utdrag via det publika API:et i stället för CSV-exporten returnerar utdragsendpointerna samma uppdelning i tre extra fält:

FältBeskrivning
platform_fee_usdDen vanliga distributionsavgift som tagits ut på utdraget
ugc_fee_usdDen UGC-/Content ID-avgift som tagits ut på utdraget
labelgrid_ugc_rateDen UGC-/Content ID-sats som gällde när utdraget skapades

Båda beloppen är negativa och blir tillsammans labelgrid_fee. Avgifter tas ut på hela det belopp som regleras på utdraget, inklusive eventuellt saldo som vidareförts från tidigare perioder, så en sats multiplicerad med enbart periodens intäkter stämmer inte alltid med beloppet – det är beloppen som gäller.

Alla tre fälten är null på utdrag som skapats innan uppdelningen började registreras. Behandla null som “inte uppdelad” och inte som noll, och fortsätt använda labelgrid_fee som avgiftssumma i samtliga fall.


Vill du se hur exporten ser ut innan du laddar ner din egen? Ladda ner vår exempelfil:

Ladda ner exempel-CSV

Exemplet innehåller platshållardata som visar typiska rader för flera plattformar och territorier, i layouten med 23 kolumner som beskrivs ovan. Varje rad i filen uppfyller formlerna i den här artikeln, så du kan använda den som testdata när du bygger en parser.


  1. Gå till Google Sheets
  2. Klicka på Arkiv → Importera
  3. Ladda upp din CSV-fil
  4. Välj “Komma” som avgränsare
  5. Klicka på Importera data
  1. Öppna Excel
  2. Klicka på Arkiv → Öppna och välj CSV-filen
  3. Excel känner automatiskt av det kommaseparerade formatet
  • Filtrera per återförsäljare för att se intäkterna per plattform
  • Pivottabell per territorium för att hitta dina starkaste marknader
  • Summera net_revenue_usd för att kontrollera ditt totala utdragsbelopp
  • Sortera efter purchase_qty för att hitta dina mest streamade spår
  • Gruppera per release för att jämföra hur olika album presterar

Stora utdrag med många rader kan ta längre tid att generera. Systemet kontrollerar i upp till 5 minuter. Om exporten gör en time out:

  1. Stäng dialogrutan
  2. Vänta några minuter
  3. Försök ladda ner igen

Bara en export kan behandlas åt gången. Vänta tills den pågående exporten är klar och försök sedan igen.

Se till att ditt kalkylprogram är inställt på UTF-8-teckenkodning vid importen. Då visas artistnamn och spårtitlar med specialtecken korrekt.

Avgiftskolumnerna (platform_fee_rate, platform_fee_usd med flera) finns bara för utdragsperioder från och med oktober 2024. Tidigare perioder visar intäktsdata utan uppdelningen av avgifter.



Behöver du hjälp med din export? Kontakta vårt supportteam.

Använder du inte LabelGrid än?

Allt du just läste om finns på vår plattform.

Se vad LabelGrid kan göra →