「Zonos」を設定
まず、「Zonos」アカウントに登録し、「Zonos」ダッシュボードでアカウントを設定します。これにより、APIキーを取得でき、「Zonos」APIで認証することができます。
基本通貨を設定
「landed cost」リクエストに含まれる金額に関するコンテキストを提供するために、リクエストの基本通貨コード(ISO通貨コードとして)を指定する必要があります。これにより、リクエスト内のすべての金銭的価値と、結果として得られる「landed cost」見積もりが表示される通貨が参照されます。サポートされている通貨とそのISOコードのリストは、私たち「landed cost」ドキュメントで確認できます。
リクエスト
{
"currency": "USD"
}
アイテムの詳細を提供する
landed cost の正確な見積もりを Zonos を使用して取得するには、ハーモナイズド(HS)コードを含む、可能な限り詳細なアイテム情報を提供する必要があります。一般的に、含める情報が多いほど、見積もりはより正確になります。
HSコードを提供することで Zonos Landed Cost は最も正確で完全な計算を返すことができますが、HSコードなしで実際のlanded costを概算することも可能です。ただし、アイテムの総コストがデミニミスの閾値を超える場合、HSコードが必要になることに注意してください。その場合、HSコードなしでリクエストを送信するとエラーが発生します。
landed cost の見積もりに含めたい各アイテムについて、リクエストボディの items
配列にエントリを追加してください。
リクエスト
{
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
]
}
送料先住所の追加
出荷元および出荷先の場所は、landed costを計算するために必要です。出荷先の完全な住所が必要ですが、ほとんどのlanded costの見積もりには出荷元の国を含めるだけで十分です。
リクエスト
{
"ship_from_country": "US",
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state": "SP"
}
}
配送コストの提供
Zonos Landed Cost APIは配送コストを計算しません - 関税、税金、手数料に焦点を当てています。配送は総landed cost 見積もりの重要な側面であり、計算方法において重要な要素であるため、配送コストを事前に指定することが不可欠です。この値は、Zonos レーティングAPIなどの配送評価APIを使用するか、キャリアの配送ソフトウェア、rate チャートなどのさまざまな手段を通じて取得できます。
配送コストに関連する情報、全体の配送金額を含む情報は、APIリクエストのshipping
フィールドを介して送信されます。
リクエスト
{
"shipping": {
"amount": 14.23
}
}
金額のみが必要ですが、APIが提供された金額に基づいて運送業者の料金を計算できるように、サービスレベル名を提供することもできます。サポートされている運送業者とサービスレベルのリストは、私たちの Landed Cost ドキュメント で確認できます。
リクエスト
{
"shipping": {
"amount": 14.23,
"service_level": "ups_express_saver"
}
}
APIリクエストを送信する
リクエストを構築し、設定したので、Zonos Landed Cost APIにPOST
リクエストを送信できます。APIキーで認証し、リクエストに正しいバージョンヘッダーを提供してください。
POST https://api.zonos.com/v1/landed_cost
リクエスト
{
"currency": "USD",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"description_customs": null,
"hs_code": "6116.10.00",
"quantity": 1
}
],
"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"
}
}
応答
{
"id": "ldct_1AoaDV8MZ8SAmsVFFTWISI",
"amount_subtotal": {
"duties": 53.54,
"fees": 27.64,
"taxes": 33.96
},
"currency": {
"id": "1aad3b7e-c",
"base": "USD",
"date": "2022-09-06T20:57:10.333+0000",
"rates": [
{
"currency": "BRL",
"rate": 5.2499
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 75,
"country_of_origin": "FR",
"country_of_origin_source": "api_request",
"description_customs": null,
"description_retail": null,
"hs_code": "6116.10.00",
"hs_code_source": "api_request",
"note": "",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "BR"
},
"de_minimis": [
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Duty applies to all shipments",
"threshold": "above",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 brl)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [
{
"amount": 45.0,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "item"
},
{
"amount": 8.538,
"description": "Basic customs duty",
"item_id": "294395",
"formula": "60 %",
"note": "Duty is 60% of the items total.",
"type": "shipping"
}
],
"fees": [
{
"amount": 15.0,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
},
{
"amount": 12.0,
"description": "UPS Disbursement Fee",
"item_id": null,
"formula": "2.00% of duties & taxes amount with a minimum of 12 usd, whichever is greater",
"note": null,
"type": "advancement"
},
{
"amount": 0.64,
"description": "UPS Currency Conversion Fee",
"item_id": null,
"formula": ".75% of the amount converted",
"note": null,
"type": "currency_conversion_fee"
}
],
"taxes": [
{
"amount": 16.46,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "item"
},
{
"amount": 3.12,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "shipping"
},
{
"amount": 9.88,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the item",
"type": "duty"
},
{
"amount": 1.87,
"description": "ICMS",
"item_id": "294395",
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": "ICMS on the duty of the shipping",
"type": "duty"
},
{
"amount": 2.63,
"description": "ICMS",
"item_id": null,
"formula": "0.82% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
"note": null,
"type": "advancement"
}
],
"removed_items": [],
"remittance": [],
"landedCostGuaranteeCode": "ZONOS"
}
「landed cost」を計算
REST APIを介して「landed cost」をリクエストする方法を学びます。
REST
「Zonos Landed Cost」APIを使用すると、国境を越えた輸入および輸出の出荷に対して、高精度の「landed cost」見積もりを迅速に取得できます。 調和(HS)コードを提供することで、「Zonos Landed Cost」は最も正確な関税計算を返すことができますが、調和コードが提供されていない場合でも、関税および税金の概算額を返します。