New Bundle
Table of Contents
1. Feature Overview
This page is for creating a new bundle one at a time: first fill in the bundle's own name, SKU, and barcode, then list which single items it contains and how many of each per set. Once created, whenever an order carries this bundle's SKU, the system automatically expands it into the single items inside for picking, shipping, and stock deduction — the bundle itself holds no physical stock. It is ideal for setting up fixed combinations of single items (gift sets, kits) once.

Fields marked with * are required.
Jump to: Bundle basics | Stock push ratio exceptions | Setting bundle contents
1.1 Bundle basics
Before creating, you must choose which merchant this bundle belongs to; the single items you add afterwards can only be chosen from that same merchant.
| Field | How to fill | Notes |
|---|---|---|
| *Bundle Name | Enter the bundle's public name, e.g. "Bath Gift Set" | Required |
| *SKU | Enter the bundle's SKU; it must match this bundle's SKU on the marketplace | Required; orders rely on this SKU to match the bundle and auto-expand it |
| Barcode | Enter the bundle's barcode | Optional |
| Activated | On means it can be sold normally; off means this bundle's operations are suspended | On by default |
1.2 Stock push ratio exceptions
A bundle holds no stock of its own. The quantity pushed to a marketplace is the number of sets its single items can make, multiplied by a push ratio. By default every e-commerce account uses its own "Push Percentage"; you only need to add an exception under "Stock push ratio exceptions (optional)" when the merchant wants a specific account to use a different ratio for this bundle. You can set it while creating the bundle — no need to save first.
| Action | How | Notes |
|---|---|---|
| Add an exception | Click "Add exception" and pick an e-commerce account from the dropdown; the account's current push percentage is filled in, then change it to the number needed | "Push ratio" is required; each account can have only one row |
| Go back to the account's default | Delete that account's row and save | An empty ratio can't be saved — delete the whole row to go back to the default |
| Set more than 100% | Allowed, for merchants who deliberately push more than they have (overselling) | A yellow warning appears when a single row exceeds 100% or the ratios across accounts add up to more than 100% (counted per warehouse actually used; accounts without a fulfillment warehouse count toward the default warehouse) |
The dropdown only lists this merchant's e-commerce accounts whose "Stock Push Method" is not "Off" and whose sales channel has "Product Mapping Rule" set to "By SKU" (unset counts as by SKU). Accounts using another rule are listed in the blue notice above: when platform orders come back, only channels that map by SKU can recognize a bundle, so bundle stock isn't pushed to those accounts.
How the pushed quantity is calculated
For each single item, take "sellable quantity ÷ quantity per set" (rounded down), take the smallest of these, then multiply by the push ratio (rounded down). For example, item A has 10 sellable and each set needs 2 (5 sets), item B has 3 sellable and each set needs 1 (3 sets): at 100% the push is 3; at 50% it's 1.
- An item's sellable quantity only counts stock this channel can ship: only stock in the e-commerce account's "Fulfillment Warehouse" counts (the merchant's default warehouse when none is specified), not other warehouses; an item with a specific inventory type counts only that type; "Default Inventory Type" counts only the sales channel's primary inventory type (the secondary inventory type only serves as a backup during allocation); stock that doesn't meet the channel's expiration requirement is excluded.
- An item that has its own stock push turned off still counts toward the bundle's buildable sets.
- After a bundle is deactivated or deleted, the next "Manual Stock Sync" sets this bundle's platform stock to 0 — unless its SKU is now used by another product or bundle, in which case 0 is not pushed so that item's platform stock isn't wiped out.
- Bundle quantities are recalculated and pushed when "Manual Stock Sync" is clicked on the e-commerce account detail page. When the account's "Stock Push Method" is "Scheduled sync (every 30 min)", a bundle whose component stock counted for that account (the sales channel's inventory types or those specified in the bundle, in the fulfillment warehouse), contents, push ratio, or active status changed is also recalculated and pushed in the next scheduled round (within about 30 minutes). "Push on inbound" doesn't include bundles. See EC Account Details for the conditions.
1.3 Setting bundle contents
Click "Add Product" to add the single items in the bundle row by row; each row is configured as follows:
| Field | How to fill | Notes |
|---|---|---|
| *Name | Search and select the single item to include | Required; only items under the same merchant can be chosen |
| Inventory Type | Assign which inventory type this item should be picked from (e.g. good stock, near-expiry); leave blank for the normal flow | If the option is missing, enable it first in the merchant's inventory type settings; the same item can't have both a "Default Inventory Type" row and a row with a specific inventory type — see the FAQ |
| *Quantity | Enter how many of this item each set needs | Required; must be greater than 0 |
After filling in all items, click "Create" to save. To create several bundles in a row, use "Save and Add Another" instead — after saving, the form clears and stays on this page.
2. FAQ
2.1 FAQ
▪ What should the bundle's SKU be?
Use the SKU under which this bundle is sold on the marketplace. When orders are imported, the system matches the order item's SKU against the bundle's SKU — only on a match does it auto-expand the bundle into its single items.
▪ Can I create a new bundle with the original SKU after deleting it?
Yes. After deleting a bundle, you can create a new bundle with its SKU for the same merchant. The old bundle retains its original SKU for historical reference. Deactivating a bundle does not release its SKU. Creation is still blocked if a product, flexible product, or another bundle that has not been deleted uses that SKU under the same merchant.
▪ Do I have to fill in the inventory type?
No. Leaving the inventory type blank follows the normal picking flow. Fill it in only when this item in the bundle must be picked from a specific inventory type (e.g. good stock or near-expiry); the picking list will then mark it.
▪ What happens if I add the same single item twice?
- Both rows have the same inventory type: the system merges them into one row by summing quantities on save.
- Each row specifies a different inventory type: both rows are kept.
- One row is "Default Inventory Type" and the other specifies an inventory type: the bundle can't be saved, and the error message names the item. The default inventory type uses the sales channel's inventory types, which may be the same stock as the specified row — counting it twice overstates the buildable sets and leads to overselling. Make all rows for that item use one or the other.
▪ Do single items need to exist before I build a bundle?
Yes. Bundle contents can only be chosen from items already on file. If you cannot find the item you want to add, create it in the Product List first, then come back and configure the bundle.
▪ Can the quantity be 0?
No. Each item's per-set quantity must be greater than 0, otherwise it cannot be saved.
2.2 Notes
⚠️ Important reminders
- The single items and the assigned inventory type in a bundle must all belong to the same merchant and be enabled, otherwise it cannot be saved.
- A bundle must contain at least one single item to be created.
💡 Tip: When creating many bundles at once, Import Bundles is much faster than adding them one by one.
3. Related Features
| Feature | Description | Link |
|---|---|---|
| Bundles | Back to the bundle list | Go |
| Import Bundles | Create or update many bundles at once with Excel | Go |
| Product List | Create the single items a bundle will use | Go |