Enabling Pre-orders for Bundled Products via Stoq Integration

Overview

This feature allows merchants to offer pre-orders on individual products within a bundle by integrating Stoq with Easy Bundles. When enabled, products that are part of a Stoq selling plan will display a "Pre-order" tag within the bundle interface, allowing customers to purchase items that are currently out of stock or designated for future release.

Core Logic & Functionality

1. Stoq Configuration

Before Easy Bundles can display pre-order options, the products must be configured within the Stoq app:

• Product Selection: Products must be added to a Pre-order plan in the Stoq dashboard (Add New Preorder).
• Availability Logic: The Continue Selling setting must be enabled within the Stoq app for these specific products. If this is disabled in Stoq, the pre-order logic will not trigger in the bundle.

2. Easy Bundles Integration & Activation

Easy Bundles automatically detects the presence of Stoq selling plans once the app is installed. To activate the display:

1. Navigate to Easy Bundles > Select the specific Bundle.
2. Go to Bundle Settings.
3. Locate and toggle ON the Individual Selling Plans setting.

3. Selection Logic (Display Rules)

The merchant must choose between two display behaviors for the pre-order interface:

• Option A: All Products

• IF a product is part of a Stoq pre-order plan, THEN the "Pre-order" tag is displayed regardless of current stock levels.
• Customer Choice: The customer can choose to "Get this now" (if in stock) or select a future date/pre-order option (e.g., "Get this one month later").
• Option B: Only Out-of-Stock

• IF a product is part of a Stoq pre-order plan AND its inventory level is zero/out-of-stock, THEN the "Pre-order" tag is displayed.
• Constraint: The "Buy it now" option is removed. The customer must select a pre-order fulfillment option.

4. Customer UI Mechanics

• The "Pre-order" Tag: A visual tag appears on top of the product card within the bundle builder to indicate pre-order status.
• Selection Pop-up: * IF there is more than one selling plan/date option available for a product, THEN a pop-up appears for the customer to select their preferred option.

• IF only one selling plan exists, THEN no pop-up appears; the single option is applied automatically.
• Add to Cart Button: The main "Add to Cart" button for the bundle does not change its text to "Pre-order." It remains "Add to Cart" (or the merchant’s custom text).

Constraints & Edge Cases

• Mutual Exclusivity: A product will only show pre-order options if it is simultaneously active in a Stoq plan and the "Individual Selling Plans" toggle is enabled in Easy Bundles.
• Language Customization: The "Pre-order" tag text and related UI elements are not hardcoded. They can be modified or translated within the Language Settings of the Easy Bundles app.
• Inventory Dependency: For the "Only Out-of-Stock" setting, the system relies on the real-time inventory synced between Shopify and Stoq to determine if the tag should be rendered.

Example Scenario: Mixed Inventory Bundle

Setup: A "Summer Kit" bundle contains a T-shirt (In Stock) and Sunglasses (Out of Stock, set to Pre-order in Stoq).

• Logic: If Only Out-of-Stock is selected, the T-shirt appears normally. The Sunglasses appear with a "Pre-order" tag.
• Action: When the customer adds the Sunglasses to the bundle, they are prompted via pop-up to select the pre-order ship date defined in Stoq. The final "Add to Cart" button for the entire bundle remains "Add to Kit."

Updated on: 27/04/2026