Per DDEX ausliefern (API oder SFTP)

Wenn Ihr Label oder Vertrieb ein eigenes Katalogsystem hat, können Sie Releases als DDEX-ERN-Nachrichten an HILLS Music senden, statt sie einzutippen. Die DDEX-Auslieferung ist nur für Partner; Artists und Labels, auch direkt unter Vertrag stehende, verwenden den Bulk-Upload.

Alle technischen Details (Ordnerstruktur, Marker, Endpunkte, Scopes und Testberichte) finden Sie auf der Entwickler-Website: DDEX-Auslieferungen und Testordner.

Drei Wege der Auslieferung

Weg	So funktioniert es	Für wen
Portal	Import → DDEX inbox: eine ZIP-Datei ausliefern oder die XML mit ihren Dateien	Alle Partner
SFTP	Die Ordner /production und /test Ihrer Inbox	Alle Partner, sobald der Login eingerichtet ist
API	POST /v1/ddex mit einem API-Schlüssel (Scope ddex:write)	Partner mit Enterprise- und Custom-Tarif

Ganz gleich, auf welchem Weg ein Batch ankommt: Er wird gleich verarbeitet und unter DDEX inbox → Batches aufgeführt.

Was mit einem Batch passiert

1. Der Batch wird gelesen und geprüft: die XML, die Regeln von HILLS, die Audio-, Cover- und Videodateien sowie UPCs und ISRCs im Abgleich mit dem Katalog.
2. Jedes Release wird als Entwurf in dem Konto angelegt, für das es bestimmt ist: in Ihrem eigenen Katalog oder bei einem Ihrer Artists oder Labels.
3. Sie prüfen die Entwürfe und reichen sie ein oder lassen sie sich selbst einreichen (siehe unten). Danach durchlaufen sie wie gewohnt Prüfung und Auslieferung an die Stores.

Ein Release, das bereits als Entwurf mit derselben UPC existiert, wird aktualisiert. Takedowns und Aktualisierungen von Releases, die in Prüfung oder live sind, werden nie automatisch übernommen: Sie werden für unser Team markiert.

Der Batch zeigt, was geschehen ist: angelegte Entwürfe, Musikvideos, ausgelassene Releases mit Begründung und Nachrichten, die nicht gelesen werden konnten.

Zuerst testen

Sie können eine Nachricht oder einen ganzen Batch testen, bevor Sie ihn ausliefern. Ein Test durchläuft alle Prüfungen einer echten Auslieferung und legt nichts an: kein Release, keine Aufnahme, keinen Artist, keinen Code und keine Auslieferung.

• Portal: DDEX inbox → Test, mit einer ERN-Nachricht oder einem Paket. Wählen Sie ein Konto, um auch UPCs und ISRCs mit dessen Katalog abzugleichen. Zum Vergleich stehen dort Beispiel-ERN-Dateien bereit.
• SFTP: Laden Sie in /test/<batch>/ hoch; der Bericht wird daneben abgelegt.
• API: POST /v1/ddex/validate.

Tests werden auf der DDEX-Seite unter den Testberichten aufgeführt.

Ihre SFTP-Inbox einrichten

Jedes Konto erhält genau einen SFTP-Login für DDEX-Auslieferungen, unter DDEX inbox → SFTP accounts. Je nach Einrichtung legen Sie ihn selbst an oder unser Team übernimmt das für Sie.

1. Wählen Sie den Benutzernamen. Er lässt sich später nicht ändern.
2. Wählen Sie die Anmeldeart: ein Passwort (generiert und einmalig angezeigt), einen öffentlichen SSH-Schlüssel oder beides.
3. Notieren Sie Host, Port, Benutzernamen und Host-Key, die auf der Seite angezeigt werden.
4. Nutzen Sie Test the connection: Laden Sie eine beliebige kleine Datei wie ping.txt in /test hoch. Die Seite wird grün, sobald sie angekommen ist.

Liefern Sie in /production/<batch>/ aus: die ERN-XML und die Dateien, auf die sie verweist, abgeschlossen durch ihren Marker (BatchComplete_*.xml oder eine beliebige *.complete). Ein Batch-Ordner, der nie seinen Marker erhält, wird nach 7 Tagen entfernt.

Automatisch einreichen

Haken Sie Submit for review automatically when a delivered release is complete an, um das manuelle Einreichen zu überspringen. Ist die Option deaktiviert, bleiben Releases Entwürfe, bis Sie sie einreichen. Die Einstellung gilt für Portal, API und SFTP.

Die API

Die API steht Partnern mit Enterprise- und Custom-Tarif zur Verfügung. Sie verwendet eine einzige Art von Schlüssel (hm_live_…), die Sie auf Ihrer Seite Developers erstellen. Beginnen Sie mit der Entwicklerdokumentation.