DOCS

透過 API 連接

首頁全球電商 訂單處理 快遞公司 透過 API 連接

連接 DHL 快遞商帳戶

安全地連接您的 DHL 快遞商帳戶，以取得協商運費並直接透過 Zonos 建立標籤。

開始使用 

DHL 快遞商帳戶連接程序會驗證您的認證資料，並確保您的帳戶已正確設定，以擷取運費和產生運送標籤。連接 DHL 帳戶時，Zonos 會先執行測試評等呼叫，確認連接正常運作，然後才會儲存您的認證資料。

若要向 DHL Express 註冊或透過 Zonos 儀表板設定，請遵循此指南中的步驟。

DHL 快遞商帳戶連接的運作方式 

連接您的 DHL 快遞商帳戶會執行以下作業：

  • 驗證您是否已為 DHL 提供正確的認證類型
  • 向 DHL API 發出即時評等呼叫，以確認認證資料有效
  • 在 Zonos 中儲存您已連接的帳戶，以供未來的運費評等與標籤建立使用
  • 傳回已連接帳戶的詳細資訊，包括您的 DHL 帳戶資訊與運費類型

連接後，您的 DHL 快遞商帳戶即可用於根據您的協商運費（如適用）取得即時運費，並建立 DHL 運送標籤。

連接您的 DHL 帳戶 

使用 carrierAccountConnect 突變（mutation）以您的認證資料連接 DHL 快遞商帳戶。

突變

使用此突變連接您的 DHL 快遞商帳戶並驗證您的認證資料。

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}

變數

此突變需要 DHL 快遞商代碼、運費類型，以及您的 DHL 帳戶認證資料。

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 需要下列認證類型：

  • API_KEY - 您的 DHL API 金鑰
  • API_PASSWORD - 您的 DHL API 密碼
  • ACCOUNT_NUMBER - 您的 DHL 帳戶編號

您可以在 DHL 帳戶入口網站中找到這些認證資料，或聯絡您的 DHL 帳戶代表。

回應範例

連接成功

當認證資料有效且 DHL 成功傳回運費時：

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}

錯誤：不支援的認證類型

如果您提供了 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}

錯誤：認證資料無效

如果認證資料的類型正確，但無法成功向 DHL 進行驗證：

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

連接完成後會發生什麼事

您的 DHL 快遞商帳戶成功連接後：

  • 該帳戶會儲存在您的組織中，並與您的認證資料建立連結
  • 您可以使用您的協商運費（如適用）擷取 DHL 運費
  • 您可以透過 Zonos API 建立 DHL 運送標籤
  • 此快遞商帳戶可用於多次運送，無需重新連接

後續步驟 

連接您的 DHL 快遞商帳戶後：

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

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

預約演示

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • 連接 DHL 快遞商帳戶
  • DHL 快遞商帳戶連接的運作方式
  • 連接您的 DHL 帳戶