Landed Cost•

ホームAPIリファレンス Landed Cost REST API landed costをリクエストする

landed costをリクエストする

landed costリクエストのキー/バリューペアを見つける。

Zonos Landed Costは、アイテムの説明に基づいて正確な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` 必須	基本通貨の文字列で三文字のISOコードで表されます。
`discounts` 任意	割引に関連する情報、ID、金額、および詳細を含みます。
`discounts.id` 任意	商人または輸出者のためのユニークな割引識別子。
`discounts.amount` 任意	割引の金額をドルとセントで表した小数。
`discounts.detail` 任意	割引の追加機能、属性、または説明。
`items` 必須	輸出されるアイテムのリスト。 `hash`
`items.id` 必須	商人または輸出者のためのユニークなアイテム識別子。
`items.amount` 必須	単一アイテムの合計をドルとセントで表した小数。
`items.amount_discount` 任意	アイテムに適用される割引の金額。
`items.brand` 任意	アイテムのブランド、例："Leatherman."
`items.category` 任意	アイテムのカテゴリの説明、例："Clothing."
`items.color` 任意	アイテムの色。
`items.country_of_origin` 任意	製造または生産国で二文字のISOコードで表されます。これは、最も正確な見積もりを得るために推奨されます。原産国が受信されない場合、最恵国待遇（MFN）rateが使用されます。
`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` OPTIONAL	landed costのリクエストのタイプ。可能な値には`delivery_duty_paid`と`delivery_duty_unpaid`が含まれます。landed costの料金は、DDPまたはDDUで送信されるかどうかによって異なる場合があります。`null`の場合、DDPリクエストが想定されます。DDPリクエストが行われ、DDPが利用できない場合、提供されたサービスレベルに対してDDPが利用できないというメッセージと共に400エラーが返されます。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	運送業者とのサービスレベル。利用可能なサービスレベルの完全なリストについては運送業者のドキュメントを参照してください。

*このフィールドは、輸入国の住所フィールドの要件に応じてオプションです。

リクエストの例

{
  "currency": "USD",
  "discounts": [
    {
      "id": "sale124",
      "amount": 43.0,
      "detail": null
    }
  ],
  "items": [
    {
      "id": "294395",
      "amount": 75,
      "amount_discount": 0,
      "brand": null,
      "category": "Women's Clothing",
      "color": null,
      "country_of_origin": "FR",
      "description_customs": null,
      "description_retail": "Hoka One Running Shoe - Women's",
      "detail": null,
      "dimensions": {
        "height": 4,
        "length": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": null,
      "hs_code": "6116.10.00",
      "image_url": "https://zonos.com/images/handbag.png",
      "quantity": 1,
      "upc_code": null,
      "weight": 10,
      "weight_unit": "pound"
    },
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "detail": null,
      "dimensions": {
        "height": 4,
        "lenght": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": "exclude",
      "hs_code": "6217.10",
      "image_url": null,
      "note": null,
      "quantity": 1,
      "upc_code": null,
      "weight": 1,
      "weight_unit": "pound"
    }
  ],
  "landed_cost": "delivery_duty_paid",
  "sale_type": "not_for_resale",
  "ship_from_country": "US",
  "ship_to": {
    "city": "Campinas",
    "country": "BR",
    "postal_code": "75828-000",
    "state": "SP"
  },
  "shipping": {
    "amount": 14.23,
    "amount_discount": 0,
    "service_level": "ups_express_saver"
  },
  "tariff_rate": "zonos_preferred"
}

例の応答

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

{
  "id": "ldct_eab3008d-a8ca-4bd7-bf6d-cd178fe3cd77",
  "amount_subtotal": {
    "duties": 27.74,
    "fees": 15.33,
    "taxes": 16.23
  },
  "currency": {
    "id": "curr_8fb20952-d",
    "base": "USD",
    "date": "2019-11-04T20:42:40.999+0000",
    "rates": [
      {
        "currency": "BRL",
        "rate": 0.2274
      }
    ]
  },
  "customs": {
    "delivery_duty_paid": "available",
    "items": [
      {
        "id": "294395",
        "amount": 32.0,
        "country_of_origin": "FR",
        "country_of_origin_source": null,
        "description_customs": "Women's Tennis Shoe",
        "description_retail": "Hoka One Running Shoe - Women's",
        "detail": null,
        "dimensions": {
          "height": 4.0,
          "length": 6.0,
          "unit": "inch",
          "width": 11.0
        },
        "hs_code": "6116.10.00",
        "hs_code_source": "account_default",
        "image_url": "https://zonos.com/images/handbag.png",
        "note": null,
        "quantity": 1,
        "upc_code": null,
        "weight": 10.0,
        "weight_unit": "pound"
      }
    ],
    "ship_to_country": "BR",
    "shipping_amount": 14.23
  },
  "de_minimis": [
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "duty"
    },
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "tax"
    }
  ],
  "duties": [
    {
      "amount": 19.2,
      "description": "duty",
      "formula": "60%",
      "item_id": "294395",
      "note": "Duty is 60% of the items total.",
      "type": "item"
    },
    {
      "amount": 8.54,
      "description": "Duty",
      "formula": "60%",
      "item_id": null,
      "note": null,
      "type": "shipping"
    }
  ],
  "fees": [
    {
      "amount": 22.0,
      "description": "UPS United States Duty and Tax Forwarding Charge",
      "formula": "15 USD",
      "item_id": null,
      "note": null,
      "type": "ddp_service_fee"
    },
    {
      "amount": 0.33,
      "description": "UPS Currency Conversion Fee",
      "formula": ".75% of the amount converted",
      "item_id": null,
      "note": null,
      "type": "currency_conversion_fee"
    }
  ],
  "removed_items": [
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "hs_code": "6217.10",
      "hs_code_source": "account_default",
      "note": null,
      "quantity": 1
    }
  ],
  "remittance": [],
  "taxes": [
    {
      "amount": 7.02,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": "294395",
      "note": null,
      "type": "item"
    },
    {
      "amount": 3.12,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "shipping"
    },
    {
      "amount": 6.09,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "duty"
    }
  ]
}

このページは役に立ちましたか？

質問は？

お問い合わせください。

Zonosを見る

ポリシーと契約