Product Bundles

Flow ID: CF-24 | Module(s): product_bundles, Product domain | Complexity: Medium

Business Overview

Bundles create rule-based discounts when specific product combinations are in the cart. Uses criteria/reference system with two behaviors and two pricing strategies.

Key concepts:

• Bundle Behavior: OneTime (1, applies once) or Recurring (2, all matching quantities)
• Pricing Strategy: Constant (1, fixed discount) or Scalar (2, tiered by quantity)
• Reference Types: ProductId (1), ProductCodeId (2), CategoryId (3), VendorId (4)

---

API Reference

REST Endpoints

Method	Path	Auth	Description
GET	/rest/product/bundle	Guest	List bundles
GET	/rest/product/bundle/{id}	Guest	Get bundle with relations
POST	/rest/product/bundle	Backend	Create bundle
GET	/rest/product/bundle-criteria	Guest	List criteria
GET	/rest/product/bundle-pricing	Guest	List pricing tiers
GET	/rest/product/bundle-display	Guest	List display settings
GET	/rest/product/bundle-builder-reference	Guest	List references

---

Cart Integration

1. Labeling: labelBundledProducts() — load active bundles → sort by weight → check criteria → label items
2. Pricing: applyBundlePricingToCartLiveData() — calculate bundle_save_price, adjust final_price
3. Order: Applied bundles saved to shop_order_basket_options_applied_bundles

Discount formula: instancedProductSavePrice = (price × qty) × (discount/100)

---

Domain Layer

Component	Path
Bundle Service	src/Domains/Product/Bundle/Service.php
Bundle WriteService	src/Domains/Product/Bundle/WriteService.php
Sub-entities	Criteria, Pricing, Display, BuilderReference, CriteriaReference
BundleBehavior Enum	src/ProductBundles/BundleBehavior.php

---

Client Extension Points

• PRODUCT_BUNDLES.ENABLED: Feature gate
• Weight priority: Higher weight = processed first
• Custom criteria: Override BundleReferenceSet matching
• HATEOAS API: AdvApiProductBundlesAdmin exposes _links for client discovery

Related Flows

• CF-02 Product Detail — related bundles shown on PDP
• CF-05 Cart — bundle pricing applied in cart
• CF-07 Order Confirmation — applied bundles saved to order basket options
• CF-12 Promotions — bundles complement promo discount rules
• AD-24 Bundles Admin — admin CRUD for bundle rules