Esportare i rendiconti royalty in CSV

Scarica i tuoi rendiconti royalty come file CSV per analizzare i guadagni in un foglio di calcolo, prepararti per la stagione fiscale o mantenere registri finanziari dettagliati.

Prima di iniziare

• Devi avere almeno un rendiconto royalty pagato (i rendiconti appaiono dopo l’elaborazione del primo pagamento)
• Un’applicazione per fogli di calcolo come Excel, Google Sheets o Numbers per aprire il file CSV

---

Scaricare un rendiconto

1. Vai a Royalties dal menu principale
2. Naviga alla scheda Statements
3. Trova il periodo del rendiconto che desideri scaricare
4. Clicca il pulsante di download (icona freccia) accanto al rendiconto

Il sistema genererà il tuo file CSV. Per i rendiconti più piccoli, il download inizia immediatamente. Per i rendiconti più grandi, vedrai un indicatore di avanzamento mentre il file viene preparato.

Consiglio

Usa il menu Download By Year in alto per esportare tutti i rendiconti di un intero anno in un unico file. Questo è utile per la preparazione fiscale annuale.

---

Cosa succede durante l’esportazione

Download istantanei

Per la maggior parte dei rendiconti, il CSV è pronto istantaneamente. Appare una finestra di dialogo con un pulsante Download per salvare il file.

Elaborazione di rendiconti grandi

Per i rendiconti con molte voci, il sistema elabora l’esportazione in background:

1. Appare una finestra di dialogo “Preparing Export”
2. Il sistema genera il file (questo potrebbe richiedere alcuni istanti)
3. Una volta pronto, appare un pulsante Download
4. Clicca Download per salvare il file

Nota

Solo un’esportazione può essere eseguita alla volta. Se vedi un messaggio “Export in Progress”, attendi che l’esportazione corrente finisca prima di iniziarne un’altra.

Cosa ricevi

Il download è un archivio ZIP che contiene:

• il file CSV (o più file CSV, se l’esportazione era abbastanza grande da essere suddivisa)
• COLUMNS.txt, un file di testo che descrive ogni colonna

Ogni esportazione generata viene conservata per 24 ore. Se entro quella finestra richiedi di nuovo un’esportazione con gli stessi parametri (stesso account, stesso intervallo di date, stesso raggruppamento), ricevi il file già generato invece di uno nuovo.

---

Riferimento colonne CSV

Ogni riga nel CSV rappresenta una singola voce del tuo rendiconto royalty. Ecco cosa significa ogni colonna.

Colonne base

Colonna	Descrizione	Esempio
pay_period	Periodo di pagamento in formato YYYYMM	202601
label	Nome della tua etichetta	Midnight Records
retailer	Nome della piattaforma	Spotify
territory	Codice paese o regione	US, GB, DE
type	Tipo di transazione	Stream, Download, UGC
cat	Numero di catalogo	MR-2026-001
upc	Codice a barre UPC della release	840123456789
release	Titolo della release	Neon Skyline
isrc	Codice ISRC della traccia (un identificatore unico per ogni traccia)	USRC12400001
track_artist	Nome dell’artista	Luna Rivera
track_title	Titolo della traccia	Golden Hour
track_version	Informazioni sulla versione o remix (vuoto se non presente)	Acoustic Version
track_count	Numero di tracce	1
purchase_qty	Numero di stream o vendite	4523
dsp_transaction_date	Data della transazione dalla piattaforma	2026-01-15
dsp_statement_id	ID di riferimento del rendiconto	SP-2026-0001

Colonne dei ricavi

Gli esempi qui sotto mostrano una riga di streaming standard e una riga UGC.

Colonna	Descrizione	Riga streaming	Riga UGC
gross_usd	Ricavi lordi in USD di quella riga, prima delle commissioni LabelGrid	18.09000000	4.63000000

Colonne delle commissioni LabelGrid

Colonna	Descrizione	Riga streaming	Riga UGC
platform_fee_rate	L’aliquota della commissione di piattaforma del tuo piano	0.05000000 (5%)	0.00000000
platform_fee_usd	Importo della commissione di piattaforma (mostrato come valore negativo)	-0.90450000	0.00000000
ugc_fee_rate	L’aliquota della commissione UGC / Content ID del tuo piano	0.00000000	0.20000000 (20%)
ugc_fee_usd	Importo della commissione UGC / Content ID (mostrato come valore negativo)	0.00000000	-0.92600000
total_labelgrid_fee	La somma delle due commissioni (valore negativo)	-0.90450000	-0.92600000
net_revenue_usd	I tuoi guadagni finali dopo tutte le commissioni LabelGrid	17.18550000	3.70400000

Nota

