DHL-Versandkonto verbinden

Stellen Sie sicher, dass Sie Ihr DHL-Versandkonto sicher verbinden, um verhandelte Versandtarife abzurufen und direkt über Zonos Etiketten zu erstellen.

Get started 

Der DHL-Versandkonto-Verbindungsprozess validiert Ihre Anmeldeinformationen und stellt sicher, dass Ihr Konto ordnungsgemäß konfiguriert ist, um Tarife abzurufen und Versandetiketten zu erstellen. Wenn Sie Ihr DHL-Konto verbinden, führt Zonos eine Test-Tarifanfrage durch, um zu überprüfen, dass die Verbindung ordnungsgemäß funktioniert, bevor Ihre Anmeldeinformationen gespeichert werden.

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

Wie die Verbindung des DHL-Versandkontos funktioniert 

• Überprüft, ob Sie die richtigen Anmeldeinformationen für DHL angegeben haben.
• Führt eine Live-Tarifanfrage an die DHL-API durch, um zu bestätigen, dass die Anmeldeinformationen gültig sind.
• Speichert Ihr verbundenes Konto in Zonos für zukünftige Versandtarifanfragen und die Erstellung von Etiketten.
• Gibt die Details des verbundenen Kontos zurück, einschließlich Ihrer DHL-Kontosinformationen und dem rate Typ.

Nachdem es verbunden ist, kann Ihr DHL-Versandkonto verwendet werden, um Echtzeit-Versandtarife basierend auf Ihren verhandelten Tarifen abzurufen (falls zutreffend) und DHL-Versandetiketten zu erstellen.

Verbinden Sie Ihr DHL-Konto 

Verwenden Sie die Mutation carrierAccountConnect, um Ihr DHL-Versandkonto mit Ihren Anmeldeinformationen zu verbinden.

Mutation

Verwenden Sie diese Mutation, um Ihr DHL-Versandkonto zu verbinden und Ihre Anmeldeinformationen zu validieren.

mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) {
  carrierAccountConnect(input: $input) {
    errors
    carrierAccount {
      credentialProvider
      id
      integrationType
      organization
      rateType
      carrier {
        id
        code
        name
      }
      credentials {
        type
        value
      }
    }
  }
}

Variablen

Die Mutation erfordert den DHL-Trägercode, den rate Typ und Ihre DHL-Kontoinformationen.

{
  "input": {
    "carrierCode": "DHL",
    "rateType": "NEGOTIATED",
    "credentials": [
      {
        "type": "API_KEY",
        "value": "actual_api_key_value"
      },
      {
        "type": "API_PASSWORD",
        "value": "actual_api_password_value"
      },
      {
        "type": "ACCOUNT_NUMBER",
        "value": "actual_account_number_value"
      }
    ]
  }
}

DHL benötigt die folgenden Zugangsdaten-Typen:

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

Sie finden diese Zugangsdaten in Ihrem DHL-Kundenportal oder indem Sie Ihren DHL-Kundenbetreuer kontaktieren.

Antwortbeispiele

Erfolgreiche Verbindung

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

{
  "data": {
    "carrierAccountConnect": {
      "errors": [],
      "carrierAccount": {
        "credentialProvider": "ORGANIZATION",
        "id": "carrier_account_123",
        "integrationType": "REST",
        "organization": "organization_id",
        "rateType": "NEGOTIATED",
        "carrier": {
          "id": "carrier_123",
          "code": "dhl",
          "name": "DHL"
        },
        "credentials": [
          {
            "type": "API_KEY",
            "value": "actual_api_key_value"
          },
          {
            "type": "API_PASSWORD",
            "value": "actual_api_password_value"
          },
          {
            "type": "ACCOUNT_NUMBER",
            "value": "actual_account_number_value"
          }
        ]
      }
    }
  }
}

Fehler: Nicht unterstützter Credential-Typ

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

{
  "data": {
    "carrierAccountConnect": {
      "errors": ["Credential type SITE_ID is not supported by carrier DHL"],
      "carrierAccount": null
    }
  }
}

Fehler: Ungültige Anmeldeinformationen

Wenn die Zugangsdaten gültig sind, sich jedoch nicht erfolgreich bei DHL authentifizieren:

{
  "data": {
    "carrierAccountConnect": {
      "errors": ["Failed to get rating from DHL API"],
      "carrierAccount": null
    }
  }
}

Was passiert nach der Verbindung

Sobald Ihr DHL-Versandkonto erfolgreich verbunden ist:

• Das Versandkonto wird in Ihrer Organisation gespeichert und mit Ihren Anmeldeinformationen verknüpft
• Sie können DHL-Versandtarife mit Ihren verhandelten Tarifen abrufen (falls zutreffend)
• Sie können DHL-Versandetiketten über die Zonos API erstellen
• Das Versandkonto kann über mehrere Sendungen hinweg verwendet werden, ohne sich erneut verbinden zu müssen

Nächste Schritte 

Nachdem Sie Ihr DHL-Versandkonto verbunden haben:

• Eine Sendung erstellen - Generieren Sie Versandetiketten mit Ihrem verbundenen DHL-Versandkonto
• Berechnen landed cost - Erhalten Sie genaue Zoll- und Steuerberechnungen für internationale Sendungen
• Unterstützte Carrier anzeigen - Sehen Sie alle Carrier und Service-Level, die über Zonos verfügbar sind