Riferimento XML

Questa pagina tratta la struttura XML e gli esempi di codice per l’importazione DDEX di LabelGrid. Per i requisiti dei metadati, i ruoli dei contributori, gli split e gli standard di formattazione, consulta Metadati release, Metadati traccia e Validazione.

ERN 4.3.2 e la versione di importazione consigliata per le nuove integrazioni: consulta ERN 4.3.2 piu sotto per il suo elemento radice, i campi di dichiarazione IA che aggiunge e un esempio 4.3.2 completo con ogni campo. La maggior parte degli esempi dettagliati di questa pagina utilizza il formato ERN 4.3; la struttura del messaggio e la stessa in 4.3.1/4.3.2, quindi si applicano a tutte e tre (cambia il namespace radice e applica le modifiche di campo di 4.3.2 — DisplayGenre, la forma complessa di Role e gli elementi IA). I valori PartyReference nell’output effettivo sono identificativi con hash MD5 (es. P8A1B2C3D4E5F6...). Gli esempi seguenti utilizzano nomi leggibili per chiarezza.

Struttura del messaggio ERN 4.3

Ogni consegna DDEX e un documento XML NewReleaseMessage con cinque sezioni principali:

NewReleaseMessage
├── MessageHeader       — Mittente, destinatario e ID messaggio
├── PartyList           — Tutti gli artisti, contributori e titolari dei diritti
├── ResourceList        — File audio e artwork con dettagli tecnici
├── ReleaseList         — La release album/singolo e le tracce individuali
└── DealList            — Termini commerciali, territori e date

L’elemento radice include il namespace ERN 4.3 e la posizione dello schema:

<?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">

Attributo	Descrizione
`xmlns:ern`	URI del namespace ERN 4.3
`xsi:schemaLocation`	Schema per la validazione
`AvsVersionId`	Versione del set di valori consentiti
`LanguageAndScriptCode`	Lingua predefinita del messaggio

ERN 4.3.2

ERN 4.3.2 e la versione di importazione consigliata per le nuove integrazioni LabelGrid. E una revisione successiva della famiglia ERN 4.3 ed e pienamente supportata dall’importatore di LabelGrid. Utilizza uno spazio dei nomi e uno schema diversi da 4.3, quindi i due non sono intercambiabili a livello XML: l’elemento radice da solo determina la versione. Se il tuo sistema puo generare entrambe, genera 4.3.2.

Elemento radice

<?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">

