> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://easybundles-help.skailama.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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."