DOCS

Per API verbinden

StartseiteGlobaler E-Commerce Fulfillment Carrier Per API verbinden

DHL-Carrier-Konto verbinden

Verbinden Sie Ihr DHL-Carrier-Konto sicher, um auf ausgehandelte Versandtarife zuzugreifen und Labels direkt über Zonos zu erstellen.

Erste Schritte 

Der Verbindungsprozess für Ihr DHL-Carrier-Konto validiert Ihre Zugangsdaten und stellt sicher, dass Ihr Konto korrekt konfiguriert ist, um Tarife abzurufen und Versandlabels zu generieren. Wenn Sie Ihr DHL-Konto verbinden, führt Zonos einen Test-Tarifabruf durch, um zu prüfen, ob die Verbindung funktioniert, bevor Ihre Zugangsdaten gespeichert werden.

Um sich bei DHL Express zu registrieren oder die Einrichtung über Ihr Zonos Dashboard vorzunehmen, folgen Sie den Schritten in dieser Anleitung.

So funktioniert die DHL-Carrier-Kontoverbindung 

Beim Verbinden Ihres DHL-Carrier-Kontos:

  • wird geprüft, ob Sie die richtigen Zugangsdaten-Typen für DHL angegeben haben
  • wird ein Live-Tarifabruf an die DHL-API durchgeführt, um die Gültigkeit der Zugangsdaten zu bestätigen
  • wird Ihr verbundenes Konto in Zonos für künftige Sendungsbewertungen und Label-Erstellung gespeichert
  • werden die Details des verbundenen Kontos zurückgegeben, einschließlich Ihrer DHL-Kontoinformationen und des Tariftyps

Nach der Verbindung können Sie mit Ihrem DHL-Carrier-Konto Echtzeit-Versandtarife auf Basis Ihrer ausgehandelten Tarife (falls zutreffend) abrufen und DHL-Versandlabels erstellen.

Ihr DHL-Konto verbinden 

Verwenden Sie die carrierAccountConnect-Mutation, um Ihr DHL-Carrier-Konto mit Ihren Zugangsdaten zu verbinden.

Mutation

Mit dieser Mutation verbinden Sie Ihr DHL-Carrier-Konto und validieren Ihre Zugangsdaten.

1mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) {
2 carrierAccountConnect(input: $input) {
3 errors
4 carrierAccount {
5 credentialProvider
6 id
7 integrationType
8 organization
9 rateType
10 carrier {
11 id
12 code
13 name
14 }
15 credentials {
16 type
17 value
18 }
19 }
20 }
21}

Variablen

Die Mutation erfordert den DHL-Carrier-Code, den Tariftyp und Ihre DHL-Kontozugangsdaten.

1{
2 "input": {
3 "carrierCode": "DHL",
4 "rateType": "NEGOTIATED",
5 "credentials": [
6 {
7 "type": "API_KEY",
8 "value": "actual_api_key_value"
9 },
10 {
11 "type": "API_PASSWORD",
12 "value": "actual_api_password_value"
13 },
14 {
15 "type": "ACCOUNT_NUMBER",
16 "value": "actual_account_number_value"
17 }
18 ]
19 }
20}

DHL erfordert folgende Zugangsdaten-Typen:

  • API_KEY – Ihr DHL-API-Schlüssel
  • API_PASSWORD – Ihr DHL-API-Passwort
  • ACCOUNT_NUMBER – Ihre DHL-Kontonummer

Diese Zugangsdaten finden Sie im DHL-Kontoportal oder über Ihren DHL-Kundenbetreuer.

Antwortbeispiele

Erfolgreiche Verbindung

Wenn die Zugangsdaten gültig sind und DHL Tarife erfolgreich zurückgibt:

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [],
5 "carrierAccount": {
6 "credentialProvider": "ORGANIZATION",
7 "id": "carrier_account_123",
8 "integrationType": "REST",
9 "organization": "organization_id",
10 "rateType": "NEGOTIATED",
11 "carrier": {
12 "id": "carrier_123",
13 "code": "dhl",
14 "name": "DHL"
15 },
16 "credentials": [
17 {
18 "type": "API_KEY",
19 "value": "actual_api_key_value"
20 },
21 {
22 "type": "API_PASSWORD",
23 "value": "actual_api_password_value"
24 },
25 {
26 "type": "ACCOUNT_NUMBER",
27 "value": "actual_account_number_value"
28 }
29 ]
30 }
31 }
32 }
33}

Fehler: Nicht unterstützter Zugangsdaten-Typ

Wenn Sie einen Zugangsdaten-Typ angeben, den DHL nicht unterstützt:

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [
5 "Credential type SITE_ID is not supported by carrier DHL"
6 ],
7 "carrierAccount": null
8 }
9 }
10}

Fehler: Ungültige Zugangsdaten

Wenn die Zugangsdaten-Typen gültig sind, die Authentifizierung bei DHL aber fehlschlägt:

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [
5 "Failed to get rating from DHL API"
6 ],
7 "carrierAccount": null
8 }
9 }
10}

Was nach der Verbindung passiert

Sobald Ihr DHL-Carrier-Konto erfolgreich verbunden ist:

  • wird das Konto in Ihrer Organisation gespeichert und mit Ihren Zugangsdaten verknüpft
  • können Sie DHL-Versandtarife mit Ihren ausgehandelten Tarifen abrufen (sofern zutreffend)
  • können Sie DHL-Versandlabels über die Zonos-API erstellen
  • kann das Carrier-Konto für mehrere Sendungen verwendet werden, ohne erneut zu verbinden

Nächste Schritte 

Nach dem Verbinden Ihres DHL-Carrier-Kontos:

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

Buchen Sie eine Demo

War diese Seite hilfreich?

Holen Sie sich Unterstützung·Rechtsdokumente·© 2026 Zonos
Auf dieser Seite:
  • DHL-Carrier-Konto verbinden
  • Erste Schritte
  • So funktioniert die DHL-Carrier-Kontoverbindung
  • Ihr DHL-Konto verbinden
  • Nächste Schritte