You are here:
Activate Order Action
In a B2B Commerce Checkout flow, activate a Salesforce standard draft order.
Required Editions
| Available in: Lightning Experience |
| View supported editions. |
In Flow Builder, add an Action element to your flow. Select the B2B
Commerce category, and search for Activate Order. To
access this action from the API, use the name
activateOrderAction.
Set Input Values:
Use values from earlier in the flow to set the inputs.
| Input Parameter | Description |
|---|---|
| cartId | The ID of the cart that transitions into a checkout. |
| orderStatus | A DynamicEnum with the OrderTypeEnum value. |
Store Output Values:
| Output Parameter | Description |
|---|---|
| backgroundOperationId | The ID of the background operation that processes the total price of all items in the cart. |
Error Conditions:
| Error Condition | Description |
|---|---|
| Invalid CartId Input | The cart ID value isn’t accepted. Error Code: UNKNOWN_EXCEPTION HTTP Status Code: 500 |
| User Can’t Invoke Action | The caller doesn’t have the appropriate permissions to call the action, including the MAD or B2B Commerce Integrator user perms. Error Code: BAD_REQUEST HTTP Status Code: 400 |
| User Doesn’t Have Access to the Cart | The buyer doesn’t own the cart, doesn’t have read access to the cart, or the cart isn’t shared with the buyer. Error Code: BAD_REQUEST HTTP Status Code: 400 |
| The Cart Isn’t in the Checkout State | The cart status isn’t in the Checkout state and can’t continue. Error Code: INVALID_OPERATION HTTP Status Code: 403 |
| Integration Is Already in Progress | Only one integration can be processed at a time. This error indicates when an integration is already running. Error Code: ALREADY_IN_PROCESS HTTP Status Code: 400 |
| Account Associated With the Cart Isn’t Valid or Accessible | The effective account listed isn’t valid. Error Code: INSUFFICIENT_ACCESS_OR_READONLY HTTP Status Code: 500 |
| User Isn’t a Member of the Store | The user isn’t a member of the store. Error Code: INSUFFICIENT_ACCESS_OR_READONLY HTTP Status Code: 500 |
| CartValidationOutput Object Has Errors | The CartValidationOutput object has errors that are related to the cart that need to be cleared before order activation. Error Code: INVALID_INPUT HTTP Status Code: 403 |
| CheckoutSession Isn’t in the Activate State | Checkout Session state must be in the Activate state for the order activation to go forward. Error Code: INVALID_INPUT HTTP Status Code: 403 |
| CheckoutSession Is in the Processing State | CheckoutSession can’t be in the Processing state. Processing indicates a separate integration is already running. Error Code: INVALID_INPUT HTTP Status Code: 403 |
| Invalid Order Status Input | The Order status input that is passed to the API must be the
Error Code: UNKNOWN_EXCEPTION HTTP Status Code: 500 |
| OrderSummary Wasn’t Created | The OrderSummary wasn’t created due to an internal error. Error Code: UNKNOWN_EXCEPTION HTTP Status Code: 403 |
| OrderSummary Already Exists | Another Apex trigger, Flow-based trigger, or other process has already created an OrderSummary for the order passed to the order activation. Error Code: UNKNOWN_EXCEPTION HTTP Status Code: 500 |
Usage:
To use the B2B Commerce Activate Order action, these requirements apply.
- The user has the appropriate permissions to invoke the action.
- The effective account is valid.
- The buyer account is a member of the store.
- The buyer has edit access to the cart.
- An order in
Draftstatus is generated from the cartToOrder action, and the orderId is in CartCheckoutSession. - The cart status is
CartStatusEnum.CHECKOUT. Session.IsProcessingisn’t set toFalse.Session.NextStateis set toactivateOrder.Session.Statecan’t be empty.- backgroundOperationId can’t be
NeworRunning. - The order being activated can’t already be associated to an OrderSummary record.
When the Activate Order action runs, these API interactions occur.
- The order item is activated, making it read-only.
- The order summary is generated asynchronously.
- The CheckoutSession is archived.
- The cart is archived.
