Dokumentation

Importieren von Vertragstypen

Massenimport oder Aktualisierung von Vertragstypen (Royalty-Regelsätze) mit einer CSV-Vorlage, mit Unterstützung für gestaffelte Regeln, Bedingungen und mehrere Zuordnungstypen.

Vertragstypen definieren die Lizenzgebührenregeln, die bestimmen, wie Einnahmen an Rechteinhaber verteilt werden. Sie können Vertragstypen in großen Mengen mithilfe der CSV-Upload-Funktion erstellen und aktualisieren – ideal beim Einrichten mehrerer Lizenzgebührenvereinbarungen auf einmal.

Vertragstypen sind wiederverwendbar – einmal erstellt, kann ein einzelner Vertragstyp über Vertragsnutzungs-Importe mit mehreren Rechteinhabern und Produkten verknüpft werden, sodass Sie die gleichen Vertragsbedingungen nicht mehrfach eingeben müssen. Aus diesem Grund sollten Vertragstypen vor der Vertragsnutzung importiert werden.

Falls Sie nur einen oder zwei Vertragstypen erstellen möchten, können Sie diese auch über die Benutzeroberfläche erstellen.

Neu bei Verträgen? Lesen Sie zuerst die Vertragsübersicht, um zu verstehen, wie Verträge, Regeln und Bedingungen zusammenwirken.

CSV-Vorlage herunterladen

Eine CSV-Vorlage können Sie von der Seite zum Importieren von Vertragstypen herunterladen:

  1. Gehen Sie zum Hauptmenü oben links und klicken Sie auf Importieren.
  2. Wählen Sie unter „Was laden Sie hoch?" die Option „Vertragstypen".
  3. Klicken Sie auf „Vorlage für Vertragstypen herunterladen".
  4. Die CSV-Datei wird auf Ihr Gerät heruntergeladen.

Sie können auch alle vorhandenen Vertragstypen von derselben Seite exportieren. Das ist hilfreich, wenn Sie Vertragstypen in großen Mengen aktualisieren möchten – exportieren, die Daten in Ihrer Tabellenkalkulationssoftware ändern und dann erneut importieren.

Funktionsweise des Vertragstyp-Imports

Jede Zeile in der CSV stellt eine einzelne Regel innerhalb eines Vertragstyps dar. Mehrere Zeilen mit demselben Namen oder Code werden als Regeln unter einem Vertragstyp zusammengefasst.

  • Regeln werden nacheinander nach Priorität ausgewertet – die erste übereinstimmende Regel wird für die Verteilung verwendet
  • Eine Regel ohne Bedingungen dient als Standardfall
  • Wenn ein Vertragstyp-Code bereits vorhanden ist, werden seine Regeln durch die Regeln aus der Datei ersetzt

Weitere Informationen dazu, wie Regeln und Bedingungen während Lizenzgebühren-Durchläufen funktionieren, finden Sie unter Vertragsübersicht.

Vertragstyp-Daten vorbereiten

Öffnen Sie die CSV-Vorlage (oder Ihre exportierte Datei) in Ihrer Tabellenkalkulationssoftware – wir empfehlen Google Sheets statt Excel.

Identitätsspalten

SpalteAliaseErforderlichBeschreibung
namecontract-type, contract-name, contract-type-nameSiehe HinweisDer Anzeigename des Vertragstyps
codecontract-code, contract-type-codeSiehe HinweisEindeutige Kennung (automatisch umgewandelt)
descriptionNeinFreie Beschreibung

Jede Zeile muss mindestens einen von Name oder Code haben. Falls nur ein Code angegeben ist (kein Name), muss der Vertragstyp bereits im System vorhanden sein. Falls der Code fehlt, wird er automatisch aus dem Namen generiert.

Regelkonfiguration

