Referência XML

Esta página cobre a estrutura XML e os exemplos de código para a importação DDEX do LabelGrid. Para os requisitos de metadados, funções de colaborador, splits e padrões de formatação, consulte Metadados do lançamento, Metadados da faixa e Validação.

A ERN 4.3.2 é a versão de importação recomendada para novas integrações. Consulte ERN 4.3.2 abaixo para ver o elemento raiz, os campos de declaração de IA que ela adiciona e um exemplo completo de 4.3.2 com todos os campos. A maioria dos exemplos detalhados desta página usa o formato ERN 4.3; a estrutura da mensagem é a mesma na 4.3.1/4.3.2, então eles valem para as três (troque o namespace raiz e aplique as mudanças de campo da 4.3.2: DisplayGenre, a forma complexa de Role e os elementos de IA). Os valores de PartyReference na saída real são identificadores em hash MD5 (ex.: P8A1B2C3D4E5F6...). Os exemplos abaixo usam nomes legíveis para maior clareza.

Estrutura da mensagem ERN 4.3

Toda entrega DDEX é um documento XML NewReleaseMessage com cinco seções principais:

NewReleaseMessage
├── MessageHeader       — Sender, recipient, and message ID
├── PartyList           — All artists, contributors, and rights holders
├── ResourceList        — Audio files and artwork with technical details
├── ReleaseList         — The album/single release and individual tracks
└── DealList            — Commercial terms, territories, and dates

O elemento raiz inclui o namespace e a localização do schema da ERN 4.3:

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

Atributo	Descrição
`xmlns:ern`	URI do namespace da ERN 4.3
`xsi:schemaLocation`	Schema para validação
`AvsVersionId`	Versão do conjunto de valores permitidos
`LanguageAndScriptCode`	Idioma padrão da mensagem

ERN 4.3.2

A ERN 4.3.2 é a versão de importação recomendada para novas integrações do LabelGrid. É uma revisão posterior da família ERN 4.3 e tem suporte completo no importador do LabelGrid. Ela usa um namespace e schema diferentes dos da 4.3, então as duas não são intercambiáveis no nível do XML: somente o elemento raiz determina a versão. Se o seu sistema consegue emitir qualquer uma das duas, gere a 4.3.2.

Elemento raiz

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

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

O schema público de release-notification da 4.3.2 fica em http://service.ddex.net/xml/ern/432/release-notification.xsd (o equivalente da 4.3 é http://service.ddex.net/xml/ern/43/release-notification.xsd). Você pode validar qualquer um dos arquivos contra o seu schema com o validador online da DDEX.

