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.

---

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

Colonna	Descrizione	Esempio
gross_usd	Ricavi lordi in USD (dopo la deduzione delle commissioni del fornitore del rendiconto)	18.09000000

Nota

L’importo gross_usd è al netto della quota del tuo fornitore di rendiconti (come Merlin o The Orchard). Questo è l’importo che arriva a LabelGrid per il tuo account.

Colonne delle commissioni LabelGrid

Colonna	Descrizione	Esempio
platform_fee_rate	Tariffa della commissione piattaforma LabelGrid basata sul tuo piano	0.05000000 (5%)
platform_fee_usd	Importo della commissione piattaforma LabelGrid (mostrato come valore negativo)	-0.90450000
ugc_fee_rate	Tariffa della commissione User-Generated Content per le piattaforme UGC	0.20000000 (20%)
ugc_fee_usd	Importo della commissione piattaforma UGC (mostrato come valore negativo)	-1.74400000
total_labelgrid_fee	Totale di tutte le commissioni LabelGrid (valore negativo)	-2.18000000
net_revenue_usd	I tuoi guadagni finali dopo tutte le commissioni	17.18550000

---

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)

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 dei tassi sono frazioni decimali, non percentuali — moltiplica per 100 per ottenere la percentuale.

Formule dei ricavi

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

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. Per esempio:

	Importo
Ricavi lordi	$18.09000000
Commissione piattaforma (5%)	-$0.90450000
Commissione UGC	$0.00000000
Ricavo netto	$17.18550000

Commissioni piattaforme UGC

La commissione UGC si applica solo alle piattaforme User-Generated Content come YouTube, TikTok e SoundCloud. Per le piattaforme di streaming standard come Spotify o Apple Music, le colonne ugc_fee_rate e ugc_fee_usd mostreranno 0.00.

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.

---

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.

---

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.