SpalteAliaseErforderlichBeschreibung
rule-priorityorder, rule-order, rulepriorityNeinAusführungsreihenfolge (ab 0). Wird automatisch erhöht, falls nicht vorhanden
allocation-typetype, allocationtype, allocationJaWie Lizenzgebühren berechnet werden (siehe unten)
allocation-percentagepercentage, percent, rate, royalty-rateBedingtErforderlich für prozentuale Typen (0–100)
allocation-fixed-pricefixed-price, price-per-unit, fixedpriceBedingtErforderlich für Festpreis-pro-Einheit-Typ – muss größer als 0 sein

Verteilungstypen

TypAliaseErforderlich
net-receiptsnet receipts, netProzentsatz (0–100)
list-pricelist price, list, rrpProzentsatz (0–100)
list-price-minus-discountlist price minus discountProzentsatz (0–100)
fixed-price-per-unitfixed price per unit, fixed price, fixedFestpreis (größer als 0)
no-allocationno allocation, noneNichts

Weitere Informationen zu den Bedeutungen der einzelnen Verteilungstypen finden Sie unter Regelaktionen in „Verträge erstellen und verwalten".

Bedingungsspalten (alle optional)

Jede Bedingung hat einen Operator und einen Wert. Falls ein Operator vorhanden ist, ist der entsprechende Wert erforderlich.

Operator-SpalteWert-SpalteBeschreibung
discount-rate-operatordiscount-rate-valueNach Rabattsatz filtern
sale-country-operatorsale-country-value (Aliase: country, countries)Nach Land filtern (ISO-Codes)
units-sold-operatorunits-sold-valueNach verkauften Einheiten filtern
total-net-receipts-operatortotal-net-receipts-valueNach Gesamtnettoeinnahmen filtern

Numerische Operatoren (Rabattsatz, verkaufte Einheiten, Nettoeinnahmen)

OperatorSymbolWort-Aliase
Größer als>greater than, more than
Größer als oder gleich>=at least
Kleiner als<less than
Kleiner als oder gleich<=at most
Gleich=is, equals, equal to
Nicht gleich!=is not, not equal to
Zwischenbetween
Einer vonin, one of
Nicht einer vonnot in, not one of

Tipp: Verwenden Sie für den Operator between das Format min-max (z. B. 10-50).

Land-Operatoren

Unterstützt: equals (=), is-not-equal (!=), is-one-of (in), is-not-one-of (not in)

Landwerte sollten ISO-Länder-Codes (2–3 Buchstaben) sein, getrennt durch Kommas. Sie werden automatisch großgeschrieben.

Vorsicht vor automatischer Formatierung durch Tabellenkalkulationen

Excel und andere Tabellenkalkulationssoftware können Ihre Daten durch automatische Formatierung beschädigen. Häufige Probleme sind lange Zahlen, die in wissenschaftliche Notation konvertiert werden, und Daten, die reformatiert werden.

Tipp: Formatieren Sie alle Zellen als Text, bevor Sie Daten eingeben oder einfügen. Ausführliche Anweisungen finden Sie unter Einführung in den Import.

Beispiele

Einfacher Prozentvertrag

nameallocation-typeallocation-percentage
Standard Authornet-receipts25

Vertrag mit mehrstufigen Regeln

namerule-priorityallocation-typeallocation-percentageunits-sold-operatorunits-sold-value
Tiered Royalty1net-receipts30>=1000
Tiered Royalty2net-receipts25>=500
Tiered Royalty3net-receipts20

Regelpriorität 3 hat keine Bedingungen, daher dient sie als Standardfall für Verkäufe unter 500 Einheiten. Weitere Informationen zu mehrstufigen Lizenzgebühren finden Sie unter Mehrstufige Lizenzgebühren.

Länderbasierter Vertrag

namerule-priorityallocation-typeallocation-percentagesale-country-operatorsale-country-value
Regional Rates1net-receipts30inGB,US,CA
Regional Rates2net-receipts20

Vertrag mit Festpreis

