標籤服務限制 - Return Helper API

此頁面由 AI 自動翻譯。如有任何疑問或不一致之處，請以英文版本為準。

每種退貨服務類型都會在產生標籤前檢查寄件地址、包裹及品項。違反規則的請求會被拒絕，並回傳指出欄位的驗證錯誤。呼叫取得所有 Return Service Types 查看您的帳戶可使用的服務類型及起運國家。

欄位名稱沿用建立 Return Shipment：shipFrom.* 即 shipment.shipFrom，parcel.* 即 shipment.parcel，items[] 即 shipment.parcel.items[]。
重量單位為克，尺寸單位為公分。長度指字元數。
API 在檢查前會將三個尺寸按由長到短排序，因此 length 一律是最長邊。
截斷至 N 字元：超出的值會被截短為 N 字元，請求繼續處理。對於合計限制，會先從最後一行地址的末尾刪除字元。最多 N 字元：超出的值會被拒絕。
所有服務皆須提供 shipFrom.country、shipFrom.contactName、shipFrom.street1 及 shipFrom.postalCode。下表列出各服務額外的規則。
選填欄位僅在送出時檢查。請直接省略不需要的選填欄位，不要送出空字串。

英國

Royal Mail Tracked Returns 48

服務類型代碼： RETURN_POSTMEN_RM_BIR (Royal Mail Tracked Returns 48), RETURN_RM48_QRCODE_BIR_GBR (Royal Mail Tracked Returns 48 - QR Code)

欄位	必填	限制
shipFrom.country	是	必須為 `gbr`
shipFrom.contactName	是	截斷至 35 字元
shipFrom.street1	是	截斷至 60 字元
shipFrom.street2	否	截斷至 60 字元；street1 + street2 合計截斷至 60 字元
shipFrom.street3	否	最多 60 字元；street1 + street2 + street3 合計截斷至 75 字元
shipFrom.city	是	最多 35 字元
shipFrom.state	否	最多 35 字元
shipFrom.postalCode	是	英國郵遞區號，大寫並含一個空格，例如 `SW1A 1AA`
shipFrom.phone	否	最多 255 字元
shipFrom.email	否	最多 255 字元，有效電子郵件格式
shipFrom.fax	否	最多 255 字元

包裹限制：

限制條件	限制
parcel.weight	必須 > 0
parcel.length	必須 > 0，最大 90 cm
parcel.width	必須 > 0，最大 46 cm
parcel.height	必須 > 0，最大 46 cm
長 + 寬 + 高	length 超過 61 cm 時最大 104 cm

品項限制：

限制條件	限制
items[].weight 總和	必須 > 0
items[].value	必須 > 0，最大 9,999,999.99

DPD

服務類型代碼： RETURN_GBR_DPD_BIR (DPD), RETURN_DPD_QR_BIR (DPD QR CODE)

欄位	必填	限制
shipFrom.country	是	必須為 `gbr`
shipFrom.contactName	是	截斷至 35 字元
shipFrom.street1	是	截斷至 70 字元
shipFrom.street2	否	截斷至 69 字元
shipFrom.street3	否	截斷至 68 字元；street1 + street2 + street3 合計截斷至 70 字元
shipFrom.city	是	1–30 字元，頭尾不可有空格
shipFrom.state	否	最多 30 字元，頭尾不可有空格
shipFrom.postalCode	是	1–8 字元，頭尾不可有空格
shipFrom.phone	是	10–15 字元：可選前導 `+`，其後僅限數字
shipFrom.email	否	最多 255 字元
shipFrom.fax	否	最多 50 字元

包裹限制：

限制條件	限制
parcel.length / width / height	均必須 > 0
最長邊 + 第二長邊	最大 120 cm

品項限制：

限制條件	限制
items[].weight 總和	必須 > 0
items[].value	必須 > 0

InPost – Locker & Shop Drop-off

服務類型代碼： RETURN_INPOST_QR_BIR

欄位	必填	限制
shipFrom.email	是	有效電子郵件格式，單行
shipFrom.phone	是	國際格式的英國手機號碼：`+447` 後接 9 位數字（共 13 字元），例如 `+447700900123`

