屬性
請求正文中的 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 | 商品的類別描述，例如 衣服。 |
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* | 客戶的地址城市、城鎮、地區、郊區或村莊的字符串。根據進口國家，此欄位可能是必需的。 |
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 登陸成本能夠根據商品的描述提供準確的登陸成本，但提供的資訊越多，登陸成本報價就會越準確。以下是必需和選擇性的輸入項，建議盡可能填寫許多選擇性欄位。