IBM Support

Delinking Parent and Component Relationship in Orders with Bundle Items

How To


Summary

How to remove bundle relationship upon cancellation or quantity deduction of any component item(s)/kit component(s) after an order is created.

Objective

When a component item (e.g., chair or table legs) is cancelled or its quantity is reduced after creation of order, OMS retains the bundle relationship and still treats the order as a bundle item.
In case you want to break the bundle relationship and treat remaining items as individual (non-bundled) items, please follow below steps:

Steps

1) Create an order with bundle item.
 
2) Use changeOrder API to cancel/reduce qty for the component item and to break the bundle-component relationship.

Sample input XML:

<Order Action="MODIFY" OrderHeaderKey="2025101707290841936" Override="Y">
  <OrderLines>
    <OrderLine ACTION="CANCEL" DeliveryMethod="SHP" OrderedQty="0.00" PrimeLineNo="2" SubLineNo="1">
      <Item ItemID="TS020314158_I1" ProductClass="NEW" UnitOfMeasure="EACH" />
      <BundleParentLine Action="REMOVE" OrderLineKey="2025101707290841937"/>
    </OrderLine>
  </OrderLines>
</Order>
 

Note : BundleParentLine OrderLineKey should be the Parent Item OrderLineKey.
 

3) Here, BundleParentLine tag identifies the bundle parent order line for the specified OrderLine and Action="REMOVE" removes the component from the bundle. The modification REMOVE_COMPONENT is executed on bundle parent line.
 
4) You can verify through UI or using getOrderDetails API output, it'll show IsBundleParent="N" for the order now.
 
 
 

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSGTJF","label":"IBM Sterling Order Management System"},"ARM Category":[{"code":"a8m50000000CcGeAAK","label":"Archive (DO NOT USE)-\u003EIBM Order Management-\u003EAPIs-\u003EOrder"},{"code":"a8m0z000000cxzSAAQ","label":"Orders"}],"ARM Case Number":"TS020314158","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":""}]

Document Information

Modified date:
27 October 2025

UID

ibm17247983