Tantiemen-Abrechnungen als CSV exportieren

Laden Sie Ihre Tantiemen-Abrechnungen als CSV-Dateien herunter, um Einnahmen in einer Tabellenkalkulation zu analysieren, sich auf die Steuersaison vorzubereiten oder detaillierte Finanzunterlagen zu führen.

Bevor Sie beginnen

Sie müssen mindestens eine bezahlte Tantiemen-Abrechnung haben (Abrechnungen erscheinen nach Ihrer ersten Auszahlung)
Eine Tabellenkalkulationsanwendung wie Excel, Google Sheets oder Numbers zum Öffnen der CSV-Datei

Eine Abrechnung herunterladen

Gehen Sie über das Hauptmenü zu Tantiemen
Navigieren Sie zum Tab Abrechnungen
Finden Sie den Abrechnungszeitraum, den Sie herunterladen möchten
Klicken Sie auf die Download-Schaltfläche (Pfeil-Symbol) neben der Abrechnung

Das System erstellt Ihre CSV-Datei. Bei kleineren Abrechnungen startet der Download sofort. Bei größeren Abrechnungen sehen Sie einen Fortschrittsindikator, während die Datei vorbereitet wird.

Was während des Exports passiert

Sofortige Downloads

Bei den meisten Abrechnungen ist die CSV sofort fertig. Ein Dialog erscheint mit einer Download-Schaltfläche zum Speichern der Datei.

Verarbeitung großer Abrechnungen

Bei Abrechnungen mit vielen Positionen verarbeitet das System den Export im Hintergrund:

Ein Dialog “Export wird vorbereitet” erscheint
Das System generiert die Datei (dies kann einen Moment dauern)
Sobald bereit, erscheint eine Download-Schaltfläche
Klicken Sie auf Download, um die Datei zu speichern

Was Sie erhalten

Der Download ist ein ZIP-Archiv mit folgendem Inhalt:

die CSV-Datei (oder mehrere CSV-Dateien, falls der Export so groß war, dass er aufgeteilt werden musste)
COLUMNS.txt, eine Klartextdatei, die jede Spalte der CSV beschreibt

Jeder erzeugte Export wird 24 Stunden lang aufbewahrt. Fordern Sie innerhalb dieses Zeitraums denselben Export erneut an (gleiches Konto, gleicher Datumsbereich, gleiche Gruppierung), erhalten Sie die bereits erstellte Datei; sie wird nicht neu erzeugt.

CSV-Spaltenreferenz

Jede Zeile in der CSV repräsentiert eine einzelne Position aus Ihrer Tantiemen-Abrechnung. Hier erfahren Sie, was jede Spalte bedeutet.

Grundlegende Spalten

Spalte	Beschreibung	Beispiel
`pay_period`	Zahlungszeitraum im Format YYYYMM	`202601`
`label`	Ihr Label-Name	`Midnight Records`
`retailer`	Plattformname	`Spotify`
`territory`	Länder- oder Regionscode	`US`, `GB`, `DE`
`type`	Transaktionstyp	`Stream`, `Download`, `UGC`
`cat`	Katalognummer	`MR-2026-001`
`upc`	Release UPC-Barcode	`840123456789`
`release`	Release-Titel	`Neon Skyline`
`isrc`	Track ISRC-Code (eine eindeutige Kennung für jeden Track)	`USRC12400001`
`track_artist`	Künstlername	`Luna Rivera`
`track_title`	Track-Titel	`Golden Hour`
`track_version`	Versions- oder Remix-Informationen (leer wenn keine)	`Acoustic Version`
`track_count`	Anzahl der Tracks	`1`
`purchase_qty`	Anzahl der Streams oder Verkäufe	`4523`
`dsp_transaction_date`	Transaktionsdatum von der Plattform	`2026-01-15`
`dsp_statement_id`	Abrechnungsreferenz-ID	`SP-2026-0001`

Umsatz-Spalten

Die Beispiele unten zeigen eine normale Streaming-Zeile und eine UGC-Zeile.

Spalte	Beschreibung	Streaming-Zeile	UGC-Zeile
`gross_usd`	Bruttoumsatz in USD für diese Zeile, vor den Gebühren von LabelGrid	`18.09000000`	`4.63000000`

LabelGrid-Gebührenspalten

Spalte	Beschreibung	Streaming-Zeile	UGC-Zeile
`platform_fee_rate`	Plattformgebührensatz Ihres Plans	`0.05000000` (5%)	`0.00000000`
`platform_fee_usd`	Betrag der Plattformgebühr (als negativer Wert angezeigt)	`-0.90450000`	`0.00000000`
`ugc_fee_rate`	UGC-/Content-ID-Gebührensatz Ihres Plans	`0.00000000`	`0.20000000` (20%)
`ugc_fee_usd`	Betrag der UGC-/Content-ID-Gebühr (als negativer Wert angezeigt)	`0.00000000`	`-0.92600000`
`total_labelgrid_fee`	Die beiden Gebühren zusammengerechnet (negativer Wert)	`-0.90450000`	`-0.92600000`
`net_revenue_usd`	Ihr Nettoumsatz nach allen LabelGrid-Gebühren	`17.18550000`	`3.70400000`

