属性
リクエスト本文のJSONキー/値ペア
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
上記のヘッダーは、このlanded costリクエストを正常完了させるために必須の入力です。
| フィールド↕ | 備考↕ |
|---|---|
currency 必須 | The base currency string, represented by a three-letter ISO code. |
discounts 任意 | The information related to any discounts, including the id, amount, and any details. |
discounts.id 任意 | The unique discount identifier for the merchant or exporter. |
discounts.amount 任意 | A decimal with the amount of the discount, in dollars and cents. |
discounts.detail 任意 | Additional features, attributes, or descriptions of the discount. |
items 必須 | The list of items being exported. hash |
items.id 必須 | The unique item identifier for the merchant or exporter. |
items.amount 必須 | A decimal with the total of one single item, in dollars and cents. |
items.amount_discount 任意 | The amount of the discount that applies to the item. |
items.brand 任意 | The brand of the item, e.g., Leatherman. |
items.category 任意 | Category description of the item, e.g., Clothing. |
items.color 任意 | Color of the item. |
items.country_of_origin 任意 | The country of manufacture or production, represented by a two-letter ISO code. This is recommended for the most accurate quotes. If no country of origin is received, the Most Favored Nation (MFN) rate is used. |
items.description_customs 任意 | The suggested description of goods for the commercial invoice. This description will usually differ from a retail description and will typically include a general description of what it is, what it is made from, and what it is used for. |
items.description_retail 任意 | The retail description of the item. |
items.detail 任意 | Additional features, attributes, or descriptions of the item. |
items.dimensions 任意 | The size of the shipment. This is recommended to get the most accurate quotes into countries where tariffs are impacted by the dimensions of the item. hash |
items.dimensions.height 任意 | A decimal for the height of the item. |
items.dimensions.length 任意 | A decimal for the length of the item. |
items.dimensions.unit 任意 | The unit of measurement for the item dimensions.Possible values are inch, centimeter, millimeter, and null.When null, inch will be used. |
items.dimensions.width 任意 | A decimal for the width of the item. |
items.duty_tax_fee_free 任意 | A string to specify if the item should not be included in the landed cost calculation. When exclude is sent in the request, the item will show up in removed_items in the API response. |
items.hs_code 任意 | Item HS code, 2 to 10 digits. |
items.image_url 任意 | The image URL. |
items.quantity 必須 | An integer with the quantity of the item. |
items.upc_code 任意 | The UPC code string for the item. |
items.weight 任意 | A decimal for the weight of the item. |
items.weight_unit 任意 | The unit of measurement string for the weight.Possible values are pound, ounce, kilogram, and null.When null, pound will be used. |
landed_cost 任意 | The type of request for a landed cost.Possible values include delivery_duty_paid and delivery_duty_unpaid.The fees for a landed cost can differ, whether it is sent DDP or DDU. If null, a DDP request will be assumed.If a DDP request is made and DDP is not available, a 400 error will be returned with a message stating that DDP is not available for the service level provided.DDP and DDU are typically both available within each service level, so please ensure that this can be configured on a per-service level basis instead of account-level. |
sale_type 任意 | An indicator of the type of sale.Possible values include not_for_resale for_resale.If null a not_for_resale request will be assumed. |
ship_from_country 必須 | The ship from country string, represented by a two-letter ISO code. |
ship_to 必須 | The destination address. hash |
ship_to.city 任意* | A string for the address city, town, district, suburb, or village of the customer. Depending on the country of import, this field may be 必須. |
ship_to.country 必須 | A string for the destination country in which the bank account is located in, represented by a two-letter ISO code. |
ship_to.postal_code 任意* | A string for the destination postal code. This field may be required when the shipment is between Northern Ireland and the European Union. |
ship_to.state 任意* | A string for the destination state code when available. If the country of import is Brazil or Canada, this field is required. |
shipping 必須 | The shipping details such as the amount, discount amount, and service level with the carrier. hash |
shipping.amount 必須 | A decimal for the sum total of the shipping costs, in dollars and cents. |
shipping.amount_discount 任意 | A decimal for the amount of the discount that applies to the shipping. |
shipping.service_level 必須 | The service_level with the carrier.See the carrier docs for the full list of available service levels by carrier. |
*This field is optional depending on the address field requirements for the country of import.
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
}
Landed Costのリクエスト
landed costリクエストのキー/値ペアを確認します。Zonos Landed Costは品目説明のみでも正確なlanded costを提供できますが、情報が多いほど見積もりはより正確になります。以下は必須および任意の入力ですが、任意フィールドもできるだけ埋めることを推奨します。