DOCS

API üzerinden Bağlan

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

Güvenli bir şekilde DHL taşıyıcı hesabınızı bağlayarak müzakere edilen kargo oranlarına erişin ve Zonos üzerinden doğrudan etiketler oluşturun.

Başlarken 

DHL taşıyıcı hesabı bağlantı süreci kimlik bilgilerinizi doğrular ve hesabınızın oranları almak ve gönderim 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 saklamadan önce bağlantının doğru şekilde çalıştığını doğrulamak için bir test oranlama çağrısı yapar.

DHL Express'e kaydolmak veya Zonos Kontrol Paneliniz üzerinden kurulum yapmak için bu Kılavuz adresindeki 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 doğrulamak için DHL API'sine canlı bir oranlama çağrısı yapar
  • Gelecek gönderi oranı değerlendirmeleri ve etiket oluşturma için bağlı hesabınızı Zonos içinde saklar
  • Bağlı hesapla ilgili ayrıntıları döndürür; bunlar DHL hesap bilgileriniz ve rate türüdür

Bağlandıktan sonra DHL taşıyıcı hesabınız, müzakere edilen oranlarınıza dayanarak gerçek zamanlı kargo ücretlerini almak ve DHL gönderi etiketleri oluşturmak için kullanılabilir (uygulanabilir ise).

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

Bu mutasyonu kullanarak DHL taşıyıcı hesabınızı bağlayın ve kimlik bilgilerinizin geçerli olduğunu doğrulayın.

MUTASYON

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) {
  carrierAccountConnect(input: $input) {
    errors
    carrierAccount {
      credentialProvider
      id
      integrationType
      organization
      rateType
      carrier {
        id
        code
        name
      }
      credentials {
        type
        value
      }
    }
  }
}

Değişkenler

Bu mutasyon DHL taşıyıcı kodunu, rate türünü ve DHL hesap bilgileriniz gerektirir.

DEĞİŞKENLER

json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "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'in aşağıdaki kimlik doğrulama türleri gereklidir:

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

Bu kimlik bilgilerini DHL hesap portalınızda bulabilir veya DHL hesap temsilcinize başvurarak edinebilirsiniz.

Yanıt örnekleri

Başarılı bağlantı

Kimlik bilgileriniz geçerli olduğunda ve DHL oranları başarıyla döndürüldüğünde:

CEVAP

json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "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"
          }
        ]
      }
    }
  }
}

Hata: Desteklenmeyen kimlik türü

DHL'nin desteklemediği bir kimlik türü sağlarsanız:

HATA

json

1
2
3
4
5
6
7
8
{
  "data": {
    "carrierAccountConnect": {
      "errors": ["Credential type SITE_ID is not supported by carrier DHL"],
      "carrierAccount": null
    }
  }
}

Hata: Geçersiz kimlik bilgileri

Kimlik bilgileriniz geçerli türde olsa bile DHL ile kimlik doğrulaması başarılı şekilde yapılamıyorsa:

HATA

json

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

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
  • Görüşmeleriniz sonucunda elde ettiğiniz oranları kullanarak DHL gönderi ücretlerini alabilirsiniz (uygulanabilir olduğunda)
  • DHL gönderi etiketlerini Zonos API'si üzerinden oluşturabilirsiniz
  • Taşıyıcı hesap, yeniden bağlamadan birden çok gönderide kullanılabilir

Sonraki adımlar 

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

Bu sayfa faydalı mıydı?