O que muda entre 4.3, 4.3.1 e 4.3.2 {#o-que-muda-entre-43-431-e-432}

O corpo da mensagem tem o mesmo formato dos exemplos de 4.3 abaixo: as seções MessageHeader, PartyList, ResourceList, ReleaseList e DealList mantêm a mesma estrutura. As diferenças são algumas mudanças no nível de elemento que foram introduzidas na ERN 4.3.1 e mantidas sem alteração na 4.3.2. Se você está migrando da 4.3 (4.3.0), estas são as três coisas a mudar:

Área	ERN 4.3 (4.3.0)	ERN 4.3.1 e 4.3.2
Elemento de gênero	`<Genre>`	`<DisplayGenre>` (mesmos filhos `GenreText` + `SubGenre`, apenas renomeado)
Função de colaborador	Simples: `<Role>StudioProducer</Role>`	Complexa: `<Role><Value>StudioProducer</Value></Role>`
Atribuição de IA	(indisponível)	Novos elementos `<ContainsAI>`, `<AiContribution>` e `<SpecialContributor>`

Todo o resto (MessageHeader, parties, deals, posição de ISRC/ISWC, detalhes técnicos de áudio/capa, títulos, P-Line/C-Line, deals, datas) é idêntico aos exemplos de 4.3 no restante desta página. As únicas peças específicas da versão são as três acima; os campos de declaração de IA ganham uma seção própria a seguir porque são o principal motivo para usar a 4.3.2.

Campos de declaração de IA (4.3.2) {#campos-de-declaracao-de-ia-432}

Esta é a parte da 4.3.2 que não existe na 4.3 simples. São três elementos, e todos descrevem a mesma declaração subjacente: quanto do conteúdo foi gerado por IA. Todo valor é um de None, Partly ou All; não há sinalizadores booleanos nem campos de texto livre.

Onde cada elemento entra

Elemento	Aparece em	Posição	Valores
`<ContainsAI>`	cada `<SoundRecording>` (faixa)	Depois de `<ParentalWarningType>`, antes de `<LanguageOfPerformance>`	`None` / `Partly` / `All`
`<ContainsAI>`	o `<Release>` principal	Depois do bloco `<ResourceGroup>`	`None` / `Partly` / `All` (o valor mais alto entre todas as faixas e a capa)
`<ContainsAI>`	a `<Image>` de capa	Depois de `<ResourceId>`, antes de `<TechnicalDetails>`	`None` / `Partly` / `All`
`<AiContribution>`	cada `<Contributor>`	Depois de `<Role>`	`None` / `Partly` / `All`
`<SpecialContributor>`	um `<Contributor>` que é totalmente IA	Substitui `<ContributorPartyReference>` (mutuamente exclusivos)	Valor fixo `GenerativeAI`

Como os valores são determinados

O formulário da faixa tem dois menus suspensos de declaração de IA (consulte Adicionar faixas): Generative AI Disclosure (a gravação sonora) e Composition AI Disclosure (a música). A capa do lançamento tem a sua própria configuração de IA. Cada uma mapeia para um valor DDEX da seguinte forma:

Seleção de declaração	Valor DDEX
Nenhuma IA generativa foi usada	`None`
Apenas assistência menor de IA	`Partly`
A IA gerou partes do material	`Partly`
Inteiramente gerado com IA	`All`

O <ContainsAI> de uma faixa é o mais alto entre suas declarações de Generative AI e Composition AI.
O <ContainsAI> do lançamento é o mais alto entre todas as faixas mais a capa.
O <AiContribution> de um <Contributor> reflete aquele crédito específico. Colaboradores nomeados (humanos) têm o teto em Partly; o valor All só é expresso por meio de <SpecialContributor>GenerativeAI</SpecialContributor>, que não carrega nome de party.

Exemplos em contexto

DisplayGenre substitui o elemento Genre da 4.3 (os filhos não mudam):

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

ContainsAI em uma faixa, na sua posição correta:

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

ContainsAI na imagem de capa (antes de TechnicalDetails):

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

Um colaborador usando a forma complexa de Role com um AiContribution, ao lado de um colaborador totalmente IA que usa SpecialContributor em vez de uma referência de party:

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

Para confirmar que uma mensagem 4.3.2 valida antes da entrega, verifique-a contra o schema público de release-notification da 4.3.2 (http://service.ddex.net/xml/ern/432/release-notification.xsd) com o validador online da DDEX.

MessageHeader

Identifica o remetente (a sua organização), o destinatário (a DSP) e um ID de mensagem único.

<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	Descrição
`MessageThreadId`	Agrupa mensagens relacionadas (ex.: atualizações do mesmo lançamento)
`MessageId`	Identificador único desta mensagem específica
`MessageSender`	O Party ID DDEX e o nome da sua organização
`MessageRecipient`	O Party ID e o nome da DSP receptora
`MessageCreatedDateTime`	Timestamp ISO 8601 de quando a mensagem foi criada

PartyList

Todas as entidades referenciadas em outros pontos do XML (o selo, os artistas, os colaboradores e as editoras) são definidas aqui. Cada party recebe um PartyReference usado para vinculá-la ao longo do documento.

Selo

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

Artistas

Os artistas podem incluir identificadores padrão como o 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>

Colaboradores

Os colaboradores (compositores, produtores, engenheiros) podem incluir identificadores 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>

Editoras

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

Identificadores de party suportados:

Identificador	Elemento	Formato
ISNI	`<ISNI>`	16 caracteres (15 dígitos + dígito verificador)
IPI	`<IpiNameNumber>`	Preenchido com zeros até 11 dígitos
Proprietary	`<ProprietaryId>`	Referência interna do LabelGrid

ResourceList

Contém todos os arquivos de áudio e a capa. Cada recurso recebe um ResourceReference (ex.: A1, A2) usado para vinculá-lo aos lançamentos.

Gravação sonora

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

Pontos-chave:

ISRC e PLine ficam dentro de SoundRecordingEdition
ISWC fica no SoundRecording pai, via WorkId (não dentro da Edition)
DisplayTitleText contém apenas o título base (sem a versão de mix)
O elemento SubTitle dentro de DisplayTitle guarda a versão de mix (vazio se não houver)
A função de exibição “Producer” mapeia para a função DDEX StudioProducer
A URI do arquivo de áudio segue o padrão: resources/{UPC}_{disc}_{track}.{ext}

Capa

<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

Contém o lançamento principal (o álbum ou single) e os lançamentos individuais de faixa. O lançamento principal vincula os recursos via ResourceGroup.

Lançamento principal

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

Pontos-chave:

ReleaseType vem antes de ReleaseId na ERN 4.3
O UPC/EAN entra em <ICPN> dentro de ReleaseId
Os recursos são vinculados por meio de ResourceGroup (não ReleaseResourceReferenceList)
ReleaseLabelReference aponta para o PartyReference do selo

Lançamento de faixa

Cada faixa também recebe o seu próprio TrackRelease para a disponibilidade individual da faixa nas plataformas:

<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

Define os termos comerciais sob os quais o lançamento fica disponível. Cada Deal especifica um território, uma data de início, um modelo comercial e um tipo de uso.

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

Tipos de modelo comercial:

Modelo	Descrição	Exemplo
`SubscriptionModel`	Streaming por assinatura paga	Spotify Premium, Apple Music
`AdvertisementSupportedModel`	Streaming gratuito com anúncios	Spotify Free, YouTube
`PayAsYouGoModel`	Compra por download avulso	iTunes, Amazon Music

Exemplos

Single completo

Um lançamento completo de faixa única, com um artista principal, um artista convidado e os créditos completos de colaboradores.

Metadados de entrada:

Campo	Valor
Título	Midnight Run
Artista	Luna Wave (principal), DJ Koda (convidado)
UPC	198765432109
Data de lançamento	2025-08-15
Selo	Neon Sounds
Número de catálogo	NS-2025-042
Gênero	Electronic / Deep House
C-Line	2025 Neon Sounds LLC
P-Line	2025 Neon Sounds LLC
ISRC da faixa	USNS12500001
Explícito	Not Explicit

XML gerado:

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

Lançamento ERN 4.3.2 completo (todos os campos, com declarações de IA)

O mesmo lançamento de cima, expresso em ERN 4.3.2 com todos os campos que o LabelGrid usa. Observe as diferenças em relação à versão 4.3: o namespace /432 e AvsVersionId="4", <DisplayGenre> em vez de <Genre>, a forma complexa <Role><Value>…</Value></Role>, o <ContainsAI> na faixa / lançamento / imagem, um <AiContribution> em cada colaborador e um vocalista totalmente IA expresso com <SpecialContributor>GenerativeAI</SpecialContributor> (sem entrada na PartyList).

Metadados de entrada (iguais aos do exemplo 4.3, mais as declarações de IA):

Campo	Valor
Generative AI Disclosure	Apenas assistência menor de IA → `Partly`
Composition AI Disclosure	Sem IA generativa → `None`
IA na capa	Sem IA generativa → `None`
Vocalista de IA	Crédito inteiramente gerado por IA → `SpecialContributor` / `All`

XML gerado:

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

Títulos em vários idiomas (japonês)

Quando um lançamento tem metadados em inglês e em japonês. Todos os elementos DisplayTitleText vêm primeiro, depois todos os elementos DisplayTitle. As leituras fonéticas do japonês usam ja-Kana (mapeado a partir do ja-Jpan interno).

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

Pontos-chave:

Agrupe todos os elementos DisplayTitleText juntos, depois todos os elementos DisplayTitle
Use ja-Kana para as leituras fonéticas do japonês (katakana); isso é mapeado a partir do código interno ja-Jpan
Forneça títulos em cada idioma suportado

Faixa de remix com versão de mix

Quando uma faixa é um remix, a versão de mix entra em SubTitle, e o remixer recebe tanto uma função de exibição FeaturedArtist quanto um ArtisticRole igual a 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>

Pontos-chave:

DisplayTitleText contém apenas o título base, nunca a forma concatenada, como “Horizon (Koda Extended Mix)”
A versão de mix entra em SubTitle, dentro de DisplayTitle
O remixer precisa dos dois: DisplayArtistRole=FeaturedArtist e ArtisticRole=Remixer
Se forem usados títulos em vários idiomas, localize a versão de mix em cada idioma

Dolby Atmos (estéreo + imersivo)

Quando uma faixa tem versões estéreo e Dolby Atmos, o SoundRecording contém dois elementos SoundRecordingEdition: um NonImmersiveEdition e um ImmersiveEdition. Cada um precisa ter o seu próprio ISRC único.

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

Pontos-chave:

A edição estéreo recebe <Type>NonImmersiveEdition</Type> somente quando também existe uma edição Dolby
A edição Dolby usa <Type>ImmersiveEdition</Type>
Cada edição precisa ter um ISRC diferente
O TechnicalResourceDetailsReference imersivo recebe o sufixo I (ex.: T1I)
A URI do arquivo de áudio Dolby usa o sufixo -dolby
O Dolby Atmos exige no mínimo 6 canais (surround 5.1)

Titulares de copyright com splits por território

Vários titulares de copyright com splits de porcentagem por região. O elemento padrão é WorkRightsController. Quando nenhum titular de copyright é definido, o selo é usado como controlador de direitos padrão a 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>

Pontos-chave:

As porcentagens devem somar exatamente 100% por território
Use Worldwide para cobertura global ou códigos de território ISO 3166-1 alpha-2 específicos
RightSharePercentage usa duas casas decimais (ex.: 60.00)
Uma loja específica usa ResourceRightsController em vez de WorkRightsController

Deal específico por território

Quando um lançamento fica disponível apenas em países específicos, e não no mundo todo:

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

Pontos-chave:

Liste vários elementos <TerritoryCode> dentro do mesmo DealTerms
Use códigos ISO 3166-1 alpha-2 (ex.: US, GB, DE)
Omita Worldwide ao especificar territórios individuais

Remoção (takedown de um lançamento)

Quando você faz uma remoção (takedown), as datas de início e de fim do período de validade são definidas 48 horas no passado:

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

Pontos-chave:

StartDate e EndDate são definidas para a mesma data, 48 horas no passado
Isso sinaliza à DSP que o lançamento deve ser removido
É gerado um deal de remoção para cada tipo de modelo comercial

Referência de campo para XML

Tabela de consulta rápida que mapeia os campos de metadados do LabelGrid para a sua representação em DDEX XML.

Campo do LabelGrid	Elemento DDEX XML	Observações
UPC/EAN	`<ICPN>`	Dentro de `<ReleaseId>`
ISRC	`<ISRC>`	Dentro de `<ResourceId>`, em `<SoundRecordingEdition>`
ISWC	`<ISWC>`	Dentro de `<WorkId>`, no `<SoundRecording>` pai (não dentro da Edition)
Título	`<DisplayTitleText>` + `<DisplayTitle>`	Um por idioma; `DisplayTitleText` usa apenas o título base
Versão de mix	`<SubTitle>`	Dentro de `<DisplayTitle>`
Artista principal	`<DisplayArtistRole>MainArtist</DisplayArtistRole>`
Artista convidado	`<DisplayArtistRole>FeaturedArtist</DisplayArtistRole>`
Remixer	`FeaturedArtist` + `<ArtisticRole>Remixer</ArtisticRole>`	Os dois elementos são necessários
Gênero	`<GenreText>` + `<SubGenre>`	Mapeado para os códigos de gênero específicos da DSP
P-Line	`<PLine>` > `<Year>` + `<PLineText>`
C-Line	`<CLine>` > `<Year>` + `<CLineText>`
Explícito	`<ParentalWarningType>`	Valores: `NotExplicit`, `Explicit`, `ExplicitContentEdited`
Data de lançamento	`<OriginalReleaseDate>` + `<StartDate>` do deal	Formato: `YYYY-MM-DD`
Território	`<TerritoryCode>`	`Worldwide` ou ISO 3166-1 alpha-2
Colaborador (Producer)	`<Role>StudioProducer</Role>`	O nome de exibição “Producer” mapeia para o DDEX `StudioProducer`
Colaborador (outros)	`<Contributor>` > `<Role>`	Códigos de função DDEX (ex.: `ComposerLyricist`, `MixingEngineer`)
Editora	`<Role>MusicPublisher</Role>`	Dentro de `<Contributor>`
Arquivo de áudio	`<File>` > `<URI>`	Padrão: `resources/{UPC}_{disc}_{track}.{ext}`
IPI	`<IpiNameNumber>`	Preenchido com zeros até 11 dígitos
ISNI	`<ISNI>`	16 caracteres
Capa	`<Image>` com `<Type>FrontCoverImage</Type>`
Tipo de lançamento	`<ReleaseType>`	Aparece antes de `<ReleaseId>` na ERN 4.3
Número de catálogo	`<CatalogNumber>`	Dentro de `<ReleaseId>`
Recursos de faixa	`<ResourceGroup>` > `<ResourceGroupContentItem>`	Não `ReleaseResourceReferenceList`
Duração	`<Duration>`	Formato ISO 8601: `PT00H04M32S`
Idioma	`<LanguageOfPerformance>`	Código de idioma ISO
Palavras-chave	`<Keywords>`	Dentro de `<TrackRelease>`
Dolby estéreo	`<Type>NonImmersiveEdition</Type>`	Presente apenas quando também existe uma edição Dolby
Dolby Atmos	`<Type>ImmersiveEdition</Type>`	ISRC separado obrigatório; a URI do arquivo usa o sufixo `-dolby`
Titular de copyright	`<WorkRightsController>`	Com `<RightSharePercentage>` e `<Territory>`

Apenas ERN 4.3.1 / 4.3.2

Estes elementos existem apenas na 4.3.1 e na 4.3.2 (não na 4.3.0). Consulte Campos de declaração de IA.

Campo do LabelGrid	Elemento DDEX XML	Observações
Gênero (4.3.1+)	`<DisplayGenre>`	Substitui `<Genre>`; mesmos filhos `GenreText` + `SubGenre`
Função de colaborador (4.3.1+)	`<Role><Value>…</Value></Role>`	Forma complexa; `<Value UserDefinedValue="…">UserDefined</Value>` para funções não padrão
IA na faixa/lançamento/capa	`<ContainsAI>`	Valores `None` / `Partly` / `All`; em `SoundRecording`, `Release` e `Image`
IA por colaborador	`<AiContribution>`	Valores `None` / `Partly` / `All`; filho de `<Contributor>`, depois de `<Role>`
Crédito inteiramente gerado por IA	`<SpecialContributor>GenerativeAI</SpecialContributor>`	Substitui `<ContributorPartyReference>` (sem nome de party)

Checklist de estrutura XML

Use este checklist para verificar o seu XML antes do envio:

Apenas ERN 4.3.1 / 4.3.2:

O gênero usa <DisplayGenre> (não <Genre>)
Todo <Contributor> usa a forma complexa <Role><Value>…</Value></Role>
O <ContainsAI> está presente em cada <SoundRecording>, no <Release> e na <Image> de capa, com valor None, Partly ou All
O <ContainsAI> da faixa fica depois de <ParentalWarningType>; na imagem, fica antes de <TechnicalDetails>
Cada <Contributor> carrega um <AiContribution> (None / Partly / All) logo depois de <Role>
Os créditos inteiramente gerados por IA usam <SpecialContributor>GenerativeAI</SpecialContributor> no lugar de <ContributorPartyReference>

Precisa de ajuda?

Se precisar de ajuda com a integração DDEX, fale com nossa equipe de suporte com os seus requisitos técnicos.

Ainda não usa a LabelGrid?

Tudo o que você acabou de ler está disponível na nossa plataforma.

Veja o que a LabelGrid pode fazer →