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.
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 stawki i Twoich poświadczeń 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 DHLAPI_PASSWORD- Twoje hasło API DHLACCOUNT_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:
{ "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świadczeń
Jeśli podasz typ poświadczeń, 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 poświadczenia
Jeśli poświadczenia są prawidłowymi typami, ale nie uwierzytelniają się pomyślnie w DHL:
{ "data": { "carrierAccountConnect": { "errors": [ "Failed to get rating from DHL API" ], "carrierAccount": null } }}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:
- Utwórz wysyłkę - Generuj etykiety wysyłkowe przy użyciu Twojego podłączonego konta przewoźnika DHL
- Oblicz całkowity koszt - Uzyskaj dokładne obliczenia cła i podatku dla wysyłek międzynarodowych
- Wyświetl obsługiwanych przewoźników - Zapoznaj się ze wszystkimi przewoźnikami i poziomami usług dostępnymi za pośrednictwem Zonos
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.