属性
请求正文中的JSON键/值对
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
上述标头是此已落地成本请求成功完成的必需输入。
| 字段↕ | 说明↕ |
|---|---|
currency 必需 | 基础货币字符串，由三字母ISO代码表示。 |
discounts 可选 | 与任何折扣相关的信息，包括ID、金额和任何详细信息。 |
discounts.id 可选 | 商家或出口商的唯一折扣标识符。 |
discounts.amount 可选 | 折扣金额的小数，以美元和美分表示。 |
discounts.detail 可选 | 折扣的附加功能、属性或描述。 |
items 必需 | 被出口的物品列表。hash |
items.id 必需 | 商家或出口商的唯一物品标识符。 |
items.amount 必需 | 单个物品总额的小数，以美元和美分表示。 |
items.amount_discount 可选 | 适用于该物品的折扣金额。 |
items.brand 可选 | 物品的品牌，例如Leatherman。 |
items.category 可选 | 物品的类别描述，例如服装。 |
items.color 可选 | 物品的颜色。 |
items.country_of_origin 可选 | 制造或生产国，由两字母ISO代码表示。为获得最准确的报价，建议提供此项。如果未收到原产国，将使用最惠国（MFN）税率。 |
items.description_customs 可选 | 商业发票商品描述的建议说明。此描述通常与零售描述不同，通常包括其是什么、由什么制成以及用途的一般描述。 |
items.description_retail 可选 | 物品的零售描述。 |
items.detail 可选 | 物品的附加功能、属性或描述。 |
items.dimensions 可选 | 货物的大小。为了在关税受物品尺寸影响的国家获得最准确的报价，建议提供此项。hash |
items.dimensions.height 可选 | 物品高度的小数。 |
items.dimensions.length 可选 | 物品长度的小数。 |
items.dimensions.unit 可选 | 物品尺寸的测量单位。可能的值是inch、centimeter、millimeter和null。当为null时，将使用inch。 |
items.dimensions.width 可选 | 物品宽度的小数。 |
items.duty_tax_fee_free 可选 | 指定物品是否不应包括在已落地成本计算中的字符串。在请求中发送exclude时，该物品将显示在API响应中的removed_items中。 |
items.hs_code 可选 | 物品HS代码，2至10位数字。 |
items.image_url 可选 | 图像URL。 |
items.quantity 必需 | 物品数量的整数。 |
items.upc_code 可选 | 物品的UPC代码字符串。 |
items.weight 可选 | 物品重量的小数。 |
items.weight_unit 可选 | 重量的测量单位字符串。可能的值是pound、ounce、kilogram和null。当为null时，将使用pound。 |
landed_cost 可选 | 已落地成本请求的类型。可能的值包括delivery_duty_paid和delivery_duty_unpaid。已落地成本的费用可能因是否以DDP或DDU发送而异。如果为null，将假设为DDP请求。如果进行DDP请求但DDP不可用，将返回400错误，其中包含说明所提供的服务级别不可用DDP的消息。DDP和DDU通常在每个服务级别内均可用，请确保可以在每个服务级别而不是帐户级别配置此项。 |
sale_type 可选 | 销售类型的指示器。可能的值包括not_for_resale和for_resale。如果为null，将假设为not_for_resale请求。 |
ship_from_country 必需 | 发货国字符串，由两字母ISO代码表示。 |
ship_to 必需 | 目标地址。hash |
ship_to.city 可选* | 客户地址城市、城镇、区、郊区或村庄的字符串。根据进口国，此字段可能是必需的。 |
ship_to.country 必需 | 银行帐户所在的目标国家的字符串，由两字母ISO代码表示。 |
ship_to.postal_code 可选* | 目标邮政编码的字符串。当货物在北爱尔兰和欧盟之间时，此字段可能是必需的。 |
ship_to.state 可选* | 目标州代码的字符串（如果可用）。如果进口国是巴西或加拿大，此字段是必需的。 |
shipping 必需 | 货运详情，例如金额、折扣金额和运营商的服务级别。hash |
shipping.amount 必需 | 运费总额的小数，以美元和美分表示。 |
shipping.amount_discount 可选 | 适用于运费的折扣金额的小数。 |
shipping.service_level 必需 | 与运营商的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已落地成本能够仅基于物品描述提供准确的已落地成本，但提供的信息越多，已落地成本报价的准确性就越高。以下是必需和可选输入，但建议尽可能填入尽可能多的可选字段。