Exporter les relevés de redevances en CSV

Téléchargez vos relevés de redevances sous forme de fichiers CSV pour analyser vos revenus dans un tableur, préparer votre déclaration fiscale ou conserver des registres financiers détaillés.

Avant de commencer

• Vous devez avoir au moins un relevé de redevances payé (les relevés apparaissent après le traitement de votre premier paiement)
• Une application de tableur comme Excel, Google Sheets ou Numbers pour ouvrir le fichier CSV

---

Télécharger un relevé

1. Accédez à Royalties depuis le menu principal
2. Naviguez vers l’onglet Statements
3. Trouvez la période de relevé que vous souhaitez télécharger
4. Cliquez sur le bouton de téléchargement (icône de flèche) à côté du relevé

Le système génèrera votre fichier CSV. Pour les relevés de petite taille, le téléchargement démarre immédiatement. Pour les relevés plus volumineux, vous verrez un indicateur de progression pendant la préparation du fichier.

Astuce

Utilisez le menu Download By Year en haut de page pour exporter tous les relevés d’une année entière dans un seul fichier. C’est utile pour la préparation fiscale annuelle.

---

Ce qui se passe pendant l’export

Téléchargements instantanés

Pour la plupart des relevés, le CSV est prêt instantanément. Une boîte de dialogue apparaît avec un bouton Download pour enregistrer le fichier.

Traitement des relevés volumineux

Pour les relevés comportant de nombreuses lignes, le système traite l’export en arrière-plan :

1. Une boîte de dialogue “Preparing Export” apparaît
2. Le système génère le fichier (cela peut prendre quelques instants)
3. Une fois prêt, un bouton Download apparaît
4. Cliquez sur Download pour enregistrer le fichier

Note

Un seul export peut être exécuté à la fois. Si vous voyez un message “Export in Progress”, attendez que l’export en cours se termine avant d’en démarrer un autre.

---

Référence des colonnes CSV

Chaque ligne du CSV représente une ligne unique de votre relevé de redevances. Voici la signification de chaque colonne.

Colonnes de base

Colonne	Description	Exemple
pay_period	Période de paiement au format YYYYMM	202601
label	Nom de votre label	Midnight Records
retailer	Nom de la plateforme	Spotify
territory	Code de pays ou de région	US, GB, DE
type	Type de transaction	Stream, Download, UGC
cat	Numéro de catalogue	MR-2026-001
upc	Code-barres UPC de la release	840123456789
release	Titre de la release	Neon Skyline
isrc	Code ISRC du titre (un identifiant unique pour chaque titre)	USRC12400001
track_artist	Nom de l’artiste	Luna Rivera
track_title	Titre du morceau	Golden Hour
track_version	Informations sur la version ou le remix (vide si aucune)	Acoustic Version
track_count	Nombre de titres	1
purchase_qty	Nombre de streams ou de ventes	4523
dsp_transaction_date	Date de transaction de la plateforme	2026-01-15
dsp_statement_id	ID de référence du relevé	SP-2026-0001

Colonnes de revenus

Colonne	Description	Exemple
gross_usd	Revenu brut en USD (après déduction des frais du fournisseur de relevés)	18.09000000

Note

Le montant gross_usd est calculé après que votre fournisseur de relevés (comme Merlin ou The Orchard) a prélevé sa part. C’est le montant qui arrive à LabelGrid pour votre compte.

Colonnes de frais LabelGrid

Colonne	Description	Exemple
platform_fee_rate	Taux de frais de plateforme LabelGrid basé sur votre plan	0.05000000 (5%)
platform_fee_usd	Montant des frais de plateforme LabelGrid (affiché comme valeur négative)	-0.90450000
ugc_fee_rate	Taux de frais pour le contenu généré par les utilisateurs sur les plateformes UGC	0.20000000 (20%)
ugc_fee_usd	Montant des frais de plateforme UGC (affiché comme valeur négative)	-1.74400000
total_labelgrid_fee	Total de tous les frais LabelGrid (valeur négative)	-2.18000000
net_revenue_usd	Vos revenus finaux après tous les frais	17.18550000

---

Spécification technique

Si vous intégrez ce CSV dans un logiciel comptable ou un backend financier, voici les détails exacts du format.

