DHL

Kurzbeschreibung

Tracking-Informationen direkt aus DHL in armin.cx abrufen und in Workflows (z. B. WISMO) verwenden. Die Verbindung erfolgt über eine eigene App im DHL Developer Portal und das Eintragen der dort erzeugten API-Zugangsdaten in armin.cx.

Schau dir folgendes Loom Video an, oder befolge die Schritte unten, um DHL zu integrieren:

Wann wird das verwendet?

Wenn Sendungsstatus aus DHL in armin.cx genutzt werden sollen, etwa für WISMO-Flows, automatische Antworten auf "Wo ist meine Bestellung?" oder regelbasierte Workflows nach Sendungsstatus.

Voraussetzungen

• Zugang zum DHL Developer Portal: https://developer.dhl.com

• Admin-Zugang in armin.cx, um Integrationen zu verwalten

Schritte

Teil 1: App im DHL Developer Portal anlegen

1. Öffne das DHL Developer Portal unter https://developer.dhl.com und melde dich an oder registriere dich.

2. Öffne über das Profil-Icon oben rechts den Bereich Apps (My Apps).

3. Klicke auf + Create App.

4. Trage einen App name ein (z. B. cx integration). Eine Beschreibung ist optional.

5. Unter Select APIs im Feld API's name die API Shipment Tracking - Unified auswählen. Es erscheint die Umgebung Production (Europe) mit dem Standard-Rate-Limit 250 requests every 1 day.

6. Klicke auf das rote + in der Spalte Add to app, damit die API in der Liste Selected APIs erscheint.

7. Unten auf Create App klicken.

8. Die App ist nun angelegt und erscheint mit Status in progress. Öffne die App.

9. Im Abschnitt Credential auf Show key neben API Key klicken und den Wert kopieren. Dasselbe für API Secret.

Teil 2: Account in armin.cx verbinden

1. In armin.cx unten links auf das eigene Profil klicken und Integrations wählen.

2. In der Integrationsliste DHL auswählen und auf den Tab Accounts wechseln.

3. Auf + Add account klicken.

4. Im Dialog Add DHL Integration:

   • Name: einen Anzeigenamen eingeben oder bei mehreren Shops den passenden Shop auswählen.

   • API Key: den Wert aus dem DHL Developer Portal einfügen.

   • API Secret: den Wert aus dem DHL Developer Portal einfügen.

5. Auf Connect klicken. Bei erfolgreicher Verbindung erscheint die Bestätigung Integration connected successfully und der Account ist unter Accounts connected sichtbar.

Hinweise / Best Practices

• Die API Shipment Tracking - Unified muss von DHL freigegeben werden. Direkt nach dem Erstellen steht die App auf in progress und die API auf pending. Verbinden mit armin.cx ist trotzdem möglich; Tracking-Abfragen funktionieren erst nach DHL-Freigabe.

• Standard-Rate-Limit: 250 requests every 1 day. Ein Upgrade kann über Request Rate Limit Upgrade in der App-Detailansicht beantragt werden.

• API Key und API Secret nicht teilen. Bei Verlust können über Add key neue Credentials in der App erzeugt werden.

• Multi-Shop-Setups: pro Shop einen separaten Account hinzufügen und im Feld Name den jeweiligen Shop wählen.

• Nach erfolgreicher Verbindung kann die DHL-Integration im Workflow Builder als Datenquelle für Tracking-Schritte und WISMO-Flows verwendet werden.

FAQ

Welche API muss ausgewählt werden? Shipment Tracking - Unified.

Was passiert, wenn der Status pending bleibt? Solange die API nicht freigegeben ist, gibt DHL keine Tracking-Daten zurück. Freigaben dauern in der Regel wenige Werktage. Bei länger ausbleibender Freigabe direkt DHL kontaktieren.

Kann ich mehrere DHL-Konten verbinden? Ja. Pro Shop oder Marke einen eigenen Account in armin.cx anlegen und das passende Name-Feld wählen.