Bundles

正確なlanded costと柔軟なpacking optionでバンドル商品を販売します。

Bundleは単一の（親）単位として販売され、注文作成時に個別のコンポーネント商品に分解される商品です。顧客がBundleを購入すると、Zonosはコンポーネントに分解し、合計が親Bundleの価格と一致するよう各コンポーネントの価格を按分し、個々のコンポーネントに基づいて関税・税金を計算します。

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

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

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

前提条件

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である必要があります。

Bundleの作成

すべてのBundleには少なくとも2つのコンポーネント商品が含まれている必要があります。単一商品のBundleは、代わりに単独のCatalog商品にしてください。

Dashboard > Products > Bundles に移動します。
右上の Add Bundle をクリックします。
BundleのSKUまたはProduct IDを入力します—ストアがZonosに送信する識別子と一致する必要があります。Zonos DashboardのItem key preferenceも正しい識別子に設定されている必要があります。
Bundleのname、price、currencyを入力します。
packing modeとして Assigned box を選択します。
具体的な寸法（長さ、幅、高さ、重量容量）を持つカートンを追加します。
Catalogを検索してコンポーネント商品を追加し、それぞれをカートンに割り当てます。各コンポーネントについて以下を指定します：
- Quantity — このコンポーネントがBundleに含まれる数量
- Box — このコンポーネントが配送されるカートン
- Price ratio — このコンポーネントが占めるBundle価格の割合（空欄の場合は自動計算されます）
Save をクリックします。

Bundleのインポート（CSV）

Manage > Import から2つのインポートオプションを利用できます：

Bundleのインポート

既存のCatalog商品を参照するBundleを作成します。インポート前に、コンポーネント商品はCatalogに既に存在している必要があります。

Dashboard > Products > Bundles に移動します。
Manage > Import bundles をクリックします。
サンプルCSVテンプレートをダウンロードします—Assigned boxまたはAuto-box形式を選択します。
コンポーネント商品ごとに1行を入力します。Bundleレベルのフィールド（SKU、name、price）は同一Bundleの各行で繰り返します。
入力済みCSVをアップロードし、Import をクリックします。

Bundle CSVフィールド

列↕	説明↕
Bundle SKU	ストアに表示されるBundleのSKU。
Bundle Product ID	ストアに表示されるBundleのproduct ID。
Bundle Name	Bundleの名前。
Bundle Description	Bundleの説明。
Bundle Image URL	Bundleの画像URL。
Bundle Amount	Bundleの合計価格。
Bundle Currency	Bundle価格の通貨。例：`USD`。
Box Number	この行のコンポーネントが配送されるカートン番号。例：`1`または`2`。同一カートンのすべてのコンポーネントで同じ番号を使用します。
Box Length	この行のカートンの長さ。
Box Width	この行のカートンの幅。
Box Height	この行のカートンの高さ。
Box Dimensional Unit	カートンの寸法単位。例：`INCH`。
Box Weight Capacity	カートンの最大重量容量。
Box Weight Unit	カートン容量の重量単位。例：`POUND`。
Item SKU	このコンポーネント商品のSKU。既存のCatalog商品と一致する必要があります。
Item Product ID	このコンポーネント商品のproduct ID。既存のCatalog商品と一致する必要があります。
Item Quantity	このコンポーネントがBundleに含まれる数量。

注記： 後方互換性のため、"Bundle"と"Kit"の両方の列プレフィックスが受け入れられます（例："Kit SKU"は"Bundle SKU"と同じように機能します）。

CSVインポートの検証ルール

以下の検証ルールがすべてのBundle CSVインポートに適用されます：

最低2商品 — すべてのBundleには少なくとも2つのコンポーネント商品が含まれている必要があります。単一商品のBundleは、代わりに単独のCatalog商品にしてください。
カートンフィールドはすべてか無しか — assigned-box bundleの場合、6つのカートンフィールド（Box Length、Box Width、Box Height、Box Dimensional Unit、Box Weight Capacity、Box Weight Unit）がすべての行に存在する必要があります。いずれかのカートンフィールドが設定されている場合、6つすべてが必須です。すべてのカートンフィールドが空の場合、Bundleはauto-boxとして扱われます。
packing modeの混在不可 — 1つのBundleでassigned-boxの行（カートン寸法あり）とauto-boxの行（カートン寸法なし）を混在させることはできません。1つのBundleのすべての行は同じモードを使用する必要があります。
HS codeの正規化 — HS codeはインポート時に自動的にフォーマットされます。英数字以外の文字（ピリオド、ハイフン、スペース）は削除され、偶数桁形式に正規化されます。