Le aliquote sono determinate a livello di rendiconto. Tutte le righe dello stesso rendiconto riportano lo stesso platform_fee_rate e lo stesso ugc_fee_rate.

---

Specifica tecnica

Se stai integrando questo CSV in un software contabile o un backend finanziario, ecco i dettagli esatti del formato.

Proprietà	Valore
Codifica	UTF-8
Delimitatore	Virgola (,)
Carattere di virgolettatura	Virgolette doppie (")
Carattere di escape	Barra rovesciata (\)
Fine riga	LF (\n)
Riga di intestazione	Sempre presente come prima riga
Totale colonne	23 (ordine fisso, vedi riferimento colonne sopra)
Consegna	Archivio ZIP con il file CSV e la legenda COLUMNS.txt

Tipi di dati e precisione

Gruppo di colonne	Tipo	Precisione
pay_period	String	YYYYMM (6 caratteri)
dsp_transaction_date	String	YYYY-MM-DD (10 caratteri)
purchase_qty	Intero	Numero intero
gross_usd, *_fee_usd, net_revenue_usd	Decimale	Fino a 8 decimali
platform_fee_rate, ugc_fee_rate	Decimale	Fino a 8 decimali (es., 0.05000000 = 5%)
Tutte le altre colonne	String	Lunghezza variabile

Consiglio

Gli importi delle commissioni sono sempre valori negativi (sono deduzioni). Le colonne delle aliquote sono frazioni decimali, non percentuali: moltiplica per 100 per ottenere la percentuale.

Formule dei ricavi

total_labelgrid_fee = platform_fee_usd + ugc_fee_usd
net_revenue_usd     = gross_usd + total_labelgrid_fee

Note per l’elaborazione automatizzata

• Campi vuoti: track_version e cat possono essere vuoti (due virgole consecutive)
• Virgolettatura del testo: I campi contenenti virgole o virgolette sono racchiusi tra virgolette doppie. Le virgolette doppie all’interno dei valori dei campi vengono rimosse durante l’esportazione.
• Esportazioni grandi: Le esportazioni superiori a 150 MB vengono suddivise in più file CSV (ciascuno con la propria riga di intestazione) e consegnate come archivio ZIP
• Ordinamento: Le righe sono ordinate per pay_period decrescente, poi per dsp_transaction_date decrescente

---

Comprendere le commissioni nel CSV

Come viene calcolato il ricavo netto

net_revenue_usd = gross_usd + total_labelgrid_fee

Poiché le commissioni sono valori negativi, riducono il tuo importo lordo. Ecco una riga di streaming completa presa dal file di esempio, con una commissione di piattaforma del 5%:

	Importo
Ricavi lordi (gross_usd)	$18.09000000
Commissione di piattaforma (5%)	-$0.90450000
Commissione UGC / Content ID	$0.00000000
Ricavo netto	$17.18550000

La commissione di piattaforma e quella UGC sono categorie separate e non si applicano a cascata

Se stai costruendo un registro contabile a partire da questa esportazione, questo è il punto più importante da mettere a fuoco.

• Entrambe le aliquote si calcolano sullo stesso importo.
• Nessuna delle due commissioni si calcola sul risultato dell’altra. La commissione UGC non si calcola sull’importo che resta dopo la commissione di piattaforma, e la commissione di piattaforma non si calcola sull’importo che resta dopo la commissione UGC.
• I due importi si sommano: total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.

Ecco un esempio concreto per una riga di un rendiconto su cui sono applicati entrambi i tipi di commissione, con un’aliquota di piattaforma del 5% e un’aliquota UGC del 20% sullo stesso importo di $100.00000000:

Calcolo	Corretto (additivo)	Errato (a cascata)
Commissione di piattaforma	-$5.00000000	-$5.00000000
Commissione UGC / Content ID	-$20.00000000 (20% di $100.00)	-$19.00000000 (20% di $95.00)
Totale commissioni LabelGrid	-$25.00000000	-$24.00000000

È la colonna di sinistra a far quadrare i conti. Un’aliquota di piattaforma del 5% e un’aliquota UGC del 20% danno una trattenuta del 25% su quell’importo, non il 24% che ottieni applicando un’aliquota a quello che resta dopo l’altra.

Quando compare ciascuna commissione

La commissione UGC / Content ID si applica ai guadagni da User-Generated Content su piattaforme come YouTube, TikTok e SoundCloud. Sulle righe delle piattaforme di streaming standard come Spotify o Apple Music, ugc_fee_rate e ugc_fee_usd mostrano 0.00.

Poiché le aliquote sono determinate a livello di rendiconto, sulla maggior parte delle righe un’aliquota è valorizzata e l’altra è a zero: di solito un rendiconto contiene un solo tipo di guadagno. Se invece un rendiconto contiene entrambi i tipi, entrambe le aliquote compaiono su tutte le righe di quel rendiconto e vale la regola additiva descritta sopra. Non dare per scontato che una sola delle due colonne di aliquota sia diversa da zero: leggi tutte quelle valorizzate e sommale.

Avviso inclusione commissioni

Le commissioni sono incluse nelle esportazioni CSV a partire dal periodo del rendiconto di ottobre 2024. I rendiconti precedenti mostrano i dati dei ricavi senza le colonne di dettaglio delle commissioni.

Le commissioni nell’API dei rendiconti

Se leggi i rendiconti tramite l’API pubblica invece che dall’esportazione CSV, gli endpoint dei rendiconti restituiscono lo stesso dettaglio in tre campi aggiuntivi:

Campo	Descrizione
platform_fee_usd	Commissione di distribuzione standard addebitata sul rendiconto
ugc_fee_usd	Commissione UGC / Content ID addebitata sul rendiconto
labelgrid_ugc_rate	Percentuale della commissione UGC / Content ID in vigore quando è stato generato il rendiconto

Entrambi gli importi sono negativi e la loro somma è labelgrid_fee. Le commissioni si calcolano sull’intero importo liquidato nel rendiconto, che comprende qualsiasi saldo riportato da periodi precedenti: moltiplicare una percentuale solo per i guadagni di quel periodo non corrisponde quindi sempre all’importo — fanno fede gli importi.

Ognuno dei tre campi può essere null, soprattutto sui rendiconti generati prima che il dettaglio venisse registrato. Non vanno sempre insieme:

• platform_fee_usd e ugc_fee_usd ci sono sempre entrambi oppure sono entrambi null: mai uno senza l’altro.
• labelgrid_ugc_rate viene salvato separatamente ed è indipendente da quella coppia: può essere null su un rendiconto che riporta entrambi gli importi e può essere valorizzato su un rendiconto in cui entrambi gli importi sono null.

Leggi ogni campo per conto suo invece di ricavarne uno dall’altro. Interpreta null come «non dettagliato», non come zero, e continua a usare labelgrid_fee come totale delle commissioni in ogni caso.

---

Scaricare un CSV di esempio

Vuoi vedere come appare l’esportazione prima di scaricare la tua? Scarica il nostro file di esempio:

Scarica CSV di esempio

L’esempio contiene dati segnaposto che mostrano voci tipiche su più piattaforme e territori, nella struttura a 23 colonne descritta sopra. Ogni riga rispetta le formule di questo articolo, quindi puoi usarlo come base di prova per sviluppare un parser.

---

Suggerimenti per lavorare con i dati

Apertura in Google Sheets

1. Vai su Google Sheets
2. Clicca File → Importa
3. Carica il tuo file CSV
4. Seleziona “Virgola” come separatore
5. Clicca Importa dati

Apertura in Excel

1. Apri Excel
2. Clicca File → Apri e seleziona il file CSV
3. Excel rileverà automaticamente il formato separato da virgole

Idee comuni per l’analisi

• Filtra per retailer per vedere i guadagni per piattaforma
• Tabella pivot per territory per trovare i tuoi mercati più forti
• Somma net_revenue_usd per verificare l’importo totale del tuo rendiconto
• Ordina per purchase_qty per trovare le tue tracce più ascoltate in streaming
• Raggruppa per release per confrontare le performance degli album

---

Risoluzione dei problemi

L’esportazione sta impiegando troppo tempo

I rendiconti grandi con molte voci potrebbero richiedere più tempo per essere generati. Il sistema esegue il polling fino a 5 minuti. Se l’esportazione va in timeout:

1. Chiudi la finestra di dialogo
2. Attendi alcuni minuti
3. Prova a scaricare di nuovo

Errore “Export in Progress”

Solo un’esportazione può essere elaborata alla volta. Attendi che l’esportazione corrente finisca, poi riprova.

Il CSV mostra caratteri inattesi

Assicurati che la tua applicazione per fogli di calcolo sia impostata sulla codifica UTF-8 durante l’importazione. Questo garantisce che i nomi degli artisti e i titoli delle tracce con caratteri speciali vengano visualizzati correttamente.

Colonne delle commissioni mancanti

Le colonne delle commissioni (platform_fee_rate, platform_fee_usd, ecc.) sono disponibili solo per i periodi di rendiconto da ottobre 2024 in poi. I periodi precedenti mostrano i dati dei ricavi senza il dettaglio delle commissioni.

---

Guide correlate

• Comprendere i report delle royalty - Come leggere i tuoi dati royalty
• Calendario dei pagamenti - Quando vengono pagate le royalty
• Informazioni fiscali - Usare i dati di esportazione per la preparazione fiscale

---

Hai bisogno di aiuto con la tua esportazione? Contatta il nostro team di supporto.