Ersteinrichtungsassistent (Setup Wizard)
Der Ersteinrichtungsassistent führt Sie Schritt für Schritt durch die Grundkonfiguration des DHL Parcel DE Connectors. Er ist ideal für die Ersteinrichtung oder wenn Sie die DHL-Anbindung von Grund auf neu konfigurieren möchten.
Seite öffnen
- Öffnen Sie das DHL Dashboard → Klicken Sie auf Setup Wizard in der Navigationsleiste.
- Oder: Öffnen Sie die Suche (Alt+Q) und suchen Sie nach "DHL Setup Wizard".
- Oder: Beim ersten Öffnen des DHL Dashboards erscheint automatisch eine Benachrichtigung mit einem Link zum Assistenten.
Voraussetzungen
Bevor Sie den Assistenten starten, stellen Sie folgende Informationen bereit:
- DHL Geschäftskundenkonto (Vertragsnummer)
- API-Schlüssel (DHL Developer Portal → App "DHL Parcel DE Shipping")
- Benutzername & Passwort (für Basic Auth) oder Client ID & Secret (für OAuth2)
- Absenderadresse (Firmenname, Straße, PLZ, Ort, Land)
API-Zugangsdaten erhalten
Registrieren Sie sich im DHL Developer Portal und erstellen Sie eine App vom Typ "DHL Parcel DE Shipping (Post & Parcel Germany)". Die API-Zugangsdaten finden Sie dort unter Ihren App-Details.
Schritte des Assistenten
Schritt 1: Willkommen
Die Willkommensseite zeigt eine Übersicht der Voraussetzungen. Stellen Sie sicher, dass Sie alle notwendigen Zugangsdaten bereithalten.
Klicken Sie auf Next, um fortzufahren.
Schritt 2: Authentifizierung
Konfigurieren Sie hier die API-Zugangsdaten für die DHL Shipping API.
| Feld | Beschreibung |
|---|---|
| Auth Type | Authentifizierungsmethode: Basic Auth (Standard/Legacy) oder OAuth2 (ROPC) |
| API Key | DHL API Key (dhl-api-key Header) — klicken zum Eingeben |
| Username / Client ID | Basic Auth Benutzername oder OAuth2 Client ID — klicken zum Eingeben |
| Password / Client Secret | Basic Auth Passwort oder OAuth2 Client Secret — klicken zum Eingeben |
| Sandbox Mode | Aktiviert die DHL Sandbox-Umgebung für Tests (keine echten Labels) |
| API Base URL | DHL API URL (wird automatisch gesetzt, nur bei Bedarf ändern) |
Credential-Eingabe
Alle sensiblen Felder (API Key, Username, Password) öffnen beim Klick einen sicheren Eingabedialog. Bereits gespeicherte Werte werden nur als "Configured" / "Not configured" angezeigt — niemals im Klartext.
Sandbox-Modus
Aktivieren Sie den Sandbox-Modus für Tests. Im Sandbox-Modus werden keine echten Versandlabels erstellt. Deaktivieren Sie den Modus erst, wenn Sie bereit für den Produktivbetrieb sind.
Schritt 3: Verbindungstest
Testen Sie die Verbindung zur DHL API, um sicherzustellen, dass Ihre Zugangsdaten korrekt sind.
- Klicken Sie auf Test Connection.
- Das Ergebnis wird angezeigt:
- Grün (Successful): Verbindung erfolgreich — Sie können fortfahren.
- Rot (Error): Verbindung fehlgeschlagen — prüfen Sie Ihre Zugangsdaten in Schritt 2.
Optionaler Schritt
Der Verbindungstest ist empfohlen, aber nicht zwingend. Sie können auch ohne Test zum nächsten Schritt wechseln.
Schritt 4: Absenderadresse
Geben Sie hier die Absenderadresse ein, die auf allen DHL-Labels gedruckt wird.
| Feld | Beschreibung |
|---|---|
| Shipper Name | Firmenname (Zeile 1) |
| Shipper Name 2 | Zusätzlicher Name (Zeile 2, optional) |
| Shipper Street | Straßenname |
| Shipper House No. | Hausnummer |
| Shipper Post Code | Postleitzahl |
| Shipper City | Ort |
| Shipper Country Code | Ländercode (ISO, z. B. DE) |
| Shipper Contact Name | Ansprechpartner |
| Shipper Email | E-Mail-Adresse |
| Shipper Phone | Telefonnummer |
Automatisch aus Firmendaten laden
Klicken Sie auf Load from Company, um die Absenderadresse automatisch aus den BC-Firmendaten (Company Information) zu übernehmen:
- Firmenname → Shipper Name
- Adresse → Straße + Hausnummer
- PLZ → Post Code
- Ort → City
- Land → Country Code
- Telefon → Phone
- E-Mail → Email
Zeitsparend
Wenn Ihre BC-Firmendaten bereits korrekt gepflegt sind, klicken Sie einfach "Load from Company" und prüfen Sie die übernommenen Werte. In den meisten Fällen müssen Sie nur den Ansprechpartner ergänzen.
Schritt 5: Standardwerte
Legen Sie Voreinstellungen fest, die bei jeder Label-Erstellung als Standard verwendet werden.
| Feld | Beschreibung | Empfehlung |
|---|---|---|
| Default Weight (g) | Standard-Paketgewicht in Gramm, falls kein Gewicht angegeben wird | 1000 (= 1 kg) |
| Label Print Format | Standard-Druckformat für Labels | Je nach Drucker (A4, 100x70mm, etc.) |
| Doc Format | Dokumentformat (PDF oder ZPL2) | PDF für Standarddrucker, ZPL2 für Thermodrucker |
| Def. GoGreen Plus | GoGreen Plus standardmäßig aktivieren | Nach Wunsch |
| Include Return Label | Retourenlabel automatisch miterstellen | Nach Geschäftsmodell |
Schritt 6: Zusammenfassung & Abschluss
Die letzte Seite zeigt eine Zusammenfassung des Konfigurationsstatus:
| Prüfpunkt | Status | Bedeutung |
|---|---|---|
| Credentials | ✓ Configured / ✗ Incomplete | API-Zugangsdaten vollständig |
| Connection Test | ✓ Successful / ○ Not tested | Verbindungstest bestanden |
| Shipper Address | ✓ Configured / ✗ Incomplete | Absenderadresse vollständig |
Klicken Sie auf Finish, um die Einrichtung abzuschließen und die Konfiguration zu speichern.
Fehlende Konfiguration
Auch wenn einzelne Prüfpunkte als "Incomplete" oder "Not tested" angezeigt werden, können Sie den Assistenten abschließen. Sie können die fehlenden Einstellungen jederzeit über die DHL Setup Card nachholen.
Nach dem Assistenten
Nach Abschluss des Setup Wizards empfehlen wir:
- Profil anlegen: Erstellen Sie mindestens ein DHL-Profil für Ihre Standard-Versandkonfiguration.
- Versandregeln definieren: Richten Sie automatische Regeln ein (z. B. Versicherung ab Betrag X).
- Tracking aktivieren: Richten Sie den separaten Tracking-API-Key ein für automatische Sendungsverfolgung.
- Testversand: Erstellen Sie ein Testlabel (im Sandbox-Modus) und prüfen Sie das Ergebnis.
Häufige Fragen
Kann ich den Assistenten erneut ausführen?
Ja. Der Assistent kann jederzeit über das Dashboard oder die Suche erneut gestartet werden. Bestehende Werte bleiben erhalten — Sie können gezielt einzelne Schritte anpassen.
Was passiert mit meinen bisherigen Einstellungen?
Der Assistent überschreibt nur Felder, die Sie aktiv ändern. Bereits konfigurierte Werte bleiben bestehen, wenn Sie den Schritt unverändert passieren.
Verbindungstest schlägt fehl — was tun?
- Prüfen Sie den API Key (häufigster Fehler: Key der falschen App aus dem Developer Portal).
- Prüfen Sie Username/Password (bei Basic Auth: die GKP-Zugangsdaten, nicht die Portal-Zugangsdaten).
- Prüfen Sie den Sandbox-Modus: Im Sandbox-Modus gelten andere Zugangsdaten als in Produktion.
- Siehe auch: Fehlerbehebung.