DOCS
Landed Cost•
ホームAPIリファレンス Landed Cost REST API Landed Costのリクエスト

Landed Costのリクエスト

landed costリクエストのキー/値ペアを確認します。

Zonos 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 必須ベース通貨の文字列。3文字のISOコードで表されます。
discounts 任意割引に関する情報。IDや金額、詳細などを含みます。
discounts.id 任意加盟店または輸出者による割引の一意の識別子。
discounts.amount 任意割引額を示す小数値(ドルとセント単位)。
discounts.detail 任意割引の追加的な特徴、属性、または説明。
items 必須輸出される品目のリスト。hash
items.id 必須加盟店または輸出者による品目の一意の識別子。
items.amount 必須1つの品目の合計金額を示す小数値(ドルとセント単位)。
items.amount_discount 任意その品目に適用される割引額。
items.brand 任意品目のブランド。例:Leatherman。
items.category 任意品目のカテゴリの説明。例:衣料品。
items.color 任意品目の色。
items.country_of_origin 任意製造または生産国。2文字の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 任意その品目をlanded costの計算に含めないかどうかを指定する文字列。リクエストで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 任意landed costリクエストの種類。指定可能な値にはdelivery_duty_paidとdelivery_duty_unpaidがあります。landed costの料金はDDPまたはDDUのどちらで送信されるかによって異なる場合があります。nullの場合、DDPリクエストとみなされます。DDPリクエストが行われ、DDPが利用できない場合、提供されたサービスレベルではDDPが利用できないことを示すメッセージとともに400エラーが返されます。DDPとDDUは通常、各サービスレベル内で両方利用可能なため、アカウントレベルではなくサービスレベルごとに設定できるようにしてください。
sale_type 任意販売種別を示す値。指定可能な値にはnot_for_resaleとfor_resaleがあります。nullの場合、not_for_resaleリクエストとみなされます。
ship_from_country 必須発送元国の文字列。2文字のISOコードで表されます。
ship_to 必須配送先の住所。hash
ship_to.city 任意*顧客の住所の市、町、区、郊外、または村を示す文字列。輸入先の国によっては、このフィールドが必須になる場合があります。
ship_to.country 必須銀行口座が所在する配送先国を示す文字列。2文字のISOコードで表されます。
ship_to.postal_code 任意*配送先の郵便番号を示す文字列。北アイルランドと欧州連合(EU)間の配送の場合、このフィールドが必須になることがあります。
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": 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のリクエスト