Entrega via DDEX (API ou SFTP)

Se a sua gravadora ou distribuidora tem um sistema de catálogo próprio, você pode enviar lançamentos à HILLS Music como mensagens DDEX ERN em vez de digitá-los. A entrega via DDEX é só para parceiros; artistas e gravadoras, inclusive os diretos, usam o upload em lote.

Os detalhes técnicos completos (estrutura de pastas, marcadores, endpoints, escopos e relatórios de teste) estão no site para desenvolvedores: DDEX deliveries e Test folder.

Três formas de entrega

Forma	Como	Quem
Portal	Import → DDEX inbox: envie um zip ou o XML com os arquivos	Todos os parceiros
SFTP	As pastas /production e /test da sua caixa de entrada	Todos os parceiros, depois que o login estiver configurado
API	POST /v1/ddex com uma chave de API (escopo ddex:write)	Parceiros nos planos Enterprise e Custom

Seja qual for a forma de chegada, o lote é processado do mesmo jeito e aparece em DDEX inbox → Batches.

O que acontece com um lote

1. O lote é lido e verificado: o XML, as regras da HILLS, os arquivos de áudio, capa e vídeo, e os UPCs e ISRCs em relação ao catálogo.
2. Cada lançamento vira um rascunho na conta a que se destina: o seu próprio catálogo ou o de um dos seus artistas ou gravadoras.
3. Você confere os rascunhos e os envia, ou deixa que sejam enviados automaticamente (veja abaixo). Depois eles passam pela revisão e pela entrega às plataformas normalmente.

Um lançamento que já existe como rascunho com o mesmo UPC é atualizado. Remoções e atualizações de lançamentos em revisão ou no ar nunca são aplicadas automaticamente: elas são sinalizadas para a nossa equipe.

O lote mostra o que foi feito: rascunhos criados, videoclipes, lançamentos deixados de fora e o motivo, e mensagens que não puderam ser lidas.

Teste antes

Você pode testar uma mensagem ou um lote inteiro antes de entregar. O teste executa todas as verificações de uma entrega e não cria nada: nenhum lançamento, gravação, artista, código ou entrega.

• Portal: DDEX inbox → Test, com uma mensagem ERN ou um pacote. Escolha uma conta para também verificar UPCs e ISRCs em relação ao catálogo dela. Há arquivos ERN de exemplo para comparação.
• SFTP: faça o upload em /test/<batch>/; o relatório é gravado ao lado.
• API: POST /v1/ddex/validate.

Os testes aparecem em Test reports, na página do DDEX.

Configure sua caixa SFTP

Cada conta tem exatamente um login SFTP para entregas DDEX, em DDEX inbox → SFTP accounts. Dependendo da sua configuração, você mesmo cria ou nossa equipe cria para você.

1. Escolha o nome de usuário. Ele não pode ser alterado depois.
2. Escolha como ele faz login: uma senha (gerada e mostrada uma única vez), uma chave pública SSH ou as duas.
3. Anote o host, a porta, o nome de usuário e a chave do host mostrados na página.
4. Use Test the connection: envie qualquer arquivo pequeno, como ping.txt, para /test. A página fica verde quando ele chega.

Entregue em /production/<batch>/: o XML do ERN e os arquivos a que ele se refere, finalizados pelo marcador (BatchComplete_*.xml ou qualquer *.complete). Uma pasta de lote que nunca recebe o marcador é removida após 7 dias.

Envio automático

Marque Submit for review automatically when a delivered release is complete para pular o envio manual. Com a opção desativada, os lançamentos ficam como rascunho até você enviá-los. A configuração vale para o portal, a API e o SFTP.

A API

A API é para parceiros nos planos Enterprise e Custom. Ela usa um único tipo de chave (hm_live_…), criada na sua página Developers. Comece pela documentação para desenvolvedores.