Fluent Commerce Logo
Docs

Order Management Lifecycle

OMS WebApp, Promising, Sourcing, Order Capture, Order Workflows, Payment Processing, and Customer Service.

Bundled Product Handling

Essential knowledgeCore knowledge to understand Fluent Commerce
A bundled product is a single sellable product formed by combining multiple child variant products. The bundle can be fulfilled either from pre-packed stock or by assembling individual child components, which can also be sold independently. This document covers how to model bundles in Fluent OMS, calculate their availability, and determine how they are fulfilled. The approach described in this document reflects a common implementation adopted by clients. Actual implementations may vary based on client-specific business requirements and future product enhancements.
  • A bundle is modelled as a Variant Product with `isBundledProduct: true` and a `childComponents` attribute listing component SKUs.
  • Bundle components can be sold individually or as part of a bundle
  • Bundle ATS is calculated as the bundle's own pre-packed stock plus the minimum available units across all child components.
  • Allocation priority: Pre-packed bundle stock is consumed first; component explosion only occurs when pre-packed stock is exhausted.
  • A MASTER Virtual Catalogue orchestrates all bundle ATS calculations — it receives inventory change events, applies the min-of-components formula, and routes results to BASE and Aggregate catalogues.
  • Selling a component individually automatically reduces the bundle's calculated availability through virtual position recalculation.
  • The `parentBundles` attribute on component products provides reverse-reference for recalculation triggers.