DOCS

Hubungkan melalui API

BerandaEcommerce global Pemenuhan Operator Pengiriman Hubungkan melalui API

Hubungkan Akun Pembawa DHL

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

Memulai 

Proses koneksi akun pembawa DHL memvalidasi kredensial Anda dan memastikan akun Anda dikonfigurasi dengan benar untuk mengambil tarif dan membuat label pengiriman. Ketika Anda menghubungkan akun DHL, Zonos melakukan panggilan pemeringkatan tes untuk memverifikasi koneksi berfungsi dengan benar sebelum menyimpan kredensial Anda.

Untuk mendaftar dengan DHL Express atau menyiapkan melalui Dashboard Zonos Anda, ikuti langkah-langkah dalam panduan ini.

Bagaimana koneksi akun pembawa DHL bekerja 

Menghubungkan akun pembawa DHL Anda:

  • Memvalidasi bahwa Anda telah menyediakan jenis kredensial yang benar untuk DHL
  • Membuat panggilan pemeringkatan langsung ke API DHL untuk mengonfirmasi kredensial valid
  • Menyimpan akun terhubung Anda di Zonos untuk pemeringkatan pengiriman dan pembuatan label di masa depan
  • Mengembalikan detail akun terhubung, termasuk informasi akun DHL Anda dan jenis tarif

Setelah terhubung, akun pembawa DHL 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 pembawa DHL Anda dengan kredensial Anda.

Mutasi

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

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}

Variabel

Mutasi memerlukan kode pembawa DHL, jenis tarif, dan kredensial akun DHL Anda.

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 memerlukan jenis 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 respons

Koneksi berhasil

Ketika kredensial valid dan DHL mengembalikan tarif dengan sukses:

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}

Kesalahan: Jenis kredensial tidak didukung

Jika Anda menyediakan jenis kredensial yang tidak didukung DHL:

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}

Kesalahan: Kredensial tidak valid

Jika kredensial adalah jenis valid tetapi tidak berhasil diautentikasi dengan DHL:

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

Apa yang terjadi setelah koneksi

Setelah akun pembawa DHL Anda berhasil terhubung:

  • Akun disimpan di organisasi Anda dan ditautkan ke kredensial Anda
  • Anda dapat mengambil tarif pengiriman DHL menggunakan tarif yang dinegosiasikan Anda (jika berlaku)
  • Anda dapat membuat label pengiriman DHL melalui API Zonos
  • Akun pembawa dapat digunakan di berbagai pengiriman tanpa terhubung kembali

Langkah selanjutnya 

Setelah menghubungkan akun pembawa DHL Anda:

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

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

Pesan demo

Apakah halaman ini bermanfaat?

Dapatkan dukungan·Dokumen hukum·© 2026 Zonos
Di halaman ini:
  • Hubungkan Akun Pembawa DHL
  • Memulai
  • Bagaimana koneksi akun pembawa DHL bekerja
  • Hubungkan akun DHL Anda
  • Langkah selanjutnya