包裹限制：

限制條件	限制
parcel.weight	必須 > 0
parcel.length	必須 > 0，最大 64 cm
parcel.width	必須 > 0，最大 41 cm
parcel.height	必須 > 0，最大 38 cm

德國

DHL

服務類型代碼： sdhl

欄位	必填	限制
shipFrom.contactName	是	截斷至 35 字元
shipFrom.street1	是	街道名稱。截斷至 35 字元
shipFrom.street2	是	門牌號碼。截斷至 5 字元
shipFrom.city	是	最多 35 字元，頭尾不可有空格
shipFrom.postalCode	是	剛好 5 位數字
shipFrom.phone	否	可選前導 `+`，其後為 1–34 位數字

DHL Retoure

服務類型代碼： RETURN_DHL_ECOMMERCE_DEU (DHL Retoure), RETURN_DHL_ECOMMERCE_INTL_DEU (DHL Retoure International) 所有欄位均不得包含 | 字元。

欄位	必填	限制
shipFrom.country	是	有效的 ISO3 國家代碼
shipFrom.contactName	是	會與您的帳戶名稱（取得 API 帳戶資訊中的 `apiName`）合併。截斷後 contactName、一個空格與 `apiName` 合計不超過 49 字元（`RETURN_DHL_ECOMMERCE_INTL_DEU` 為 26 字元）
shipFrom.street1	是	截斷至 49 字元
shipFrom.street2	是	截斷至 49 字元
shipFrom.street3	否	最多 150 字元
shipFrom.city	否	最多 30 字元
shipFrom.state	否	最多 100 字元
shipFrom.postalCode	是	1–10 字元
shipFrom.phone	否	最多 20 字元：僅限數字及 `- ( ) # +`
shipFrom.email	否	最多 50 字元

包裹限制：

限制條件	限制
parcel.length	必須 > 0，最大 120 cm
parcel.width	必須 > 0，最大 60 cm
parcel.height	必須 > 0，最大 60 cm

品項限制：

限制條件	限制
items[].value	必須 > 0.01

法國

Mondial Relay

服務類型代碼： RETURN_MONDIALRELAY_FRA (Mondial Relay- Dropoff), RETURN_MONDIALRELAY_EU_FRA (Mondial Relay EU- Dropoff)

欄位	必填	限制
shipFrom.country	是	有效的 ISO3 國家代碼
shipFrom.contactName	是	截斷至 27 字元
shipFrom.street1	是	截斷至 40 字元
shipFrom.street2	否	street2 + street3 合計最多 30 字元
shipFrom.street3	否	street2 + street3 合計最多 30 字元
shipFrom.city	是	—
shipFrom.postalCode	是	最多 10 字元
shipFrom.phone	否	最多 20 字元；必須是 `shipFrom.country` 所屬國家的有效電話號碼
shipFrom.email	否	最多 48 字元，有效電子郵件格式

包裹限制：

限制條件	限制
parcel.weight	必須 > 0
parcel.length	必須 > 0，最大 240 cm
parcel.width / height	均必須 > 0
長 + 寬 + 高	必須小於 250 cm

品項限制：

限制條件	限制
items[].value	必須 > 0

美國

FedEx Ground

服務類型代碼： fedex_ground (Fedex Ground-NJ), RETURN_FEDEX_GROUND_WA (Fedex Ground-WA), RETURN_FEDEX_GROUND_USCA (FedEx Ground-CA), RETURN_FEDEX_GROUND_TX (FedEx Ground-TX)

欄位	必填	限制
shipFrom.country	是	必須為 `usa`
shipFrom.contactName	是	截斷至 30 字元
shipFrom.street1	是	截斷至 30 字元
shipFrom.street2	否	截斷至 30 字元
shipFrom.street3	否	截斷至 29 字元。同時送出 street1、street2 及 street3 時：合計最多 59 字元
shipFrom.state	是	剛好 2 字元
shipFrom.postalCode	是	剛好 5 位數字
shipFrom.phone	是	可選前導 `+`，其後為 10–16 位數字或空格
shipFrom.email	否	有效電子郵件格式
shipFrom.fax	否	最多 16 字元

