Entrega por DDEX (API o SFTP)

Si tu sello o tu empresa de distribución tiene su propio sistema de catálogo, puedes enviar los lanzamientos a HILLS Music como mensajes DDEX ERN en lugar de introducirlos a mano. La entrega por DDEX es solo para socios; los artistas y los sellos, incluidos los directos, usan la carga masiva.

Los detalles técnicos completos (estructura de carpetas, marcadores, endpoints, scopes e informes de prueba) están en el sitio para desarrolladores: DDEX deliveries y Test folder.

Tres vías de entrada

Vía	Cómo	Quién
Portal	Import → DDEX inbox: entrega un zip, o el XML con sus archivos	Todos los socios
SFTP	Las carpetas /production y /test de tu buzón	Todos los socios, una vez configurado el acceso
API	POST /v1/ddex con una clave de API (scope ddex:write)	Socios con planes Enterprise y Custom

Llegue por donde llegue, cada lote se procesa igual y aparece en DDEX inbox → Batches.

Qué pasa con un lote

1. El lote se lee y se comprueba: el XML, las normas de HILLS, los archivos de audio, portada y video, y los UPC e ISRC frente al catálogo.
2. Cada lanzamiento se convierte en un borrador de la cuenta a la que corresponde: tu propio catálogo o el de uno de tus artistas o sellos.
3. Revisas los borradores y los envías, o dejas que se envíen solos (ver más abajo). Después pasan por la revisión y la entrega a las plataformas habituales.

Si ya existe un borrador con el mismo UPC, se actualiza. Las retiradas y las actualizaciones de lanzamientos en revisión o publicados nunca se aplican automáticamente: se señalan para que las revise nuestro equipo.

El lote muestra lo que se ha hecho: borradores creados, videoclips, lanzamientos omitidos y el motivo, y mensajes que no se han podido leer.

Prueba primero

Puedes probar un mensaje o un lote completo antes de entregarlo. Una prueba ejecuta todas las comprobaciones de una entrega y no crea nada: ni lanzamientos, ni grabaciones, ni artistas, ni códigos, ni entregas.

• Portal: DDEX inbox → Test, con un mensaje ERN o un paquete. Elige una cuenta para comprobar también los UPC e ISRC frente a su catálogo. Ahí tienes archivos ERN de ejemplo para comparar.
• SFTP: sube a /test/<batch>/; el informe se escribe junto al lote.
• API: POST /v1/ddex/validate.

Las pruebas aparecen en Test reports, en la página de DDEX.

Configura tu buzón SFTP

Cada cuenta tiene exactamente un acceso SFTP para las entregas DDEX, en DDEX inbox → SFTP accounts. Según tu configuración, lo creas tú o lo crea nuestro equipo por ti.

1. Elige el nombre de usuario. No se puede cambiar más adelante.
2. Elige cómo se autentica: con una contraseña (generada y mostrada una sola vez), con una clave pública SSH o con ambas.
3. Anota el host, el puerto, el nombre de usuario y la clave del host que aparecen en la página.
4. Usa Test the connection: sube a /test cualquier archivo pequeño, como ping.txt. La página se pone en verde cuando llega.

Entrega en /production/<batch>/: el XML ERN y los archivos a los que hace referencia, cerrado con su marcador (BatchComplete_*.xml o cualquier *.complete). Una carpeta de lote que nunca recibe su marcador se elimina a los 7 días.

Envío automático

Marca Submit for review automatically when a delivered release is complete para saltarte el envío manual. Si está desactivado, los lanzamientos siguen como borradores hasta que los envíes. El ajuste se aplica al portal, a la API y a SFTP.

La API

La API está disponible para los socios con planes Enterprise y Custom. Usa un único tipo de clave (hm_live_…), que se crea en tu página Developers. Empieza por la documentación para desarrolladores.