XML-Referenz
Diese Seite behandelt die XML-Struktur und Codebeispiele fuer den DDEX-Import von LabelGrid. Fuer Metadaten-Anforderungen, Mitwirkenden-Rollen, Splits und Formatierungsstandards siehe Release-Metadaten, Track-Metadaten und Validierung.
ERN 4.3.2 ist die empfohlene Import-Version fuer neue Integrationen — siehe ERN 4.3.2 weiter unten fuer das Wurzelelement, die KI-Kennzeichnungsfelder, die es hinzufuegt, und ein vollstaendiges 4.3.2-Beispiel mit jedem Feld. Die meisten ausfuehrlichen Beispiele auf dieser Seite verwenden das Format ERN 4.3; die Nachrichtenstruktur ist in 4.3.1/4.3.2 dieselbe, sie gelten also fuer alle drei (tausche den Wurzel-Namespace und wende die 4.3.2-Feldaenderungen an — DisplayGenre, die komplexe Role-Form und die KI-Elemente). PartyReference-Werte in der tatsaechlichen Ausgabe sind MD5-gehashte Identifikatoren (z.B. P8A1B2C3D4E5F6...). Die folgenden Beispiele verwenden lesbare Namen zur Verdeutlichung.
ERN 4.3 Nachrichtenstruktur
Abschnitt betitelt „ERN 4.3 Nachrichtenstruktur“Jede DDEX-Lieferung ist ein NewReleaseMessage XML-Dokument mit fuenf Hauptabschnitten:
NewReleaseMessage├── MessageHeader — Absender, Empfaenger und Nachrichten-ID├── PartyList — Alle Kuenstler, Mitwirkende und Rechteinhaber├── ResourceList — Audiodateien und Artwork mit technischen Details├── ReleaseList — Die Album-/Single-Release und einzelne Tracks└── DealList — Kommerzielle Bedingungen, Gebiete und DatenDas Wurzelelement beinhaltet den ERN 4.3 Namespace und die Schema-Position:
<?xml version="1.0" encoding="UTF-8"?><NewReleaseMessage xmlns:ern="http://ddex.net/xml/ern/43" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddex.net/xml/ern/43 http://ddex.net/xml/ern/43/release-notification.xsd" AvsVersionId="3" LanguageAndScriptCode="en">| Attribut | Beschreibung |
|---|---|
xmlns:ern | ERN 4.3 Namespace-URI |
xsi:schemaLocation | Schema fuer die Validierung |
AvsVersionId | Version des erlaubten Wertesatzes |
LanguageAndScriptCode | Standardsprache der Nachricht |
ERN 4.3.2
Abschnitt betitelt „ERN 4.3.2“ERN 4.3.2 ist die empfohlene Import-Version fuer neue LabelGrid-Integrationen. Es ist eine spaetere Revision der ERN-4.3-Familie und wird vom LabelGrid-Importer vollstaendig unterstuetzt. Es verwendet einen anderen Namespace und ein anderes Schema als 4.3, daher sind die beiden auf XML-Ebene nicht austauschbar: Allein das Wurzelelement bestimmt die Version. Wenn Ihr System beide erzeugen kann, generieren Sie 4.3.2.
Wurzelelement
Abschnitt betitelt „Wurzelelement“<?xml version="1.0" encoding="UTF-8"?><NewReleaseMessage xmlns:ern="http://ddex.net/xml/ern/432" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddex.net/xml/ern/432 http://ddex.net/xml/ern/432/release-notification.xsd" AvsVersionId="4" LanguageAndScriptCode="en">| Attribut | ERN 4.3 | ERN 4.3.2 |
|---|---|---|
xmlns:ern | http://ddex.net/xml/ern/43 | http://ddex.net/xml/ern/432 |
xsi:schemaLocation | …/ern/43 …/ern/43/release-notification.xsd | …/ern/432 …/ern/432/release-notification.xsd |
AvsVersionId | 3 | 4 |
Das oeffentliche release-notification-Schema von 4.3.2 befindet sich unter http://service.ddex.net/xml/ern/432/release-notification.xsd (das 4.3-Aequivalent ist http://service.ddex.net/xml/ern/43/release-notification.xsd). Sie koennen beide Dateien mit dem DDEX-Online-Validator gegen ihr Schema pruefen.
Was sich zwischen 4.3, 4.3.1 und 4.3.2 aendert {#what-changes-between-43-431-and-432}
Abschnitt betitelt „Was sich zwischen 4.3, 4.3.1 und 4.3.2 aendert {#what-changes-between-43-431-and-432}“Der Nachrichtenkoerper hat dieselbe Form wie die 4.3-Beispiele weiter unten — die Abschnitte MessageHeader, PartyList, ResourceList, ReleaseList und DealList behalten dieselbe Struktur. Die Unterschiede sind eine Handvoll Aenderungen auf Element-Ebene, die in ERN 4.3.1 eingefuehrt und unveraendert in 4.3.2 uebernommen wurden. Wenn Sie von 4.3 (4.3.0) wechseln, sind dies die drei zu aendernden Dinge:
| Bereich | ERN 4.3 (4.3.0) | ERN 4.3.1 und 4.3.2 |
|---|---|---|
| Genre-Element | <Genre> | <DisplayGenre> — dieselben Kindelemente GenreText + SubGenre, nur umbenannt |
| Mitwirkenden-Rolle | Einfach: <Role>StudioProducer</Role> | Komplex: <Role><Value>StudioProducer</Value></Role> |
| KI-Attribution | (nicht verfuegbar) | Neue Elemente <ContainsAI>, <AiContribution> und <SpecialContributor> |
Alles andere — MessageHeader, Parteien, Deals, Platzierung von ISRC/ISWC, technische Details von Audio/Artwork, Titel, P-Line/C-Line, Deals, Daten — ist identisch mit den 4.3-Beispielen im restlichen Teil dieser Seite. Die einzigen versionsspezifischen Teile sind die drei oben genannten; die KI-Kennzeichnungsfelder erhalten als Naechstes ihren eigenen Abschnitt, da sie der Hauptgrund sind, 4.3.2 zu verwenden.
KI-Kennzeichnungsfelder (4.3.2) {#ai-declaration-fields-432}
Abschnitt betitelt „KI-Kennzeichnungsfelder (4.3.2) {#ai-declaration-fields-432}“Dies ist der Teil von 4.3.2, der im einfachen 4.3 nicht existiert. Es gibt drei Elemente, und sie beschreiben alle dieselbe zugrunde liegende Offenlegung: wie viel des Inhalts von KI generiert wurde. Jeder Wert ist einer von None, Partly oder All — es gibt keine booleschen Flags und keine Freitextfelder.
Wohin jedes Element gehoert
Abschnitt betitelt „Wohin jedes Element gehoert“| Element | Erscheint auf | Position | Werte |
|---|---|---|---|
<ContainsAI> | jeder <SoundRecording> (Track) | Nach <ParentalWarningType>, vor <LanguageOfPerformance> | None / Partly / All |
<ContainsAI> | die Haupt-<Release> | Nach dem <ResourceGroup>-Block | None / Partly / All — der hoechste Wert ueber alle Tracks und das Artwork |
<ContainsAI> | das Cover-<Image> | Nach <ResourceId>, vor <TechnicalDetails> | None / Partly / All |
<AiContribution> | jeder <Contributor> | Nach <Role> | None / Partly / All |
<SpecialContributor> | ein <Contributor>, der vollstaendig KI ist | Ersetzt <ContributorPartyReference> (gegenseitig ausschliessend) | Fester Wert GenerativeAI |
Wie die Werte bestimmt werden
Abschnitt betitelt „Wie die Werte bestimmt werden“Das Track-Formular hat zwei KI-Offenlegungs-Dropdowns (siehe Tracks hinzufuegen) — Generative AI Disclosure (die Tonaufnahme) und Composition AI Disclosure (der Song). Das Release-Artwork hat seine eigene KI-Einstellung. Jede wird wie folgt einem DDEX-Wert zugeordnet:
| Offenlegungsauswahl | DDEX-Wert |
|---|---|
| Keine generative KI verwendet | None |
| Nur geringfuegige KI-Unterstuetzung | Partly |
| KI-generierte Materialanteile | Partly |
| Vollstaendig mit KI generiert | All |
- Der
<ContainsAI>-Wert eines Tracks ist der hoechste seiner Generative-AI- und Composition-AI-Offenlegungen. - Der
<ContainsAI>-Wert der Release ist der hoechste ueber jeden Track plus das Artwork. - Der
<AiContribution>-Wert eines<Contributor>spiegelt diesen spezifischen Credit wider. Benannte (menschliche) Mitwirkende sind aufPartlybegrenzt — ein Wert vonAllwird ausschliesslich ueber<SpecialContributor>GenerativeAI</SpecialContributor>ausgedrueckt, das keinen Parteinamen traegt.
Beispiele im Kontext
Abschnitt betitelt „Beispiele im Kontext“DisplayGenre ersetzt das 4.3-Element Genre (die Kindelemente bleiben unveraendert):
<!-- 4.3.2 uses DisplayGenre; 4.3.0 used Genre --><DisplayGenre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre></DisplayGenre>ContainsAI auf einem Track, an seiner korrekten Position:
<SoundRecording> <ResourceReference>A1</ResourceReference> <!-- ... editions, titles, artists, contributors, duration ... --> <ParentalWarningType>NotExplicit</ParentalWarningType> <ContainsAI>Partly</ContainsAI> <LanguageOfPerformance>en</LanguageOfPerformance></SoundRecording>ContainsAI auf dem Cover-Bild (vor TechnicalDetails):
<Image> <ResourceReference>A2</ResourceReference> <Type>FrontCoverImage</Type> <ResourceId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890:cover</ProprietaryId> </ResourceId> <ContainsAI>None</ContainsAI> <TechnicalDetails> <!-- ... --> </TechnicalDetails></Image>Ein Mitwirkender, der die komplexe Role-Form mit einem AiContribution verwendet, neben einem vollstaendig KI-generierten Mitwirkenden, der SpecialContributor anstelle einer Parteireferenz verwendet:
<!-- Human contributor: complex Role + per-credit AiContribution --><Contributor SequenceNumber="1"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role><Value>StudioProducer</Value></Role> <AiContribution>None</AiContribution></Contributor>
<!-- Fully AI-generated credit: SpecialContributor replaces ContributorPartyReference --><Contributor SequenceNumber="2"> <SpecialContributor>GenerativeAI</SpecialContributor> <Role><Value>Vocalist</Value></Role> <AiContribution>All</AiContribution></Contributor>Um zu bestaetigen, dass eine 4.3.2-Nachricht vor der Lieferung valide ist, pruefe sie gegen das oeffentliche release-notification-Schema von 4.3.2 (http://service.ddex.net/xml/ern/432/release-notification.xsd) mit dem DDEX-Online-Validator.
MessageHeader
Abschnitt betitelt „MessageHeader“Identifiziert den Absender (Ihre Organisation), den Empfaenger (den DSP) und eine eindeutige Nachrichten-ID.
<MessageHeader> <MessageThreadId>20250815-neonsounds-001</MessageThreadId> <MessageId>20250815-neonsounds-001-msg01</MessageId> <MessageSender> <PartyId>PADPIDA2025010100A</PartyId> <PartyName><FullName>Neon Sounds</FullName></PartyName> </MessageSender> <MessageRecipient> <PartyId>PADPIDA2014120301U</PartyId> <PartyName><FullName>Spotify</FullName></PartyName> </MessageRecipient> <MessageCreatedDateTime>2025-08-01T10:30:00Z</MessageCreatedDateTime></MessageHeader>| Element | Beschreibung |
|---|---|
MessageThreadId | Gruppiert zusammengehoerige Nachrichten (z.B. Aktualisierungen derselben Release) |
MessageId | Eindeutiger Identifikator fuer diese spezifische Nachricht |
MessageSender | Die DDEX Party ID und der Name Ihrer Organisation |
MessageRecipient | Die Party ID und der Name des empfangenden DSP |
MessageCreatedDateTime | ISO 8601-Zeitstempel der Nachrichtenerstellung |
PartyList
Abschnitt betitelt „PartyList“Alle Entitaeten, die anderswo im XML referenziert werden — das Plattenlabel, Kuenstler, Mitwirkende und Verlage — werden hier definiert. Jede Partei erhaelt eine PartyReference, die verwendet wird, um sie im gesamten Dokument zu verknuepfen.
Plattenlabel
Abschnitt betitelt „Plattenlabel“<Party> <PartyReference>P_LABEL_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds LLC</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:label:100</ProprietaryId> </PartyId></Party>Kuenstler
Abschnitt betitelt „Kuenstler“Kuenstler koennen Standard-Identifikatoren wie ISNI enthalten:
<!-- Primary Artist with ISNI --><Party> <PartyReference>P_ARTIST_LUNAWAVE</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Luna Wave</FullName> </PartyName> <PartyId> <ISNI>0000000012345678</ISNI> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:200</ProprietaryId> </PartyId></Party>
<!-- Featured Artist (no ISNI) --><Party> <PartyReference>P_ARTIST_DJKODA</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>DJ Koda</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:201</ProprietaryId> </PartyId></Party>Mitwirkende
Abschnitt betitelt „Mitwirkende“Mitwirkende (Songschreiber, Produzenten, Techniker) koennen IPI-Identifikatoren enthalten:
<!-- Songwriter / Composer / Producer with IPI --><Party> <PartyReference>P_CONTRIB_SARAHCHEN</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Sarah Chen</FullName> </PartyName> <PartyId> <IpiNameNumber>00123456789</IpiNameNumber> </PartyId></Party>
<!-- Mixing Engineer (no IPI) --><Party> <PartyReference>P_CONTRIB_MIXMASTER</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Mike Torres</FullName> </PartyName></Party>Verlage
Abschnitt betitelt „Verlage“<Party> <PartyReference>P_PUBLISHER_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds Publishing</FullName> </PartyName></Party>Unterstuetzte Partei-Identifikatoren:
| Identifikator | Element | Format |
|---|---|---|
| ISNI | <ISNI> | 16 Zeichen (15 Ziffern + Pruefziffer) |
| IPI | <IpiNameNumber> | Mit Nullen aufgefuellt auf 11 Ziffern |
| Proprietaer | <ProprietaryId> | Interne LabelGrid-Referenz |
ResourceList
Abschnitt betitelt „ResourceList“Enthaelt alle Audiodateien und Artwork. Jede Ressource erhaelt eine ResourceReference (z.B. A1, A2), die verwendet wird, um sie mit Releases zu verknuepfen.
Tonaufnahme
Abschnitt betitelt „Tonaufnahme“<SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type>
<!-- ISRC and P-Line inside SoundRecordingEdition --> <SoundRecordingEdition> <ResourceId> <ISRC>USNS12500001</ISRC> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine>
<!-- Technical details of the audio file --> <TechnicalDetails> <TechnicalResourceDetailsReference>T1</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="WAV">UserDefined</AudioCodecType> <NumberOfChannels>2</NumberOfChannels> <SamplingRate>44100</SamplingRate> <BitsPerSample>16</BitsPerSample> <File> <URI>resources/198765432109_01_01.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>d41d8cd98f00b204e9800998ecf8427e</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition>
<!-- ISWC goes on parent SoundRecording, NOT inside Edition --> <WorkId> <ISWC>T3351864278</ISWC> </WorkId>
<!-- Track title --> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle>
<!-- Display artist string --> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName>
<!-- Artist roles --> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist>
<!-- Contributors --> <Contributor SequenceNumber="1"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role>ComposerLyricist</Role> </Contributor> <Contributor SequenceNumber="2"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <!-- "Producer" display role maps to DDEX role "StudioProducer" --> <Role>StudioProducer</Role> </Contributor> <Contributor SequenceNumber="3"> <ContributorPartyReference>P_CONTRIB_MIXMASTER</ContributorPartyReference> <Role>MixingEngineer</Role> </Contributor> <Contributor SequenceNumber="4"> <ContributorPartyReference>P_PUBLISHER_NEONSOUNDS</ContributorPartyReference> <Role>MusicPublisher</Role> </Contributor>
<!-- Copyright ownership --> <WorkRightsController> <RightsControllerPartyReference>P_LABEL_NEONSOUNDS</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>100.00</RightSharePercentage> <Territory>Worldwide</Territory> </WorkRightsController>
<!-- Duration in ISO 8601 format --> <Duration>PT00H04M32S</Duration>
<!-- Parental warning --> <ParentalWarningType>NotExplicit</ParentalWarningType>
<!-- Language of performance --> <LanguageOfPerformance>en</LanguageOfPerformance></SoundRecording>Wichtige Punkte:
ISRCundPLinegehoeren inSoundRecordingEditionISWCgehoert zum uebergeordnetenSoundRecordingueberWorkId(nicht in die Edition)DisplayTitleTextenthaelt nur den Basistitel (keine Mix-Version)- Das
SubTitle-Element innerhalb vonDisplayTitleenthaelt die Mix-Version (leer, wenn keine vorhanden) - Die Anzeigerolle “Producer” entspricht der DDEX-Rolle
StudioProducer - Die Audio-Datei-URI folgt dem Muster:
resources/{UPC}_{disc}_{track}.{ext}
Cover-Art
Abschnitt betitelt „Cover-Art“<Image> <ResourceReference>A2</ResourceReference> <Type>FrontCoverImage</Type> <ResourceId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890:cover</ProprietaryId> </ResourceId> <TechnicalDetails> <TechnicalResourceDetailsReference>T2</TechnicalResourceDetailsReference> <ImageCodecType>JPEG</ImageCodecType> <ImageHeight>3000</ImageHeight> <ImageWidth>3000</ImageWidth> <File> <URI>resources/198765432109.jpg</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4</HashSumValue> </HashSum> </File> </TechnicalDetails></Image>ReleaseList
Abschnitt betitelt „ReleaseList“Enthaelt die Hauptrelease (das Album oder die Single) und einzelne Track-Releases. Die Hauptrelease verknuepft Ressourcen ueber ResourceGroup.
Hauptrelease
Abschnitt betitelt „Hauptrelease“<Release> <ReleaseReference>R0</ReleaseReference>
<!-- ReleaseType comes before ReleaseId in ERN 4.3 --> <ReleaseType>Single</ReleaseType>
<ReleaseId> <ICPN>198765432109</ICPN> <CatalogNumber Namespace="PADPIDA2025010100A">NS-2025-042</CatalogNumber> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890</ProprietaryId> </ReleaseId>
<DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle>
<DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist>
<ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference>
<PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <CLine> <Year>2025</Year> <CLineText>Neon Sounds LLC</CLineText> </CLine>
<Genre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </Genre>
<OriginalReleaseDate>2025-08-15</OriginalReleaseDate>
<ParentalWarningType>NotExplicit</ParentalWarningType>
<!-- ResourceGroup links tracks and artwork to the release --> <ResourceGroup> <SequenceNumber>1</SequenceNumber> <ResourceGroupContentItem> <SequenceNumber>1</SequenceNumber> <ReleaseResourceReference>A1</ReleaseResourceReference> </ResourceGroupContentItem> <ResourceGroupContentItem> <SequenceNumber>2</SequenceNumber> <ReleaseResourceReference>A2</ReleaseResourceReference> </ResourceGroupContentItem> </ResourceGroup></Release>Wichtige Punkte:
ReleaseTypekommt vorReleaseIdin ERN 4.3- Die UPC/EAN geht in
<ICPN>innerhalb vonReleaseId - Ressourcen werden ueber
ResourceGroupverknuepft (nichtReleaseResourceReferenceList) ReleaseLabelReferenceverweist auf diePartyReferencedes Labels
Track-Release
Abschnitt betitelt „Track-Release“Jeder Track erhaelt auch seine eigene TrackRelease fuer die individuelle Track-Verfuegbarkeit auf Plattformen:
<TrackRelease> <ReleaseReference>RT1</ReleaseReference> <ReleaseId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ReleaseId>
<DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle>
<ReleaseResourceReference>A1</ReleaseResourceReference> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference>
<Genre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </Genre>
<Keywords>electronic deep house chill night</Keywords></TrackRelease>DealList
Abschnitt betitelt „DealList“Definiert die kommerziellen Bedingungen, unter denen die Release verfuegbar ist. Jeder Deal gibt ein Gebiet, ein Startdatum, ein kommerzielles Modell und einen Nutzungstyp an.
<DealList> <ReleaseDeal> <DealReleaseReference>R0</DealReleaseReference>
<!-- Subscription streaming (e.g., Spotify Premium) --> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal>
<!-- Ad-supported streaming (e.g., Spotify Free) --> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>AdvertisementSupportedModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal>
<!-- Pay-per-download (e.g., iTunes) --> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>PayAsYouGoModel</CommercialModelType> <UseType>PermanentDownload</UseType> </DealTerms> </Deal>
</ReleaseDeal></DealList>Kommerzielle Modelltypen:
| Modell | Beschreibung | Beispiel |
|---|---|---|
SubscriptionModel | Kostenpflichtiges Abo-Streaming | Spotify Premium, Apple Music |
AdvertisementSupportedModel | Kostenloses werbegestuetztes Streaming | Spotify Free, YouTube |
PayAsYouGoModel | Pay-per-Download-Kauf | iTunes, Amazon Music |
Beispiele {#examples}
Abschnitt betitelt „Beispiele {#examples}“Vollstaendige Single-Release
Eine vollstaendige Einzeltrack-Release mit einem Hauptkuenstler, einem Featured-Kuenstler und vollstaendigen Mitwirkenden-Credits.
Eingabe-Metadaten:
| Feld | Wert |
|---|---|
| Titel | Midnight Run |
| Kuenstler | Luna Wave (Haupt), DJ Koda (Featured) |
| UPC | 198765432109 |
| Veroeffentlichungsdatum | 2025-08-15 |
| Label | Neon Sounds |
| Katalognummer | NS-2025-042 |
| Genre | Electronic / Deep House |
| C-Line | 2025 Neon Sounds LLC |
| P-Line | 2025 Neon Sounds LLC |
| Track-ISRC | USNS12500001 |
| Explizit | Nicht explizit |
Generiertes XML:
<?xml version="1.0" encoding="UTF-8"?><NewReleaseMessage xmlns:ern="http://ddex.net/xml/ern/43" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddex.net/xml/ern/43 http://ddex.net/xml/ern/43/release-notification.xsd" AvsVersionId="3" LanguageAndScriptCode="en">
<MessageHeader> <MessageThreadId>20250815-neonsounds-001</MessageThreadId> <MessageId>20250815-neonsounds-001-msg01</MessageId> <MessageSender> <PartyId>PADPIDA2025010100A</PartyId> <PartyName><FullName>Neon Sounds</FullName></PartyName> </MessageSender> <MessageRecipient> <PartyId>PADPIDA2014120301U</PartyId> <PartyName><FullName>Spotify</FullName></PartyName> </MessageRecipient> <MessageCreatedDateTime>2025-08-01T10:30:00Z</MessageCreatedDateTime> </MessageHeader>
<PartyList> <Party> <PartyReference>P_LABEL_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds LLC</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:label:100</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_ARTIST_LUNAWAVE</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Luna Wave</FullName> </PartyName> <PartyId> <ISNI>0000000012345678</ISNI> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:200</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_ARTIST_DJKODA</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>DJ Koda</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:201</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_CONTRIB_SARAHCHEN</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Sarah Chen</FullName> </PartyName> <PartyId> <IpiNameNumber>00123456789</IpiNameNumber> </PartyId> </Party> <Party> <PartyReference>P_CONTRIB_MIXMASTER</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Mike Torres</FullName> </PartyName> </Party> <Party> <PartyReference>P_PUBLISHER_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds Publishing</FullName> </PartyName> </Party> </PartyList>
<ResourceList> <SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type> <SoundRecordingEdition> <ResourceId> <ISRC>USNS12500001</ISRC> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <TechnicalDetails> <TechnicalResourceDetailsReference>T1</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="WAV">UserDefined</AudioCodecType> <NumberOfChannels>2</NumberOfChannels> <SamplingRate>44100</SamplingRate> <BitsPerSample>16</BitsPerSample> <File> <URI>resources/198765432109_01_01.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>d41d8cd98f00b204e9800998ecf8427e</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition> <WorkId> <ISWC>T3351864278</ISWC> </WorkId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist> <Contributor SequenceNumber="1"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role>ComposerLyricist</Role> </Contributor> <Contributor SequenceNumber="2"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role>StudioProducer</Role> </Contributor> <Contributor SequenceNumber="3"> <ContributorPartyReference>P_CONTRIB_MIXMASTER</ContributorPartyReference> <Role>MixingEngineer</Role> </Contributor> <Contributor SequenceNumber="4"> <ContributorPartyReference>P_PUBLISHER_NEONSOUNDS</ContributorPartyReference> <Role>MusicPublisher</Role> </Contributor> <WorkRightsController> <RightsControllerPartyReference>P_LABEL_NEONSOUNDS</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>100.00</RightSharePercentage> <Territory>Worldwide</Territory> </WorkRightsController> <Duration>PT00H04M32S</Duration> <ParentalWarningType>NotExplicit</ParentalWarningType> <LanguageOfPerformance>en</LanguageOfPerformance> </SoundRecording>
<Image> <ResourceReference>A2</ResourceReference> <Type>FrontCoverImage</Type> <ResourceId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890:cover</ProprietaryId> </ResourceId> <TechnicalDetails> <TechnicalResourceDetailsReference>T2</TechnicalResourceDetailsReference> <ImageCodecType>JPEG</ImageCodecType> <ImageHeight>3000</ImageHeight> <ImageWidth>3000</ImageWidth> <File> <URI>resources/198765432109.jpg</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4</HashSumValue> </HashSum> </File> </TechnicalDetails> </Image> </ResourceList>
<ReleaseList> <Release> <ReleaseReference>R0</ReleaseReference> <ReleaseType>Single</ReleaseType> <ReleaseId> <ICPN>198765432109</ICPN> <CatalogNumber Namespace="PADPIDA2025010100A">NS-2025-042</CatalogNumber> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890</ProprietaryId> </ReleaseId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <CLine> <Year>2025</Year> <CLineText>Neon Sounds LLC</CLineText> </CLine> <Genre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </Genre> <OriginalReleaseDate>2025-08-15</OriginalReleaseDate> <ParentalWarningType>NotExplicit</ParentalWarningType> <ResourceGroup> <SequenceNumber>1</SequenceNumber> <ResourceGroupContentItem> <SequenceNumber>1</SequenceNumber> <ReleaseResourceReference>A1</ReleaseResourceReference> </ResourceGroupContentItem> <ResourceGroupContentItem> <SequenceNumber>2</SequenceNumber> <ReleaseResourceReference>A2</ReleaseResourceReference> </ResourceGroupContentItem> </ResourceGroup> </Release>
<TrackRelease> <ReleaseReference>RT1</ReleaseReference> <ReleaseId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ReleaseId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <ReleaseResourceReference>A1</ReleaseResourceReference> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference> <Genre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </Genre> <Keywords>electronic deep house chill night</Keywords> </TrackRelease> </ReleaseList>
<DealList> <ReleaseDeal> <DealReleaseReference>R0</DealReleaseReference> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>AdvertisementSupportedModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>PayAsYouGoModel</CommercialModelType> <UseType>PermanentDownload</UseType> </DealTerms> </Deal> </ReleaseDeal> </DealList>
</NewReleaseMessage>Vollstaendige ERN 4.3.2-Release (alle Felder, mit KI-Kennzeichnungen)
Dieselbe Release wie oben, ausgedrueckt in ERN 4.3.2 mit jedem Feld, das LabelGrid verwendet. Beachten Sie die Unterschiede zur 4.3-Version: den /432-Namespace und AvsVersionId="4", <DisplayGenre> statt <Genre>, die komplexe <Role><Value>…</Value></Role>-Form, <ContainsAI> auf dem Track / der Release / dem Bild, ein <AiContribution> auf jedem Mitwirkenden und einen vollstaendig KI-generierten Vocalisten, ausgedrueckt mit <SpecialContributor>GenerativeAI</SpecialContributor> (kein PartyList-Eintrag).
Eingabe-Metadaten (gleich wie das 4.3-Beispiel, plus KI-Offenlegungen):
| Feld | Wert |
|---|---|
| Generative AI Disclosure | Nur geringfuegige KI-Unterstuetzung → Partly |
| Composition AI Disclosure | Keine generative KI → None |
| Artwork AI | Keine generative KI → None |
| KI-Vocalist | Vollstaendig KI-generierter Credit → SpecialContributor / All |
Generiertes XML:
<?xml version="1.0" encoding="UTF-8"?><NewReleaseMessage xmlns:ern="http://ddex.net/xml/ern/432" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddex.net/xml/ern/432 http://ddex.net/xml/ern/432/release-notification.xsd" AvsVersionId="4" LanguageAndScriptCode="en">
<MessageHeader> <MessageThreadId>20250815-neonsounds-001</MessageThreadId> <MessageId>20250815-neonsounds-001-msg01</MessageId> <MessageSender> <PartyId>PADPIDA2025010100A</PartyId> <PartyName><FullName>Neon Sounds</FullName></PartyName> </MessageSender> <MessageRecipient> <PartyId>PADPIDA2014120301U</PartyId> <PartyName><FullName>Spotify</FullName></PartyName> </MessageRecipient> <MessageCreatedDateTime>2025-08-01T10:30:00Z</MessageCreatedDateTime> </MessageHeader>
<PartyList> <Party> <PartyReference>P_LABEL_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds LLC</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:label:100</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_ARTIST_LUNAWAVE</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Luna Wave</FullName> </PartyName> <PartyId> <ISNI>0000000012345678</ISNI> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:200</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_ARTIST_DJKODA</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>DJ Koda</FullName> </PartyName> <PartyId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:artist:201</ProprietaryId> </PartyId> </Party> <Party> <PartyReference>P_CONTRIB_SARAHCHEN</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Sarah Chen</FullName> </PartyName> <PartyId> <IpiNameNumber>00123456789</IpiNameNumber> </PartyId> </Party> <Party> <PartyReference>P_CONTRIB_MIXMASTER</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Mike Torres</FullName> </PartyName> </Party> <Party> <PartyReference>P_PUBLISHER_NEONSOUNDS</PartyReference> <PartyName LanguageAndScriptCode="en"> <FullName>Neon Sounds Publishing</FullName> </PartyName> </Party> <!-- No Party entry for the AI vocalist — it is declared via SpecialContributor --> </PartyList>
<ResourceList> <SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type> <SoundRecordingEdition> <ResourceId> <ISRC>USNS12500001</ISRC> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <TechnicalDetails> <TechnicalResourceDetailsReference>T1</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="WAV">UserDefined</AudioCodecType> <NumberOfChannels>2</NumberOfChannels> <SamplingRate>44100</SamplingRate> <BitsPerSample>16</BitsPerSample> <File> <URI>resources/198765432109_01_01.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>d41d8cd98f00b204e9800998ecf8427e</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition> <WorkId> <ISWC>T3351864278</ISWC> </WorkId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist>
<!-- Contributors use the complex Role form and carry an AiContribution --> <Contributor SequenceNumber="1"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role><Value>ComposerLyricist</Value></Role> <AiContribution>None</AiContribution> </Contributor> <Contributor SequenceNumber="2"> <ContributorPartyReference>P_CONTRIB_SARAHCHEN</ContributorPartyReference> <Role><Value>StudioProducer</Value></Role> <AiContribution>None</AiContribution> </Contributor> <Contributor SequenceNumber="3"> <ContributorPartyReference>P_CONTRIB_MIXMASTER</ContributorPartyReference> <Role><Value>MixingEngineer</Value></Role> <AiContribution>Partly</AiContribution> </Contributor> <!-- Fully AI-generated vocal credit: SpecialContributor replaces the party reference --> <Contributor SequenceNumber="4"> <SpecialContributor>GenerativeAI</SpecialContributor> <Role><Value>Vocalist</Value></Role> <AiContribution>All</AiContribution> </Contributor> <Contributor SequenceNumber="5"> <ContributorPartyReference>P_PUBLISHER_NEONSOUNDS</ContributorPartyReference> <Role><Value>MusicPublisher</Value></Role> <AiContribution>Partly</AiContribution> </Contributor>
<WorkRightsController> <RightsControllerPartyReference>P_LABEL_NEONSOUNDS</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>100.00</RightSharePercentage> <Territory>Worldwide</Territory> </WorkRightsController> <Duration>PT00H04M32S</Duration> <ParentalWarningType>NotExplicit</ParentalWarningType> <!-- Track-level AI = highest of Generative AI (Partly) and Composition AI (None) --> <ContainsAI>Partly</ContainsAI> <LanguageOfPerformance>en</LanguageOfPerformance> </SoundRecording>
<Image> <ResourceReference>A2</ResourceReference> <Type>FrontCoverImage</Type> <ResourceId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890:cover</ProprietaryId> </ResourceId> <!-- Artwork AI declaration, before TechnicalDetails --> <ContainsAI>None</ContainsAI> <TechnicalDetails> <TechnicalResourceDetailsReference>T2</TechnicalResourceDetailsReference> <ImageCodecType>JPEG</ImageCodecType> <ImageHeight>3000</ImageHeight> <ImageWidth>3000</ImageWidth> <File> <URI>resources/198765432109.jpg</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4</HashSumValue> </HashSum> </File> </TechnicalDetails> </Image> </ResourceList>
<ReleaseList> <Release> <ReleaseReference>R0</ReleaseReference> <ReleaseType>Single</ReleaseType> <ReleaseId> <ICPN>198765432109</ICPN> <CatalogNumber Namespace="PADPIDA2025010100A">NS-2025-042</CatalogNumber> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890</ProprietaryId> </ReleaseId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave feat. DJ Koda</DisplayArtistName> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> </DisplayArtist> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <CLine> <Year>2025</Year> <CLineText>Neon Sounds LLC</CLineText> </CLine> <!-- 4.3.2 uses DisplayGenre instead of Genre --> <DisplayGenre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </DisplayGenre> <OriginalReleaseDate>2025-08-15</OriginalReleaseDate> <ParentalWarningType>NotExplicit</ParentalWarningType> <ResourceGroup> <SequenceNumber>1</SequenceNumber> <ResourceGroupContentItem> <SequenceNumber>1</SequenceNumber> <ReleaseResourceReference>A1</ReleaseResourceReference> </ResourceGroupContentItem> <ResourceGroupContentItem> <SequenceNumber>2</SequenceNumber> <ReleaseResourceReference>A2</ReleaseResourceReference> </ResourceGroupContentItem> </ResourceGroup> <!-- Release-level AI = highest value across all tracks and artwork --> <ContainsAI>Partly</ContainsAI> </Release>
<TrackRelease> <ReleaseReference>RT1</ReleaseReference> <ReleaseId> <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:track:12345</ProprietaryId> </ReleaseId> <DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Midnight Run</TitleText> <SubTitle/> </DisplayTitle> <ReleaseResourceReference>A1</ReleaseResourceReference> <ReleaseLabelReference>P_LABEL_NEONSOUNDS</ReleaseLabelReference> <DisplayGenre> <GenreText>Electronic</GenreText> <SubGenre>Deep House</SubGenre> </DisplayGenre> <Keywords>electronic deep house chill night</Keywords> </TrackRelease> </ReleaseList>
<DealList> <ReleaseDeal> <DealReleaseReference>R0</DealReleaseReference> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>AdvertisementSupportedModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms> </Deal> <Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>PayAsYouGoModel</CommercialModelType> <UseType>PermanentDownload</UseType> </DealTerms> </Deal> </ReleaseDeal> </DealList>
</NewReleaseMessage>Mehrsprachige Titel (Japanisch)
Wenn eine Release sowohl englische als auch japanische Metadaten hat. Alle DisplayTitleText-Elemente kommen zuerst, dann alle DisplayTitle-Elemente. Japanische phonetische Lesungen verwenden ja-Kana (zugeordnet vom internen ja-Jpan).
<!-- All DisplayTitleText elements first --><DisplayTitleText LanguageAndScriptCode="ja">夜明けの歌</DisplayTitleText><DisplayTitleText LanguageAndScriptCode="en">Song of Dawn</DisplayTitleText>
<!-- Then all DisplayTitle elements --><DisplayTitle LanguageAndScriptCode="ja"> <TitleText>夜明けの歌</TitleText> <SubTitle/></DisplayTitle><DisplayTitle LanguageAndScriptCode="en"> <TitleText>Song of Dawn</TitleText> <SubTitle/></DisplayTitle>
<!-- Japanese phonetic reading uses ja-Kana --><PartyName LanguageAndScriptCode="en"> <FullName>Yuki Tanaka</FullName></PartyName><PartyName LanguageAndScriptCode="ja-Kana"> <FullName>タナカ ユキ</FullName></PartyName>Wichtige Punkte:
- Gruppieren Sie alle
DisplayTitleText-Elemente zusammen, dann alleDisplayTitle-Elemente - Verwenden Sie
ja-Kanafuer japanische phonetische Lesungen (Katakana) — dies wird vom internen Codeja-Jpanzugeordnet - Stellen Sie Titel in jeder unterstuetzten Sprache bereit
Remix-Track mit Mix-Version
Wenn ein Track ein Remix ist, geht die Mix-Version in SubTitle und der Remixer erhaelt sowohl eine FeaturedArtist-Anzeigerolle als auch eine ArtisticRole von Remixer.
<SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type>
<SoundRecordingEdition> <ResourceId> <ISRC>GBXYZ2500042</ISRC> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Deep Records</PLineText> </PLine> </SoundRecordingEdition>
<!-- DisplayTitleText uses base title only (NOT "Horizon (Koda Extended Mix)") --> <DisplayTitleText LanguageAndScriptCode="en">Horizon</DisplayTitleText> <!-- Mix version goes into SubTitle --> <DisplayTitle LanguageAndScriptCode="en"> <TitleText>Horizon</TitleText> <SubTitle>Koda Extended Mix</SubTitle> </DisplayTitle>
<DisplayArtistName ApplicableTerritoryCode="Worldwide">Luna Wave</DisplayArtistName>
<!-- Primary artist --> <DisplayArtist SequenceNumber="1"> <ArtistPartyReference>P_ARTIST_LUNAWAVE</ArtistPartyReference> <DisplayArtistRole>MainArtist</DisplayArtistRole> </DisplayArtist>
<!-- Remixer: uses FeaturedArtist for display + ArtisticRole=Remixer --> <DisplayArtist SequenceNumber="2"> <ArtistPartyReference>P_ARTIST_DJKODA</ArtistPartyReference> <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> <ArtisticRole>Remixer</ArtisticRole> </DisplayArtist>
<Duration>PT00H06M45S</Duration> <ParentalWarningType>NotExplicit</ParentalWarningType></SoundRecording>Wichtige Punkte:
DisplayTitleTextenthaelt nur den Basistitel — niemals die verkettete Form wie “Horizon (Koda Extended Mix)”- Die Mix-Version geht in
SubTitleinnerhalb vonDisplayTitle - Der Remixer benoetigt sowohl
DisplayArtistRole=FeaturedArtistals auchArtisticRole=Remixer - Bei mehrsprachigen Titeln lokalisieren Sie die Mix-Version in jeder Sprache
Dolby Atmos (Stereo + Immersiv)
Wenn ein Track sowohl Stereo- als auch Dolby Atmos-Versionen hat, enthaelt das SoundRecording zwei SoundRecordingEdition-Elemente — eine NonImmersiveEdition und eine ImmersiveEdition. Jede muss ihren eigenen eindeutigen ISRC haben.
<SoundRecording> <ResourceReference>A1</ResourceReference> <Type>MusicalWorkSoundRecording</Type>
<!-- Stereo edition (marked NonImmersive when Dolby also exists) --> <SoundRecordingEdition> <Type>NonImmersiveEdition</Type> <ResourceId> <ISRC>USNS12500001</ISRC> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <TechnicalDetails> <TechnicalResourceDetailsReference>T1</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="WAV">UserDefined</AudioCodecType> <NumberOfChannels>2</NumberOfChannels> <SamplingRate>44100</SamplingRate> <BitsPerSample>16</BitsPerSample> <File> <URI>resources/198765432109_01_01.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>d41d8cd98f00b204e9800998ecf8427e</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition>
<!-- Dolby Atmos / Immersive edition (separate ISRC required) --> <SoundRecordingEdition> <Type>ImmersiveEdition</Type> <ResourceId> <!-- Must be a different ISRC from the stereo edition --> <ISRC>USNS12500002</ISRC> </ResourceId> <PLine> <Year>2025</Year> <PLineText>Neon Sounds LLC</PLineText> </PLine> <TechnicalDetails> <!-- Technical ref suffixed with "I" for immersive --> <TechnicalResourceDetailsReference>T1I</TechnicalResourceDetailsReference> <DeliveryFile> <Type>AudioFile</Type> <AudioCodecType UserDefinedValue="DolbyAtmos">UserDefined</AudioCodecType> <NumberOfChannels>8</NumberOfChannels> <SamplingRate>48000</SamplingRate> <BitsPerSample>24</BitsPerSample> <File> <!-- Dolby file uses "-dolby" suffix --> <URI>resources/198765432109_01_01-dolby.wav</URI> <HashSum> <Algorithm>MD5</Algorithm> <HashSumValue>f1e2d3c4b5a6f1e2d3c4b5a6f1e2d3c4</HashSumValue> </HashSum> </File> </DeliveryFile> </TechnicalDetails> </SoundRecordingEdition>
<DisplayTitleText LanguageAndScriptCode="en">Midnight Run</DisplayTitleText> <!-- ... titles, artists, contributors, duration, parental warning ... --></SoundRecording>Wichtige Punkte:
- Die Stereo-Edition erhaelt
<Type>NonImmersiveEdition</Type>nur wenn auch eine Dolby-Edition existiert - Die Dolby-Edition verwendet
<Type>ImmersiveEdition</Type> - Jede Edition muss einen anderen ISRC haben
- Die immersive
TechnicalResourceDetailsReferencewird mitIsuffigiert (z.B.T1I) - Die Dolby-Audio-Datei-URI verwendet das Suffix
-dolby - Dolby Atmos erfordert mindestens 6 Kanaele (5.1 Surround), typischerweise 8 Kanaele
Copyright-Inhaber mit Gebiets-Splits
Mehrere Copyright-Inhaber mit regionalen prozentualen Splits. Das Standardelement ist WorkRightsController. Wenn keine Copyright-Inhaber festgelegt sind, wird das Plattenlabel als Standard-Rechteinhaber mit 100% verwendet.
<!-- Copyright owner: 60% worldwide --><WorkRightsController> <RightsControllerPartyReference>P_OWNER_PUBLISHERA</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>60.00</RightSharePercentage> <Territory>Worldwide</Territory></WorkRightsController>
<!-- Copyright owner: 40% worldwide --><WorkRightsController> <RightsControllerPartyReference>P_OWNER_PUBLISHERB</RightsControllerPartyReference> <RightsControlType>RightsController</RightsControlType> <RightSharePercentage>40.00</RightSharePercentage> <Territory>Worldwide</Territory></WorkRightsController>Wichtige Punkte:
- Prozentsaetze muessen pro Gebiet genau 100% ergeben
- Verwenden Sie
Worldwidefuer globale Abdeckung oder spezifische ISO 3166-1 Alpha-2-Gebietscodes RightSharePercentageverwendet zwei Dezimalstellen (z.B.60.00)- Ein bestimmter Outlet verwendet
ResourceRightsControlleranstelle vonWorkRightsController
Gebietsspezifischer Deal
Wenn eine Release nur in bestimmten Laendern statt weltweit verfuegbar ist:
<Deal> <DealTerms> <!-- Available only in US, GB, DE, FR, and AU --> <TerritoryCode>US</TerritoryCode> <TerritoryCode>GB</TerritoryCode> <TerritoryCode>DE</TerritoryCode> <TerritoryCode>FR</TerritoryCode> <TerritoryCode>AU</TerritoryCode> <ValidityPeriod> <StartDate>2025-08-15</StartDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms></Deal>Wichtige Punkte:
- Listen Sie mehrere
<TerritoryCode>-Elemente innerhalb desselbenDealTermsauf - Verwenden Sie ISO 3166-1 Alpha-2-Codes (z.B.
US,GB,DE) - Lassen Sie
Worldwideweg, wenn Sie einzelne Gebiete angeben
Takedown (Entfernung einer Release)
Wenn Sie einen Takedown veranlassen, werden sowohl das Start- als auch das Enddatum im Gueltigkeitszeitraum 48 Stunden in die Vergangenheit gesetzt:
<Deal> <DealTerms> <TerritoryCode>Worldwide</TerritoryCode> <ValidityPeriod> <StartDate>2025-06-13</StartDate> <EndDate>2025-06-13</EndDate> </ValidityPeriod> <CommercialModelType>SubscriptionModel</CommercialModelType> <UseType>UserMakeAvailableLabelProvided</UseType> </DealTerms></Deal>Wichtige Punkte:
- Sowohl
StartDateals auchEndDatesind auf dasselbe Datum gesetzt, 48 Stunden in der Vergangenheit - Dies signalisiert dem DSP, dass die Release entfernt werden soll
- Ein Takedown-Deal wird fuer jeden kommerziellen Modelltyp generiert
Feld-zu-XML-Referenz
Abschnitt betitelt „Feld-zu-XML-Referenz“Schnelle Nachschlagetabelle, die LabelGrid-Metadatenfelder ihrer DDEX XML-Darstellung zuordnet.
| LabelGrid-Feld | DDEX XML-Element | Hinweise |
|---|---|---|
| UPC/EAN | <ICPN> | Innerhalb von <ReleaseId> |
| ISRC | <ISRC> | Innerhalb von <ResourceId> in <SoundRecordingEdition> |
| ISWC | <ISWC> | Innerhalb von <WorkId> im uebergeordneten <SoundRecording> (nicht in der Edition) |
| Titel | <DisplayTitleText> + <DisplayTitle> | Einer pro Sprache; DisplayTitleText verwendet nur den Basistitel |
| Mix-Version | <SubTitle> | Innerhalb von <DisplayTitle> |
| Hauptkuenstler | <DisplayArtistRole>MainArtist</DisplayArtistRole> | |
| Featured-Kuenstler | <DisplayArtistRole>FeaturedArtist</DisplayArtistRole> | |
| Remixer | FeaturedArtist + <ArtisticRole>Remixer</ArtisticRole> | Beide Elemente erforderlich |
| Genre | <GenreText> + <SubGenre> | Zugeordnet zu DSP-spezifischen Genre-Codes |
| P-Line | <PLine> > <Year> + <PLineText> | |
| C-Line | <CLine> > <Year> + <CLineText> | |
| Explizit | <ParentalWarningType> | Werte: NotExplicit, Explicit, ExplicitContentEdited |
| Veroeffentlichungsdatum | <OriginalReleaseDate> + Deal <StartDate> | Format: YYYY-MM-DD |
| Gebiet | <TerritoryCode> | Worldwide oder ISO 3166-1 Alpha-2 |
| Mitwirkender (Producer) | <Role>StudioProducer</Role> | Der Anzeigename “Producer” entspricht dem DDEX StudioProducer |
| Mitwirkender (andere) | <Contributor> > <Role> | DDEX-Rollencodes (z.B. ComposerLyricist, MixingEngineer) |
| Verlag | <Role>MusicPublisher</Role> | Innerhalb von <Contributor> |
| Audiodatei | <File> > <URI> | Muster: resources/{UPC}_{disc}_{track}.{ext} |
| IPI | <IpiNameNumber> | Mit Nullen aufgefuellt auf 11 Ziffern |
| ISNI | <ISNI> | 16 Zeichen |
| Cover-Art | <Image> mit <Type>FrontCoverImage</Type> | |
| Release-Typ | <ReleaseType> | Erscheint vor <ReleaseId> in ERN 4.3 |
| Katalognummer | <CatalogNumber> | Innerhalb von <ReleaseId> |
| Track-Ressourcen | <ResourceGroup> > <ResourceGroupContentItem> | Nicht ReleaseResourceReferenceList |
| Dauer | <Duration> | ISO 8601-Format: PT00H04M32S |
| Sprache | <LanguageOfPerformance> | ISO-Sprachcode |
| Schluesselwoerter | <Keywords> | Innerhalb von <TrackRelease> |
| Dolby Stereo | <Type>NonImmersiveEdition</Type> | Nur vorhanden, wenn auch eine Dolby-Edition existiert |
| Dolby Atmos | <Type>ImmersiveEdition</Type> | Separater ISRC erforderlich; Datei-URI verwendet Suffix -dolby |
| Copyright-Inhaber | <WorkRightsController> | Mit <RightSharePercentage> und <Territory> |
Nur ERN 4.3.1 / 4.3.2
Abschnitt betitelt „Nur ERN 4.3.1 / 4.3.2“Diese Elemente existieren nur in 4.3.1 und 4.3.2 (nicht in 4.3.0). Siehe KI-Kennzeichnungsfelder.
| LabelGrid-Feld | DDEX XML-Element | Hinweise |
|---|---|---|
| Genre (4.3.1+) | <DisplayGenre> | Ersetzt <Genre>; dieselben Kindelemente GenreText + SubGenre |
| Mitwirkenden-Rolle (4.3.1+) | <Role><Value>…</Value></Role> | Komplexe Form; <Value UserDefinedValue="…">UserDefined</Value> fuer nicht-standardmaessige Rollen |
| KI auf Track/Release/Artwork | <ContainsAI> | Werte None / Partly / All; auf SoundRecording, Release und Image |
| KI pro Mitwirkendem | <AiContribution> | Werte None / Partly / All; Kindelement von <Contributor>, nach <Role> |
| Vollstaendig KI-generierter Credit | <SpecialContributor>GenerativeAI</SpecialContributor> | Ersetzt <ContributorPartyReference> (kein Parteiname) |
XML-Struktur-Checkliste
Abschnitt betitelt „XML-Struktur-Checkliste“Verwenden Sie diese Checkliste, um Ihr XML vor dem Einreichen zu ueberpruefen:
- Das Wurzel-
<NewReleaseMessage>beinhaltet den ERN 4.3 Namespace und die Schema-Position -
<MessageHeader>hat gueltigeMessageThreadId,MessageId, Absender und Empfaenger - Alle Parteien (Label, Kuenstler, Mitwirkende, Verlage) sind in
<PartyList>definiert - Jede Partei hat eine eindeutige
<PartyReference> - Der
<SoundRecording>-Typ istMusicalWorkSoundRecording - ISRC befindet sich innerhalb von
<SoundRecordingEdition>><ResourceId> - ISWC (falls vorhanden) befindet sich im uebergeordneten
<SoundRecording>ueber<WorkId>, nicht in der Edition -
<DisplayTitleText>enthaelt nur den Basistitel (keine Mix-Version) - Die Mix-Version (falls vorhanden) befindet sich in
<SubTitle>innerhalb von<DisplayTitle> - Der Remixer hat sowohl
DisplayArtistRole=FeaturedArtistals auchArtisticRole=Remixer - Die Audio-Datei
<URI>folgt dem Musterresources/{UPC}_{disc}_{track}.{ext} - Das Cover-Art
<Image>hat<Type>FrontCoverImage</Type> -
<ReleaseType>kommt vor<ReleaseId>in der Haupt-<Release> - UPC/EAN befindet sich in
<ICPN>innerhalb von<ReleaseId> - Ressourcen sind ueber
<ResourceGroup>verknuepft (nichtReleaseResourceReferenceList) - Dolby Atmos-Editionen haben separate ISRCs von Stereo-Editionen
-
<WorkRightsController>-Prozentsaetze ergeben pro Gebiet 100% - Der Deal
<TerritoryCode>verwendetWorldwideoder gueltige ISO 3166-1 Alpha-2-Codes - Alle Daten verwenden das Format
YYYY-MM-DD - Takedown-Deals haben sowohl
<StartDate>als auch<EndDate>48 Stunden in der Vergangenheit gesetzt
Nur ERN 4.3.1 / 4.3.2:
- Genre verwendet
<DisplayGenre>(nicht<Genre>) - Jeder
<Contributor>verwendet die komplexe<Role><Value>…</Value></Role>-Form -
<ContainsAI>ist auf jedem<SoundRecording>, der<Release>und dem Cover-<Image>vorhanden, mit WertNone,PartlyoderAll -
<ContainsAI>auf dem Track steht nach<ParentalWarningType>; auf dem Bild steht es vor<TechnicalDetails> - Jeder
<Contributor>traegt ein<AiContribution>(None/Partly/All) unmittelbar nach<Role> - Vollstaendig KI-generierte Credits verwenden
<SpecialContributor>GenerativeAI</SpecialContributor>anstelle von<ContributorPartyReference>
Brauchen Sie Hilfe?
Abschnitt betitelt „Brauchen Sie Hilfe?“Wenn Sie Unterstuetzung bei der DDEX-Integration benoetigen, kontaktieren Sie unser Support-Team mit Ihren technischen Anforderungen.
Sie nutzen LabelGrid noch nicht?
Alles, was Sie gerade gelesen haben, steht Ihnen auf unserer Plattform zur Verfügung.
Entdecken Sie, was LabelGrid kann →