包裹限制：

限制條件	限制
parcel.length / width / height	均必須 > 0
最長邊	最大 274 cm
長度 + 周長	最大 419 cm（最長邊 + 2 × 其餘兩邊，無條件進位）

品項限制：

限制條件	限制
items[].weight 總和	必須 > 0，最大 68,000 g
items[].value	必須 > 0

USPS

服務類型代碼	名稱	長度 + 周長
`RETURN_USPS_NJ`	USPS Priority Mail-NJ	最大 274 cm
`endicia`	USPS Priority Mail-WA	最大 274 cm
`RETURN_USPS_PM_USCA`	USPS Priority Mail-CA	最大 274 cm
`RETURN_USPS_PM_USTX`	USPS Priority Mail-TX	最大 274 cm
`RETURN_USPS_QRCODE_PM_USCA`	USPS QR CODE-PM-CA	最大 274 cm
`RETURN_USPS_QRCODE_PM_USTX`	USPS QR CODE-PM-TX	最大 274 cm
`RETURN_USPS_BROKER_PM_NJ`	USPS QR CODE-PM-NJ
`RETURN_USPS_BROKER_PM_WA`	USPS QR CODE-PM-WA
`RETURN_ENDICIA_USPS_GROUND_ADVANTAGE_NJ`	USPS Ground Advantage-NJ	最大 330 cm
`RETURN_ENDICIA_USPS_GROUND_ADVANTAGE_WA`	USPS Ground Advantage-WA	最大 330 cm
`RETURN_USPS_GA_USCA`	USPS Ground Advantage-CA	最大 330 cm
`RETURN_USPS_GA_USTX`	USPS Ground Advantage-TX	最大 330 cm
`RETURN_USPS_QRCODE_GA_USCA`	USPS QR CODE-GA-CA	最大 330 cm
`RETURN_USPS_QRCODE_GA_USTX`	USPS QR CODE-GA-TX	最大 330 cm
`RETURN_USPS_BROKER_GA_NJ`	USPS QR CODE-GA-NJ
`RETURN_USPS_BROKER_GA_WA`	USPS QR CODE-GA-WA

長度 + 周長 = 最長邊 + 2 × 其餘兩邊。

欄位	必填	限制
shipFrom.country	是	必須為 `usa`
shipFrom.contactName	是	截斷至 100 字元
shipFrom.street1	是	截斷至 50 字元
shipFrom.street2	否	截斷至 50 字元
shipFrom.street3	否	最多 100 字元
shipFrom.city	是	最多 50 字元
shipFrom.state	是	最多 50 字元
shipFrom.postalCode	是	最多 14 字元
shipFrom.phone	是	最多 30 字元
shipFrom.email	是	最多 50 字元，有效電子郵件格式

包裹限制：

限制條件	限制
parcel.weight	必須 > 0，最大 31,751 g
parcel.length / width / height	均必須 > 0

加拿大

Canada Post

服務類型代碼： ubi_ca

欄位	必填	限制
shipFrom.contactName	是	截斷至 50 字元
shipFrom.street1	是	截斷至 45 字元
shipFrom.street2	否	截斷至 41 字元
shipFrom.street3	否	截斷至 80 字元
shipFrom.city	是	最多 50 字元
shipFrom.state	是	最多 80 字元
shipFrom.postalCode	是	最多 16 字元
shipFrom.phone	是	最多 20 字元
shipFrom.email	是	最多 50 字元
orderTitle	是	1–50 字元。必須以字母開頭；僅限字母、數字、空格及 `# / - _ ( )`

包裹限制：

限制條件	限制
parcel.weight	必須 > 0，最大 30,000 g
parcel.length / width / height	均必須 > 0，最大 200 cm

澳洲

AU Post

服務類型代碼： ubi_au

