Landed Cost を計算

landed cost リクエストに含まれる金額に文脈を持たせるため、リクエストの基準通貨コード（ISO 通貨コードとして）を指定する必要があります。これはリクエスト内のすべての金額、および結果として返される landed cost 見積もりがどの通貨で表示されるかを示します。サポートされている通貨とその ISO コードの一覧は、landed cost のドキュメントでご確認いただけます。

Zonos を使用して可能な限り正確な landed cost 見積もりを取得するには、HS コード（品目分類番号）を含む、できるだけ多くの品目ごとの詳細情報を提供する必要があります。一般的に、含める情報が多いほど、見積もりの精度は高くなります。

HS コードを提供することで Zonos Landed Cost は最も正確かつ完全な計算を返しますが、HS コードがなくても実際の landed cost を概算することは可能です。ただし、品目の合計金額が de minimis のしきい値を超える場合は、HS コードが必要になることがあります。その場合、HS コードを指定せずにリクエストを送信するとエラーになります。

landed cost 見積もりに含めたい品目ごとに、リクエストボディの items 配列にエントリを追加してください。

landed cost を計算するには、配送元（ship-from）と配送先（ship-to）の場所が必要です。配送先については完全な住所が必要ですが、配送元については、多くの landed cost 見積もりでは国名のみで十分です。

Zonos Landed Cost API は配送コストそのものを計算するものではなく、関税・税金・手数料の計算に重点を置いています。配送コストは landed cost 見積もり全体の重要な要素であり、計算方法にも大きく影響するため、事前に配送コストを指定することが必須です。この値は、Zonos Rating API などの配送レーティング API を利用したり、配送業者の配送ソフトウェアや料率表など、その他さまざまな方法で取得できます。

配送コストの合計額を含む配送関連の情報は、API リクエストの shipping フィールドで送信します。

必須なのは金額のみですが、サービスレベル名も併せて指定することで、API が指定した金額をもとに配送業者の手数料を計算できるようになります。サポートされている配送業者とサービスレベルの一覧は、Landed Cost のドキュメントでご確認いただけます。

リクエストの構築と設定が完了したら、Zonos Landed Cost API に POST リクエストを送信できます。API キーで認証し、リクエストに正しいバージョンヘッダーを指定してください。

POST https://api.zonos.com/v1/landed_cost