DOCS

Kết nối qua API

Trang chủThương mại điện tử toàn cầu Xử lý đơn hàng Nhà vận chuyển Kết nối qua API

Kết nối Tài khoản Nhà cung cấp DHL

Kết nối tài khoản nhà cung cấp DHL của bạn một cách an toàn để truy cập các tỷ giá đã thương lượng và tạo nhãn trực tiếp thông qua Zonos.

Bắt đầu 

Quá trình kết nối tài khoản nhà cung cấp DHL xác thực thông tin đăng nhập của bạn và đảm bảo tài khoản của bạn được định cấu hình đúng cách để truy xuất tỷ giá và tạo nhãn vận chuyển. Khi bạn kết nối tài khoản DHL của mình, Zonos sẽ thực hiện lệnh gọi xếp hạng kiểm tra để xác minh rằng kết nối hoạt động chính xác trước khi lưu trữ thông tin đăng nhập của bạn.

Để đăng ký với DHL Express hoặc thiết lập thông qua Bảng điều khiển Zonos của bạn, hãy làm theo các bước trong hướng dẫn này.

Cách hoạt động của kết nối tài khoản nhà cung cấp DHL 

Kết nối tài khoản nhà cung cấp DHL của bạn:

  • Xác thực rằng bạn đã cung cấp các loại thông tin đăng nhập chính xác cho DHL
  • Thực hiện lệnh gọi xếp hạng trực tiếp tới API DHL để xác nhận rằng thông tin đăng nhập có hiệu lực
  • Lưu trữ tài khoản đã kết nối của bạn trong Zonos để xếp hạng lô hàng và tạo nhãn trong tương lai
  • Trả về chi tiết tài khoản đã kết nối, bao gồm thông tin tài khoản DHL và loại tỷ giá của bạn

Sau khi kết nối, tài khoản nhà cung cấp DHL của bạn có thể được sử dụng để nhận tỷ giá vận chuyển thời gian thực dựa trên tỷ giá đã thương lượng của bạn (nếu có) và tạo nhãn vận chuyển DHL.

Kết nối tài khoản DHL của bạn 

Sử dụng mutation carrierAccountConnect để kết nối tài khoản nhà cung cấp DHL của bạn với thông tin đăng nhập của bạn.

Mutation

Sử dụng mutation này để kết nối tài khoản nhà cung cấp DHL của bạn và xác thực thông tin đăng nhập của bạ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}

Biến

Mutation yêu cầu mã nhà cung cấp DHL, loại tỷ giá và thông tin đăng nhập tài khoản DHL của bạn.

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 yêu cầu các loại thông tin đăng nhập sau:

  • API_KEY - Khóa API DHL của bạn
  • API_PASSWORD - Mật khẩu API DHL của bạn
  • ACCOUNT_NUMBER - Số tài khoản DHL của bạn

Bạn có thể tìm thấy những thông tin đăng nhập này trong cổng thông tin tài khoản DHL của bạn hoặc bằng cách liên hệ với đại diện tài khoản DHL của bạn.

Ví dụ phản hồi

Kết nối thành công

Khi thông tin đăng nhập có hiệu lực và DHL trả về tỷ giá thành công:

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}

Lỗi: Loại thông tin đăng nhập không được hỗ trợ

Nếu bạn cung cấp một loại thông tin đăng nhập mà DHL không hỗ trợ:

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}

Lỗi: Thông tin đăng nhập không hợp lệ

Nếu thông tin đăng nhập là các loại hợp lệ nhưng không xác thực thành công với DHL:

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

Điều gì xảy ra sau khi kết nối

Sau khi tài khoản nhà cung cấp DHL của bạn được kết nối thành công:

  • Tài khoản được lưu trữ trong tổ chức của bạn và được liên kết với thông tin đăng nhập của bạn
  • Bạn có thể truy xuất tỷ giá vận chuyển DHL bằng cách sử dụng tỷ giá đã thương lượng của bạn (khi có)
  • Bạn có thể tạo nhãn vận chuyển DHL thông qua API Zonos
  • Tài khoản nhà cung cấp có thể được sử dụng trên nhiều lô hàng mà không cần kết nối lại

Các bước tiếp theo 

Sau khi kết nối tài khoản nhà cung cấp DHL của bạn:

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

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

Đặt lịch demo

Trang này có hữu ích không?

Nhận hỗ trợ·Tài liệu pháp lý·© 2026 Zonos
Trên trang này:
  • Kết nối Tài khoản Nhà cung cấp DHL
  • Bắt đầu
  • Cách hoạt động của kết nối tài khoản nhà cung cấp DHL
  • Kết nối tài khoản DHL của bạn
  • Các bước tiếp theo