nameallocation-typeallocation-fixed-price
Fixed Ratefixed-price-per-unit1.50

Vertragstypen-CSV hochladen

Speichern Sie die Datei nach der Überprüfung als CSV. In Google Sheets erfolgt dies über Datei > Herunterladen > CSV.

  1. Gehen Sie zum Hauptmenü oben links und klicken Sie auf Importieren.
  2. Wählen Sie unter „Was laden Sie hoch?" die Option „Vertragstypen".
  3. Klicken Sie unter „Datei auswählen" auf „Durchsuchen" und navigieren Sie zu Ihrer CSV-Datei.
  4. Klicken Sie auf „Weiter".
  5. Die Datei wird hochgeladen und validiert (auf Probleme überprüft). Die Ergebnisse werden auf einer Vorschauseite angezeigt.
  6. Falls die Ergebnisse gut aussehen, klicken Sie auf „Fortfahren" und die Vertragstypen werden importiert (oder, falls die Vorschau Probleme hervorhebt, müssen Sie die Daten korrigieren – lesen Sie die Fehlermeldung und überprüfen Sie die obigen Anforderungen).

Trockentest-Vorschau

Vor der Anwendung des Imports wird eine Zusammenfassung angezeigt, die zeigt:

  • Neue Vertragstypen, die erstellt werden sollen (mit Regelanzahl)
  • Vorhandene Vertragstypen, die aktualisiert werden sollen (alte und neue Regelanzahl)
  • Alle Validierungsfehler, die behoben werden müssen

Sie müssen den Import bestätigen, bevor Änderungen gespeichert werden.

Validierung

Der Import führt eine Validierung durch, bevor Änderungen vorgenommen werden:

  • Name oder Code – mindestens einer muss pro Zeile angegeben werden
  • Verteilungstyp – muss ein erkannter Typ sein
  • Prozentsatz – erforderlich für prozentuale Typen, muss 0–100 sein
  • Festpreis – erforderlich für Festpreis-pro-Einheit, muss größer als 0 sein
  • Operatoren – müssen gültig sein, falls vorhanden
  • Werte – erforderlich, wenn ein Operator angegeben ist
  • Länder-Codes – müssen 2–3 stellige ISO-Codes sein
  • Regelprioitäten – müssen innerhalb jedes Vertragstyps eindeutig sein
  • Zwischen-Werte – müssen das Format min-max mit zwei Zahlen verwenden

Vertragstypen in großen Mengen aktualisieren

Sie können den obigen Prozess auch verwenden, um vorhandene Vertragstypen in großen Mengen zu aktualisieren.

Wenn ein Vertragstyp-Code in der CSV mit einem vorhandenen Datensatz übereinstimmt:

  • Der Name und die Beschreibung werden aktualisiert (falls vorhanden)
  • Alle vorhandenen Regeln werden durch die Regeln aus der CSV ersetzt – dies ist ein vollständiger Austausch, daher werden alle Regeln, die nicht in der CSV vorhanden sind, entfernt

Tipps

  • Verwenden Sie den Template-CSV-Download, um die korrekten Spaltenüberschriften zu erhalten
  • Verwenden Sie die Export-Funktion, um Ihre aktuellen Vertragstypen als Ausgangspunkt für Bearbeitungen herunterzuladen
  • Spaltennamen sind flexibel – viele Aliase werden akzeptiert (siehe obige Tabellen)
  • Operatoren können als Symbole (>, >=) oder Wörter (greater than, at least) geschrieben werden
  • Leere Bedingungsspalten werden ignoriert – fügen Sie nur die erforderlichen Bedingungen hinzu
  • Regelpriorität ist optional – Regeln werden automatisch nummeriert, falls nicht vorhanden

Nächste Schritte

Nachdem Ihre Vertragstypen eingerichtet sind, können Sie diese mit Rechteinhabern und Produkten verknüpfen, indem Sie Vertragsnutzung importieren.