Technische Spezifikation

Wenn Sie diese CSV in Buchhaltungssoftware oder ein Finanz-Backend integrieren, finden Sie hier die genauen Formatdetails.

Eigenschaft	Wert
Kodierung	UTF-8
Trennzeichen	Komma (`,`)
Anführungszeichen	Doppelte Anführungszeichen (`"`)
Escape-Zeichen	Backslash (`\`)
Zeilenende	LF (`\n`)
Kopfzeile	Immer als erste Zeile vorhanden
Gesamtspalten	23 (feste Reihenfolge, siehe Spaltenreferenz oben)
Lieferung	ZIP-Archiv mit der CSV-Datei und der Referenzdatei `COLUMNS.txt`

Datentypen und Genauigkeit

Spaltengruppe	Typ	Genauigkeit
`pay_period`	String	`YYYYMM` (6 Zeichen)
`dsp_transaction_date`	String	`YYYY-MM-DD` (10 Zeichen)
`purchase_qty`	Integer	Ganzzahl
`gross_usd`, `*_fee_usd`, `net_revenue_usd`	Dezimal	Bis zu 8 Dezimalstellen
`platform_fee_rate`, `ugc_fee_rate`	Dezimal	Bis zu 8 Dezimalstellen (z.B. `0.05000000` = 5%)
Alle anderen Spalten	String	Variable Länge

Umsatzformeln

total_labelgrid_fee = platform_fee_usd + ugc_fee_usd
net_revenue_usd     = gross_usd + total_labelgrid_fee

Hinweise zur automatisierten Verarbeitung

Leere Felder: track_version und cat können leer sein (zwei aufeinanderfolgende Kommas)
Text-Anführungszeichen: Felder mit Kommas oder Anführungszeichen werden in doppelte Anführungszeichen eingeschlossen. Doppelte Anführungszeichen innerhalb von Feldwerten werden beim Export entfernt.
Große Exporte: Exporte über 150 MB werden in mehrere CSV-Dateien aufgeteilt (jede mit eigener Kopfzeile) und als ZIP-Archiv geliefert
Sortierung: Zeilen sind nach pay_period absteigend sortiert, dann nach dsp_transaction_date absteigend

Gebühren in der CSV verstehen

Wie der Nettoumsatz berechnet wird

net_revenue_usd = gross_usd + total_labelgrid_fee

Da Gebühren negative Werte sind, reduzieren sie Ihren Bruttobetrag. Hier eine vollständige Streaming-Zeile aus der Beispieldatei, mit 5% Plattformgebührensatz:

	Betrag
Bruttoumsatz (`gross_usd`)	$18.09000000
Plattformgebühr (5%)	-$0.90450000
UGC-/Content-ID-Gebühr	$0.00000000
Nettoumsatz	$17.18550000

Plattformgebühr und UGC-Gebühr sind getrennte Kategorien und bauen nicht aufeinander auf

Das ist der wichtigste Punkt, wenn Sie Ihre Buchhaltung auf diesem Export aufbauen.

Beide Gebühren werden auf denselben Betrag erhoben.
Keine der beiden Gebühren wird auf das Ergebnis der anderen erhoben: Die UGC-Gebühr gilt nicht für den Betrag, der nach Abzug der Plattformgebühr übrig bleibt, und für die Plattformgebühr gilt dasselbe umgekehrt.
Die beiden Beträge werden addiert: total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.

Ein durchgerechnetes Beispiel für eine Zeile aus einer Abrechnung, in der beide Gebührenarten anfallen: 5% Plattformgebührensatz und 20% UGC-Gebührensatz auf denselben Betrag von $100.00000000.

Berechnung	Korrekt (additiv)	Falsch (aufeinander aufbauend)
Plattformgebühr	-$5.00000000	-$5.00000000
UGC-/Content-ID-Gebühr	-$20.00000000 (20% von $100.00)	-$19.00000000 (20% von $95.00)
LabelGrid-Gebühr gesamt	-$25.00000000	-$24.00000000

Richtig ist die linke Spalte. 5% Plattformgebührensatz und 20% UGC-Gebührensatz ergeben zusammen einen Abzug von 25% auf diesen Betrag, nicht die 24%, die herauskommen, wenn Sie einen Satz auf den Rest des anderen anwenden.

Wann welche Gebühr anfällt

Die UGC-/Content-ID-Gebühr gilt für Einnahmen aus User-Generated Content auf Plattformen wie YouTube, TikTok und SoundCloud. In Zeilen von Standard-Streaming-Plattformen wie Spotify oder Apple Music zeigen ugc_fee_rate und ugc_fee_usd den Wert 0.00.

Da die Sätze pro Abrechnung ermittelt werden, ist in den meisten Zeilen nur einer der beiden Sätze ungleich null: Eine Abrechnung enthält in der Regel nur eine Art von Einnahmen. Wenn eine Abrechnung doch beide Arten enthält, erscheinen beide Sätze in jeder Zeile dieser Abrechnung, und es gilt die additive Regel von oben. Gehen Sie nicht davon aus, dass genau eine der beiden Satzspalten ungleich null ist. Lesen Sie beide Satzspalten aus und addieren Sie die Werte.

Hinweis zur Gebühreninklusion

Gebühren sind in CSV-Exporten ab dem Abrechnungszeitraum Oktober 2024 enthalten. Frühere Abrechnungen zeigen Umsatzdaten ohne die Gebührenaufschlüsselungsspalten.

Gebühren in der Abrechnungs-API

Wenn Sie Abrechnungen über die öffentliche API statt über den CSV-Export lesen, geben die Abrechnungs-Endpoints dieselbe Aufteilung in drei zusätzlichen Feldern zurück:

Feld	Beschreibung
`platform_fee_usd`	Auf der Abrechnung berechnete reguläre Vertriebsgebühr
`ugc_fee_usd`	Auf der Abrechnung berechnete UGC-/Content-ID-Gebühr
`labelgrid_ugc_rate`	UGC-/Content-ID-Gebührensatz, der bei Erstellung der Abrechnung galt

Beide Beträge sind negativ und ergeben zusammen labelgrid_fee. Gebühren werden auf den gesamten mit der Abrechnung ausgeglichenen Betrag erhoben, einschließlich eines aus früheren Zeiträumen vorgetragenen Saldos – ein Satz multipliziert mit den Einnahmen allein dieses Zeitraums ergibt daher nicht immer den Betrag; maßgeblich sind die Beträge.

Jedes der drei Felder kann null sein, meist bei Abrechnungen, die vor der Erfassung der Aufschlüsselung erstellt wurden. Sie ändern sich nicht gemeinsam:

platform_fee_usd und ugc_fee_usd sind immer beide gefüllt oder beide null – nie das eine ohne das andere.
labelgrid_ugc_rate wird getrennt gespeichert und verhält sich unabhängig von diesem Paar: Der Satz kann null sein, obwohl beide Beträge vorhanden sind, und er kann gefüllt sein, obwohl beide Beträge null sind.

Lesen Sie jedes Feld für sich, statt von einem auf das andere zu schließen. Behandeln Sie null als „nicht aufgeschlüsselt“ und nicht als Null und verwenden Sie in jedem Fall weiterhin labelgrid_fee als Gebührensumme.

Eine Beispiel-CSV herunterladen

Möchten Sie sehen, wie der Export aussieht, bevor Sie Ihre eigene Datei herunterladen? Laden Sie unsere Beispieldatei herunter:

Beispiel-CSV herunterladen

Das Beispiel ist im Layout mit 23 Spalten aufgebaut (siehe oben) und enthält Platzhalterdaten mit typischen Positionen aus mehreren Plattformen und Territorien. Jede Zeile entspricht den Formeln aus diesem Artikel. Sie können die Datei daher als Testdatensatz verwenden, wenn Sie einen Parser entwickeln.

Tipps für die Arbeit mit den Daten

In Google Sheets öffnen

Gehen Sie zu Google Sheets
Klicken Sie auf Datei → Importieren
Laden Sie Ihre CSV-Datei hoch
Wählen Sie “Komma” als Trennzeichen
Klicken Sie auf Daten importieren

In Excel öffnen

Öffnen Sie Excel
Klicken Sie auf Datei → Öffnen und wählen Sie die CSV-Datei
Excel erkennt das kommagetrennte Format automatisch

Häufige Analyseideen

Nach Retailer filtern, um Einnahmen pro Plattform zu sehen
Pivot-Tabelle nach Territory, um Ihre stärksten Märkte zu finden
net_revenue_usd summieren, um Ihren Gesamtabrechnungsbetrag zu überprüfen
Nach purchase_qty sortieren, um Ihre meistgestreamten Tracks zu finden
Nach Release gruppieren, um die Performance von Alben zu vergleichen

Fehlerbehebung

Export dauert zu lange

Große Abrechnungen mit vielen Positionen können länger zum Generieren benötigen. Das System fragt bis zu 5 Minuten lang ab. Wenn der Export eine Zeitüberschreitung erreicht:

Schließen Sie den Dialog
Warten Sie einige Minuten
Versuchen Sie es erneut mit dem Download

Fehler “Export läuft”

Es kann nur ein Export gleichzeitig verarbeitet werden. Warten Sie, bis der aktuelle Export abgeschlossen ist, und versuchen Sie es dann erneut.

CSV zeigt unerwartete Zeichen

Stellen Sie sicher, dass Ihre Tabellenkalkulationsanwendung beim Importieren auf UTF-8-Codierung eingestellt ist. Dies gewährleistet, dass Künstlernamen und Track-Titel mit Sonderzeichen korrekt angezeigt werden.

Fehlende Gebührenspalten

Gebührenspalten (platform_fee_rate, platform_fee_usd, etc.) sind nur für Abrechnungszeiträume ab Oktober 2024 verfügbar. Frühere Zeiträume zeigen Umsatzdaten ohne die Gebührenaufschlüsselung.