Bundle + Catalog商品のインポート

Catalog商品とBundleの両方を1回のアップロードで作成します。コンポーネント商品がまだCatalogに存在しない場合に使用します—自動的に作成または更新されます。

Dashboard > Products > Bundles に移動します。
Manage > Import bundles + catalog items をクリックします。
サンプルCSVテンプレートをダウンロードします—Assigned boxまたはAuto-box形式を選択します。
商品詳細列（name、HS code、原産国、計量値）を含め、コンポーネント商品ごとに1行を入力します。
入力済みCSVをアップロードし、Import をクリックします。

インポートはまず子のCatalog商品を作成または更新し、その後それらを参照するBundleを作成します。同じSKUまたはproduct IDの商品が既に存在する場合、その詳細はCSVの値で更新されます。HS codeはインポート時に自動的に正規化されます（英数字以外の文字が削除され、標準の偶数桁形式にフォーマットされます）。

結合CSVフィールド

すべてのBundle CSVフィールドに加えて商品詳細列を含みます：

列↕	説明↕
Bundle SKU	BundleのSKU。
Bundle Product ID	Bundleのproduct ID。
Bundle Name	Bundleの名前。
Bundle Description	Bundleの説明。
Bundle Image URL	Bundleの画像URL。
Bundle Amount	Bundleの合計価格。
Bundle Currency	Bundle価格の通貨。例：`USD`。
Box Number	このコンポーネントが配送されるカートン。
Box Length	カートンの長さ。
Box Width	カートンの幅。
Box Height	カートンの高さ。
Box Dimensional Unit	寸法単位。例：`INCH`。
Box Weight Capacity	カートンの重量容量。
Box Weight Unit	重量単位。例：`POUND`。
Item SKU	コンポーネント商品のSKU。
Item Product ID	コンポーネント商品のproduct ID。
Item Name	Catalog商品の表示名。
Item Description	商品の説明。
Item HS Code	通関分類用のHarmonized System code。
Item Country of Origin	商品の製造国を示す2文字の国コード。例：`CN`。
Item Weight	商品の重量。
Item Weight Unit	重量単位。例：`POUND`。
Item Length	商品の長さ。
Item Width	商品の幅。
Item Height	商品の高さ。
Item Dimensional Unit	商品計量の寸法単位。例：`INCH`。
Item Quantity	このコンポーネントがBundleに含まれる数量。
Item Amount	個別コンポーネント商品の価格。Catalog商品の作成・更新に使用されます。
Item Currency	商品価格の通貨。例：`USD`。
Item Packing Preference	この商品の梱包方法。指定されたカートンで梱包する商品には`ASSIGNED_BOX`、cartonizationには`CONSOLIDATED`、単独配送が必要な商品には`SHIPS_ALONE`を使用します。任意—カートン列がある場合はデフォルトで`ASSIGNED_BOX`になります。

Bundleのエクスポート

Dashboard > Products > Bundles に移動します。
Manage > Export をクリックします。
エクスポートオプションを選択します：
- Export all bundles — すべてのBundleをエクスポートします
- Export assigned box bundles — 事前割り当てカートンを持つBundleのみエクスポートします
- Export auto bundles — auto-box bundleのみエクスポートします
Export をクリックします。準備ができ次第、CSVがメールで送信されます。

Bundleの編集

注記： Bundleの編集は今後の注文にのみ影響します。既に行われ履行済みの注文には影響しません。

Dashboard > Products > Bundles に移動します。
編集するBundleをクリックします。
フィールドを更新し、Save をクリックします。

packing modeの変更、コンポーネントの追加・削除、カートン割り当ての更新、Bundle価格の変更が可能です。

Bundleの削除

単一のBundleを削除するには、Bundleを開いて Delete をクリックします。

複数のBundleを一度に削除するには：

チェックボックスで削除するBundleを選択します。
Delete selected をクリックします。
削除を確認します。

現在のページのすべてのBundleを削除するには、Manage > Delete page をクリックします。

quoterでのBundleの使用

quoterから直接quoteにBundleを追加し、注文前にlanded costをプレビューできます。

