屬性
請求主體中的 JSON 關鍵/值對
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
上述標題是此著陸成本請求成功完成的必須輸入。
| 欄位↕ | 說明↕ |
|---|---|
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 | 商品類別說明，例如 Clothing。 |
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 | 字串，指定商品是否應排除在著陸成本計算之外。在請求中發送 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 OPTIONAL | 著陸成本請求的類型。可能的值包括 delivery_duty_paid 和 delivery_duty_unpaid。著陸成本的費用可能會有所不同，取決於是否以 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* | 客戶位址城市、城鎮、區域、郊區或村莊的字串。根據進口國家/地區，此欄位可能是 REQUIRED。 |
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": null8
}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": 1127
},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": 1149
},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
}
申請著陸成本
尋找著陸成本請求中的關鍵/值對。雖然 Zonos Landed Cost 能夠根據商品描述提供準確的著陸成本，但提供的資訊越多，著陸成本報價的準確度就越高。以下是 REQUIRED（必須）和 OPTIONAL（可選）輸入，但建議盡可能填入所有可選欄位。