QuoteLineItem

Represents a quote line item, which is a member of the list of Product2 products associated with a quote, along with other information about those line items on that quote.

Introduced in API version 17.0.

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

  • The user must have “Edit” permissions on quote records to create or update quote line items on a quote. The user must have “Edit” permissions on quote records to delete a quote line item.
  • Some of the fields are available when you turn on Subscription Management.
  • Type: double
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 64.0
  • Type: percent
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 68.0
  • Type: textarea
  • Properties: Nillable
  • Introduced: API version 68.0

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 58.0

  • Relationship name: BasisTransactionItem

  • Relationship type: relationship

  • Refers to: QuoteLineItem

  • Type: string
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 64.0
  • Description: Identifier for a product bundle in a transaction processing batch. This value makes sure that quote lines from the same bundles process together.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 54.0
  • Description: The time period that indicates how often the quote line item is billed. This field is available when Subscription Management is enabled.
  • Possible values:
    • Annual — Annual
    • Monthly — Monthly
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort
  • Introduced: API version 61.0
  • Description: Reference to the original quote for which this quote line item is created.

  • Type: int

  • Properties: Create, Defaulted on create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 68.0

  • Default value: 1

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 61.0

  • Relationship name: BillingTreatment

  • Relationship type: relationship

  • Refers to: BillingTreatment

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 62.0
  • Description: Custom product name for the quote line item.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Text description of the line item. Limit: 225 characters.
  • Type: percent
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The optional discount percentage, specified by the sales representative at the line level. Editable number from 0 to 100.
  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 59.0
  • Description: The fixed amount discount to apply to the quote line item.

  • Type: boolean

  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update

  • Introduced: API version 64.0

  • Description:

    Indicates that the quote line item is set to automatically renew (True) or not (False).

    The default value is false.

  • Default value: false

  • Type: date
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 62.0
  • Description: The date on which the resources associated with the quote line item are granted.

  • Type: date

  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Introduced: API version 54.0

  • Description:

    If the quote line item is sold on subscription, this field indicates the date on which the subscription ends. This field is available if Subscription Management is enabled in your org.

    You can indicate a subscription’s length by using either StartDate and EndDate, or by using StartDate and SubscriptionTerm. If you provide a value for both EndDate and SubscriptionTerm, EndDate is used to determine the subscription’s length.

  • Type: datetime

  • Properties: Filter, Nillable, Sort

  • Introduced: API version 65.0

  • Description:

    The end date and time of the quote line item, which is derived from the End Date and End Time fields in the time zone specified in the Start and End Time Zone field. If the time zone isn’t specified, the default is Coordinated Universal Time (UTC).

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: double
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 60.0
  • Description: If the quote line item is sold on a subscription, this field indicates the end quantity when the subscription ends. This field is available with Subscription Management.

  • Type: time

  • Properties: Create, Filter, Nillable, Sort, Update

  • Introduced: API version 65.0

  • Description:

    The end time of the quote line item.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: boolean
  • Properties: Defaulted on create, Filter, Group, Sort
  • Description: Read-only. Indicates whether the opportunity line item that the quote line item is synced with has a quantity schedule.
  • Default value: false
  • Type: boolean
  • Properties: Defaulted on create, Filter, Group, Sort
  • Description: Read-only. Indicates whether the opportunity line item that the quote line item is synced with has a revenue schedule. If this object has a revenue schedule, the GrandTotal and TotalPrice fields can’t be updated. In addition, the Quantity field can’t be updated if this object has a quantity schedule. The system ignores any attempt to update this field. The update isn’t rejected but the updated value is ignored.
  • Default value: false
  • Type: boolean
  • Properties: Defaulted on create, Filter, Group, Sort
  • Description: Read-only. Indicates whether the line item uses schedules.
  • Default value: false

  • Type: boolean

  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update

  • Introduced: API version 62.0

  • Description:

    Indicates whether the segment for the quote line item is a primary segment (true) or not (false).

    The default value is false.

  • Default value: false

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 61.0

  • Description:

    The ID of the legal entity record associated with the quote line item.

    This field is a relationship field.

  • Relationship name: LegalEntity

  • Relationship type: relationship

  • Refers to: LegalEntity

  • Type: string
  • Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
  • Description: Read-only. An automatically generated number identifying the quote line item. In the form of QL-XXXXX.
  • Type: currency
  • Properties: Filter, Nillable, Sort
  • Description: Read-only. Corresponds to the UnitPrice on the PricebookEntry that is associated with this line item, which can be in the standard price book or a custom price book. A client app can use this information to show whether the unit price (or sales price) of the line item differs from the price book entry list price.
  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 54.0
  • Description: The ListPrice times the Quantity. This field is a calculated field.

  • Type: percent

  • Properties: Create, Filter, Nillable, Sort, Update

  • Introduced: API version 65.0

  • Description:

    The optional margin percentage, specified by the sales representative at the line item level.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: currency

  • Properties: Create, Filter, Nillable, Sort, Update

  • Introduced: API version 65.0

  • Description:

    The optional margin amount, specified by the sales representative at the line item level.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 56.0
  • Description: The price after all adjustments, inclusive of quantity, prorated for the duration of the subscription. This field is a calculated field equal to TotalAdjustmentAmount plus TotalLineAmount. This field is available with Subscription Management.
  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 54.0
  • Description: The unit price after all price adjustments are applied.
  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort
  • Introduced: API version 40.0
  • Description: ID of the related opportunity line item. This field is populated by the API during creation of the quote line item. Not editable.
  • Relationship name: OpportunityLineItem
  • Relationship type: relationship
  • Refers to: OpportunityLineItem

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 57.0

  • Description:

    The unique identifier of the related line item in the parent quote.

    This field is populated by the API during creation of the quote line item.

    This field is available in version 58.0 and later. This field is available when Subscription Management is enabled.

    This field is a relationship field.

  • Relationship name: ParentQuoteLineItem

  • Relationship type: relationship

  • Refers to: QuoteLineItem

  • Type: percent
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 59.0
  • Description: The partner’s discount percent applied to the quote lines.
  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 59.0
  • Description: The unit price after applying the discount given to the partner for the quote line item.

  • Type: picklist

  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Introduced: API version 54.0

  • Description:

    The period boundary helps determine the start and end date of the billing periods. This field is available with Subscription Management and Revenue Cloud.

    Keep these considerations in mind for amendment, renewal, and cancellations of assets in Revenue Cloud.

    • The value of the PeriodBoundary field is copied from the AssetActionSource (initial sale), by default.
    • For termed selling models where the PeriodBoundary value is Anniversary, the value of the PeriodBoundary field is automatically converted to DayOfPeriod.
    • Start date adjustment operation on an asset preserves the original value without conversion.

  • Possible values:

    • AlignToCalendar — AlignToCalendar — the period starts on the first day of the term unit; for example, the first day of the month.
    • Anniversary — Anniversary — The start date determines the boundary. For example, if a monthly subscription starts on September 13, the subscription starts on the 13th day of each month.
    • DayOfPeriod — DayOfPeriod — the period starts on the day indicated by PeriodBoundaryDay.
    • LastDayOfPeriod — LastDayOfPeriod — the period starts on the last day of the pricing term unit.

  • Type: int

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 54.0

  • Description:

    Required when PeriodBoundary is DayOfPeriod. Indicates day of the week or month that marks the period boundary. Must be an integer from 1 through 31. This field is available with Subscription Management and Revenue Cloud.

    Keep these considerations in mind for amendment, renewal, and cancellations of assets in Revenue Cloud.

    • The value of the PeriodBoundary field is copied from the AssetActionSource (initial sale), by default.
    • When PeriodBoundary field value is converted from Anniversary to DayOfPeriod for termed selling models, the value of the PeriodBoundaryDay field is automatically populated with the day value from AssetActionSource.StartDate.
    • Start date adjustment operation on an asset preserves the original value without conversion.

  • Type: picklist

  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Introduced: API version 58.0

  • Description:

    The field is populated based on input in the StartDate, PeriodBoundary, and PeriodBoundaryDay when BillingFrequency is Annual and PricingTermUnit is Annual or by manual user entry.

    Keep these considerations in mind for amendment, renewal, and cancellations of assets in Revenue Cloud.

    • The value of the PeriodBoundary field is copied from the AssetActionSource (initial sale), by default.
    • For termed selling models where PeriodBoundary field value is Anniversary and PricingTermUnit field value is ANNUAL, SEMI_ANNUAL, or QUARTERLY, the value of the PeriodBoundaryStartMonth field is automatically recalculated by using AssetActionSource.StartDate.month.
    • Start date adjustment operation on an asset preserves the original value without conversion.

  • Possible values:

    • 1-January — 1-January
    • 2-February — 2-February
    • 3-March — 3-March
    • 4-April — 4-April
    • 5-May — 5-May
    • 6-June — 6-June
    • 7-July — 7-July
    • 8-August — 8-August
    • 9-September — 9-September
    • 10-October — 10-October
    • 11-November — 11-November
    • 12-December — 12-December

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 65.0

  • Description:

    The price uplift policy associated with this quote line item.

    This field is a relationship field.

  • Relationship name: PriceRevisionPolicy

  • Relationship type: relationship

  • Refers to: PriceRevisionPolicy

  • Type: string
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 60.0
  • Description: The price waterfall identifier generated by Salesforce Pricing that’s associated with the pricing of the detail record.
  • Type: reference
  • Properties: Create, Filter, Group, Sort
  • Description: Required. ID of the associated PricebookEntry. Exists only for orgs with Products enabled. In API 38.0 and earlier, if Product2Id is populated with PricebookEntryId data, you receive an error message. In API 39.0 and later, Product2Id is nulled, and PricebookEntryId is populated with the PricebookEntryId data.
  • Relationship name: PricebookEntry
  • Relationship type: relationship
  • Refers to: PricebookEntry

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 63.0

  • Description:

    The contract used for pricing that’s associated with the quote line item.

    This field is a relationship field.

  • Relationship name: PricingContract

  • Relationship type: relationship

  • Refers to: Contract

  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Introduced: API version 68.0
  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 55.0
  • Description: The number of terms in the subscription. For example, if a monthly subscription is priced yearly, this field is 12. This field is available with Subscription Management.
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 54.0
  • Description: A calculated field indicating the number of pricing terms in the subscription. This field is available with Subscription Management.
  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Introduced: API version 55.0
  • Description: The unit of time for the pricing term. This field is available with Subscription Management.
  • Possible values:
    • Annual — Annual — Available in API version 58.0 and later. UI label is Years.
    • Months — Months
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort
  • Introduced: API version 58.0
  • Type: reference
  • Properties: Create, Filter, Group, Sort
  • Introduced: API version 30.0
  • Description: Required. ID of the Product2 associated with this QuoteLineItem. In API 38.0 and earlier, if Product2Id is populated with PricebookEntryId data, you receive an error message. In API 39.0 and later, Product2Id is nulled, and PricebookEntryId is populated with the PricebookEntryId data.
  • Relationship name: Product2
  • Relationship type: relationship
  • Refers to: Product2
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 62.0
  • Description: The ID of the product instance that’s added to a quote. Each quote line item created for the same product instance has the same product instance identifier value.

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 55.0

  • Description:

    The ID of the related product selling model. This field is available with Subscription Management.

    This field is a relationship field.

  • Relationship name: ProductSellingModel

  • Relationship type: relationship

  • Refers to: ProductSellingModel

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 54.0

  • Description:

    The ID of the related proration policy. This field is available with Subscription Management.

    This field is a relationship field.

  • Relationship name: ProrationPolicy

  • Relationship type: relationship

  • Refers to: ProrationPolicy

  • Type: double
  • Properties: Create, Filter, Sort, Update
  • Description: Required. The number of units for the line item.

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 58.0

  • Description:

    The ID of the related quote action. This field is available with Subscription Management and Revenue Lifecycle Management.

    This field is a relationship field.

  • Relationship name: QuoteAction

  • Relationship type: relationship

  • Refers to: QuoteAction

  • Type: reference
  • Properties: Create, Filter, Group, Sort
  • Description: Required. ID of the associated quote.
  • Relationship name: Quote
  • Relationship type: masterdetail
  • Refers to: Quote

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 61.0

  • Description:

    The ID of the quote line group for the quote line item.

    This field is a relationship field.

  • Relationship name: QuoteLineGroup

  • Relationship type: relationship

  • Refers to: QuoteLineGroup

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 62.0

  • Description:

    The ID of the recipient for the quote line item.

    This field is a relationship field.

  • Relationship name: QuoteLineItemRecipient

  • Relationship type: relationship

  • Refers to: QuoteLineItemRecipient

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort
  • Introduced: API version 66.0

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 64.0

  • Relationship name: QuoteRecipientGroup

  • Relationship type: relationship

  • Refers to: QuoteRecipientGroup

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 62.0
  • Description: The ramp ID used to group quote line item segments.
  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Introduced: API version 68.0
  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 64.0

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 65.0

  • Description:

    The quote line item ID related to the order item created.

    This field is a relationship field.

  • Relationship name: RelatedQuoteLineItem

  • Relationship type: relationship

  • Refers to: QuoteLineItem

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 66.0

  • Relationship name: ReplacementGroup

  • Relationship type: relationship

  • Refers to: QuoteLineGroup

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 63.0
  • Type: string
  • Properties: Create, Filter, Group, idLookup, Nillable, Sort, Update
  • Introduced: API version 62.0
  • Description: The ID of the segment.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 62.0
  • Description: The name of the quote line item segment.

  • Type: picklist

  • Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Introduced: API version 62.0

  • Description:

    The time period for the segment.

    The default value is Yearly.

  • Possible values:

    • Custom — Custom
    • FreeTrial — FreeTrial — Free Trial
    • Prorated — Prorated
    • Yearly — Yearly (default)

  • Default value: Yearly

  • Type: picklist

  • Properties: Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort

  • Introduced: API version 55.0

  • Description:

    Indicates whether the quote line item is sold as a one-time purchase, an evergreen subscription, or as a termed subscription. This field is available with Subscription Management.

    The default value is OneTime.

  • Possible values:

    • Evergreen — Evergreen
    • OneTime — OneTime (default)
    • TermDefined — TermDefined

  • Default value: OneTime

  • Type: date
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The date when the product revenue is recognized and the product quantity is shipped.
  • Type: int
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 21.0
  • Description: The value of where the line item is in the sorted order such as 1, 2, 3. The SortOrder value determines the order in which a quote line item appears in the Quote Line Items related list and the Quote PDF. Client apps can use this value to match the sort order in Salesforce. This field is only available in API versions 21.0 and greater.
  • Type: date
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 54.0
  • Description: If the quote line item is sold on subscription, this field indicates the date on which the subscription starts. This field is available with Subscription Management.

  • Type: datetime

  • Properties: Filter, Nillable, Sort

  • Introduced: API version 65.0

  • Description:

    The start date and time of the quote line item, which is derived from the Start Date and Start Time fields in the time zone specified in the Start and End Time Zone field. If the time zone isn’t specified, the default is Coordinated Universal Time (UTC).

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: picklist

  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Introduced: API version 65.0

  • Description:

    The time zone for the quote line item’s start and end dates, times, and datetimes.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 60.0
  • Description: If the quote line item is sold on a subscription, this field indicates the item quantity when the subscription starts. This field is available with Subscription Management.

  • Type: time

  • Properties: Create, Filter, Nillable, Sort, Update

  • Introduced: API version 65.0

  • Description:

    The start time of the quote line item.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 54.0
  • Description: The starting unit price times the quantity.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 54.0
  • Description: Indicates whether the starting unit price was entered manually or calculated. This field is available with Subscription Management.
  • Possible values:
    • Manual — Manual
    • System — System
    • Inherited — Inherited

  • Type: int

  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Introduced: API version 54.0

  • Description:

    The number of terms in the subscription.

    You can indicate a subscription’s length by using either StartDate and EndDate, or by using StartDate and SubscriptionTerm. If you provide a value for both EndDate and SubscriptionTerm, EndDate is used and SubscriptionTerm is ignored.

  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Introduced: API version 54.0
  • Description: The unit of time used to define the subscription. This field is available with Subscription Management.
  • Possible values:
    • Annual — Annual — UI label is Years
    • Months — Months
  • Type: currency
  • Properties: Filter, Nillable, Sort
  • Description: The line item’s Quantity multiplied by the UnitPrice. In Revenue Cloud, Subtotal is set to TotalLineAmount when TotalLineAmount has a value.

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 55.0

  • Relationship name: TaxTreatment

  • Relationship type: relationship

  • Refers to: TaxTreatment

  • Type: percent

  • Properties: Filter, Nillable, Sort

  • Introduced: API version 65.0

  • Description:

    The total discount percentage applied at the line item level. This percentage is calculated by using the formula: (Total Line Amount - Net Total Price) / Total Line Amount.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 56.0
  • Description: The sum of the adjustments applied to the quote line item, inclusive of quantity, prorated for the duration of the subscription. This field is available with Subscription Management.

  • Type: currency

  • Properties: Filter, Nillable, Sort

  • Introduced: API version 65.0

  • Description:

    The total cost of all products sold in the quote, calculated by multiplying the quantity by the unit cost.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 56.0
  • Description: The total price of the quote line item, before price adjustments, inclusive of quantity, prorated for the duration of the subscription. This price is a calculated field equal to ListPrice times Quantity times PricingTermCount. This field is available with Subscription Management.

  • Type: percent

  • Properties: Filter, Nillable, Sort

  • Introduced: API version 65.0

  • Description:

    The effective margin percentage at the line item level. This percentage is calculated by using the formula: (Net Total Price - Total Cost) / Net Total Price.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: currency

  • Properties: Filter, Nillable, Sort

  • Introduced: API version 65.0

  • Description:

    The effective margin amount at the line item level. This amount is calculated by subtracting total cost from net total price.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: currency
  • Properties: Filter, Nillable, Sort
  • Description: Read-only. Calculated by applying the Discount to the Subtotal. This field is nillable, but you can’t set both TotalPrice and to null in the same update. To insert the for a quote line item via the API (given only a unit price and the quantity), calculate this field as the unit price multiplied by the quantity. This field is read only if the quote line item has a revenue schedule.
  • Type: currency
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 54.0
  • Type: currency
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 54.0

  • Type: currency

  • Properties: Create, Filter, Nillable, Sort, Update

  • Introduced: API version 65.0

  • Description:

    The unit cost of a product sold as part of the quote.

    This field is available in Revenue Cloud in API version 65.0 and later.

  • Type: currency
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Required. The price per unit for the quote line item.
  • Type: percent
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 64.0
  • Description: The percentage increase of the quote line item’s unit price.

  • Type: picklist

  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Introduced: API version 60.0

  • Description:

    Specifies whether the quote line item was configured and priced by Revenue Lifecycle Management.

    A quote can be activated only after all its quote line items are configured and priced by Revenue Lifecycle Management.

  • Possible values:

    • Warning — Warning — Indicates that the quote line item wasn’t configured and priced by Revenue Lifecycle Management.

  • Type: picklist

  • Properties: Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort

  • Introduced: API version 64.0

  • Description:

    Specifies how Salesforce shows a quote line item in the Transaction Line Editor and a quote document.

    The default value is Always.

  • Possible values:

    • Always — Always (default) — Quote line items are always displayed in the Transaction Line Editor.
    • Never — Never — Quote line items aren’t displayed in the Transaction Line Editor or in the quote document.
    • Quote Document Only — Quote Document Only — Quote line items are displayed only in the quote document, but not in the Transaction Line Editor.
    • Transaction Line Editor Only — Transaction Line Editor Only — Quote line items are displayed only in the Transaction Line Editor, but not in the quote document.

  • Default value: Always

A quote record can have QuoteLineItem records only if the quote has a Pricebook2. A QuoteLineItem must correspond to a Product2 that is listed in the quote’s Pricebook2.

If the multicurrency option is enabled, the CurrencyIsoCode field is present. It can’t be modified, it’s always set to the value of the CurrencyIsoCode of the parent quote.

Effects on Quotes

Quotes with related QuoteLineItem objects are affected in the following ways:

  • Creating a QuoteLineItem increments the quote value by the TotalPrice of the QuoteLineItem.
  • When you create or update a QuoteLineItem, the API verifies that the line item corresponds to a PricebookEntry in the Pricebook2 associated with the quote.

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.