How kits work
When you create a kit in Catalog, you define:
- The kit SKU and price — the product identifier and total price as it appears in your store
- Component items — each individual product included in the kit, referenced by SKU or product ID
- Box assignments — which components ship in which box, so the label and packing slip reflect your actual packaging
When an order containing a kit is fulfilled, Zonos automatically:
- Expands the kit into its individual components
- Allocates the kit price across components using the price ratio you defined
- Declares each component separately on the commercial invoice at the correct per-unit value
- Groups components into their assigned boxes for cartonization and label generation
This ensures accurate duty and tax calculations and smooth customs clearance — without any manual work per order.
Create a kit
- Go to Dashboard → Products → Catalog.
- Click Manage Catalog in the upper right-hand corner. Then, select Add Kit from the dropdown.
- Enter the kit SKU or Product ID — this must match the identifier your store sends to Zonos.
- Enter the kit name, price, and currency.
- Add component items by searching your catalog. For each component, specify:
- Quantity — how many units of this component are in the kit
- Box — which box this component ships in (add multiple boxes if your kit ships in more than one)
- Price ratio — the portion of the kit price this component represents (used for commercial invoice declared values)
- Click Save.
To bulk-create kits by importing a CSV file:
- Click Manage Catalog → Import kits.
- Download the kit CSV template.
- Fill out one row per component item per box. Kit-level fields (SKU, name, price) repeat on every row for the same kit.
- Upload your completed CSV and click Import.
Kit CSV fields
| Column↕ | Description↕ |
|---|---|
| Kit SKU | The SKU of the kit as it appears in your store. |
| Kit Product ID | The product ID of the kit as it appears in your store. |
| Kit Name | The name of the kit. |
| Kit Description | A description of the kit. |
| Kit Image URL | Image URL for the kit. |
| Kit Amount | The total price of the kit. |
| Kit Currency | The currency of the kit price, e.g., USD. |
| Box Number | The box number this row's component ships in, e.g., 1 or 2. Use the same number for all components in the same box. |
| Box Length | Length of the box for this row. |
| Box Width | Width of the box for this row. |
| Box Height | Height of the box for this row. |
| Box Dimensional Unit | Dimensional unit for the box, e.g., INCH. |
| Box Weight Capacity | Maximum weight capacity of the box. |
| Box Weight Unit | Weight unit for the box capacity, e.g., POUND. |
| Item SKU | The SKU of this component item. Must match an existing catalog item. |
| Item Product ID | The product ID of this component item. Must match an existing catalog item. |
| Item Quantity | How many units of this component are in the kit. |
Edit a kit
Note: Edits to a kit affect future orders only. Orders already placed and fulfilled are not affected.
- Go to Dashboard → Products → Catalog.
- Select the Kits tab.
- Click the kit you want to edit.
- Update the fields and click Save.
Delete a kit
To delete a single kit, open the kit and click Delete.
To delete multiple kits at once:
- Select the kits you want to delete using the checkboxes.
- Click Delete selected.
- Confirm the deletion.
To delete all kits for your organization, click Manage Catalog → Delete all.
Export kits
Kits are exported separately from standard catalog items.
- Go to Dashboard → Products → Catalog.
- Select the Kits tab.
- Click Manage Catalog → Export kits.
- Find your kit CSV file in your downloads or email inbox.
Mixed kit orders
A single order can contain multiple kits and standalone items simultaneously. For example, an order with:
- 1× 4-pack kit
- 1× 2-pack kit
- 1× single item
Zonos expands each kit independently and declares all components — in this case, 7 individual units — on the commercial invoice at the correct per-unit values. Each kit's components ship in their defined boxes, and the single item ships separately.
Kits and commercial invoices
Each component of a kit is declared as a separate line item on the commercial invoice. The declared value for each component is calculated using the price ratio you set when creating the kit — for example, if a $30 kit contains three equally-valued items, each is declared at $10.
This matters for customs because many countries assess duties and taxes on a per-item basis. Without per-component declarations, customs may assess duties on the full kit price for every item, or flag the shipment for review.
Packing slips
When fulfilling a kit order, the Zonos packing slip groups components by box. Each box section lists the components assigned to it with their SKUs, descriptions, and quantities. If a box is removed during label creation, it appears on the packing slip as deleted — preserving the box numbering so warehouse staff can reconcile against the physical shipment.
Kits
Declare multi-component products accurately on commercial invoices.
A kit is a product sold as a single unit that contains multiple individual components — for example, a gift set containing a candle, a notebook, and a pen. When a kit ships internationally, customs requires each component to be declared separately on the commercial invoice at its individual value. Zonos Catalog kits automate this: you define the kit once, and Zonos expands it into its components at the correct per-unit declared values on every international shipment, with no manual intervention required.