欄位	必填	限制
shipFrom.contactName	是	截斷至 35 字元
shipFrom.street1	是	截斷至 40 字元
shipFrom.street2	否	截斷至 60 字元
shipFrom.street3	否	最多 80 字元
shipFrom.city	是	最多 80 字元
shipFrom.state	是	最多 80 字元
shipFrom.postalCode	是	最多 16 字元
shipFrom.phone	否	最多 20 字元
shipFrom.email	否	最多 50 字元
orderTitle	是	最多 50 字元

包裹限制：

限制條件	限制
parcel.weight	必須 > 0，最大 22,000 g
parcel.length / width / height	均必須 > 0，最大 105 cm
長 × 寬 × 高	最大 250,000 cm³

香港

SF Express

服務類型代碼： sf_hk (SF Express), RETURN_SF_EXPRESS_XB_HKG (SF Express Macao-HK)

欄位	必填	限制
shipFrom.contactName	是	截斷至 30 字元
shipFrom.street1	是	截斷至 39 字元；street1 + street2 合計截斷至 39 字元
shipFrom.street2	否	見 street1
shipFrom.city	否	最多 100 字元
shipFrom.postalCode	是	最多 25 字元
shipFrom.phone	否	可選前導 `+`，其後為 2–15 位數字；首位數字不可為 `0`
shipFrom.email	否	最多 200 字元

包裹限制：

限制條件	限制
parcel.length / width / height	均必須 > 0

品項限制：

限制條件	限制
items[].weight 總和	必須 > 0
items[].value	最多 3 位小數

DHL Express Worldwide（寄往香港）

服務類型代碼： RETURN_SPACESHIP_DHL (DHL- Express Worldwide)

欄位	必填	限制
shipFrom.contactName	是	最多 200 字元
shipFrom.street1	是	最多 70 字元
shipFrom.street2	否	最多 50 字元；street1 + street2 合計最多 96 字元
shipFrom.city	是	最多 30 字元
shipFrom.state	否	最多 35 字元
shipFrom.postalCode	是	最多 9 字元
shipFrom.phone	是	最多 20 字元；必須是 `shipFrom.country` 所屬國家的有效電話號碼
shipFrom.email	否	最多 81 字元，有效電子郵件格式
shipFrom.fax	否	最多 255 字元

包裹限制：

限制條件	限制
parcel.length / width / height	均必須 > 0，僅限整數公分
最長邊	最大 303 cm
長 + 寬 + 高	最大 789 cm

品項限制：

限制條件	限制
items[].description	必填，最多 35 字元
items[].value	必須 >= 0，最多 2 位小數

FedEx International Economy（寄往香港）

服務類型代碼： RETURN_SPACESHIP_FEDEX (Fedex- International Economy)

欄位	必填	限制
shipFrom.contactName	是	最多 200 字元
shipFrom.street1	是	最多 70 字元
shipFrom.street2	否	最多 50 字元；street1 + street2 合計最多 96 字元
shipFrom.city	是	最多 100 字元
shipFrom.state	否	最多 80 字元
shipFrom.postalCode	是	最多 10 字元
shipFrom.phone	是	最多 20 字元；必須是 `shipFrom.country` 所屬國家的有效電話號碼
shipFrom.email	否	最多 81 字元，有效電子郵件格式
shipFrom.fax	否	最多 255 字元

包裹限制：

限制條件	限制
parcel.length / width / height	均必須 > 0，僅限整數公分
最長邊	最大 274 cm
長 + 寬 + 高	最大 302 cm

品項限制：

限制條件	限制
items[].description	必填，最多 35 字元
items[].value	必須 >= 0，最多 2 位小數

UPS Worldwide Express Saver（寄往香港）

服務類型代碼： RETURN_UPS_SV_HKG (UPS Worldwide Express Saver)

欄位	必填	限制
shipFrom.contactName	是	最多 35 字元
shipFrom.street1	是	最多 70 字元
shipFrom.street2	否	最多 50 字元；street1 + street2 合計最多 96 字元
shipFrom.city	是	最多 30 字元
shipFrom.state	否	最多 80 字元
shipFrom.postalCode	是	最多 9 字元。`shipFrom.country` 為 `twn` 時：3 或 5 位數字
shipFrom.phone	是	最多 20 字元；必須是 `shipFrom.country` 所屬國家的有效電話號碼
shipFrom.email	否	最多 81 字元，有效電子郵件格式
shipFrom.fax	否	最多 255 字元

