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

Was this helpful?

Edit on GitHub
Export as PDF
  1. Shopify Integration
  2. Pre-orders and Backorders

Presell Catalog Synchronization

Learn how HotWax Commerce syncs pre-order and backorder catalogs to Shopify.

PreviousPresell Catalog ManagementNextOrder Returns

Last updated 3 months ago

Was this helpful?

How is the Pre-Order and Backorder Catalog Synced from HotWax Commerce to Shopify?

The items that are available for pre-order or backorder are transferred from HotWax Commerce to Shopify through the "presell catalog sync" job. This job is set to run every 15 minutes by default and updates the product listings on Shopify based on any changes made to the pre-order/backorder category in HotWax Commerce within the last 15 minutes.

The products are listed/delisted from Shopify through the following steps:

  1. The “presell catalog sync” job generates a GraphQL file that contains information about products that have been added or removed from the pre-order/backorder category. This file is then uploaded to Shopify. The details included in the GraphQL file are the promised delivery date, product category, and product status.

  2. The GraphQL File also indicates whether the "continue selling when out of stock" flag should be turned ON or OFF.

  3. When a GraphQL file is processed by Shopify, the meta field on the product variants is populated with the promise date, product category, and product status. HotWax Commerce checks the inventory policy for each product variant to ensure that "Continue selling when out of stock" is automatically turned on or off

To further illustrate this example, let’s take a look at a GraphQL file for the given purchase order items:

Purchase Orders
Product Name
Arrival Date
Product category
Status
Continue Selling Out of Stock

PO 1234

Black Jacket

10-10-23

Pre-order

Active

True

PO 1234

Green Jacket

10-10-23

Backorder

Active

True

PO 2345

Red Shirt

08-08-23

Pre-order

Active

True

PO 2345

Green Shirt

08-08-23

Pre-order

Active

True

PO 2345

Purple Shirt

08-08-23

Backorder

Active

True

PO 1AB2

Yellow Shirt

07-31-23

Pre-order

Active

True

Once all the products are listed on Shopify, it's important to add the HC:Pre-order or HC:Backorder tag accordingly. These tags can easily be added using the 'Add pre-order tags' and 'Add backorder tags' jobs, which run every 15 minutes. By checking the pre-order category in the meta fields, the jobs add the appropriate tag to the parent product on Shopify.

The HotWax Commerce Pre-order PDP app utilizes tags and meta fields to modify the 'Add to Cart' button and show the expected delivery date on Shopify PDP. Products labeled with 'HC:Pre-order' tags will have the 'Add to Cart' button changed to 'Pre-Order', while products with 'HC:Backorder' tags will display 'Backorder' instead.

When a product is delisted from presell, its status changes to inactive and the option to 'continue selling out of stock' is set to false. There are three conditions that may require inventory to be delisted from Shopify.

After the merchant has received all the orders for the available ATP on the black jacket:

Purchase Orders
Product Name
Arrival Date
Product category
Presell Status
Continue Selling Out of Stock

PO 1234

Black Jacket

10-10-23

Pre-order

Inactive

False

When the merchant receives red shirts inventory at their fulfillment center:

Purchase Orders
Product Name
Arrival Date
Product category
Presell Status
Continue Selling Out of Stock

PO 2345

Red Shirt

08-08-23

Pre-order

Inactive

False

When the arrival date of a purchase order is passed:

Purchase Orders
Product Name
Arrival Date
Product category
Presell Status
Continue Selling Out of Stock

PO 1AB2

Yellow Shirt

07-31-23

Pre-order

Inactive

False

After delisting pre-orderable products from Shopify, merchants can use the 'Remove pre-order tags' and 'Remove backorder tags' jobs to get rid of the HC:Pre-order and HC:Backorder tags. This will happen automatically every 15 minutes.

If a pre-orderable product is delisted from Shopify, the buttons for 'Pre-order' and 'Backorder' will switch to 'Add to Cart' on the Shopify PDP page as long as there is inventory for any upcoming orders. If the available to promise (ATP) quantity runs out and becomes zero, the "Pre-order" and "Backorder" buttons will switch to "Out of Stock".

Fig. 2 : Configurations of 'Sync Variant Details' job in Job Managers App
Fig.3 : Pre-order button on PDP
Fig.4 : Out of Stock button on PDP