Połączenie konta przewoźnika DHL

Bezpiecznie połącz swoje konto DHL, aby uzyskać dostęp do negocjowanych stawek wysyłkowych i tworzyć etykiety bezpośrednio przez Zonos.

Rozpocznij 

Proces łączenia konta przewoźnika DHL weryfikuje Twoje dane uwierzytelniające i zapewnia, że Twoje konto jest poprawnie skonfigurowane do pobierania stawek i generowania etykiet wysyłkowych. Po połączeniu konta DHL, Zonos wykonuje testowe wywołanie ratingowe, aby potwierdzić poprawność połączenia, zanim zapisze Twoje dane uwierzytelniające.

Aby zarejestrować się w DHL Express lub skonfigurować konto przez swoje Zonos Dashboard, postępuj zgodnie z krokami w tym przewodniku.

Jak działa połączenie konta przewoźnika DHL 

Połączenie konta DHL:

• Weryfikuje, czy podałeś poprawne typy danych uwierzytelniających dla DHL
• Wykonuje rzeczywiste wywołanie ratingowe do API DHL, aby potwierdzić poprawność danych uwierzytelniających
• Zapisuje Twoje połączone konto w Zonos na potrzeby przyszłych wywołań ratingowych i tworzenia etykiet wysyłkowych
• Zwraca szczegóły połączonego konta, w tym informacje o koncie DHL i typ rate

Po połączeniu, Twoje konto DHL może być używane do uzyskiwania rzeczywistych stawek wysyłkowych na podstawie negocjowanych stawek (jeśli dotyczy) oraz do tworzenia etykiet DHL.

Połącz swoje konto DHL 

Użyj mutacji carrierAccountConnect, aby połączyć swoje konto DHL za pomocą danych uwierzytelniających.

Mutacja

Użyj tej mutacji, aby połączyć swoje konto DHL i zweryfikować dane uwierzytelniające.

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

Zmienne

Mutacja wymaga kodu przewoźnika DHL, typu rate oraz danych konta DHL.

{
  "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 wymaga następujących typów poświadczeń:

• API_KEY - Twój klucz API DHL
• API_PASSWORD - Twoje hasło API DHL
• ACCOUNT_NUMBER - Twój numer konta DHL

Możesz znaleźć te poświadczenia w portalu konta DHL lub kontaktując się z przedstawicielem konta DHL.

Przykłady odpowiedzi

Udane połączenie

Gdy poświadczenia są poprawne i DHL zwraca stawki pomyślnie:

{
  "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"
          }
        ]
      }
    }
  }
}

Błąd: Nieobsługiwany typ poświadczenia

Jeśli podasz typ poświadczenia, którego DHL nie obsługuje:

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

Błąd: Nieprawidłowe dane uwierzytelniające

Jeśli dane uwierzytelniające są prawidłowe, ale nie uwierzytelniają się pomyślnie w DHL:

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

Co się dzieje po połączeniu

Po pomyślnym połączeniu konta DHL w przewoźniku:

• Konto jest przechowywane w Twojej organizacji i powiązane z Twoimi danymi uwierzytelniającymi
• Możesz pobierać stawki wysyłkowe DHL, korzystając ze swoich wynegocjowanych stawek (jeśli dotyczy)
• Możesz tworzyć etykiety wysyłkowe DHL poprzez API Zonos
• Konto przewoźnika może być używane w wielu wysyłkach bez ponownego połączenia

Kolejne kroki 

Po podłączeniu konta DHL w przewoźniku:

• Utwórz przesyłkę - Wygeneruj etykiety wysyłkowe za pomocą Twojego połączonego konta DHL
• Oblicz landed cost - Uzyskaj dokładne wyliczenia ceł i podatków dla przesyłek międzynarodowych
• Zobacz obsługiwane przewoźniki - Zobacz wszystkie dostępne przewoźniki i poziomy usług poprzez Zonos