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.

Ce que vous recevez

Le téléchargement est une archive ZIP qui contient :

• le fichier CSV (ou plusieurs fichiers CSV, si l’export est suffisamment volumineux pour être découpé)
• COLUMNS.txt, un fichier texte de référence décrivant chaque colonne du fichier

Chaque export généré est conservé pendant 24 heures. Si vous relancez un export avec les mêmes paramètres (compte, plage de dates et regroupement) dans ce délai, vous récupérez le fichier déjà généré, sans nouvelle génération.

---

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

Les exemples ci-dessous montrent une ligne de streaming standard et une ligne UGC.

Colonne	Description	Ligne streaming	Ligne UGC
gross_usd	Revenu brut en USD pour cette ligne, avant les frais LabelGrid	18.09000000	4.63000000

Colonnes de frais LabelGrid

Colonne	Description	Ligne streaming	Ligne UGC
platform_fee_rate	Taux de frais de plateforme de votre plan	0.05000000 (5%)	0.00000000
platform_fee_usd	Montant des frais de plateforme (affiché comme valeur négative)	-0.90450000	0.00000000
ugc_fee_rate	Taux de frais UGC / Content ID de votre plan	0.00000000	0.20000000 (20%)
ugc_fee_usd	Montant des frais UGC / Content ID (affiché comme valeur négative)	0.00000000	-0.92600000
total_labelgrid_fee	Somme des deux frais (valeur négative)	-0.90450000	-0.92600000
net_revenue_usd	Vos revenus finaux après tous les frais LabelGrid	17.18550000	3.70400000

Note

Les taux sont déterminés par relevé. Toutes les lignes d’un même relevé portent le même platform_fee_rate et le même ugc_fee_rate.

---

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)
Format de livraison	Archive ZIP contenant le CSV et un fichier de référence COLUMNS.txt

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

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. Voici une ligne de streaming complète tirée du fichier d’exemple, avec des frais de plateforme de 5% :

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

Frais de plateforme et frais UGC : deux catégories distinctes, sans effet de cascade

C’est le point le plus important à maîtriser si vous alimentez votre comptabilité à partir de cet export.

• Les deux taux portent sur le même montant.
• Aucun des deux frais n’est prélevé sur le résultat de l’autre. Les frais UGC ne s’appliquent pas à ce qui reste après les frais de plateforme, et les frais de plateforme ne s’appliquent pas à ce qui reste après les frais UGC.
• Les deux montants s’additionnent : total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.

Voici un exemple chiffré pour une ligne d’un relevé qui porte les deux types de frais, avec un taux de plateforme de 5% et un taux UGC de 20% sur ce même montant de $100.00000000 :

Calcul	Correct (additif)	Incorrect (en cascade)
Frais de plateforme	-$5.00000000	-$5.00000000
Frais UGC / Content ID	-$20.00000000 (20% de $100.00)	-$19.00000000 (20% de $95.00)
Total des frais LabelGrid	-$25.00000000	-$24.00000000

C’est la colonne de gauche qui tombe juste. Un taux de plateforme de 5% et un taux UGC de 20% représentent une déduction de 25% sur ce montant, et non les 24% que l’on obtient en appliquant un taux au reliquat de l’autre.

Quand chaque type de frais s’applique

Les frais UGC / Content ID s’appliquent aux revenus issus des contenus générés par les utilisateurs sur des plateformes comme YouTube, TikTok et SoundCloud. Sur les lignes provenant de plateformes de streaming standard comme Spotify ou Apple Music, ugc_fee_rate et ugc_fee_usd affichent 0.00.

Comme les taux sont déterminés par relevé, la plupart des lignes affichent un seul taux renseigné et l’autre à zéro : un relevé ne porte généralement qu’un seul type de revenus. Si un relevé porte bien les deux, les deux taux apparaissent sur chacune de ses lignes, et c’est la règle additive ci-dessus qui s’applique. Ne partez pas du principe qu’une seule des deux colonnes de taux est non nulle : lisez celles qui sont renseignées et additionnez-les.

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.

Les frais dans l’API des relevés

Si vous lisez les relevés via l’API publique plutôt que par l’export CSV, les endpoints de relevés renvoient la même ventilation dans trois champs supplémentaires :

Champ	Description
platform_fee_usd	Frais de distribution standard prélevés sur le relevé
ugc_fee_usd	Frais UGC / Content ID prélevés sur le relevé
labelgrid_ugc_rate	Taux des frais UGC / Content ID en vigueur lors de la génération du relevé

Les deux montants sont négatifs et leur somme donne labelgrid_fee. Les frais portent sur la totalité du montant réglé sur le relevé, y compris tout solde reporté de périodes antérieures : multiplier un taux par les seuls revenus de la période ne correspond donc pas toujours au montant — ce sont les montants qui font foi.

N’importe lequel des trois champs peut valoir null, le plus souvent sur les relevés générés avant l’enregistrement de la ventilation. Ils ne varient pas ensemble :

• platform_fee_usd et ugc_fee_usd sont toujours tous les deux renseignés ou tous les deux à null — jamais l’un sans l’autre.
• labelgrid_ugc_rate est enregistré séparément et évolue indépendamment de ces deux-là : il peut valoir null sur un relevé qui porte pourtant les deux montants, et être renseigné sur un relevé où les deux montants sont à null.

Lisez chaque champ pour lui-même plutôt que d’en déduire un à partir d’un autre. Traitez null comme « non ventilé » et non comme zéro, et continuez d’utiliser labelgrid_fee comme total des frais dans tous les cas.

---

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, dans la structure à 23 colonnes décrite ci-dessus. Chacune de ses lignes respecte les formules de cet article : vous pouvez donc vous en servir comme jeu de test pour développer un parseur.

---

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.