Loading
Prepare for Email to Become the Default Login ExperienceRead More
Automate Your Business Processes with Salesforce Flow
Add Cart Item Action

Add Cart Item Action

In a B2B Commerce Checkout flow, add an item to a cart.

Required Editions

Available in: Lightning Experience
View supported editions.
Note
Note Cart actions aren’t available in flows for B2B stores built on an Aura template. To build a B2B Commerce Checkout flow for an Aura store, see B2B Commerce Checkout Flow (Aura).

In Flow Builder, add an Action element to your flow. Select the Commerce category, and search for Add Cart Item. To access this action from REST API, use the name addCartItem.

Set Input Values

Use values from earlier in the flow to set the inputs.

Input ParameterDescription
Cart State or ID ID of the cart or state of the cart to add an item to. Valid state values are: active and current. A current cart is not closed or pending deletion.
effectiveAccountId (Optional) ID of the buyer account or guest buyer profile for which the request is made. If unspecified, the default value is determined from context.
Web Store ID The ID of the web store.
Cart Item Input

This input is an Apex-defined variable of class ConnectApi.CartItemInput, which includes these fields:

  • productId — ID of the product.
  • quantity — Quantity of the cart item. Use a value that can be converted to BigDecimal.
  • type — Type of the cart item. The only valid value is Product.

Store Output Values

Use output values later in the flow. The values are assigned when the item is created.

Output ParameterDescription
Added Cart Item

This output is an Apex-defined variable of class ConnectApi.CartItem, which includes these fields:

  • itemizedAdjustment​Amount — Total itemized adjustment amount for the item, including promotions and excluding taxes.
  • listPrice — List price for the item.
  • salesPrice — Sales price for the item.
  • totalAdjustmentAmount — Adjustments made to the unit price for the item. This value is informational only and isn’t used in pricing calculations.
  • totalAmount — Total amount for the item.
  • totalListPrice — Total list price for the item.
  • totalPrice — Total price for the item including adjustments but excluding taxes.
  • totalTax — Total tax for the item.
  • unitAdjustedPrice — Unit price, including adjustments, for the item. This value is informational only and isn’t used in pricing calculations.
  • unitAdjustmentAmount — Total amount including discounts, but excluding shipping and tax, for product items in the cart.

Error Conditions

Error Condition Description

The user doesn’t have access to the cart.

Error Message: You don't have access to this cart. If possible, contact the admin for this web store.

Error Code: INSUFFICIENT_ACCESS_OR_READONLY

HTTP Status Code: 400

 
Loading
Salesforce Help | Article