包裹限制：

限制條件	限制
parcel.weight	必須 > 0
parcel.length / width / height	均必須 > 0，僅限整數公分
最長邊	最大 274 cm
長 + 寬 + 高	最大 302 cm
長度 + 周長	最大 400 cm（最長邊 + 2 × 其餘兩邊）

品項限制：

限制條件	限制
items[].weight 總和	必須 > 0
items[].description	必填，最多 35 字元
items[].value	必須 >= 0，最多 2 位小數

日本

Sagawa Express

服務類型代碼： RETURN_SAGAWA_EXPR_JPN

欄位	必填	限制
shipFrom.contactName	是	最多 255 字元
shipFrom.street1	是	最多 255 字元
shipFrom.street2	否	最多 255 字元
shipFrom.state	否	最多 255 字元；僅限日文字元
shipFrom.city	否	最多 255 字元；僅限日文字元
shipFrom.postalCode	是	`NNNNNNN` 或 `NNN-NNNN`
shipFrom.phone	是	僅限數字

包裹限制：

限制條件	限制
parcel.weight	最大 30,000 g
長 + 寬 + 高	最大 160 cm

DHL Express Worldwide（寄往日本及新加坡）

服務類型代碼： RETURN_DHL_WPX_PHY_DROP_JPN (DHL Express Worldwide-JP (Physical Label)-Drop Off), RETURN_DHL_WPX_QR_DROP_JPN (DHL Express Worldwide-JP (QR Code)-Drop Off), RETURN_DHL_WPX_PHY_DROP_SGP (DHL Express Worldwide-SG (Physical Label)-Drop Off), RETURN_DHL_WPX_QR_DROP_SGP (DHL Express Worldwide-SG (QR Code)-Drop Off)

欄位	必填	限制
shipFrom.country	是	有效的 ISO3 國家代碼
shipFrom.contactName	是	最多 255 字元
shipFrom.street1	是	最多 45 字元
shipFrom.street2	否	最多 45 字元
shipFrom.street3	否	最多 45 字元
shipFrom.city	是	最多 45 字元
shipFrom.state	否	最多 35 字元
shipFrom.postalCode	是	最多 12 字元
shipFrom.phone	是	最多 70 字元
shipFrom.email	否	最多 70 字元，有效電子郵件格式

包裹限制：

限制條件	限制
parcel.length / width / height	均必須 > 0

品項限制：

限制條件	限制
items[].weight	必須 > 0
items[].value	必須 > 0

新加坡

SingPost

服務類型代碼： RETURN_SGPPOST_EZY2SHIP

欄位	必填	限制
shipFrom.contactName	是	截斷至 35 字元
shipFrom.street1	是	截斷至 35 字元
shipFrom.street2	否	截斷至 35 字元
shipFrom.street3	否	截斷至 35 字元
shipFrom.city	是	最多 30 字元
shipFrom.state	是	最多 30 字元
shipFrom.postalCode	是	剛好 6 位數字
shipFrom.phone	是	最多 20 字元
shipFrom.fax	否	最多 255 字元

包裹限制：

限制條件	限制
parcel.weight	必須 > 0 且小於 100,000 g
parcel.length / width / height	均必須 > 0，最大 999.99 cm，最多 2 位小數

品項限制：

限制條件	限制
品項數量	最多 20 個
items[].weight	必須 > 0 且小於 100,000 g
items[].weight 總和	必須小於 100,000 g
items[].value	必須 >= 0，最大 9,999,999.99，最多 2 位小數

J&T Express – Drop-off (Point to Door)

服務類型代碼： RETURN_JNT_PUDO_SG

欄位	必填	限制
shipFrom.city	是	—
shipFrom.state	是	—
shipFrom.postalCode	是	剛好 6 字元

包裹限制：

限制條件	限制
parcel.weight	必須 > 0
parcel.length / width / height	均必須 > 0，最大 80 cm
長 + 寬 + 高	最大 240 cm
長 × 寬 × 高	最大 150,000 cm³