Attributo	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`

Lo schema pubblico release-notification di 4.3.2 si trova all’indirizzo http://service.ddex.net/xml/ern/432/release-notification.xsd (l’equivalente di 4.3 e http://service.ddex.net/xml/ern/43/release-notification.xsd). Puoi validare entrambi i file rispetto al loro schema con il validatore online DDEX.

Cosa cambia tra 4.3, 4.3.1 e 4.3.2 {#what-changes-between-43-431-and-432}

Il corpo del messaggio ha la stessa forma degli esempi 4.3 riportati di seguito: le sezioni MessageHeader, PartyList, ResourceList, ReleaseList e DealList mantengono la stessa struttura. Le differenze sono un piccolo numero di modifiche a livello di elemento che sono state introdotte in ERN 4.3.1 e mantenute invariate in 4.3.2. Se stai passando da 4.3 (4.3.0), queste sono le tre cose da cambiare:

Area	ERN 4.3 (4.3.0)	ERN 4.3.1 e 4.3.2
Elemento genere	`<Genre>`	`<DisplayGenre>` — stessi figli `GenreText` + `SubGenre`, semplicemente rinominato
Ruolo del contributore	Semplice: `<Role>StudioProducer</Role>`	Complesso: `<Role><Value>StudioProducer</Value></Role>`
Attribuzione IA	(non disponibile)	Nuovi elementi `<ContainsAI>`, `<AiContribution>` e `<SpecialContributor>`

Tutto il resto — MessageHeader, parti, deal, posizionamento di ISRC/ISWC, dettagli tecnici di audio/artwork, titoli, P-Line/C-Line, deal, date — e identico agli esempi 4.3 nel resto di questa pagina. Le uniche parti specifiche della versione sono le tre indicate sopra; i campi di dichiarazione IA hanno una propria sezione di seguito perche sono il motivo principale per usare 4.3.2.

Campi di dichiarazione IA (4.3.2) {#ai-declaration-fields-432}

Questa e la parte di 4.3.2 che non esiste in 4.3 puro. Ci sono tre elementi, e descrivono tutti la stessa dichiarazione di base: quanta parte del contenuto e stata generata dall’IA. Ogni valore e uno tra None, Partly o All: non ci sono flag booleani ne campi a testo libero.

Dove va ciascun elemento

Elemento	Compare su	Posizione	Valori
`<ContainsAI>`	ogni `<SoundRecording>` (traccia)	Dopo `<ParentalWarningType>`, prima di `<LanguageOfPerformance>`	`None` / `Partly` / `All`
`<ContainsAI>`	la `<Release>` principale	Dopo il blocco `<ResourceGroup>`	`None` / `Partly` / `All` — il valore piu alto tra tutte le tracce e l’artwork
`<ContainsAI>`	l’`<Image>` di copertina	Dopo `<ResourceId>`, prima di `<TechnicalDetails>`	`None` / `Partly` / `All`
`<AiContribution>`	ogni `<Contributor>`	Dopo `<Role>`	`None` / `Partly` / `All`
`<SpecialContributor>`	un `<Contributor>` interamente generato da IA	Sostituisce `<ContributorPartyReference>` (mutuamente esclusivo)	Valore fisso `GenerativeAI`

Come vengono determinati i valori

Il modulo della traccia ha due menu a discesa di dichiarazione IA (consulta Aggiungere tracce) — Generative AI Disclosure (la registrazione audio) e Composition AI Disclosure (la canzone). L’artwork della release ha la propria impostazione IA. Ciascuna corrisponde a un valore DDEX come segue:

Selezione di dichiarazione	Valore DDEX
Nessuna IA generativa utilizzata	`None`
Solo assistenza IA minore	`Partly`
Porzioni di materiale generate da IA	`Partly`
Interamente generato con IA	`All`

Il <ContainsAI> di una traccia e il valore piu alto tra le sue dichiarazioni Generative AI e Composition AI.
Il <ContainsAI> della release e il valore piu alto tra tutte le tracce piu l’artwork.
L’<AiContribution> di un <Contributor> riflette quello specifico credito. I contributori nominati (umani) sono limitati a Partly: un valore di All viene espresso solo tramite <SpecialContributor>GenerativeAI</SpecialContributor>, che non comporta alcun nome di parte.

Esempi nel contesto

DisplayGenre sostituisce l’elemento Genre di 4.3 (i figli sono invariati):

<!-- 4.3.2 uses DisplayGenre; 4.3.0 used Genre -->
<DisplayGenre>
  <GenreText>Electronic</GenreText>
  <SubGenre>Deep House</SubGenre>
</DisplayGenre>

ContainsAI su una traccia, nella sua posizione corretta:

<SoundRecording>
  <ResourceReference>A1</ResourceReference>
  <!-- ... editions, titles, artists, contributors, duration ... -->
  <ParentalWarningType>NotExplicit</ParentalWarningType>
  <ContainsAI>Partly</ContainsAI>
  <LanguageOfPerformance>en</LanguageOfPerformance>
</SoundRecording>

ContainsAI sull’immagine di copertina (prima di TechnicalDetails):

<Image>
  <ResourceReference>A2</ResourceReference>
  <Type>FrontCoverImage</Type>
  <ResourceId>
    <ProprietaryId Namespace="PADPIDA2025010100A">labelgrid:release:67890:cover</ProprietaryId>
  </ResourceId>
  <ContainsAI>None</ContainsAI>
  <TechnicalDetails>
    <!-- ... -->
  </TechnicalDetails>
</Image>

Un contributore che usa la forma complessa di Role con un AiContribution, accanto a un contributore interamente IA che usa SpecialContributor invece di un riferimento di parte:

<!-- 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>

Per confermare che un messaggio 4.3.2 sia valido prima della consegna, verificalo rispetto allo schema pubblico release-notification di 4.3.2 (http://service.ddex.net/xml/ern/432/release-notification.xsd) con il validatore online DDEX.

MessageHeader

Identifica il mittente (la tua organizzazione), il destinatario (il DSP) e un ID messaggio unico.

<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>

Elemento	Descrizione
`MessageThreadId`	Raggruppa i messaggi correlati (es. aggiornamenti alla stessa release)
`MessageId`	Identificativo unico per questo specifico messaggio
`MessageSender`	Il Party ID DDEX e il nome della tua organizzazione
`MessageRecipient`	Il Party ID e il nome del DSP destinatario
`MessageCreatedDateTime`	Timestamp ISO 8601 di quando il messaggio e stato creato

PartyList

Tutte le entita referenziate altrove nell’XML — l’etichetta discografica, gli artisti, i contributori e gli editori — sono definite qui. Ogni parte riceve un PartyReference utilizzato per collegarla in tutto il documento.

Etichetta discografica

<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>

Artisti

Gli artisti possono includere identificativi standard come ISNI:

<!-- 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>

Contributori

I contributori (autori, produttori, tecnici) possono includere identificativi IPI:

<!-- 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>

Editori

<Party>
  <PartyReference>P_PUBLISHER_NEONSOUNDS</PartyReference>
  <PartyName LanguageAndScriptCode="en">
    <FullName>Neon Sounds Publishing</FullName>
  </PartyName>
</Party>

Identificativi parte supportati:

Identificativo	Elemento	Formato
ISNI	`<ISNI>`	16 caratteri (15 cifre + cifra di controllo)
IPI	`<IpiNameNumber>`	Riempito con zeri fino a 11 cifre
Proprietario	`<ProprietaryId>`	Riferimento interno LabelGrid

ResourceList

Contiene tutti i file audio e l’artwork. Ogni risorsa riceve un ResourceReference (es. A1, A2) utilizzato per collegarla alle release.

Registrazione audio

<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>

Punti chiave:

ISRC e PLine vanno dentro SoundRecordingEdition
ISWC va nel SoundRecording padre tramite WorkId (non dentro l’Edition)
DisplayTitleText contiene solo il titolo base (senza versione mix)
L’elemento SubTitle dentro DisplayTitle contiene la versione mix (vuoto se assente)
Il ruolo di visualizzazione “Producer” corrisponde al ruolo DDEX StudioProducer
L’URI del file audio segue il pattern: resources/{UPC}_{disc}_{track}.{ext}

Copertina

<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

Contiene la release principale (l’album o il singolo) e le release delle singole tracce. La release principale si collega alle risorse tramite ResourceGroup.

Release principale

<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>

Punti chiave:

ReleaseType viene prima di ReleaseId in ERN 4.3
L’UPC/EAN va in <ICPN> dentro ReleaseId
Le risorse sono collegate tramite ResourceGroup (non ReleaseResourceReferenceList)
ReleaseLabelReference punta al PartyReference dell’etichetta

Release traccia

Ogni traccia ha anche la propria TrackRelease per la disponibilita individuale sulle piattaforme:

<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

Definisce i termini commerciali sotto i quali la release e disponibile. Ogni Deal specifica un territorio, una data di inizio, un modello commerciale e un tipo di utilizzo.

<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>

Tipi di modello commerciale:

Modello	Descrizione	Esempio
`SubscriptionModel`	Streaming in abbonamento a pagamento	Spotify Premium, Apple Music
`AdvertisementSupportedModel`	Streaming gratuito supportato da pubblicita	Spotify Free, YouTube
`PayAsYouGoModel`	Acquisto con pagamento per download	iTunes, Amazon Music

Esempi {#examples}

Release singolo completa

Una release completa a singola traccia con un artista principale, un artista in featuring e crediti contributori completi.

Metadati di input:

Campo	Valore
Titolo	Midnight Run
Artista	Luna Wave (principale), DJ Koda (featuring)
UPC	198765432109
Data di uscita	2025-08-15
Etichetta	Neon Sounds
Numero di catalogo	NS-2025-042
Genere	Electronic / Deep House
C-Line	2025 Neon Sounds LLC
P-Line	2025 Neon Sounds LLC
ISRC traccia	USNS12500001
Esplicito	Non esplicito

XML generato:

<?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>

Release ERN 4.3.2 completa (tutti i campi, con dichiarazioni IA)

La stessa release di cui sopra, espressa in ERN 4.3.2 con ogni campo utilizzato da LabelGrid. Nota le differenze rispetto alla versione 4.3: il namespace /432 e AvsVersionId="4", <DisplayGenre> invece di <Genre>, la forma complessa <Role><Value>…</Value></Role>, <ContainsAI> sulla traccia / release / immagine, un <AiContribution> su ogni contributore e un vocalist interamente IA espresso con <SpecialContributor>GenerativeAI</SpecialContributor> (senza voce in PartyList).

Metadati di input (gli stessi dell’esempio 4.3, piu le dichiarazioni IA):

Campo	Valore
Generative AI Disclosure	Solo assistenza IA minore → `Partly`
Composition AI Disclosure	Nessuna IA generativa → `None`
Artwork AI	Nessuna IA generativa → `None`
Vocalist IA	Credito interamente generato da IA → `SpecialContributor` / `All`

XML generato:

<?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>

Titoli multi-lingua (giapponese)

Quando una release ha metadati sia in inglese che in giapponese. Tutti gli elementi DisplayTitleText vengono prima, poi tutti gli elementi DisplayTitle. Le letture fonetiche giapponesi usano ja-Kana (mappato dall’interno 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>

Punti chiave:

Raggruppa tutti gli elementi DisplayTitleText insieme, poi tutti gli elementi DisplayTitle
Usa ja-Kana per le letture fonetiche giapponesi (katakana) — questo e mappato dal codice interno ja-Jpan
Fornisci i titoli in ogni lingua supportata

Traccia remix con versione mix

Quando una traccia e un remix, la versione mix va in SubTitle e il remixer riceve sia un ruolo di visualizzazione FeaturedArtist che un ArtisticRole di 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>

Punti chiave:

DisplayTitleText contiene solo il titolo base — mai la forma concatenata come “Horizon (Koda Extended Mix)”
La versione mix va in SubTitle dentro DisplayTitle
Il remixer necessita sia di DisplayArtistRole=FeaturedArtist che di ArtisticRole=Remixer
Se si usano titoli multi-lingua, localizza la versione mix in ogni lingua

Dolby Atmos (stereo + immersivo)

Quando una traccia ha sia la versione stereo che Dolby Atmos, il SoundRecording contiene due elementi SoundRecordingEdition — uno NonImmersiveEdition e uno ImmersiveEdition. Ognuno deve avere il proprio ISRC unico.

<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>

Punti chiave:

L’edizione stereo riceve <Type>NonImmersiveEdition</Type> solo quando esiste anche un’edizione Dolby
L’edizione Dolby usa <Type>ImmersiveEdition</Type>
Ogni edizione deve avere un ISRC diverso
Il TechnicalResourceDetailsReference immersivo e suffissato con I (es. T1I)
L’URI del file audio Dolby usa il suffisso -dolby
Dolby Atmos richiede un minimo di 6 canali (surround 5.1), tipicamente 8 canali

Titolari del copyright con split territoriali

Piu titolari del copyright con percentuali di split regionali. L’elemento predefinito e WorkRightsController. Quando non sono impostati titolari del copyright, l’etichetta discografica viene utilizzata come controllore dei diritti predefinito al 100%.

<!-- 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>

Punti chiave:

Le percentuali devono totalizzare esattamente il 100% per territorio
Usa Worldwide per la copertura globale, o codici territorio specifici ISO 3166-1 alpha-2
RightSharePercentage utilizza due cifre decimali (es. 60.00)
Un outlet specifico utilizza ResourceRightsController invece di WorkRightsController

Deal specifico per territorio

Quando una release e disponibile solo in paesi specifici anziche in tutto il mondo:

<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>

Punti chiave:

Elenca piu elementi <TerritoryCode> all’interno dello stesso DealTerms
Usa codici ISO 3166-1 alpha-2 (es. US, GB, DE)
Ometti Worldwide quando specifichi territori individuali

Takedown (rimozione di una release)

Quando emetti un takedown, sia la data di inizio che la data di fine nel periodo di validita sono impostate 48 ore nel passato:

<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>

Punti chiave:

Sia StartDate che EndDate sono impostate alla stessa data, 48 ore nel passato
Questo segnala al DSP che la release deve essere rimossa
Un deal di takedown viene generato per ogni tipo di modello commerciale

Riferimento campo-XML

Tabella di consultazione rapida che mappa i campi dei metadati LabelGrid alla loro rappresentazione XML DDEX.

Campo LabelGrid	Elemento XML DDEX	Note
UPC/EAN	`<ICPN>`	Dentro `<ReleaseId>`
ISRC	`<ISRC>`	Dentro `<ResourceId>` all’interno di `<SoundRecordingEdition>`
ISWC	`<ISWC>`	Dentro `<WorkId>` nel `<SoundRecording>` padre (non dentro l’Edition)
Titolo	`<DisplayTitleText>` + `<DisplayTitle>`	Uno per lingua; `DisplayTitleText` usa solo il titolo base
Versione mix	`<SubTitle>`	Dentro `<DisplayTitle>`
Artista principale	`<DisplayArtistRole>MainArtist</DisplayArtistRole>`
Artista in featuring	`<DisplayArtistRole>FeaturedArtist</DisplayArtistRole>`
Remixer	`FeaturedArtist` + `<ArtisticRole>Remixer</ArtisticRole>`	Entrambi gli elementi necessari
Genere	`<GenreText>` + `<SubGenre>`	Mappato a codici genere specifici del DSP
P-Line	`<PLine>` > `<Year>` + `<PLineText>`
C-Line	`<CLine>` > `<Year>` + `<CLineText>`
Esplicito	`<ParentalWarningType>`	Valori: `NotExplicit`, `Explicit`, `ExplicitContentEdited`
Data di uscita	`<OriginalReleaseDate>` + deal `<StartDate>`	Formato: `YYYY-MM-DD`
Territorio	`<TerritoryCode>`	`Worldwide` o ISO 3166-1 alpha-2
Contributore (Producer)	`<Role>StudioProducer</Role>`	Il nome visualizzato “Producer” corrisponde al DDEX `StudioProducer`
Contributore (altro)	`<Contributor>` > `<Role>`	Codici ruolo DDEX (es. `ComposerLyricist`, `MixingEngineer`)
Editore	`<Role>MusicPublisher</Role>`	Dentro `<Contributor>`
File audio	`<File>` > `<URI>`	Pattern: `resources/{UPC}_{disc}_{track}.{ext}`
IPI	`<IpiNameNumber>`	Riempito con zeri fino a 11 cifre
ISNI	`<ISNI>`	16 caratteri
Copertina	`<Image>` con `<Type>FrontCoverImage</Type>`
Tipo di release	`<ReleaseType>`	Appare prima di `<ReleaseId>` in ERN 4.3
Numero di catalogo	`<CatalogNumber>`	Dentro `<ReleaseId>`
Risorse traccia	`<ResourceGroup>` > `<ResourceGroupContentItem>`	Non `ReleaseResourceReferenceList`
Durata	`<Duration>`	Formato ISO 8601: `PT00H04M32S`
Lingua	`<LanguageOfPerformance>`	Codice lingua ISO
Parole chiave	`<Keywords>`	Dentro `<TrackRelease>`
Dolby stereo	`<Type>NonImmersiveEdition</Type>`	Presente solo quando esiste anche l’edizione Dolby
Dolby Atmos	`<Type>ImmersiveEdition</Type>`	ISRC separato richiesto; l’URI del file usa il suffisso `-dolby`
Titolare copyright	`<WorkRightsController>`	Con `<RightSharePercentage>` e `<Territory>`

Solo ERN 4.3.1 / 4.3.2

Questi elementi esistono solo in 4.3.1 e 4.3.2 (non in 4.3.0). Consulta Campi di dichiarazione IA.

Campo LabelGrid	Elemento XML DDEX	Note
Genere (4.3.1+)	`<DisplayGenre>`	Sostituisce `<Genre>`; stessi figli `GenreText` + `SubGenre`
Ruolo del contributore (4.3.1+)	`<Role><Value>…</Value></Role>`	Forma complessa; `<Value UserDefinedValue="…">UserDefined</Value>` per ruoli non standard
IA su traccia/release/artwork	`<ContainsAI>`	Valori `None` / `Partly` / `All`; su `SoundRecording`, `Release` e `Image`
IA per contributore	`<AiContribution>`	Valori `None` / `Partly` / `All`; figlio di `<Contributor>`, dopo `<Role>`
Credito interamente generato da IA	`<SpecialContributor>GenerativeAI</SpecialContributor>`	Sostituisce `<ContributorPartyReference>` (senza nome di parte)

Checklist struttura XML

Usa questa checklist per verificare il tuo XML prima dell’invio:

Solo ERN 4.3.1 / 4.3.2:

Il genere usa <DisplayGenre> (non <Genre>)
Ogni <Contributor> usa la forma complessa <Role><Value>…</Value></Role>
<ContainsAI> e presente su ogni <SoundRecording>, sulla <Release> e sull’<Image> di copertina, con valore None, Partly o All
Il <ContainsAI> sulla traccia si trova dopo <ParentalWarningType>; sull’immagine si trova prima di <TechnicalDetails>
Ogni <Contributor> riporta un <AiContribution> (None / Partly / All) immediatamente dopo <Role>
I crediti interamente generati da IA usano <SpecialContributor>GenerativeAI</SpecialContributor> al posto di <ContributorPartyReference>

Hai bisogno di aiuto?

Se hai bisogno di assistenza con l’integrazione DDEX, contatta il nostro team di supporto con i tuoi requisiti tecnici.

Non usi ancora LabelGrid?

Tutto ciò che hai appena letto è disponibile sulla nostra piattaforma.

Scopri cosa può fare LabelGrid →