APIを使用した出荷ゾーンの設定

シッピングゾーン（ゾーン）とは、出発地と目的地の郵便番号によって定義される地理的なエリアの集まりである。 これらのゾーンは、通過時間と通過率が似ている。 輸送業者は、輸送ゾーンを使用して、そのエリア内のすべての貨物に適用される輸送期間と料金を決定する。 APIを使用して出荷ゾーンを設定することができます。

ゾーンとトランジットタイムの設定

ゾーンとトランジット・コンポーネントを設定するには、 Upload shipping zone components API を参照のこと。

// Upload zone components with transit duration:
zone,origin_country,destination_country,origin_postal_code_begin,origin_postal_code_end,destination_postal_code_begin,destination_postal_code_end,transit_duration
ZONE_US_001,US,US,19533,19533,40000,41899,P3DT0H
ZONE_GB_001,GB,GB,E16 0AA,E16 0AA,AB1 0,AB1 9,P2DT0H

キャリアサービスのゾーン定義のアップロード

新しいゾーンを導入したい場合の使用例を考えてみましょう：
  • 新しい店舗をオープンすることになり、新しい店舗の郵便番号をゾーンとして導入したい。
  • 配送先の郵便番号が変更されました。

既存のキャリアサービスに新しいゾーンを導入する場合は、新しいゾーンが以前にアップロードしたゾーンと重複しないようにしてください。 キャリアサービスが動作するゾーンを指定するには、 Upload zone definitions APIを使用する。

キャリアサービスの既存の郵便番号のゾーン定義を変更するには、まず、 Delete carrier zones for a carrier service APIを使用して、キャリアサービスの既存のゾーンをすべて削除します。

特定のゾーンコンポーネントまたはルートを作成または更新する

キャリアサービスの特定のゾーンコンポーネントまたはゾーン内のルートのトランジット期間を作成または更新するには、次のコマンドを使用します：
POST /cas/{tenantId}/v1/configuration/carrierServices/{carrierServiceId}/zones/_bulkUpsert API

出荷ゾーンのコンポーネントを削除する

出荷ゾーンのコンポーネントを削除したい場合の使用例を以下に示す：

  • 新しいゾーンを作成したり、特定の店舗の郵便番号を並べ替えたりしています。
  • 店舗を閉鎖する場合、または店舗が特定地域への配送対象外となった場合。
  • 間違ってコンポーネントを一括アップロードしてしまい、元に戻したい。
  • ゾーンコンポーネントをある出荷ゾーンから別の出荷ゾーンに移動したい。 この場合、既存のゾーンコンポーネントを削除し、新しい出荷ゾーンを参照して再アップロードする必要があります。
前述のいずれのユースケースについても、特定のキャリアサービス用に構成されたすべての配送ゾーンコンポーネントを削除するには、 Delete shipping zone components APIを使用します。
注： 郵便番号範囲や配送ゾーンなど、異なるパラメータを持つコンポーネントを再作成するためにAPIを使用する場合は、重複を防ぐために既存のコンポーネントを削除する必要があります。

競合するコンポーネントを削除する前に、必ず新しいショッピング・ゾーン・コンポーネントを作成してください。 特定の輸送会社サービス用に新しい出荷ゾーンのコンポーネントが作成された場合、競合するコンポーネントを削除することで、ゾーンの重複やギャップが解消される。

ゾーンを作成し、トランジットの所要時間と料金を指定するには、以下のシナリオが利用可能です：
  • 国内配送のシナリオを処理するためにゾーンを作成します。
  • 国際配送のシナリオを処理するためにゾーンを作成します。
  • 各ゾーンの通過時間を指定する。
  • 各ゾーンの通過料金を指定する。

詳しくはキャリアゾーンを参照。

輸送期間と輸送遅延

出荷ゾーンを設定すると同時に、以下のAPIのいずれかを使用して、輸送期間と輸送遅延を設定することもできます：詳細については、 APIを使用したトランジット期間の設定を参照してください。

追加料金

サーチャージは、出荷コンポーネントを設定する際に設定することも、個別に設定することもできます。 詳細については、 APIを使用したゾーン・コンポーネント追加料金の設定を参照のこと。