Commerce Order Management
This skill activates when a practitioner needs to set up or extend Salesforce Order Management (OMS): creating OrderSummary records from activated Orders, building FulfillmentOrder routing logic, processing cancellations and returns through Connect API actions, handling async payment jobs, and subscribing to OMS platform events. It covers only OMS-licensed orgs — it does NOT cover CPQ orders or standard Salesforce Orders outside of OMS.
Before Starting
Gather this context before working on anything in this domain:
- Confirm the org has a Salesforce Order Management or Commerce license. OMS objects (OrderSummary, FulfillmentOrder, ReturnOrder) and Connect API order management actions are unavailable without it.
- Establish the
OrderLifeCycleType for each OrderSummary before creation: MANAGED (all mutations must go through Connect API actions) or UNMANAGED (direct DML is allowed). This value is immutable after the OrderSummary record is created.
- Verify the upstream Order is in
Activated status before triggering OrderSummary creation. A Draft or non-activated Order will not produce a valid OrderSummary.
- CPQ-generated Orders do NOT automatically create OrderSummary records and are not in scope for this skill.
- Payment gateway and payment method setup must be confirmed before testing ensure-funds or ensure-refunds flows.
Core Concepts
Order Lifecycle in OMS
The canonical OMS object chain is:
Order (Activated)
└── OrderSummary (OrderLifeCycleType: MANAGED | UNMANAGED)
├── OrderItemSummary (one per OrderItem, represents product line)
└── OrderDeliveryGroupSummary (groups items by shipping address/method)
└── FulfillmentOrder
└── FulfillmentOrderLineItem
ReturnOrder
└── ReturnOrderLineItem
An Order must reach Status = Activated before the OMS trigger fires to create the OrderSummary. The OrderSummary represents the commercial truth of the order throughout its lifecycle and is the anchor for all downstream financial and fulfillment records.
MANAGED vs UNMANAGED OrderLifeCycleType
OrderLifeCycleType on the OrderSummary record controls whether the platform enforces Connect API usage for mutations:
- MANAGED: All quantity and price changes to OrderItemSummary records must be made through Connect API core actions (
submit-cancel, submit-return, adjust-item-submit). Direct DML (insert/update/delete) on OrderItemSummary in MANAGED mode will either fail with an exception or silently produce inconsistencies in financial summaries. Change orders are created automatically to track each adjustment.
- UNMANAGED: Direct DML is permitted. Intended for custom or non-standard order scenarios that cannot conform to the OMS state machine.
This field is immutable after OrderSummary creation. Set it correctly during the Order-to-OrderSummary flow; it cannot be changed later.
Connect API Order Management Actions
All MANAGED-mode mutations are executed through named Connect API actions. Key actions:
| Action |
Purpose |
Notes |
submit-cancel |
Cancel one or more OrderItemSummary quantities |
Produces a ChangeOrder; eligible pre-fulfillment |
submit-return |
Initiate a return for fulfilled items |
Creates ReturnOrder + ReturnOrderLineItem records |
adjust-item-submit |
Adjust item quantity or price |
Can produce up to 3 separate ChangeOrders for pre/in/post-fulfillment splits |
ensure-funds-async |
Authorize or capture payment |
Enqueued async job; errors surfaced via ProcessExceptionEvent |
ensure-refunds-async |
Issue refund to customer |
Enqueued async job; errors surfaced via ProcessExceptionEvent |
Platform Events for OMS
OMS publishes platform events at key lifecycle moments. Subscribe to these in Flow or Apex:
OrderSummaryCreatedEvent: Fires after an OrderSummary is created from an Order. Use to trigger downstream provisioning.
OrderSumStatusChangedEvent: Fires when an OrderSummary's status changes (e.g., to Fulfilled, Cancelled).
FOStatusChangedEvent: Fires when a FulfillmentOrder status changes (e.g., to Fulfilled, Cancelled).
ProcessExceptionEvent: Fires when an async job (ensure-funds-async, ensure-refunds-async) encounters an error. You must subscribe to this event to surface payment failures; they are not surfaced through standard exception handling.
Common Patterns
Pattern: Standard Fulfillment Flow
When to use: An Order has been activated and items need to be routed to a fulfillment location for picking, packing, and shipping.
How it works:
- Order reaches
Status = Activated (manually or through a Checkout flow).
- OMS trigger fires;
OrderSummaryCreatedEvent is published.
- Subscribe to
OrderSummaryCreatedEvent in a triggered Flow or Apex handler.
- In the handler, call the OMS routing engine or a custom routing Flow to create FulfillmentOrder records grouped by location and delivery group.
- FulfillmentOrder starts in
Draft status; transition to Activated to release to the warehouse.
- Subscribe to
FOStatusChangedEvent to react when warehouse marks items as shipped/fulfilled.
- Call
ensure-funds-async to capture payment once fulfillment is confirmed.
Why not the alternative: Creating FulfillmentOrder records manually via DML without routing logic leads to incorrect location assignments and breaks the OMS inventory reservation model.
Pattern: Cancellation and Return Flow
When to use: A customer wants to cancel an unfulfilled item (pre-fulfillment cancel) or return a fulfilled item.
How it works:
Pre-fulfillment cancel:
- Call Connect API action
submit-cancel with the OrderSummaryId and a list of {orderItemSummaryId, quantity} pairs.
- OMS validates eligible cancel quantity and creates a ChangeOrder.
- Call
ensure-refunds-async to issue the refund. Subscribe to ProcessExceptionEvent for failures.
Post-fulfillment return:
- Call Connect API action
submit-return with the OrderSummaryId and returned line items.
- OMS creates a ReturnOrder and ReturnOrderLineItem records.
- When the ReturnOrderLineItem is processed (item received), call
ensure-refunds-async.
Why not the alternative: Manually updating OrderItemSummary quantities in MANAGED mode will either throw a DML exception or corrupt financial aggregates on the OrderSummary. Always use the Connect API actions.
Decision Guidance
| Situation |
Recommended Approach |
Reason |
| Standard B2C or B2B order in OMS-licensed org |
Use MANAGED OrderLifeCycleType |
Enforces financial consistency; Connect API actions create auditable ChangeOrders |
| Custom order scenario that cannot fit OMS state machine |
Use UNMANAGED OrderLifeCycleType |
Allows direct DML; but loses OMS financial-summary automation |
| Item cancellation before fulfillment starts |
submit-cancel Connect API action |
Updates TotalCancelled quantities and creates ChangeOrder automatically |
| Item return after fulfillment |
submit-return Connect API action + ReturnOrder |
Creates ReturnOrder records; eligible for ensure-refunds-async |
| Price or quantity adjustment spanning fulfillment status |
adjust-item-submit |
Can produce up to 3 ChangeOrders to split pre/in/post-fulfillment amounts |
| Payment authorization or capture |
ensure-funds-async |
Async job; subscribe to ProcessExceptionEvent for error handling |
| Refund issuance |
ensure-refunds-async |
Async job; subscribe to ProcessExceptionEvent for error handling |
| CPQ-generated Order needing OMS processing |
Out of scope — CPQ Orders do not create OrderSummary |
Separate license and data model required; evaluate integration patterns instead |
Recommended Workflow
Step-by-step instructions for an AI agent or practitioner working on this task:
- Verify prerequisites: Confirm OMS license is provisioned, the Order is in Activated status, and OrderLifeCycleType has been decided (MANAGED is the default for OMS implementations).
- Establish the OrderSummary: Ensure the Order activation triggers OrderSummary creation. Confirm that
OrderLifeCycleType is set correctly before creation since it cannot be changed afterward. Subscribe to OrderSummaryCreatedEvent for downstream triggering.
- Configure fulfillment routing: Build or configure the routing logic (OMS routing engine or custom Flow/Apex) to create FulfillmentOrder records from OrderDeliveryGroupSummary records. Validate that FulfillmentOrders reference correct locations.
- Implement cancellation and return paths: Use
submit-cancel for pre-fulfillment cancellations and submit-return for post-fulfillment returns. Never use direct DML on OrderItemSummary in MANAGED mode.
- Wire up async payment jobs: Invoke
ensure-funds-async after fulfillment confirmation and ensure-refunds-async after return/cancel. Subscribe to ProcessExceptionEvent to catch and handle payment job failures.
- Subscribe to OMS platform events: Register event-triggered Flows or Apex for
FOStatusChangedEvent, OrderSumStatusChangedEvent, and ProcessExceptionEvent to keep downstream systems synchronized.
- Test end-to-end in sandbox: Activate a test Order, verify OrderSummary creation, run a cancellation and a return through the Connect API, confirm ChangeOrder records are created, and verify ProcessExceptionEvent handling fires correctly.
Review Checklist
Run through these before marking work in this area complete:
Salesforce-Specific Gotchas
Non-obvious platform behaviors that cause real production problems:
- OrderLifeCycleType is immutable after OrderSummary creation — If MANAGED is set and later the implementation requires direct DML, there is no API to change it. The OrderSummary must be deleted and recreated, which can orphan related financial records. Plan the lifecycle type carefully before go-live.
- Direct DML on OrderItemSummary in MANAGED mode silently corrupts totals — Updating
QuantityCanceled or TotalPrice directly via Apex DML does not raise a reliable exception in all API versions; in some cases it succeeds but leaves the OrderSummary aggregate fields (TotalAdjustedProductAmount, etc.) in an inconsistent state that cannot be repaired without support.
- ProcessExceptionEvent is the only error signal from async payment jobs —
ensure-funds-async and ensure-refunds-async are enqueued Queueable jobs. They do not throw exceptions to the calling context, and they do not log to standard Apex debug logs by default. If no ProcessExceptionEvent subscriber exists, payment failures are invisible at runtime.
- adjust-item-submit produces up to 3 ChangeOrders — If an adjustment spans items that are partially pre-fulfillment, in-fulfillment, and post-fulfillment, the platform creates a separate ChangeOrder for each segment. Code that assumes a single ChangeOrder per adjustment call will miss records.
- CPQ Orders do not create OrderSummary records — CPQ uses its own Order object but the OMS trigger that creates OrderSummary only fires for Orders provisioned through the Commerce/OMS activation path. A CPQ Order activated in the standard Salesforce UI will not produce an OrderSummary. Do not mix these paths.
Output Artifacts
| Artifact |
Description |
| OrderSummary record |
Immutable-lifecycle-type record representing the commercial truth of the order; anchor for all OMS financial and fulfillment records |
| FulfillmentOrder + FulfillmentOrderLineItem |
Routing unit sent to a specific fulfillment location; transitions through Draft → Activated → Fulfilled |
| ChangeOrder |
Audit record created by submit-cancel, submit-return, or adjust-item-submit; up to 3 per adjust-item-submit call |
| ReturnOrder + ReturnOrderLineItem |
Return authorization and line-level return records created by submit-return |
| Platform event subscriptions |
Flow or Apex triggers on FOStatusChangedEvent, OrderSumStatusChangedEvent, OrderSummaryCreatedEvent, ProcessExceptionEvent |
Related Skills
commerce-checkout-configuration — Covers checkout flow setup that activates Orders feeding into OMS
commerce-product-catalog — Product and pricing setup upstream of OMS order creation
flow-for-admins — Building event-triggered Flows to subscribe to OMS platform events
quote-to-cash-process — End-to-end Q2C; references OMS as the fulfillment leg post-order activation
Official Sources Used
1---2name: commerce-order-management3description: "Use this skill for Salesforce Order Management (OMS) tasks: order lifecycle, OrderSummary creation and status, FulfillmentOrder creation and routing, returns, exchanges, cancellations, and platform event subscriptions. Trigger keywords: order management, OrderSummary, FulfillmentOrder, ReturnOrder, ensure-funds, ensure-refunds, submit-cancel, submit-return, adjust-item-submit. NOT for CPQ quote-to-order workflows, standard Salesforce Orders without OMS, or B2B/B2C storefront setup."4category: admin5salesforce-version: "Spring '25+"6well-architected-pillars:7 - Reliability8 - Security9 - Performance10triggers:11 - "How do I create an OrderSummary from an activated Order in Salesforce OMS?"12 - "FulfillmentOrder is not being created or routed correctly — how do I set up fulfillment flows?"13 - "Customer wants to cancel or return items in an order — how do I use submit-cancel or submit-return?"14 - "ensure-funds or ensure-refunds jobs are failing silently — how do I handle payment errors in OMS?"15 - "OrderItemSummary quantity is wrong after I tried to update it with DML — why did it break?"16tags:17 - order-management18 - oms19 - order-summary20 - fulfillment-order21 - return-order22 - connect-api23 - platform-events24inputs:25 - "Activated Salesforce Order record (Status = Activated) with associated OrderItems and PricebookEntries"26 - "OrderLifeCycleType choice: MANAGED (OMS controls all mutations) or UNMANAGED (direct DML allowed)"27 - "Payment gateway or payment method setup (for ensure-funds / ensure-refunds flows)"28 - "Fulfillment location records and routing configuration"29 - "OMS license confirmation: Salesforce Order Management or Commerce license must be provisioned"30outputs:31 - "OrderSummary record with correct OrderLifeCycleType (immutable after creation)"32 - "FulfillmentOrder and FulfillmentOrderLineItem records routed to fulfillment locations"33 - "ChangeOrder records tracking pre/in/post-fulfillment quantity and price adjustments"34 - "ReturnOrder and ReturnOrderLineItem records for customer returns"35 - "Platform event subscription logic for FOStatusChangedEvent, OrderSumStatusChangedEvent, OrderSummaryCreatedEvent, ProcessExceptionEvent"36dependencies: []37version: 1.0.038author: Pranav Nagrecha39updated: 2026-04-1140metadata:41 source: https://skillmd.com/skills/banibratachatterjee/commerce-order-management42---4344# Commerce Order Management4546This skill activates when a practitioner needs to set up or extend Salesforce Order Management (OMS): creating OrderSummary records from activated Orders, building FulfillmentOrder routing logic, processing cancellations and returns through Connect API actions, handling async payment jobs, and subscribing to OMS platform events. It covers only OMS-licensed orgs — it does NOT cover CPQ orders or standard Salesforce Orders outside of OMS.4748---4950## Before Starting5152Gather this context before working on anything in this domain:5354- Confirm the org has a Salesforce Order Management or Commerce license. OMS objects (OrderSummary, FulfillmentOrder, ReturnOrder) and Connect API order management actions are unavailable without it.55- Establish the `OrderLifeCycleType` for each OrderSummary before creation: MANAGED (all mutations must go through Connect API actions) or UNMANAGED (direct DML is allowed). This value is immutable after the OrderSummary record is created.56- Verify the upstream Order is in `Activated` status before triggering OrderSummary creation. A Draft or non-activated Order will not produce a valid OrderSummary.57- CPQ-generated Orders do NOT automatically create OrderSummary records and are not in scope for this skill.58- Payment gateway and payment method setup must be confirmed before testing ensure-funds or ensure-refunds flows.5960---6162## Core Concepts6364### Order Lifecycle in OMS6566The canonical OMS object chain is:6768```69Order (Activated)70 └── OrderSummary (OrderLifeCycleType: MANAGED | UNMANAGED)71 ├── OrderItemSummary (one per OrderItem, represents product line)72 └── OrderDeliveryGroupSummary (groups items by shipping address/method)73 └── FulfillmentOrder74 └── FulfillmentOrderLineItem75ReturnOrder76 └── ReturnOrderLineItem77```7879An Order must reach `Status = Activated` before the OMS trigger fires to create the OrderSummary. The OrderSummary represents the commercial truth of the order throughout its lifecycle and is the anchor for all downstream financial and fulfillment records.8081### MANAGED vs UNMANAGED OrderLifeCycleType8283`OrderLifeCycleType` on the OrderSummary record controls whether the platform enforces Connect API usage for mutations:8485- **MANAGED**: All quantity and price changes to OrderItemSummary records must be made through Connect API core actions (`submit-cancel`, `submit-return`, `adjust-item-submit`). Direct DML (insert/update/delete) on OrderItemSummary in MANAGED mode will either fail with an exception or silently produce inconsistencies in financial summaries. Change orders are created automatically to track each adjustment.86- **UNMANAGED**: Direct DML is permitted. Intended for custom or non-standard order scenarios that cannot conform to the OMS state machine.8788This field is **immutable after OrderSummary creation**. Set it correctly during the Order-to-OrderSummary flow; it cannot be changed later.8990### Connect API Order Management Actions9192All MANAGED-mode mutations are executed through named Connect API actions. Key actions:9394| Action | Purpose | Notes |95|---|---|---|96| `submit-cancel` | Cancel one or more OrderItemSummary quantities | Produces a ChangeOrder; eligible pre-fulfillment |97| `submit-return` | Initiate a return for fulfilled items | Creates ReturnOrder + ReturnOrderLineItem records |98| `adjust-item-submit` | Adjust item quantity or price | Can produce up to 3 separate ChangeOrders for pre/in/post-fulfillment splits |99| `ensure-funds-async` | Authorize or capture payment | Enqueued async job; errors surfaced via ProcessExceptionEvent |100| `ensure-refunds-async` | Issue refund to customer | Enqueued async job; errors surfaced via ProcessExceptionEvent |101102### Platform Events for OMS103104OMS publishes platform events at key lifecycle moments. Subscribe to these in Flow or Apex:105106- **`OrderSummaryCreatedEvent`**: Fires after an OrderSummary is created from an Order. Use to trigger downstream provisioning.107- **`OrderSumStatusChangedEvent`**: Fires when an OrderSummary's status changes (e.g., to Fulfilled, Cancelled).108- **`FOStatusChangedEvent`**: Fires when a FulfillmentOrder status changes (e.g., to Fulfilled, Cancelled).109- **`ProcessExceptionEvent`**: Fires when an async job (ensure-funds-async, ensure-refunds-async) encounters an error. **You must subscribe to this event** to surface payment failures; they are not surfaced through standard exception handling.110111---112113## Common Patterns114115### Pattern: Standard Fulfillment Flow116117**When to use:** An Order has been activated and items need to be routed to a fulfillment location for picking, packing, and shipping.118119**How it works:**1201211. Order reaches `Status = Activated` (manually or through a Checkout flow).1222. OMS trigger fires; `OrderSummaryCreatedEvent` is published.1233. Subscribe to `OrderSummaryCreatedEvent` in a triggered Flow or Apex handler.1244. In the handler, call the OMS routing engine or a custom routing Flow to create FulfillmentOrder records grouped by location and delivery group.1255. FulfillmentOrder starts in `Draft` status; transition to `Activated` to release to the warehouse.1266. Subscribe to `FOStatusChangedEvent` to react when warehouse marks items as shipped/fulfilled.1277. Call `ensure-funds-async` to capture payment once fulfillment is confirmed.128129**Why not the alternative:** Creating FulfillmentOrder records manually via DML without routing logic leads to incorrect location assignments and breaks the OMS inventory reservation model.130131### Pattern: Cancellation and Return Flow132133**When to use:** A customer wants to cancel an unfulfilled item (pre-fulfillment cancel) or return a fulfilled item.134135**How it works:**136137Pre-fulfillment cancel:1381. Call Connect API action `submit-cancel` with the OrderSummaryId and a list of `{orderItemSummaryId, quantity}` pairs.1392. OMS validates eligible cancel quantity and creates a ChangeOrder.1403. Call `ensure-refunds-async` to issue the refund. Subscribe to `ProcessExceptionEvent` for failures.141142Post-fulfillment return:1431. Call Connect API action `submit-return` with the OrderSummaryId and returned line items.1442. OMS creates a ReturnOrder and ReturnOrderLineItem records.1453. When the ReturnOrderLineItem is processed (item received), call `ensure-refunds-async`.146147**Why not the alternative:** Manually updating OrderItemSummary quantities in MANAGED mode will either throw a DML exception or corrupt financial aggregates on the OrderSummary. Always use the Connect API actions.148149---150151## Decision Guidance152153| Situation | Recommended Approach | Reason |154|---|---|---|155| Standard B2C or B2B order in OMS-licensed org | Use MANAGED OrderLifeCycleType | Enforces financial consistency; Connect API actions create auditable ChangeOrders |156| Custom order scenario that cannot fit OMS state machine | Use UNMANAGED OrderLifeCycleType | Allows direct DML; but loses OMS financial-summary automation |157| Item cancellation before fulfillment starts | `submit-cancel` Connect API action | Updates TotalCancelled quantities and creates ChangeOrder automatically |158| Item return after fulfillment | `submit-return` Connect API action + ReturnOrder | Creates ReturnOrder records; eligible for `ensure-refunds-async` |159| Price or quantity adjustment spanning fulfillment status | `adjust-item-submit` | Can produce up to 3 ChangeOrders to split pre/in/post-fulfillment amounts |160| Payment authorization or capture | `ensure-funds-async` | Async job; subscribe to ProcessExceptionEvent for error handling |161| Refund issuance | `ensure-refunds-async` | Async job; subscribe to ProcessExceptionEvent for error handling |162| CPQ-generated Order needing OMS processing | Out of scope — CPQ Orders do not create OrderSummary | Separate license and data model required; evaluate integration patterns instead |163164---165166## Recommended Workflow167168Step-by-step instructions for an AI agent or practitioner working on this task:1691701. **Verify prerequisites**: Confirm OMS license is provisioned, the Order is in Activated status, and OrderLifeCycleType has been decided (MANAGED is the default for OMS implementations).1712. **Establish the OrderSummary**: Ensure the Order activation triggers OrderSummary creation. Confirm that `OrderLifeCycleType` is set correctly before creation since it cannot be changed afterward. Subscribe to `OrderSummaryCreatedEvent` for downstream triggering.1723. **Configure fulfillment routing**: Build or configure the routing logic (OMS routing engine or custom Flow/Apex) to create FulfillmentOrder records from OrderDeliveryGroupSummary records. Validate that FulfillmentOrders reference correct locations.1734. **Implement cancellation and return paths**: Use `submit-cancel` for pre-fulfillment cancellations and `submit-return` for post-fulfillment returns. Never use direct DML on OrderItemSummary in MANAGED mode.1745. **Wire up async payment jobs**: Invoke `ensure-funds-async` after fulfillment confirmation and `ensure-refunds-async` after return/cancel. Subscribe to `ProcessExceptionEvent` to catch and handle payment job failures.1756. **Subscribe to OMS platform events**: Register event-triggered Flows or Apex for `FOStatusChangedEvent`, `OrderSumStatusChangedEvent`, and `ProcessExceptionEvent` to keep downstream systems synchronized.1767. **Test end-to-end in sandbox**: Activate a test Order, verify OrderSummary creation, run a cancellation and a return through the Connect API, confirm ChangeOrder records are created, and verify ProcessExceptionEvent handling fires correctly.177178---179180## Review Checklist181182Run through these before marking work in this area complete:183184- [ ] OMS license is confirmed on the org185- [ ] OrderLifeCycleType is set to the correct value before OrderSummary creation and has been documented — it cannot be changed after creation186- [ ] All MANAGED-mode mutations use Connect API actions (submit-cancel, submit-return, adjust-item-submit) — no direct DML on OrderItemSummary187- [ ] ProcessExceptionEvent subscription is in place for ensure-funds-async and ensure-refunds-async failures188- [ ] FulfillmentOrder creation and routing logic handles all OrderDeliveryGroupSummary records189- [ ] Platform event subscriptions (OrderSummaryCreatedEvent, FOStatusChangedEvent, OrderSumStatusChangedEvent) are deployed and tested190- [ ] CPQ orders have been confirmed as out of scope; a separate integration path is documented if CPQ feeds into OMS191192---193194## Salesforce-Specific Gotchas195196Non-obvious platform behaviors that cause real production problems:1971981. **OrderLifeCycleType is immutable after OrderSummary creation** — If MANAGED is set and later the implementation requires direct DML, there is no API to change it. The OrderSummary must be deleted and recreated, which can orphan related financial records. Plan the lifecycle type carefully before go-live.1992. **Direct DML on OrderItemSummary in MANAGED mode silently corrupts totals** — Updating `QuantityCanceled` or `TotalPrice` directly via Apex DML does not raise a reliable exception in all API versions; in some cases it succeeds but leaves the OrderSummary aggregate fields (TotalAdjustedProductAmount, etc.) in an inconsistent state that cannot be repaired without support.2003. **ProcessExceptionEvent is the only error signal from async payment jobs** — `ensure-funds-async` and `ensure-refunds-async` are enqueued Queueable jobs. They do not throw exceptions to the calling context, and they do not log to standard Apex debug logs by default. If no `ProcessExceptionEvent` subscriber exists, payment failures are invisible at runtime.2014. **adjust-item-submit produces up to 3 ChangeOrders** — If an adjustment spans items that are partially pre-fulfillment, in-fulfillment, and post-fulfillment, the platform creates a separate ChangeOrder for each segment. Code that assumes a single ChangeOrder per adjustment call will miss records.2025. **CPQ Orders do not create OrderSummary records** — CPQ uses its own Order object but the OMS trigger that creates OrderSummary only fires for Orders provisioned through the Commerce/OMS activation path. A CPQ Order activated in the standard Salesforce UI will not produce an OrderSummary. Do not mix these paths.203204---205206## Output Artifacts207208| Artifact | Description |209|---|---|210| OrderSummary record | Immutable-lifecycle-type record representing the commercial truth of the order; anchor for all OMS financial and fulfillment records |211| FulfillmentOrder + FulfillmentOrderLineItem | Routing unit sent to a specific fulfillment location; transitions through Draft → Activated → Fulfilled |212| ChangeOrder | Audit record created by submit-cancel, submit-return, or adjust-item-submit; up to 3 per adjust-item-submit call |213| ReturnOrder + ReturnOrderLineItem | Return authorization and line-level return records created by submit-return |214| Platform event subscriptions | Flow or Apex triggers on FOStatusChangedEvent, OrderSumStatusChangedEvent, OrderSummaryCreatedEvent, ProcessExceptionEvent |215216---217218## Related Skills219220- `commerce-checkout-configuration` — Covers checkout flow setup that activates Orders feeding into OMS221- `commerce-product-catalog` — Product and pricing setup upstream of OMS order creation222- `flow-for-admins` — Building event-triggered Flows to subscribe to OMS platform events223- `quote-to-cash-process` — End-to-end Q2C; references OMS as the fulfillment leg post-order activation224225---226227## Official Sources Used228229- Salesforce Order Management Developer Guide v66.0 Spring '26 — https://developer.salesforce.com/docs/atlas.en-us.order_management_developer_guide.meta/order_management_developer_guide/230- Connect REST API Developer Guide — Order Management Actions — https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_order_management.htm231- Platform Events Developer Guide — https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_events_intro.htm232- Object Reference — OrderSummary — https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_ordersummary.htm233- Salesforce Well-Architected Overview — https://architect.salesforce.com/docs/architect/well-architected/guide/overview.html