品項限制：

限制條件	限制
items[].value	必須 > 0

DHL Express Worldwide（寄往新加坡）

請參閱 DHL Express Worldwide（寄往日本及新加坡）。

台灣

Yamato

服務類型代碼： RETURN_YAMATO_TWN

欄位	必填	限制
shipFrom.contactName	是	最多 30 字元。僅限中文字元、英文字母、數字、空格及 `~!@#$%^&*()_+=-[]{};:'",.?/
shipFrom.phone	是	`09` 後接 8 位數字
shipFrom.city	是	city + street1 + street2 + street3 合計最多 120 字元
orderTitle	是	最多 100 字元

包裹限制：

限制條件	限制
parcel.weight	必須 > 0 且小於 20,000 g
長 + 寬 + 高	最大 150 cm

品項限制：

限制條件	限制
items[].description	最多 20 字元

馬來西亞

DHL eCommerce

服務類型代碼： RETURN_DHL_ECOMMERC_MYS

欄位	必填	限制
shipFrom.contactName	是	截斷至 35 字元
shipFrom.street1	是	截斷至 100 字元；street1 + street2 合計截斷至 100 字元
shipFrom.street2	否	見 street1
shipFrom.city	是	最多 35 字元
shipFrom.postalCode	是	最多 10 字元
shipFrom.phone	是	最多 16 字元。馬來西亞號碼，可選 `+60`，數字之間可用 `-` 或空格分隔，例如 `+60 12-345 6789`

品項限制：

限制條件	限制
items[].weight 總和	最大 30,000 g
items[].value	不得為 0

阿拉伯聯合大公國

EMX

服務類型代碼： RETURN_EMX_ARE

欄位	必填	限制
shipFrom.country	是	有效的 ISO3 國家代碼
shipFrom.contactName	是	最多 48 字元
shipFrom.street1	是	最多 100 字元
shipFrom.street2	否	最多 100 字元
shipFrom.street3	否	最多 100 字元；street1 + street2 + street3 合計最多 100 字元
shipFrom.city	是	最多 100 字元
shipFrom.state	是	最多 255 字元
shipFrom.postalCode	是	最多 64 字元
shipFrom.phone	是	最多 25 字元
shipFrom.email	否	最多 50 字元

包裹限制：

限制條件	限制
parcel.length / width / height	均必須 > 0

品項限制：

限制條件	限制
items[].weight	必須 > 0，最多 3 位小數
items[].description	最多 128 字元
items[].value	必須 > 0，最多 2 位小數

​英國

​Royal Mail Tracked Returns 48

​DPD

​InPost – Locker & Shop Drop-off

​德國

​DHL

​DHL Retoure

​法國

​Mondial Relay

​美國

​FedEx Ground

​USPS

​加拿大

​Canada Post

​澳洲

​AU Post

​香港

​SF Express

​DHL Express Worldwide（寄往香港）

​FedEx International Economy（寄往香港）

​UPS Worldwide Express Saver（寄往香港）

​日本

​Sagawa Express

​DHL Express Worldwide（寄往日本及新加坡）

​新加坡

​SingPost

​J&T Express – Drop-off (Point to Door)

​DHL Express Worldwide（寄往新加坡）

​台灣

​Yamato

​馬來西亞

​DHL eCommerce

​阿拉伯聯合大公國

​EMX

英國

Royal Mail Tracked Returns 48

DPD

InPost – Locker & Shop Drop-off

德國

DHL

DHL Retoure

法國

Mondial Relay

美國

FedEx Ground

USPS

加拿大

Canada Post

澳洲

AU Post

香港

SF Express

DHL Express Worldwide（寄往香港）

FedEx International Economy（寄往香港）

UPS Worldwide Express Saver（寄往香港）

日本

Sagawa Express

DHL Express Worldwide（寄往日本及新加坡）

新加坡

SingPost

J&T Express – Drop-off (Point to Door)

DHL Express Worldwide（寄往新加坡）

台灣

Yamato

馬來西亞

DHL eCommerce

阿拉伯聯合大公國

EMX