Bundles

Bundleは単一の（親）単位として販売され、Checkoutで個別のコンポーネント商品に分解される商品です。顧客がBundleを購入すると、Zonosはコンポーネントに分解し、各コンポーネントの価格をBundle価格に合わせて調整し、各コンポーネントのHS codeと原産国に基づいて関税・税金を計算します。

例：事業者がシャツを1着$30で販売するか、4着セットを$100のBundleで販売します。顧客がBundleを購入すると：

• 注文と商業インボイスには 4着のシャツが各$25 と表示されます（1 Bundleで$100、または4着それぞれ$30ではありません）
• 各シャツのHS codeと原産国がlanded cost計算に使用されます
• 配送コストは、事業者が実際に使用するカートンの寸法に基づいて計算されます

パッキングモード 

Bundleは、配送用に商品をどのようにカートンへ梱包するかを制御する2つのpacking modeをサポートします：

Assigned box

事業者が既知の寸法を持つ特定のカートンに商品を事前割り当てします。各カートンは長さ、幅、高さ、重量容量で定義されます。Cartonizationは推定ではなく、これらの正確なカートンを使用します。

最適な用途： どのカートンで配送するか分かっている商品、または常に同じカートンで配送されるBundle。

Auto-box

事業者はカートンを指定せずに商品をBundleにグループ化します。注文時、Zonosはcartonizationアルゴリズムを使用して、商品の寸法と利用可能な梱包オプションに基づいて最適なカートン梱包を決定します。

最適な用途： 梱包が変動するBundle、柔軟な梱包が必要な商品、またはZonosに自動でカートン選択を最適化させたい場合。

どちらのモードも、Bundleを商品ごとのHS code、原産国、割引価格を持つ個別コンポーネントに分解します。違いはカートンの決定方法のみです。

Bundleの仕組み 

CatalogでBundleを作成する際、以下を定義します：

• Bundle SKU or product ID — ストアと一致する商品識別子
• Bundle price — ストアに表示される合計価格
• Packing mode — assigned boxまたはauto-box
• Component items — Bundleに含まれる各個別商品。Catalog商品IDで参照します。Bundleに追加する前に、コンポーネントはCatalog商品として既に存在している必要があります。
• Box assignments（assigned boxのみ）— どのコンポーネントがどのカートンで配送されるか。実際の寸法と重量を使用します。

Bundleを含む注文が行われると、Zonosは自動的に：

1. Bundleを分解して個別コンポーネントにします
2. 各コンポーネントの価格を調整し、計算されたprice ratioで単価がBundle価格に一致するようにします
3. 各コンポーネントのHS code、原産国、カートン寸法を使用してlanded costを計算—正確な関税、税金、配送合計を提供します
4. labelを生成—assigned-box bundleは定義済みカートンごとに1つのlabelを取得し、auto-box bundleはcartonizationの結果に基づいてlabelを取得します

前提条件 

Bundleを作成する前に、以下を確認してください：

• すべてのコンポーネント商品がZonos Catalog内のCatalog商品として存在すること。BundleはCatalog商品IDでコンポーネントを参照します—まだ存在しない商品は追加できません。コンポーネントはストアで個別販売する必要はなく、Catalog内でBundle部品としてのみ存在できます。
• 各コンポーネントに正確なHS code、原産国、計量値（重量と寸法）があること。Bundleが分解される際のlanded cost計算に使用されます。
• BundleのSKUまたはproduct IDが、eコマースプラットフォームがZonosに送信する識別子およびZonos DashboardのItem key preferenceと一致すること。Shopifyストアでは、Bundleのproduct IDはBundle商品のShopify variant IDである必要があります。

landed costにおけるBundleの重要性 

Bundleがない場合、Zonosは単一の明細行（例：「Truck Tire 4-Pack — $1,000」）しか見えず、中身が見えません。これにより問題が発生します：

• 商品ごとのHS codeなし—Zonosは正確な関税率のためコンポーネントを分類できません
• 実際のカートン寸法なし—事業者の実際のカートンではなく自動パッキングアルゴリズムで配送コストが推定されます
• 商品ごとの価格なし—コンポーネントごとの割引価格ではなくBundle全額が関税計算に使用されます

Bundleはコンポーネント分解、カートン割り当て（またはauto-boxグルーピング）、価格配分を事前にZonosに提供することで3つすべてを解決します。結果として、顧客が国境で実際に支払う金額を反映したlanded cost見積もりが得られます。

価格比率とコンポーネント価格 

Bundleが販売される際、Zonosは各コンポーネントの個別価値を把握する必要があります。これは、国際配送では商業インボイスに商品ごとの申告価額が必要であり、関税・税金が各商品ごとに個別に計算されるためです。

priceRatioは、Bundleの合計価格がコンポーネント間でどのように分割されるかを制御します。自分で設定する必要はありません—空欄のままにすると、Zonosは自動的に価格をすべてのコンポーネントに均等に分割します。

例えば、4本のタイヤを含む$1,000のBundleでprice ratioを設定しない場合、各タイヤは自動的に$250（各0.25）で申告されます。コンポーネントの価値が異なる場合—例えば2本がプレミアムタイヤ、2本がスタンダードタイヤの場合—実際の価値差を反映するため0.35や0.15のような比率を手動で設定できます。

Zonosは比率を自動的に正規化するため、計算を気にする必要はありません：

• 一部の比率を空欄のままにすると、残りの値がそれらのコンポーネント間で均等に分割されます
• 比率の合計が正確に1.0にならない場合、Zonosは比例して調整します
• 最終的な比率は常に正確に1.0の合計になります

Cartonizationとlabel 

混在注文

同一注文内の非Bundle商品は、Bundleがどちらのpacking modeを使用しているかに関わらず、標準のcartonizationアルゴリズムで別途梱包されます。

混合Bundle注文 

単一の注文に複数のBundleと単独商品を同時に含めることができます。例えば、以下を含む注文：

• assigned boxの4パックBundle × 1（2カートンで配送）
• auto-boxの3商品Bundle × 1（cartonizationが梱包を決定）
• 単独商品 × 1

Zonosは各Bundleを独立して分解します。landed cost計算は、正確な寸法を持つすべてのカートンとすべての個別コンポーネント価格をカバーします。各カートンに独自のlabelが付きます。

Shopify連携 

Shopifyストアで使用する場合、Bundleには特定の動作があります。

セットアップ

Zonos CatalogのBundle product IDは、Bundle商品のShopify variant IDと一致する必要があります。これによりZonosはShopify明細行をBundle定義に照合します。商品バリアント表示時のShopify管理URLでvariant IDを確認できます。

注文フロー

顧客がShopifyストアでBundleを注文すると：

1. ShopifyはBundle親の単一明細行を送信します（例：「Truck Tire 4-Pack x 1」）。
2. Zonosは明細行のvariant IDをCatalog内のBundle product IDに照合します。
3. Zonosはlanded cost計算のためBundleを個別コンポーネントに分解します—各コンポーネントのHS code、原産国、割引価格が正確な関税・税金に使用されます。
4. Shopify注文は引き続き単一のBundle明細行を表示します—コンポーネント分解はZonosが完全に処理します。

フルフィルメント

フルフィルメント作成時、Zonosは分解されたBundleコンポーネントを元のShopify Bundle明細行に再マッピングします。事業者はShopifyでBundle親の履行を確認します（例：「Truck Tire 4-Pack x 1 fulfilled」）が、商業インボイスと通関書類は各コンポーネントを個別に記載します。