Menu

Articles in this section

Shopify Kits & Bundles: Supported Shopify Order Structures

In this article

     

    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.

    Related articles