Livrer en DDEX (API ou SFTP)

Si votre label ou votre activité de distribution dispose de son propre système de gestion de catalogue, vous pouvez envoyer vos sorties à HILLS Music sous forme de messages DDEX ERN au lieu de les saisir. La livraison DDEX est réservée aux partenaires ; les artistes et labels, y compris directs, utilisent l’import en masse.

Tous les détails techniques (arborescence des dossiers, marqueurs, endpoints, scopes et rapports de test) se trouvent sur le site développeurs : Livraisons DDEX et Dossier de test.

Trois voies d’entrée

Voie	Comment	Pour qui
Portail	Import → DDEX inbox : livrez un zip, ou le XML avec ses fichiers	Tous les partenaires
SFTP	Les dossiers /production et /test de votre boîte	Tous les partenaires, une fois l’identifiant configuré
API	POST /v1/ddex avec une clé API (scope ddex:write)	Partenaires des offres Enterprise et Custom

Quelle que soit la voie d’arrivée, un lot est traité de la même façon et listé sous DDEX inbox → Batches.

Ce qu’il advient d’un lot

1. Le lot est lu et vérifié : le XML, les règles HILLS, les fichiers audio, de pochette et vidéo, ainsi que les UPC et ISRC par rapport au catalogue.
2. Chaque sortie devient un brouillon sur le compte auquel elle est destinée : votre propre catalogue, ou l’un de vos artistes ou labels.
3. Vous vérifiez les brouillons et les soumettez, ou vous les laissez se soumettre automatiquement (voir ci-dessous). Ils passent ensuite par la vérification et la livraison aux plateformes habituelles.

Une sortie qui existe déjà en brouillon avec le même UPC est mise à jour. Les retraits et les mises à jour de sorties en vérification ou en ligne ne sont jamais appliqués automatiquement : ils sont signalés à notre équipe.

Le lot indique ce qui a été fait : brouillons créés, clips, sorties écartées et pourquoi, et messages qui n’ont pas pu être lus.

Tester d’abord

Vous pouvez tester un message ou un lot entier avant de le livrer. Un test effectue toutes les vérifications d’une livraison sans rien créer : ni sortie, ni enregistrement, ni artiste, ni code, ni livraison.

• Portail : DDEX inbox → Test, avec un message ERN ou un package. Choisissez un compte pour vérifier aussi les UPC et ISRC par rapport à son catalogue. Des fichiers ERN d’exemple sont disponibles pour comparaison.
• SFTP : déposez dans /test/<batch>/ ; le rapport est écrit à côté.
• API : POST /v1/ddex/validate.

Les tests sont listés sous Test reports sur la page DDEX.

Configurer votre boîte SFTP

Chaque compte dispose d’un seul identifiant SFTP pour les livraisons DDEX, sous DDEX inbox → SFTP accounts. Selon votre configuration, vous le créez vous-même ou notre équipe le crée pour vous.

1. Choisissez son nom d’utilisateur. Il ne pourra plus être modifié.
2. Choisissez son mode de connexion : un mot de passe (généré et affiché une seule fois), une clé publique SSH, ou les deux.
3. Notez l’hôte, le port, le nom d’utilisateur et la clé d’hôte affichés sur la page.
4. Utilisez Test the connection : déposez un petit fichier quelconque, comme ping.txt, dans /test. La page passe au vert à son arrivée.

Livrez dans /production/<batch>/ : le XML ERN et les fichiers auxquels il fait référence, suivis de son marqueur (BatchComplete_*.xml ou n’importe quel *.complete). Un dossier de lot qui ne reçoit jamais son marqueur est supprimé au bout de 7 jours.

Soumission automatique

Cochez Submit for review automatically when a delivered release is complete pour vous passer de la soumission manuelle. Si l’option est désactivée, les sorties restent en brouillon jusqu’à ce que vous les soumettiez. Ce réglage s’applique au portail, à l’API et au SFTP.

L’API

L’API est réservée aux partenaires des offres Enterprise et Custom. Elle utilise un seul type de clé (hm_live_…), créée sur votre page Developers. Commencez par la documentation développeurs.