DOCS

API Aracılığıyla Bağlayın

DHL Taşıyıcı Hesabını Bağlayın

Müzakere edilmiş kargo oranlarına erişmek ve Zonos aracılığıyla doğrudan etiket oluşturmak için DHL taşıyıcı hesabınızı güvenli bir şekilde bağlayın.

Başlayın 

DHL taşıyıcı hesabı bağlantı süreci kimlik bilgilerinizi doğrular ve hesabınızın oranları almak ve kargo etiketleri oluşturmak için doğru şekilde yapılandırıldığından emin olur. DHL hesabınızı bağladığınızda Zonos, kimlik bilgilerinizi depolamadan önce bağlantının doğru çalıştığını doğrulamak için bir test oranlama çağrısı gerçekleştirir.

DHL Express'e kaydolmak veya Zonos Dashboard üzerinden ayarlamak için bu kılavuzdaki adımları izleyin.

DHL taşıyıcı hesabı bağlantısı nasıl çalışır? 

DHL taşıyıcı hesabınızı bağlamak:

  • DHL için doğru kimlik bilgisi türlerini sağladığınızı doğrular
  • Kimlik bilgilerinin geçerli olduğunu onaylamak için DHL API'sine canlı bir oranlama çağrısı yapar
  • Bağlı hesabınızı, gelecekteki kargo oranlaması ve etiket oluşturma için Zonos'ta saklar
  • DHL hesap bilgileriniz ve oran türü dahil olmak üzere bağlı hesap ayrıntılarını döndürür

Bağlandıktan sonra DHL taşıyıcı hesabınız, müzakere edilmiş oranlarınıza (varsa) dayalı gerçek zamanlı kargo oranları almak ve DHL kargo etiketleri oluşturmak için kullanılabilir.

DHL hesabınızı bağlayın 

DHL taşıyıcı hesabınızı kimlik bilgilerinizle bağlamak için carrierAccountConnect mutasyonunu kullanın.

Mutasyon

DHL taşıyıcı hesabınızı bağlamak ve kimlik bilgilerinizi doğrulamak için bu mutasyonu kullanın.

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}

Değişkenler

Mutasyon; DHL taşıyıcı kodunu, oran türünü ve DHL hesap kimlik bilgilerinizi gerektirir.

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 aşağıdaki kimlik bilgisi türlerini gerektirir:

  • API_KEY - DHL API anahtarınız
  • API_PASSWORD - DHL API parolanız
  • ACCOUNT_NUMBER - DHL hesap numaranız

Bu kimlik bilgilerini DHL hesap portalınızda bulabilir veya DHL hesap temsilcinizle iletişime geçerek öğrenebilirsiniz.

Yanıt örnekleri

Başarılı bağlantı

Kimlik bilgileri geçerli olduğunda ve DHL başarıyla oran döndürdüğünde:

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}

Hata: Desteklenmeyen kimlik bilgisi türü

Desteklenmeyen bir kimlik bilgisi türü sağlarsanız:

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}

Hata: Geçersiz kimlik bilgileri

Kimlik bilgileri geçerli türlerde olsa da DHL ile başarıyla kimlik doğrulaması yapmazsa:

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

Bağlantıdan sonra ne olur?

DHL taşıyıcı hesabınız başarıyla bağlandıktan sonra:

  • Hesap, kuruluşunuzda saklanır ve kimlik bilgilerinizle ilişkilendirilir
  • Müzakere edilmiş oranlarınızı kullanarak (varsa) DHL kargo oranlarını alabilirsiniz
  • Zonos API aracılığıyla DHL kargo etiketleri oluşturabilirsiniz
  • Taşıyıcı hesabı, yeniden bağlanmaya gerek kalmadan birden fazla gönderi için kullanılabilir

Sonraki adımlar 

DHL taşıyıcı hesabınızı bağladıktan sonra:

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

Bu sayfa faydalı mıydı?