Responsive Image

Work declarations in the CWR format

Common Work Registration (CWR) is the international standard format of CISAC in order to register musical works for original and sub-publishers.  In order to register works with GEMA in the CWR format, please use the 2.2 version. We recommend the CWR format if you register more than 1,000 works per year.

This is how the registration process via the CWR format works

  1. Create technical prerequisites

  2. Transfer submitter code and submitter number

  3. Set up and text sharebox and SFTP account

  4. Data exchange via SFTP, data protection compliant

1. Create technical prerequisites

You have implemented the functional specifications for CWR 2.2. in your system. You can create CWR files and are ready to test them with us.

2. Submitter code and submitter number

In order to transfer CWR data, we need your submitter code and your submitter number:

  • Submitter code: Consists of 2 - 3 alphanumeric characters. You can choose this code freely. We then check with CISAC whether it is unique.
  • Submitter number corresponds to the IPI name number of your publisher creating and sending out the CWR files.

3. Die Sharebox, SFTP-Account und Tests

In order to transmit the test files to us in a data protection compliant manner, we provide a sharebox for the data exchange.

After the test phase has been completed, the file exchange will take place via SFTP.

In order to set up the sharebox and the SFTP account for you, we need details from you up front:

  • the contact person responsible for the CWR in your company
  • his or her phone number and
  • his or her e-mail address.

Please also tell us which e-mail address(es) should receive the automatic notification e-mails once we have processed a CWR file.

Please send all of the above details to regservices@gema.de.

As soon as the submitter code has been confirmed and the sharebox set up, you can upload your first test file to the sharebox. Please take our test file requirements into account.
The test file contains:

  • no more than 100 works (datasets)
  • all work constellations which you are going to register when carrying out live operations

Please also read the document: Further file requirements

The results of the processing of test files will then be stored in your sharebox. In the testphase, we accompany you on your journey and determine together with you, when you can submit your first “live” CWR file.

Information on the download

FAQs

Leider gelingt es nicht immer CWR-Dateien zu verarbeiten, da manche Dateien so schwerwiegende Fehler haben, dass die Datei nach der Vorgabe der CISAC komplett abgewiesen wird. Das heißt, kein Werk innerhalb dieser Datei konnte eingespielt werden. Senden wir Ihnen diese Rückmeldung, korrigieren Sie bitte die Datei und laden Sie sie erneut hoch. 

Die Fehlermeldungen zu dem am häufigsten auftretenden Fehler sind:

  • RECORD LENGTH DID NOT MATCH THE RECORD LENGTH SPECIFIED

    Die enthaltende Zeile hat eine Satzlänge, die unzulässig ist, meist basierend auf Sonderzeichen oder ungültige Zeichen, die den Satz verlängern.

    Beispiel:

    Fehlermeldesatz, der direkt über der fehlerhaften Zeile steht:

    FILF009RECORD LENGTH DID NOT MATCH THE RECORD LENGTH SPECIFIED
    ALT0000000000000015D@MP D€T€CT0R                                               ADAN
  • A DETAIL RECORD HAD A RECORD SEQUENCE NUMBER INCORRECTLY INCREMENTED

    Jedes neue Werk innerhalb der Datei muss mit einer fortlaufenden Sequenznummer gemeldet werden

    Auszug zwei aufeinander folgender Werke:

    NWR0000000000000000TESTWERK 1                                                    
    SPU000000000000000101000023314ORIGINALVERLAG 1
    SPU000000000000000201000007402ADMINISTRATOR 1
    SPU000000000000000301000006386DEUTSCHER SUBVERLAG
    SPT0000000000000004000006386      016660416703333I0276N001
    ...
    ...
    ...
    NWR0000000200000000TESTWERK 2
    SPU000000020000000101000003073ORIGINALVERLAG 4
    SPU000000020000000201000006386DEUTSCHER SUBVERLAG
    SPT0000000200000003000006386      006250062501875I0276N001

    Nachdem ersten gemeldeten Werk mit der Sequenznummer 0, hätte die Sequenznummer fortlaufend erhöht werden müssen, statt der 2 hätte die Sequenznummer 1 sein müssen.
  • RECORD TYPE WAS NEITHER A VALID TRANSACTION TYPE NOR A VALID DETAIL RECORD TYPE

    Am Anfang der jeweiligen Zeile wurde ein „RECORD TYPE“ genutzt, welcher gemäß den Vorgaben der CISAC unbekannt ist.  

    z. B.  
    OPT000000000000000903000025650
    STATT
    OPU000000000000000903000025650ORIGINALVERLAG 3

Am häufigsten fehlt der Agreement Type.

Die Fehlermeldung innerhalb des CWR Files ist:

INTERESTED PARTY EQUAL TO PUBLISHER TYPE "SE" ON AN SPU, BUT NO AGREEMENT TYPE WAS ENTERED (GEMA ONLY)

Ein einzelner Datensatz, auch Transaktionen genannt, beinhaltet alle Daten für ein Werk, dass Sie anmelden möchten. 

Der Fehler INTERESTED PARTY EQUAL TO PUBLISHER TYPE "SE" ON AN SPU, BUT NO AGREEMENT TYPE WAS ENTERED (GEMA ONLY) stellt einen Spezialfall dar, da es sich hierbei um eine GEMA Besonderheit handelt.

Für jeden Subverlag, der der GEMA angeschlossen ist - unabhängig davon, ob dieser Anschluss für das gesamte Gebiet „Welt“ gilt oder auf bestimmte Gebiete beschränkt ist - muss beim entsprechenden SPU Satz des GEMA Mitglieds der Agreement Type angegeben werden. 

Gültige Werte sind:

  • PS = Einzel- oder Optionsvertrag oder 
  • PG = Generalvertrag

Bitte ergänzen Sie den Agreement Type an den fehlenden Stellen und übermitteln Sie uns die betroffenen Werke in einer neuen CWR-Datei. 

Get help – quickly!

If you need us, our help centre offers answers to your questions – it is quick and easy to use and accessible to you 24/7 – and there are no waiting times.

Schematic illustration of the help centre