--- schema_version: "1" id: 26dd04fdc0e6b3458ab57a2d2d00e8a0ec2259b32053eea3a811203dbd5d176c title: CartItem collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_cartitem.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_cartitem.htm source_site: developer.salesforce.com content_type: documentation content_hash: a663f8cf38d7b2fa9059dd82342e5bfe1cfb5a408bdd55c5a5e2c90a3fa5f0f7 description: Represents an item in a WebCart that’s active in a store built with B2B. Cart item can be of type Product or Charge. This object is available in API version 49.0 and later. --- # CartItem Represents an item in a WebCart that’s active in a store built with B2B. Cart item can be of type Product or Charge. This object is available in API version 49.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert() ## Special Access Rules The CartItem object is available only if the B2B Commerce license is enabled. ## Fields | Field | Details | | --- | --- | | AdjustmentAmount | Type currency Properties Create, Filter, Nillable, Sort, Update Description Non-itemized adjustments for this cart item. | | AdjustmentTax​Amount | Type currency Properties Create, Filter, Nillable, Sort, Update Description The tax that’s calculated on the AdjustmentAmount. | | AssociatedItem​Pricing | Type picklist Properties Create, Filter, Nillable, Sort, Update Description Specifies how a child cart item is priced relative to its parent cart item within a product bundle. This field is null for standalone products that aren't part of a bundle. Available in API version 65.0 and later. Possible values are: - IncludedInBundlePrice—Indicates that the parent product’s price includes the aggregated prices of its child components. - NotIncludedInBundlePrice—Indicates that the parent product’s price doesn’t include the aggregated prices of its child components. | | BillingFrequency | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Specifies how often a subscription is billed. Available in API version 59.0 and later. Possible values are: - Annual - MilestonePlan - Monthly - Quarterly - Semi-Annual | | CartDelivery​GroupId | Type reference Properties Create, Filter, Group, Sort, Update Description The ID of the CartDeliveryGroup that’s associated with a cart item. This field is a relationship field. Relationship Name CartDeliveryGroup Relationship Type Lookup Refers To CartDeliveryGroup | | CartId | Type reference Properties Create, Filter, Group, Sort Description The ID of the WebCart that’s associated with a cart item. This field is a relationship field. Relationship Name Cart Relationship Type Lookup Refers To WebCart | | ChildProduct​Count | Type int Properties Create, Defaulted on create, Filter, Group, Nillable, Sort, Update Description The total number of child products associated with this cart item. If a child product is a bundle, its own ChildProductCount is included in this total. For simple products that don’t have any child products, the ChildProductCount value is zero. | | Configure​DuringSale | Type picklist Properties Create, Filter, Nillable, Sort, Update Description Specify whether a product bundle is configurable. Available in API version 65.0 and later. Possible values are: - Allowed - NotAllowed | | CurrencyIsoCode | Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The ISO code for the currency that’s specified on the buyer’s account. Default value is USD. Possible values are: - AED—UAE Dirham - AUD—Australian Dollar - BRL—Brazilian Real - CAD—Canadian Dollar - EUR—Euro - GBP—British Pound - INR—Indian Rupee - JPY—Japanese Yen - SEK—Swedish Krona - USD—U.S. Dollar | | DistributedAdjustment​Amount | Type currency Properties Defaulted on create, Filter, Nillable, Sort Description A calculated field that determines the amount of a cart-wide promotional adjustment when distributed across all items in the cart. This field is for display purposes only and is valid only during checkout. This field is available in API version 52.0 and later. You receive $10 off, and there are 5 items in the cart. The distributed adjustment is (-$2). | | DistributedAdjustment​TaxAmount | Type currency Properties Defaulted on create, Filter, Nillable, Sort Description A calculated field that determines the amount of a cart-wide tax adjustment due to promotions when distributed across all items in the cart. This field is available in API version 52.0 and later. EXAMPLE: Your discount causes a cart-wide tax reduction of (-$10), and there are 5 items in the cart. The distributed tax adjustment is (-$2). | | EndQuantity | Type double Properties Create, Filter, Nillable, Sort, Update Description Indicates the final asset quantity when the subscription is modified or when it ends. | | FirstPymtPriceAferAdjustments | Type currency Properties Create, Filter, Nillable, Sort, Update Description The first term price for term-based subscription products, after price adjustments are applied. The total amount for a non-subscription product or a non-term based subscription product, after price adjustments are applied. This is available in API version 60.0 and later. | | FirstPymtTax | Type currency Properties Create, Filter, Nillable, Sort, Update Description The tax for the first term price for term-based subscription products. The tax amount for a non-subscription product or a non-term subscription product. This field is available in API version 60.0 and later. | | GrossAdjustment​Amount | Type currency Properties Filter, Nillable, Sort Description The gross amount of the price adjustment on the cart item (tax inclusive). This is available in API version 55.0 and later. | | GrossUnitPrice | Type currency Properties Create, Filter, Nillable, Sort, Update Description The gross amount of the unit price for a cart item (tax inclusive). This is available in API version 55.0 and later. | | IsShippingChargeNot​Applicable | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether shipping charges are applicable (true) or not (false) to the cart item. The default value is false. This field is available in API version 64.0 and later. | | ItemizedAdjustment​Amount | Type currency Properties Defaulted on create, Filter, Nillable, Sort Description A calculated field that determines the total amount of promotional adjustments that are specific to an item. This field is available in API version 52.0 and later. EXAMPLE: One cart item has one discount code for $10 off. Your itemized adjustment amount is (-$10) for that item. | | ItemizedAdjustment​TaxAmount | Type currency Properties Defaulted on create, Filter, Nillable, Sort Description A calculated field that determines the total amount of promotion-related tax adjustments that are specific to an item. This field is available in API version 52.0 and later. EXAMPLE: One cart item has one discount code for $10 off. This reduces the tax on that item by (-$2). Your itemized adjustment tax amount is (-$2) for that item. | | ListPrice | Type currency Properties Create, Filter, Nillable, Sort, Update Description The original price of the cart item. Typically shown with a line through it. List price is shown only when it’s higher than the negotiated price. If the list price is the same or lower, it isn’t shown to the buyer. This field is available in API version 52.0 and later. | | Name | Type string Properties Create, Filter, Group, idLookup, Sort, Update Description The name of this CartItem record. Name can be up to 255 characters. | | NetAdjustment​Amount | Type currency Properties Filter, Nillable, Sort Description The net amount of the price adjustment made on the cart item (tax exclusive). This is available in API version 55.0 and later. | | NetUnitPrice | Type currency Properties Create, Filter, Nillable, Sort, Update Description The net amount of the unit price for the cart item (tax exclusive). This is available in API version 55.0 and later. | | NetUnitPriceAfterAdjustments | Type currency Properties Create, Filter, Nillable, Sort, Update Description The net unit price for a cart item, after all tier and promotional price adjustments are applied. This field is available in API version 60.0 and later. | | ParentCart​ItemId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the cart item's parent CartItem. The value is empty if the item is a top-level cart item. This field is a relationship field. Relationship Name CartItem Relationship Type Lookup Refers To CartItem | | PerUnitWeight | Type double Properties Create, Filter, Nillable, Sort, Update Description Weight per unit of this cart item, in the unit specified by WeightUnit. This field is available in API version 62.0 and later. | | PeriodBoundary | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The. Default value is . Possible values are: - AlignToCalendar - Anniversary - DayOfPeriod - LastDayOfPeriod | | PeriodBoundaryDay | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The . | | PeriodBoundaryStartMonth | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The. Default value is . Possible values are: - 1—January - 10—October - 11—November - 12—December - 2—February - 3—March - 4—April - 5—May - 6—June - 7—July - 8—August - 9—September | | PriceBookEntryId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the price book entry for the product. This field is available in API version 60.0 and later. This field is a relationship field. Relationship Name PricebookEntry Relationship Type Lookup Refers To PricebookEntry | | PricingTermCount | Type double Properties Create, Filter, Nillable, Sort, Update Description A calculated field that indicates the number of pricing terms in the subscription. This field is available in API version 59.0 and later. | | Product2Id | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of a product type cart item. Cart items can be of type PRODUCT or CHARGE. This field is a relationship field. Relationship Name Product2 Relationship Type Lookup Refers To Product2 | | ProductClass | Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The product class of the cart item. Default value is Simple. Possible values are: - Bundle - Set - Simple - Variation - VariationParent | | ProductRelated​ComponentId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the cart item's ProductRelatedComponent. The ProductRelatedComponent represents a product that is included in a product bundle, a set, or a product and an add-on. The ProductRelatedComponent is empty if the item is a top-level cart item. This field is a relationship field. Relationship Name ProductRelatedComponent Relationship Type Lookup Refers To ProductRelatedComponent | | ProductSellingModelId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the model used to sell a product. This field is available in API version 59.0 or later. This field is a relationship field. Relationship Name ProductSellingModel Relationship Type Lookup Refers To ProductSellingModel | | ProductValidation​Key | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The product validation key of the cart item. | | ProductRelationshipTypeId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the product relationship type that defines the relationship between a product bundle and its child product. Available in API version 65.0 and later. This field is a relationship field. Relationship Name ProductRelationshipType Relationship Type Lookup Refers To [https://developer.salesforce.com/docs/atlas.en-us.object\_reference.meta/object\_reference/sforce\_api\_objects\_productrelationshiptype.htm](https://developer.salesforce.com/docs/atlas.en-us.264.0.object_reference.meta/object_reference/sforce_api_objects_productrelationshiptype.htm "HTML (New Window)")ProductRelationshipType | | ProrationPolicyId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the proration policy, which defines how prices are calculated for each time period within a subscription term. This field is available in API version 60.0 and later. This field is a relationship field. Relationship Name ProrationPolicy Relationship Type Lookup Refers To Proration Policy | | StartQuantity | Type double Properties Create, Filter, Nillable, Sort, Update Description Indicates the initial asset quantity when the subscription starts. | | Quantity | Type double Properties Create, Filter, Nillable, Sort, Update Description The number of a given cart item in a cart. | | QuoteLineItemId | Type reference Properties Create, Filter, Group, Sort, Update Description ID of the associated quote line item. Applicable only if the cart is created from a quote. | | QuantityScaleMethod | Type picklist Properties Create, Filter, Nillable, Sort, Update Description Determines how a child product's quantity scales when added to a cart or configured within a product bundle. Available in API version 65.0 and later. Possible values are: - Constant—Represents a value that remains fixed relative to the parent bundle. - Proportional—Represents a value that varies in proportion to the parent bundle’s price or quantity. | | SalesPrice | Type currency Properties Create, Filter, Nillable, Sort, Update Description The discounted price of a cart item. | | SellingModelType | Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The type of the product selling model associated with a term-based subscription product. This field is available in API version 60.0 and later. Possible values are: - Evergreen - OneTime - TermDefined The default value is OneTime. | | Sku | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The Shelf-Keeping Unit ID of a cart item. | | StockCheck​Method | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Determines how inventory is assessed for a cart item that’s part of a bundle or set. Possible values are: - ChildProducts—Inventory is assessed based on the child product or products. - ParentProduct—Inventory is assessed based on the parent product. | | SubType | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Specifies the subtype of the product. Possible values are: - Bonus—Bonus product. - GiftWrap—Gift wrapped product. This field is available in API version 64.0 and later. | | SubscriptionTerm | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The number of terms (years or months, for example) in the subscription. This field is available in API version 59.0 and later. | | TaxTreatment​Id | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the related tax treatment for the cart item. This field is available in API version 63.0 and later. This field is available with Subscription Management. This field is a relationship field. Relationship Name TaxTreatment Relationship Type Lookup Refers To TaxTreatment | | TotalAdjustment​Amount | Type currency Properties Create, Filter, Nillable, Sort, Update Description The total amount of all promotional adjustments on the item, both distributed and itemized. This field is available in API version 52.0 and later. | | TotalAmount | Type currency Properties Filter, Nillable, Sort Description The total cost of this cart item, including taxes and adjustments. | | TotalFirstPymtAdjAmount | Type currency Properties Create, Filter, Nillable, Sort, Update Description The total adjustment amount for the first payment of a term-based susbcription product. The TotalAdjustmentAmount for non-subscription products and non-term based subscription products. This field is available in API version 63.0 and later. | | TotalFirstPymtListPrice | Type currency Properties Create, Filter, Nillable, Sort, Update Description The first-payment amount for a term-based subscription product, based on the product's ListPrice. This is the same value as TotalListPrice for non-subscription products or non-term based subscription products. This price is only for comparison, and not the price at which the buyer purchases a product. This field is available in API version 63.0 and later. | | TotalFirstPymtPrice | Type currency Properties Create, Filter, Nillable, Sort, Update Description The first term price for term-based subscription products. The price of a line item for non-subscription products and non-term based subscription products. This price includes price adjustments and excludes taxes. This field is available in API version 63.0 and later. | | TotalLine​Amount | Type currency Properties Create, Filter, Nillable, Sort, Update Description Total amount for this cart item, based on sales price and quantity. | | TotalLineFirstPymtAmount | Type currency Properties Create, Filter, Nillable, Sort, Update Description The first term price for term-based subscripiton products, calculated based on the sales price and quantity, before any price adjustments are made. This is the same value as TotalLineAmount for non-subscription products and non-term based subscription products. This field is available in API version 63.0 and later. | | TotalLineFirstPymtTaxAmount | Type currency Properties Defaulted on create, Filter, Nillable, Sort Description The tax on the first payment amount, after price adjustments, for term-based subscription products. The tax on the price of the product for non-subscription products and non-term based subscription products. Taxes are also calculated on the delivery charge items. This field is a calculated field. This field is available in API version 63.0 and later. | | TotalLineGross​Amount | Type currency Properties Filter, Nillable, Sort Description The total gross amount of the line item (tax inclusive). This is available in API version 55.0 and later. | | TotalLineNet​Amount | Type currency Properties Filter, Nillable, Sort Description The total net amount of the line item (tax exclusive). This is available in API version 55.0 and later. | | TotalLineTax​Amount | Type currency Properties Defaulted on create, Filter, Nillable, Sort Description Total tax amount for TotalLineAmount. | | TotalListPrice | Type currency Properties Create, Filter, Nillable, Sort, Update Description Total amount for this cart item, based on ListPrice. We provide this value for comparison. It's not the price that the buyer is paying. | | TotalPrice | Type currency Properties Create, Filter, Nillable, Sort, Update Description Total amount for this cart item, including adjustments but excluding taxes. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note Although this field is Nillable, if you want to use [Commerce Webstore Cart Promotions](https://developer.salesforce.com/docs/atlas.en-us.264.0.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_cart_promotions.htm), this field is required. | | TotalPriceAfterAll​Adjustments | Type currency Properties Create, Filter, Nillable, Sort, Update Description Total price after all price adjustments are applied. This field is available in API version 52.0 and later. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note Although this field is Nillable, if you want to use [Commerce Webstore Cart Promotions](https://developer.salesforce.com/docs/atlas.en-us.264.0.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_cart_promotions.htm), this field is required. | | TotalPrice​TaxAmount | Type currency Properties Filter, Nillable, Sort Description Total tax amount for a cart item before promotional adjustments, including quantity-based adjustments. This field is available in API version 56.0 and later. | | TotalPromo​AdjustmentAmount | Type currency Properties Create, Defaulted on create, Filter, Nillable, Sort, Update Description Total itemized and distributed adjustment amount in cart (only for promotions). This field is available in API version 52.0 and later. | | TotalPromoAdjustment​TaxAmount | Type currency Properties Filter, Nillable, Sort Description Total itemized and distributed adjustment tax amount in cart (only for promotions). This field is available in API version 52.0 and later. | | TotalTaxAmount | Type currency Properties Filter, Nillable, Sort Description Total tax amount for this cart item. This value includes taxes for both TotalLineAmount and AdjustmentAmount. | | TotalWeight | Type double Properties Filter, Nillable, Sort Description Total weight of this cart item, in the unit specified by WeightUnit. This field is available in API version 62.0 and later. | | Type | Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The CartItem type. Possible values are: - Product - Charge | | UnitAdjusted​Price | Type currency Properties Create, Filter, Nillable, Sort, Update Description Price per quantity unit after a tier discount or surcharge is applied. This field is available in API version 50.0 and later. | | UnitAdjustedPrice​WithItemAdj | Type currency Properties Create, Filter, Nillable, Sort, Update Description Unit price, including both tier and item level discounts, for the item. | | UnitAdjustment​Amount | Type currency Properties Create, Filter, Nillable, Sort, Update Description Tier discount or surcharge to apply to a quantity unit. This amount is added to the SalesPrice to get the UnitAdjustedPrice. This field is available in API version 50.0 and later. | | UnitItemAdjustment​Amount | Type currency Properties Create, Filter, Nillable, Sort, Update Description Item level adjustments made to the unit price for the item. | | UnitPriceAfterAdjustments | Type currency Properties Create, Filter, Nillable, Sort, Update Description The unit price for a cart item, after tier and promotional price adjustments are applied. This field is available in API version 60.0 and later. | | WeightUnit | Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Unit of measurement for the weight of the cart item. This field is available in API version 62.0 and later. Possible values are: - Grams - Kilograms - Ounces - Pounds | ## Associated Objects This object has the following associated objects. Unless it’s noted, associated objects are available in the same API version as this object. [CartItemChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 58.0) Change events are available for the object. #### See Also - [Commerce Webstore Cart Promotions](https://developer.salesforce.com/docs/atlas.en-us.264.0.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_cart_promotions.htm "Commerce Webstore Cart Promotions - html (New Window)") - [Commerce Webstore Promotions, Associate Action](https://developer.salesforce.com/docs/atlas.en-us.264.0.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_promotions_actions_associate.htm "Commerce Webstore Promotions, Associate Action - html (New Window)") - [Commerce Webstore Promotions, Execute Action](https://developer.salesforce.com/docs/atlas.en-us.264.0.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_promotions_actions_execute.htm "Commerce Webstore Promotions, Execute Action - html (New Window)") - [CartDeliveryGroup](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_cartdeliverygroup.htm "Represents shipping information for the delivery of items in an order against a store built with B2B Commerce or D2C Commerce. This object is available in API version 49.0 and later.") - [WebCart](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_webcart.htm "Represents an online shopping cart for a store built with B2B Commerce or D2C Commerce, with total amounts for products, shipping and handling, and taxes. This object is available in API version 49.0 and later.")