Zonos をセットアップ
まず Zonos アカウントに登録し、Zonos Dashboard でアカウントを構成します。その後、Zonos API 認証に使用する API キーを取得できます。
基準通貨を設定
landed cost リクエストに含まれる金額に文脈を持たせるため、リクエストの基準通貨コード（ISO 通貨コードとして）を指定する必要があります。これはリクエスト内のすべての金額、および結果として返される landed cost 見積もりがどの通貨で表示されるかを示します。サポートされている通貨とその ISO コードの一覧は、landed cost のドキュメントでご確認いただけます。
{ "currency": "USD"}品目詳細を提供
Zonos を使用して可能な限り正確な landed cost 見積もりを取得するには、HS コード（品目分類番号）を含む、できるだけ多くの品目ごとの詳細情報を提供する必要があります。一般的に、含める情報が多いほど、見積もりの精度は高くなります。
HS コードを提供することで Zonos Landed Cost は最も正確かつ完全な計算を返しますが、HS コードがなくても実際の landed cost を概算することは可能です。ただし、品目の合計金額が de minimis のしきい値を超える場合は、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 を計算するには、配送元（ship-from）と配送先（ship-to）の場所が必要です。配送先については完全な住所が必要ですが、配送元については、多くの 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 Rating API などの配送レーティング API を利用したり、配送業者の配送ソフトウェアや料率表など、その他さまざまな方法で取得できます。
配送コストの合計額を含む配送関連の情報は、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" }
Landed Cost を計算
REST API 経由で Landed Cost をリクエストする方法を学びます。
REST
Zonos Landed Cost API を使用すると、国境を越えた輸入・輸出配送について、非常に精度の高い landed cost 見積もりを迅速に取得できます。HS コード（品目分類番号）を指定することで、Zonos Landed Cost はより正確な関税計算を返しますが、HS コードが指定されていない場合でも、関税および税金の概算額を返します。