quoterのItemsセクションで Search bundles タブに切り替えます。
name、SKU、またはproduct IDでBundleを検索します。
Bundleを選択します。Zonosは自動的に：
- item listでBundleを展開して個別のコンポーネント商品にし、それぞれに独自のHS code、原産国、割引価格を付与します。
- カートンを入力（assigned-box bundleのみ）—Bundleの事前定義されたカートンがBoxesセクションに追加され、寸法が事前入力されます。
- カートン入力をスキップ（auto-box bundle）—quote計算時にcartonizationがカートンを決定します。
コンポーネント商品はitem list内でBundle名の下にグループ化されて表示されます。
quoteを計算します。landed costは実際のBundle構造を反映し—コンポーネントごとの関税、税金、実際または自動決定されたカートン寸法に基づく配送費が計算されます。

同じquoteに複数のBundleと単独商品を追加できます。各Bundleは独立して展開されます。

landed costにおけるBundleの重要性

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

商品ごとのHS codeなし—Zonosは正確な関税率のためコンポーネントを分類できません
実際のカートン寸法なし—事業者の実際のカートンではなく自動パッキングアルゴリズムで配送コストが推定されます
商品ごとの価格なし—コンポーネントごとの割引価格ではなくBundle全額が関税計算に使用されます
商業インボイスの情報が不正確—商業インボイスには個々の商品ではなく1つの商品として表示されます
汎用的なパッキングスリップ—パッキングスリップには注文に含める各商品が表示されず、Bundle全体の単一明細行のみが表示されます

Bundleはコンポーネント分解、カートン割り当て（またはauto-boxグルーピング）、価格配分を事前にZonosに提供することで5つすべてを解決します。結果として、顧客が国境で実際に支払う金額を反映した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とラベル

Assigned-box bundleのコンポーネントは、標準のbin-packingアルゴリズムではなく事業者定義カートンを使用します。各コンポーネントのpackingPreferenceはASSIGNED_BOXに設定され、cartonizationにpackageOptionIdとpackageOptionIdIndexで指定されたカートンに配置するよう指示します。

これがassigned-box bundleの中核的利点です—事業者は商品の配送方法を正確に把握しているため、landed cost計算に使用されるカートン寸法と重量は推定ではなく正確です。

Bundle内の各カートンは独自の追跡番号付き配送ラベルを生成します。2カートンのBundleは2つのラベルを生成します。

混在注文

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

混合Bundle注文

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

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

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

プラットフォーム連携

eコマースプラットフォームごとにBundleの扱いは異なります。以下のセクションでは、サポート対象の各プラットフォームでZonosのBundleがどのように連携するかを説明します。

Shopify

セットアップ

Zonos CatalogのBundle product IDは、Bundle商品のShopify variant IDと一致する必要があります。数値のvariant IDのみを使用してください（例：45271622844730）。完全なGraphQL IDは使用しないでください。商品バリアント表示時のShopify管理URLでvariant IDを確認できます。

注文フロー

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

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

フルフィルメント

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

配送不要の商品

配送不要としてフラグが設定されたShopify商品（デジタルダウンロード、ギフトカードなど）は、landed cost計算から自動的に除外されます。Bundleに物理的なコンポーネントとデジタルコンポーネントが混在している場合、物理的なコンポーネントのみがレーティングとフルフィルメントのためにZonosに送信されます。

BigCommerce

セットアップ

Zonos CatalogのBundle SKUまたはproduct IDは、BigCommerceの商品識別子と一致する必要があります。BigCommerceのproduct IDは数値のみです（例：12345）。そのため、Zonos Bundle定義のproduct IDが数値のBigCommerce product IDであることを確認してください。BigCommerceはカート内の商品を物理商品とデジタル商品にネイティブに分けており、これが混在コンテンツを含むBundleの扱いに影響します。

注文フロー

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

BigCommerceはBundleの明細行をZonosに送信します。
Zonosはproduct IDをCatalog内のBundle定義に照合します。
Zonosはlanded cost計算のためBundleを個別コンポーネントに分解します。
各物理コンポーネントのHS code、原産国、割引価格が正確な関税・税金に使用されます。

Bundle内のデジタル商品

BigCommerceはデジタル商品をサポートしています（例：デジタル編集ソフトウェアのダウンロード）。BigCommerceはフルフィルメント時にデジタル商品へのアクセスを送信するため、デジタル商品をZonosのBundle定義に含めることはできません。通常の最善策は、Bundle内の物理商品にBundleの全額を設定し、Bundleがカートに入っている場合に常にデジタル商品を含めるプロモーションルールをBigCommerceで作成することです。

