Shopify Kits & Bundles: Supported Shopify Order Structures

This article explains how kits and bundles must be structured in Shopify in order to work with the MasonHub Shopify integration.

​

Overview

MasonHub supports a set of Shopify order structures for kits and bundles when using Shopify’s native bundles or other third-party apps. Ensuring your Shopify orders follow one of the supported patterns below will allow orders to flow into MasonHub and be fulfilled successfully.

​

Supported Shopify Order Structures

​

Option 1: Parent Item Only (Bundle / Kit SKU)

Shopify Structure

• The Shopify order contains only the parent (bundle or kit) SKU.
• No component SKUs appear as separate line items on the order.

Requirements

• The parent item must be configured as a Kit SKU in MasonHub.

Notes

• Shopify sends MasonHub the order with just the parent SKU. If inventory is pre-kitted and available for the parent SKU, MasonHub ships that inventory. If not, MasonHub picks the configured components and ships the parent SKU in Shopify.

​

Option 2: Components Only on the Shopify Order

Shopify Structure

• The Shopify order contains only the component SKUs.
• No parent or bundle SKU is included on the order.

Requirements

• Each component SKU must exist in MasonHub as an individual item SKU.

Notes

• This approach is commonly used by bundle apps that expand bundles into their components before order creation.

​

Parent + Components on the Order (Virtual Parent)

This structure is supported only if the parent item is virtual.

Shopify Structure

• The Shopify order contains both:
  • A parent (bundle) item
  • The component SKUs

Requirements

• The parent SKU must be configured in Shopify as a non-inventory (virtual) item.

Notes

MasonHub will act only on the component SKUs (non-virtual) present on the order.

Validation and testing are strongly recommended to confirm compatibility with your bundle app.

Example of separate fulfillment for physical and virtual parent item:

A Shopify fulfillment will be marked fulfilled with the shipped component SKUs and tracking number when the MasonHub App ships the components on the order.

A second Shopify fulfillment will be marked fulfilled with the non-inventory item and without tracking when the MasonHub App ships the components on the order.

​

Unsupported Shopify Structures

The following configurations are not supported:

• A parent SKU that is inventory-bearing and component SKUs appearing together on the same order

​

Best Practices

• Choose one Shopify order structure and apply it consistently.
• Avoid mixing parent and component fulfillment logic.