Documents
HomeGlossary
Learn Shopify
Learn Shopify
  • Shopify Integration
    • Introduction
    • Products
      • Product Download
      • Updating Product Details
      • Deleting Products
      • Creating/Deleting Products with Shopify Webhooks
      • Gift Cards Download
      • Kit Products Download
      • Product Synchronization for Multiple Shopify Stores
    • Inventory
      • Inventory Synchronization
      • Location Mapping
      • Inventory Synchronization of Gift Cards
      • Inventory Synchronization of Kit Products
    • Orders
      • Order Download
        • thruDateBuffer and bufferTime
      • Order Approval for Fulfillment
      • Order Updates
      • POS Sales Download
      • Gift Cards Order Download
      • Kit Order Download
    • Order Fulfillment
      • Gift Cards Order Fulfillment
      • Kit Order Fulfillment
    • Order Cancellations
      • Complete Order Cancellation
      • Partial Order Cancellation
    • BOPIS Orders
      • Shopify PDP Experience
      • BOPIS Order Download
    • Pre-orders and Backorders
      • Presell Catalog Management
      • Presell Catalog Synchronization
    • Order Returns
      • Import Returns from Shopify
      • Shopify POS Exchanges
  • Setup Shopify
    • Install HotWax Commerce App
    • Multiple Store Setup
    • Required Permissions from Shopify
    • Enable BOPIS/Pre-order on Shopify
    • Integration Mappings
      • Locations
      • Shipping Method
      • Sales channel
      • Payment Method
      • Product Type
    • Troubleshooting
      • Facility Mapping Discrepancy
  • Synchronization Flows
    • Initial Product Sync
    • Initial Order Sync
    • Initial Inventory Sync
    • Troubleshooting
      • Product Sync
      • Order Sync
      • Inventory Sync
  • Additional resources
    • Kit Products
    • POS Completed Orders
Powered by GitBook
On this page
  • Install Bundles app reader in OMS
  • Map Shopify 'Kit' product types
  • Jobs to sync Kit Products from Shopify
  • Limitations of using Bundles App

Was this helpful?

Edit on GitHub
Export as PDF
  1. Additional resources

Kit Products

To seamlessly import Kit products into OMS, ensure that the Shopify Config Access Scope is set to grant both read and write access to the Shopify shop.

The Bundles app checks inventory levels at 10-minute intervals, reducing inventory for kit products if individual item inventory decreases. Kit products have no physical inventory of their own, like NetSuite, the inventory calculations are based on the lowest common denominator between all individual components.

For multi-location inventory calculations, a kit products availability is determined by the lowest common denominator of the kit component inventory available by facility. The computed inventory of a kit product at each facility is then summed to produce the final sellable inventory number.

During allocation, brokering is run on the kit components directly which actually have physical inventory at facilities. By default splitting is disabled for kit products in an order.

HotWax does not push kit product inventory to Shopify. Kit product inventory on Shopify is computed entirely by the Bundles app.

Install Bundles app reader in OMS

Out of the box HotWax Commerce does not come with a pre-loaded kit product integration with the Bundles app on Shopify. Before configuring Kit product data in OMS, it's crucial to install the Bundles app reader in OMS. Failure to do so may lead to missing jobs for the Bundles app. Follow the steps below for a seamless installation:

The Kit Component Metafields feature in the Bundles app on Shopify must be enabled for this functionality to work.

Step 1: Access WebTools

Go to the WebTools for your OMS instance using the provided sample link:

https://{instanceName}.hotwax.io/webtools/control/EntityImportReaders

Step 2: Add Kit Product Reader

In the Enter readers section, add the Bundles reader extension by typing ext-bundles.

Step 3: Import Configuration

Click on the "Import" button to initiate the installation process.

By following these steps, you ensure that the Bundles Reader is properly integrated into OMS, allowing for accurate and efficient data communication during import configurations.

Map Shopify 'Kit' product types

For HotWax to recognize your products as true kit products, their product type in Shopify must be mapped to 'Marketing Package' in HotWax. usually this is some variation of the word "Kit": KIT,kit,Kit.

The Shopify product type value is case sensitive

<ShopifyShopTypeMapping mappedKey="{Shopify Kit Type}" mappedTypeId="SHOPIFY_PRODUCT_TYPE" mappedValue="MARKETING_PKG_PICK" shopId="SHOP"/>

Jobs to sync Kit Products from Shopify

Import kit components from Shopify

Import kit product components

Enable this job for kit product associations

Add or Update kit product associations

Limitations of using Bundles App

Bundles simplify kit products and their component management, but it has drawbacks when it comes to determining inventory for multi-location fulfillment. The app aggregates the lowest inventory of each component accessible across every location to determine kit inventory. Because it ignores the need for every element of a kit to be accessible at the same place to fulfill the order, this method may lead to inaccurate inventory counts.

Example

For example, suppose a kit product consists of a belt and a wallet, with the inventory distributed between two stores:

  • Brooklyn Store: 3 belts, 2 wallets

  • Broadway Store: 1 belt, 5 wallets

In this case, the Bundles app calculates the total kit inventory as 4 by adding the total number of belts and wallets across both locations (belts: 3 + 1 = 4, wallets: 2 + 5 = 7). However, this calculation is incorrect because the actual number of kits that can be fulfilled is only 3. Brooklyn can fulfill 2 kits (with 3 belts and 2 wallets), and Broadway can fulfill 1 kit (with 1 belt and 1 wallet). The remaining items are insufficient to complete any additional kits.

PreviousInventory SyncNextPOS Completed Orders

Last updated 1 month ago

Was this helpful?

Learn more about how HotWax Commerce helps retailers and their components in Shopify and NetSuite if the retailer is not using the Bundles App.

manage kit products