--- schema_version: "1" id: f90b962a5ca9ea09383062389a2c462bdd578ad19bc3bde885d6fe3b3381bd56 title: OrderItem collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/industries/advanced-orders-for-telesales/references/standard-objects/order-item.md canonical_url: https://developer.salesforce.com/docs/industries/advanced-orders-for-telesales/references/advanced-orders-for-telesales-objects/order-item.html source_site: developer.salesforce.com content_type: documentation content_hash: b3694dbe2a822399a9d32259014e7effe54a56a806db3e83df56d223ac35e82a products: - Advanced Orders for Telesales Developer Guide - Industries Developer Documentation --- # OrderItem Standard object representing a single line item (product or charge) on an Order. In Manufacturing/Automotive/Consumer Goods Cloud orgs with Advanced Orders enabled, OrderItem is extended with fields linking each line to an OrderItemSpec template and carrying additional pricing/quantity metadata used during order capture and pricing calculation. This object is available in API version 68.0 and later. ## Supported Calls `create()`, `delete()`, `describeLayout()`, `describeSObjects()`, `getDeleted()`, `getUpdated()`, `query()`, `retrieve()`, `update()`, `upsert()` ## Special Access Rules No additional setup or permissions beyond standard object- and field-level security are required to use the standard OrderItem object. The Manufacturing/Automotive/Consumer Goods-specific extension field OrderItemSpecId, along with related quantity/pricing fields (RecommendedQuantity, TargetQuantity, IsPreviouslyOrderedItem, IsPromotedProduct, FreeItemParentType, FreeItemPricingStep), requires the Advanced Orders feature to be enabled and populated. ## Fields ### AvailableQuantity **Type:** double **Properties:** Filter, Nillable, Sort **Description:** The quantity of the ordered product currently available to fulfill this line item. This is a calculated, read-only field. ### CurrencyIsoCode **Type:** picklist **Properties:** Defaulted on create, Filter, Group, Restricted picklist, Sort **Description:** The ISO code for the currency of this record. Possible values are: AED (UAE Dirham), USD (U.S. Dollar), and every other active currency ISO code configured for the org. The default value is USD. ### Description **Type:** string **Properties:** Create, Filter, Group, Nillable, Sort, Update **Description:** A text description of the order line item. ### Discount **Type:** percent **Properties:** Create, Filter, Nillable, Sort, Update **Description:** The discount percentage applied to this line item. ### EndDate **Type:** date **Properties:** Create, Filter, Group, Nillable, Sort, Update **Description:** The date this order line item's terms end. ### FreeItemParentType **Type:** picklist **Properties:** Create, Filter, Group, Nillable, Restricted picklist, Sort, Update **Description:** Specifies the type of parent record associated with the free item. Possible values are Item, Order, and Reward. ### FreeItemPricingStep **Type:** string **Properties:** Create, Filter, Group, Nillable, Sort, Update **Description:** The calculation step or rule that generates the free item. ### IsAuthorizationListProduct **Type:** boolean **Properties:** Create, Defaulted on create, Filter, Group, Sort, Update **Description:** Indicates whether the product on this line item belongs to the account's product authorization list. The default value is false. ### IsOutOfStock **Type:** boolean **Properties:** Create, Defaulted on create, Filter, Group, Sort, Update **Description:** Indicates whether the ordered product was out of stock at the time of order capture. The default value is false. ### IsPreviouslyOrderedItem **Type:** boolean **Properties:** Create, Defaulted on create, Filter, Group, Sort, Update **Description:** Indicates whether this product was previously ordered by the account. The default value is false. ### IsPromotedProduct **Type:** boolean **Properties:** Create, Defaulted on create, Filter, Group, Sort, Update **Description:** Indicates whether this product was promoted (recommended or suggested) to the buyer during order capture. The default value is false. ### ListPrice **Type:** currency **Properties:** Create, Filter, Nillable, Sort **Description:** The list price of the product before any discounts or pricing adjustments. ### ManualOverridePrice **Type:** currency **Properties:** Create, Filter, Nillable, Sort, Update **Description:** A manually entered price that overrides the pricing engine's calculated price. ### NetTotalPrice **Type:** currency **Properties:** Create, Filter, Nillable, Sort, Update **Description:** The net total price for this line item (unit price × quantity) after all pricing adjustments. ### NetUnitPrice **Type:** currency **Properties:** Create, Filter, Nillable, Sort, Update **Description:** The net unit price for this line item after all pricing adjustments. ### OrderId **Type:** reference **Properties:** Create, Filter, Group, Sort **Description:** The parent Order this line item belongs to. **Relationship Name:** Order **Refers To:** Order ### OrderItemNumber **Type:** string **Properties:** Autonumber, Defaulted on create, Filter, idLookup, Sort **Description:** The auto-generated line item number. ### OrderItemSpecId **Type:** reference **Properties:** Create, Filter, Group, Nillable, Sort, Update **Description:** The OrderItemSpec (line-item specification template) that governs this line item's behavior. Part of the Advanced Orders feature. **Relationship Name:** OrderItemSpec **Refers To:** OrderItemSpec ### OriginalOrderItemId **Type:** reference **Properties:** Create, Filter, Group, Nillable, Sort **Description:** The original OrderItem this line item references, for example on a change or return order. **Relationship Name:** OriginalOrderItem **Refers To:** OrderItem ### PriceWaterfallIdentifier **Type:** string **Properties:** Filter, Group, Nillable, Sort **Description:** The waterfall execution identifier generated by the pricing procedure for this line item. ### PricebookEntryId **Type:** reference **Properties:** Create, Filter, Group, Nillable, Sort **Description:** The PricebookEntry that determines the pricing for this line item. **Relationship Name:** PricebookEntry **Refers To:** PricebookEntry ### Product2Id **Type:** reference **Properties:** Create, Filter, Group, Nillable, Sort **Description:** The Product2 ordered on this line item. **Relationship Name:** Product2 **Refers To:** Product2 ### QtyModificationReason **Type:** picklist **Properties:** Create, Filter, Group, Nillable, Sort, Update **Description:** The reason the ordered quantity was modified from its original or recommended value. ### Quantity **Type:** double **Properties:** Create, Filter, Sort, Update **Description:** The quantity of the product ordered on this line item. ### QuantityUnitOfMeasureId **Type:** reference **Properties:** Create, Filter, Group, Nillable, Sort **Description:** The UnitOfMeasure in which Quantity is expressed. **Relationship Name:** QuantityUnitOfMeasure **Refers To:** UnitOfMeasure ### RcvQuantityMismatchRsn **Type:** picklist **Properties:** Create, Filter, Group, Nillable, Sort, Update **Description:** The reason for a mismatch between the ordered and received quantity. ### RecommendedQuantity **Type:** double **Properties:** Create, Filter, Nillable, Sort, Update **Description:** The quantity recommended for this line item, for example by a replenishment or AI recommendation engine. ### RelatedOrderItemId **Type:** reference **Properties:** Filter, Group, Nillable, Sort **Description:** A related OrderItem, such as a corresponding line on a linked order. **Relationship Name:** RelatedOrderItem **Refers To:** OrderItem ### RemainingQuantity **Type:** double **Properties:** Create, Filter, Nillable, Sort, Update **Description:** The quantity of this line item still remaining to be fulfilled. ### RoundedLineAmount **Type:** currency **Properties:** Filter, Nillable, Sort **Description:** The line amount for this item after rounding rules are applied. This is a calculated, read-only field. ### ServiceDate **Type:** date **Properties:** Create, Filter, Group, Nillable, Sort, Update **Description:** The date the product or service on this line item is to be delivered or performed. ### TargetQuantity **Type:** double **Properties:** Create, Filter, Nillable, Sort, Update **Description:** The target quantity for this line item, used for goal-based or promotional order guidance. ### TotalAdjustmentAmount **Type:** currency **Properties:** Create, Filter, Sort, Update **Description:** The total amount of pricing adjustments applied to this line item. ### TotalAmtWithTax **Type:** currency **Properties:** Filter, Nillable, Sort **Description:** The total amount for this line item, including tax. This is a calculated, read-only field. ### TotalLineAmount **Type:** currency **Properties:** Create, Filter, Nillable, Sort, Update **Description:** The total amount for this line item, excluding tax. ### TotalPrice **Type:** currency **Properties:** Filter, Nillable, Sort **Description:** The total price for this line item (unit price × quantity), before adjustments. This is a calculated, read-only field. ### TotalTaxAmount **Type:** currency **Properties:** Create, Filter, Sort, Update **Description:** The total tax amount for this line item. ### Type **Type:** picklist **Properties:** Create, Filter, Group, Nillable, Restricted picklist, Sort, Update **Description:** The type of line item. Possible values are Delivery Charge, Fee, and Order Product. ### TypeCode **Type:** picklist **Properties:** Filter, Group, Nillable, Restricted picklist, Sort **Description:** The system type code of the line item. Possible values are Charge and Product. ### UnitPrice **Type:** currency **Properties:** Create, Filter, Nillable, Sort, Update **Description:** The unit price for this line item before pricing adjustments. ## Associated Objects This object has the following associated objects. If the API version isn't specified, they're available in the same API versions as this object. Otherwise, they're available in the specified API version and later. - [OrderItemChangeEvent](https://developer.salesforce.com/docs/industries/advanced-orders-for-telesales/references/associated-objects/change-event.md): Change events are available for the object. - [OrderItemFeed](https://developer.salesforce.com/docs/industries/advanced-orders-for-telesales/references/associated-objects/feed.md): Feed tracking is available for the object. - [OrderItemHistory](https://developer.salesforce.com/docs/industries/advanced-orders-for-telesales/references/associated-objects/history.md): History is available for tracked fields of the object. - [OrderItemOwnerSharingRule](https://developer.salesforce.com/docs/industries/advanced-orders-for-telesales/references/associated-objects/owner-sharing-rule.md): Sharing rules are available for the object. - [OrderItemShare](https://developer.salesforce.com/docs/industries/advanced-orders-for-telesales/references/associated-objects/share.md): Sharing is available for the object.