DOCS
Landed Cost•
首頁API 參考 Landed Cost REST API 申請 landed cost

申請 landed cost

查找 landed cost 請求中的鍵值對。

儘管 Zonos Landed Cost 僅根據商品描述即可提供準確的 landed cost，但提供的資訊越多，landed cost 報價就會越準確。以下列出必需和選擇性的輸入項，建議盡可能填寫所有選擇性欄位。

強烈建議提供 HS 稅則編號。與基本 landed cost 不同，完整 landed cost 將包含按 HS 稅則編號分列的商品級關稅稅率明細。

屬性 

請求正文中的 JSON 鍵值對

POST | https://api.zonos.com/v1/landed_cost

HEADER zonos-version: 2019-11-21

上述標頭是此 landed cost 請求成功完成所需的輸入。

欄位↕備註↕
currency REQUIRED基礎貨幣字符串，由 三字母 ISO 代碼 表示。
discounts OPTIONAL與任何折扣相關的資訊，包括 ID、金額和任何詳細資訊。
discounts.id OPTIONAL商家或出口商的唯一折扣標識符。
discounts.amount OPTIONAL一個十進制數，以美元和美分表示折扣金額。
discounts.detail OPTIONAL折扣的其他特性、屬性或描述。
items REQUIRED出口商品的清單。hash
items.id REQUIRED商家或出口商的唯一商品標識符。
items.amount REQUIRED一個十進制數，以美元和美分表示單個商品的總額。
items.amount_discount OPTIONAL適用於商品的折扣金額。
items.brand OPTIONAL商品的品牌，例如 Leatherman。
items.category OPTIONAL商品的類別描述，例如 衣服。
items.color OPTIONAL商品的顏色。
items.country_of_origin OPTIONAL製造或生產國，由 兩字母 ISO 代碼 表示。建議使用此欄位以獲得最準確的報價。如果未收到原產國，將使用最惠國 (MFN) 稅率。
items.description_customs OPTIONAL商業發票建議的商品描述。此描述通常與零售描述不同，通常會包括商品是什麼、是什麼製成的以及是什麼用途的一般描述。
items.description_retail OPTIONAL商品的零售描述。
items.detail OPTIONAL商品的其他特性、屬性或描述。
items.dimensions OPTIONAL貨物的大小。建議使用此欄位以獲得最準確的報價，特別是在稅率受商品尺寸影響的國家。hash
items.dimensions.height OPTIONAL商品高度的十進制數。
items.dimensions.length OPTIONAL商品長度的十進制數。
items.dimensions.unit OPTIONAL商品尺寸的測量單位。可能的值為 inch、centimeter、millimeter 和 null。當為 null 時，將使用 inch。
items.dimensions.width OPTIONAL商品寬度的十進制數。
items.duty_tax_fee_free OPTIONAL一個字符串，用於指定商品是否不應包括在 landed cost 計算中。當請求中發送 exclude 時，商品將在 API 回應中的 removed_items 中出現。
items.hs_code OPTIONAL商品 HS 稅則編號，2 到 10 位。
items.image_url OPTIONAL圖像 URL。
items.quantity REQUIRED商品數量的整數。
items.upc_code OPTIONAL商品的 UPC 代碼字符串。
items.weight OPTIONAL商品重量的十進制數。
items.weight_unit OPTIONAL重量的測量單位字符串。可能的值為 pound、ounce、kilogram 和 null。當為 null 時，將使用 pound。
landed_cost OPTIONALlanded cost 請求的類型。可能的值包括 delivery_duty_paid 和 delivery_duty_unpaid。landed cost 的費用可能會有所不同，取決於是以 DDP 還是 DDU 發送。如果為 null，將假設為 DDP 請求。如果進行 DDP 請求且 DDP 不可用，將返回 400 錯誤，並顯示 DDP 不適用於提供的服務級別的訊息。DDP 和 DDU 通常在每個服務級別內都可用，因此請確保可以按服務級別配置，而不是帳戶級別。
sale_type OPTIONAL銷售類型的指示符。可能的值包括 not_for_resale 和 for_resale。如果為 null，將假設為 not_for_resale 請求。
ship_from_country REQUIRED發貨國字符串，由 兩字母 ISO 代碼 表示。
ship_to REQUIRED目的地址。hash
ship_to.city OPTIONAL*客戶的地址城市、城鎮、地區、郊區或村莊的字符串。根據進口國家，此欄位可能是必需的。
ship_to.country REQUIRED銀行帳戶所在目的地國家的字符串，由 兩字母 ISO 代碼 表示。
ship_to.postal_code OPTIONAL*目的地郵遞區號的字符串。當貨物在北愛爾蘭和歐盟之間運送時，此欄位可能是必需的。
ship_to.state OPTIONAL*當可用時目的地州代碼的字符串。如果進口國家是巴西或加拿大，此欄位是必需的。
shipping REQUIRED運輸詳細資訊，例如金額、折扣金額以及承運商的服務級別。hash
shipping.amount REQUIRED以美元和美分表示的運輸成本總額的十進制數。
shipping.amount_discount OPTIONAL適用於運輸的折扣金額的十進制數。
shipping.service_level REQUIRED承運商的 service_level。請參閱 承運商文檔 以了解按承運商提供的可用服務級別的完整清單。

*此欄位根據進口國家的地址欄位要求是選擇性的。

1{
2 "currency": "USD",
3 "discounts": [
4 {
5 "id": "sale124",
6 "amount": 43,
7 "detail": null
8 }
9 ],
10 "items": [
11 {
12 "id": "294395",
13 "amount": 75,
14 "amount_discount": 0,
15 "brand": null,
16 "category": "Women's Clothing",
17 "color": null,
18 "country_of_origin": "FR",
19 "description_customs": null,
20 "description_retail": "Hoka One Running Shoe - Women's",
21 "detail": null,
22 "dimensions": {
23 "height": 4,
24 "length": 6,
25 "unit": "inch",
26 "width": 11
27 },
28 "duty_tax_fee_free": null,
29 "hs_code": "6116.10.00",
30 "image_url": "https://zonos.com/images/handbag.webp",
31 "quantity": 1,
32 "upc_code": null,
33 "weight": 10,
34 "weight_unit": "pound"
35 },
36 {
37 "id": "294396",
38 "amount": 15,
39 "country_of_origin": "CN",
40 "country_of_origin_source": "account_default",
41 "description_customs": "Men's t-shirt 100% polyester",
42 "description_retail": "Galaxy Quest Men's Tee Blue",
43 "detail": null,
44 "dimensions": {
45 "height": 4,
46 "lenght": 6,
47 "unit": "inch",
48 "width": 11
49 },
50 "duty_tax_fee_free": "exclude",
51 "hs_code": "6217.10",
52 "image_url": null,
53 "note": null,
54 "quantity": 1,
55 "upc_code": null,
56 "weight": 1,
57 "weight_unit": "pound"
58 }
59 ],
60 "landed_cost": "delivery_duty_paid",
61 "sale_type": "not_for_resale",
62 "ship_from_country": "US",
63 "ship_to": {
64 "city": "Campinas",
65 "country": "BR",
66 "postal_code": "75828-000",
67 "state": "SP"
68 },
69 "shipping": {
70 "amount": 14.23,
71 "amount_discount": 0,
72 "service_level": "ups_express_saver"
73 },
74 "tariff_rate": "zonos_preferred"
75}

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • 申請 landed cost
  • 屬性