Hubungkan Akun DHL Carrier

Hubungkan akun DHL Carrier Anda secara aman untuk mengakses tarif pengiriman yang dinegosiasikan dan membuat label langsung melalui Zonos.

Mulai 

Proses koneksi akun DHL Carrier memvalidasi kredensial Anda dan memastikan akun Anda dikonfigurasi dengan benar untuk mengambil tarif dan menghasilkan label pengiriman. Saat Anda menghubungkan akun DHL Anda, Zonos melakukan panggilan penilaian tes untuk memverifikasi koneksi berfungsi dengan benar sebelum menyimpan kredensial Anda.

Untuk mendaftar dengan DHL Express atau mengatur melalui Zonos Dasbor, ikuti langkah-langkah dalam panduan ini.

Cara kerja koneksi akun DHL Carrier 

Koneksi akun DHL Carrier:

• Memvalidasi bahwa Anda telah menyediakan tipe kredensial yang benar untuk DHL
• Mengirim permintaan penilaian langsung ke DHL API untuk memastikan kredensialnya valid
• Menyimpan akun yang terhubung di Zonos untuk penilaian pengiriman di masa mendatang dan pembuatan label
• Mengembalikan rincian akun yang terhubung, termasuk informasi akun DHL Anda dan tipe rate

Setelah terhubung, akun DHL Carrier Anda dapat digunakan untuk mendapatkan tarif pengiriman waktu nyata berdasarkan tarif yang dinegosiasikan (jika berlaku) dan membuat label pengiriman DHL.

Hubungkan akun DHL Anda 

Gunakan mutasi carrierAccountConnect untuk menghubungkan akun DHL carrier Anda dengan kredensial Anda.

Mutasi

Gunakan mutasi ini untuk menghubungkan akun DHL carrier Anda dan memvalidasi kredensial Anda.

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

Variabel

Mutasi ini memerlukan kode kurir DHL, rate tipe, dan kredensial akun DHL Anda.

{
  "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 membutuhkan tipe kredensial berikut:

• API_KEY - Kunci API DHL Anda
• API_PASSWORD - Kata sandi API DHL Anda
• ACCOUNT_NUMBER - Nomor akun DHL Anda

Anda dapat menemukan kredensial ini di portal akun DHL Anda atau dengan menghubungi perwakilan akun DHL Anda.

Contoh Tanggapan

Koneksi berhasil

Ketika kredensial valid dan DHL mengembalikan tarif dengan sukses:

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

Kesalahan: Tipe kredensial yang tidak didukung

Jika Anda memberikan tipe kredensial yang tidak didukung DHL:

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

Kesalahan: Kredensial tidak valid

Jika kredensialnya valid tetapi tidak berhasil diautentikasi dengan DHL:

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

Apa yang terjadi setelah koneksi

Setelah akun operator DHL Anda berhasil terhubung:

• Akun tersebut disimpan di organisasi Anda dan terkait dengan kredensial Anda
• Anda dapat mengambil tarif pengiriman DHL menggunakan tarif yang dinegosiasikan Anda (jika berlaku)
• Anda dapat membuat label pengiriman DHL melalui Zonos API
• Akun operator dapat digunakan untuk beberapa pengiriman tanpa perlu menyambungkan kembali

Langkah selanjutnya 

Setelah menghubungkan akun operator DHL Anda:

• Buat pengiriman - Hasilkan label pengiriman menggunakan akun operator DHL yang terhubung Anda
• Hitung landed cost - Dapatkan perhitungan bea dan pajak yang akurat untuk pengiriman internasional
• Lihat operator pengiriman yang didukung - Lihat semua operator pengiriman dan tingkat layanan yang tersedia melalui Zonos