Get shipping fees from origin location
返品配送
発送元から Shipping Fees を取得
GET
Get shipping fees from origin location
指定された発送元(国 + 郵便番号)とパーセルの寸法/重量に対して、利用可能な Return Service Types とその料金見積りを返します。他の
/api/ServiceType/* ルックアップに「料金付き」で対応するもので、 Return Shipment を作成 を呼び出す前のプレビューに使用します。プレビュー時点の料金は保証されませんが、同じ入力なら通常は Shipment 作成時に同じ料金になります。
このエンドポイントは Return カタログに料金を付与したものを返します。Resend の出庫サービスにはこのエンドポイントは適用されません — Warehouse で利用可能な Shipment Service Types を取得 から始めてください。Resend の料金はオーダー作成時に決まり、このエンドポイントではプレビューできません。
呼び出すタイミング
- 既知の寸法と重量のパーセルに対して、最安の返品料金を選びたいとき。
- 統合テスト時に、特定の国でアカウントが対応する返品サービスを確認したいとき。
必須パラメータ
fromCountryCode— 必須、小文字 ISO3(例:usa、gbr)。有効な値は すべての発送元国を取得 を参照してください。fromPostalCode— 必須、非空。weight、dimension1、dimension2、dimension3— すべて必須かつ> 0であること。limit— 任意、上限は50。省略時は制限なし(レスポンスは利用可能なサービス数で制限されます)。
レスポンスの注意
- 各エントリは
serviceTypeCode、serviceType(表示名)、warehouseId(返品を受け取る Warehouse)、currencyCode、feeを含みます。 - 一覧は当該発送元でアカウントに有効な返品サービスのみに絞り込まれます。空のレスポンスは、当該発送元で当該サイズ/重量に合うサービスがないことを意味します。
chargeableWeightはキャリアが実際に課金する重量で、容積重量の切り上げによりweightを上回る場合があります。
関連
- Return Shipment を作成 — 選択した
serviceTypeCodeを使用。 - Return Service Types をすべて取得 — サイズ/重量でフィルタしない完全な返品サービス一覧。
- 発送元国/宛先国で Return Service Types を取得 と 発送元国と Warehouse で Return Service Types を取得 — 料金見積りを伴わないより絞り込んだルックアップ。
- すべての国を取得 と すべての発送元国を取得 — 有効な国コード。
承認
Your API key
Your API token — keep this private
クエリパラメータ
ISO3 origin country code
Origin postal code
Parcel weight
Length (longest dimension)
Width (second longest dimension)
Height (shortest dimension)
Maximum number of results
必須範囲:
0 <= x <= 50レスポンス
Success
Shipping fee summary