Propriété	Valeur
Encodage	UTF-8
Délimiteur	Virgule (,)
Caractère de citation	Guillemet double (")
Caractère d’échappement	Barre oblique inversée (\)
Fin de ligne	LF (\n)
Ligne d’en-tête	Toujours présente en première ligne
Nombre de colonnes	23 (ordre fixe, voir la référence des colonnes ci-dessus)

Types de données et précision

Groupe de colonnes	Type	Précision
pay_period	String	YYYYMM (6 caractères)
dsp_transaction_date	String	YYYY-MM-DD (10 caractères)
purchase_qty	Entier	Nombre entier
gross_usd, *_fee_usd, net_revenue_usd	Décimal	Jusqu’à 8 décimales
platform_fee_rate, ugc_fee_rate	Décimal	Jusqu’à 8 décimales (ex., 0.05000000 = 5%)
Toutes les autres colonnes	String	Longueur variable

Astuce

Les montants des frais sont toujours des valeurs négatives (ce sont des déductions). Les colonnes de taux sont des fractions décimales, pas des pourcentages — multipliez par 100 pour obtenir le pourcentage.

Formules de revenus

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

Notes pour le traitement automatisé

• Champs vides : track_version et cat peuvent être vides (deux virgules consécutives)
• Mise entre guillemets : Les champs contenant des virgules ou des guillemets sont encadrés de guillemets doubles. Les guillemets doubles dans les valeurs de champ sont supprimés lors de l’export.
• Exports volumineux : Les exports de plus de 150 Mo sont divisés en plusieurs fichiers CSV (chacun avec sa propre ligne d’en-tête) et livrés sous forme d’archive ZIP
• Tri : Les lignes sont triées par pay_period décroissant, puis par dsp_transaction_date décroissant

---

Comprendre les frais dans le CSV

Comment le revenu net est calculé

net_revenue_usd = gross_usd + total_labelgrid_fee

Puisque les frais sont des valeurs négatives, ils réduisent votre montant brut. Par exemple :

	Montant
Revenu brut	$18.09000000
Frais de plateforme (5%)	-$0.90450000
Frais UGC	$0.00000000
Revenu net	$17.18550000

Frais des plateformes UGC

Les frais UGC s’appliquent uniquement aux plateformes de contenu généré par les utilisateurs comme YouTube, TikTok et SoundCloud. Pour les plateformes de streaming standard comme Spotify ou Apple Music, les colonnes ugc_fee_rate et ugc_fee_usd afficheront 0.00.

Avis d’inclusion des frais

Les frais sont inclus dans les exports CSV à partir de la période de relevé d’octobre 2024. Les relevés antérieurs affichent les données de revenus sans les colonnes de ventilation des frais.

---

Télécharger un exemple de CSV

Vous voulez voir à quoi ressemble l’export avant de télécharger le vôtre ? Téléchargez notre fichier d’exemple :

Télécharger l’exemple CSV

L’exemple contient des données fictives montrant des lignes typiques sur plusieurs plateformes et territoires.

---

Conseils pour travailler avec les données

Ouvrir dans Google Sheets

1. Allez sur Google Sheets
2. Cliquez sur Fichier → Importer
3. Téléchargez votre fichier CSV
4. Sélectionnez “Virgule” comme séparateur
5. Cliquez sur Importer les données

Ouvrir dans Excel

1. Ouvrez Excel
2. Cliquez sur Fichier → Ouvrir et sélectionnez le fichier CSV
3. Excel détectera automatiquement le format séparé par des virgules

Idées d’analyse courantes

• Filtrer par retailer pour voir les revenus par plateforme
• Tableau croisé dynamique par territory pour trouver vos marchés les plus forts
• Additionner net_revenue_usd pour vérifier le montant total de votre relevé
• Trier par purchase_qty pour trouver vos titres les plus écoutés
• Regrouper par release pour comparer les performances des albums

---

Dépannage

L’export prend trop de temps

Les relevés volumineux comportant de nombreuses lignes peuvent prendre plus de temps à générer. Le système interroge pendant 5 minutes maximum. Si l’export expire :

1. Fermez la boîte de dialogue
2. Attendez quelques minutes
3. Réessayez de télécharger

Erreur “Export in Progress”

Un seul export peut être traité à la fois. Attendez que l’export en cours se termine, puis réessayez.

Le CSV affiche des caractères inattendus

Assurez-vous que votre application de tableur est configurée sur l’encodage UTF-8 lors de l’importation. Cela garantit que les noms d’artistes et les titres de morceaux avec des caractères spéciaux s’affichent correctement.

Colonnes de frais manquantes

Les colonnes de frais (platform_fee_rate, platform_fee_usd, etc.) ne sont disponibles que pour les périodes de relevés à partir d’octobre 2024. Les périodes antérieures affichent les données de revenus sans la ventilation des frais.

---

Guides associés

• Understanding Royalty Reports - Comment lire vos données de redevances
• Payment Schedule - Quand les redevances sont payées
• Informations fiscales - Utiliser les données d’export pour la préparation fiscale

---

Besoin d’aide avec votre export ? Contactez notre équipe d’assistance.