フルフィルメント

BigCommerceはデジタル商品の配信（メール/ダウンロード）を物理的なフルフィルメントとは別に処理します。物理的なBundleコンポーネントは、配送ラベルと追跡情報とともにZonosを通じてフルフィルメントされます。デジタル商品は購入後にBigCommerceによって自動的に配信されます。

WooCommerce

注意： Zonos CatalogのBundleは現在WooCommerceではサポートされていません。 WooCommerceストアでは、WooCommerce Product Bundlesなどのプラグインを使用してバンドル商品を販売できますが、これらはコンポーネント単位のlanded cost計算のためのZonos Bundle定義とは照合されません。カート内の各商品は単独の商品として扱われます。

現在WooCommerceでBundleを販売している場合、Zonosはカート内の各商品に対して個別にlanded costを計算します。コンポーネントごとのHS codeと正確な関税率を得るには、WooCommerceストアの各コンポーネント商品にZonos Catalog内の正しい分類データがあることを確認してください。

Magento

セットアップ

Zonos CatalogのBundle SKUは、Magentoのproduct entity ID（数値）と一致する必要があります。これはMagento管理画面の商品一覧で確認できます。Magentoにはネイティブのbundle商品タイプがあり、顧客がMagentoのBundleをカートに追加すると、プラットフォームは親商品を単一の明細行としてZonosに送信します。

注文フロー

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

MagentoはBundle親を単一の明細行としてZonosに送信します。
ZonosはSKUをCatalog内のBundle定義に照合し、個別コンポーネントに分解します。
各コンポーネントのHS code、原産国、割引価格がlanded cost計算に使用されます。
注文インポート時、ZonosはMagento注文が顧客のカートと一致するよう、元のMagento Bundle明細行を再構築します。

在庫

Magentoは在庫を親ではなくBundleの子商品で管理します。Bundleが注文されると、各コンポーネントの在庫が個別に減算されます。Bundle親は独自の在庫数を持ちません。

仮想商品とダウンロード商品

Magentoはvirtualおよびdownloadable商品タイプをサポートしています。Bundleに物理的でないコンポーネントが含まれる場合は、それらをZonos Bundle定義から除外し、物理商品のみを含めてください。Magentoは仮想商品とダウンロード商品の配信を別途処理します。

フルフィルメント

Zonosは物理コンポーネントの配送ラベルを作成します。Magento注文には元のBundle明細行が表示されます。追跡番号は注文単位で適用され、Magentoは物理的でないコンポーネントを含むBundle全体の請求書を生成します。

Miva

セットアップ

Zonos CatalogのBundle product IDは、Mivaのproduct code（Miva商品カタログの文字列識別子）と一致する必要があります。Mivaはネイティブのvariant/kitシステムを使用しており、顧客が複数のパーツを含む商品バリアントを選択すると、Mivaはキット情報をZonosに送信します。

注文フロー

顧客がMivaストアでキットを注文すると：

Mivaは商品とそのキット構成をZonosに送信します。
Zonosはproduct codeをCatalog内のBundle定義に照合します。
Zonosはlanded cost計算のためキットを個別コンポーネントに分解します。
Bundleの価格はMivaによって決定されます—Zonosは分解されたコンポーネントに価格比率を適用し、商品ごとの正確な申告価格を算出します。

複数カートンのフルフィルメント

Miva連携は複数カートンでのキットのフルフィルメントをサポートしています。Bundleが複数のカートンで配送される場合、各カートンは注文商品と照合され、独自の追跡番号を持つ個別の出荷が作成されます。

配送不要の商品

Bundleに物理的でない商品が含まれる場合は、Mivaで配送不要としてマークし、Zonos Bundle定義から除外してください。配送不要の商品はZonosに渡され、landed cost計算から除外されます。

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

CatalogItemInput PackagingOptionCreateInput

MUTATIONS

catalogItemCreate catalogItemDelete catalogItemUpdate packagingOptionCreate

デモを予約する

Bundles

Assigned box

Auto-box

Bundleの作成

Bundleのインポート（CSV）

Bundleのエクスポート

Bundleの編集

Bundleの削除

quoterでのBundleの使用

混在注文

Shopify

BigCommerce

WooCommerce

Magento

Miva

このページは役に立ちましたか？