DOCS
Strona głównaGlobalny handel elektroniczny Realizacja zamówień Przewoźnicy Podłącz przez API

Podłącz konto przewoźnika DHL

Bezpiecznie podłącz swoje konto przewoźnika DHL, aby uzyskać dostęp do uzgodnionych stawek wysyłki i tworzyć etykiety bezpośrednio za pośrednictwem Zonos.

Zacznij 

Proces podłączania konta przewoźnika DHL sprawdza poprawność Twoich poświadczeń i upewnia się, że Twoje konto jest prawidłowo skonfigurowane do pobierania stawek i generowania etykiet wysyłkowych. Gdy podłączysz swoje konto DHL, Zonos wykonuje testowe obliczenie stawki, aby zweryfikować, że połączenie działa prawidłowo, przed zapisaniem Twoich poświadczeń.

Aby zarejestrować się w DHL Express lub skonfigurować za pośrednictwem Twojego Zonos Dashboard, postępuj zgodnie z krokami w tym przewodniku.

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

Podłączenie Twojego konta przewoźnika DHL:

  • Sprawdza, czy podałeś prawidłowe typy poświadczeń dla DHL
  • Wykonuje bezpośrednie obliczenie stawki do API DHL, aby potwierdzić poprawność poświadczeń
  • Przechowuje Twoje połączone konto w Zonos do przyszłych obliczeń stawek wysyłki i tworzenia etykiet
  • Zwraca szczegóły połączonego konta, w tym informacje o Twoim koncie DHL i typ stawki

Po podłączeniu Twoje konto przewoźnika DHL można wykorzystać do uzyskania stawek wysyłki w czasie rzeczywistym na podstawie Twoich uzgodnionych stawek (jeśli dotyczy) i tworzenia etykiet wysyłkowych DHL.

Podłącz swoje konto DHL 

Użyj mutacji carrierAccountConnect, aby podłączyć Twoje konto przewoźnika DHL za pomocą Twoich poświadczeń.

Mutacja

Użyj tej mutacji, aby podłączyć Twoje konto przewoźnika DHL i walidować Twoje poświadczenia.

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}

Zmienne

Mutacja wymaga kodu przewoźnika DHL, typu stawki i Twoich poświadczeń DHL.

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 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 Twojego konta DHL lub kontaktując się z przedstawicielem Twojego konta DHL.

Przykłady odpowiedzi

Pomyślne podłączenie

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

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}

Błąd: Nieobsługiwany typ poświadczeń

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

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}

Błąd: Nieprawidłowe poświadczenia

Jeśli poświadczenia są prawidłowymi typami, ale nie uwierzytelniają się pomyślnie w DHL:

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

Co się dzieje po podłączeniu

Po pomyślnym podłączeniu Twojego konta przewoźnika DHL:

  • Konto jest przechowywane w Twojej organizacji i powiązane z Twoimi poświadczeniami
  • Możesz pobierać stawki wysyłki DHL przy użyciu Twoich uzgodnionych stawek (jeśli dotyczy)
  • Możesz tworzyć etykiety wysyłkowe DHL za pośrednictwem API Zonos
  • Konto przewoźnika można wykorzystać w wielu wysyłkach bez ponownego podłączania

Następne kroki 

Po podłączeniu Twojego konta przewoźnika DHL:

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

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

Czy ta strona była pomocna?

Uzyskaj wsparcie·Dokumenty prawne·© 2026 Zonos
Na tej stronie:
  • Podłącz konto przewoźnika DHL
  • Zacznij
  • Jak działa podłączenie konta przewoźnika DHL
  • Podłącz swoje konto DHL
  • Następne kroki