Price List Item (ProductPriceLevel) table/entity reference (Microsoft Dynamics 365)

Information about how to price a product in the specified price level, including pricing method, rounding option, and discount type based on a specified product unit.

Messages

The following table lists the messages for the Price List Item (ProductPriceLevel) table. Messages represent operations that can be performed on the table. They may also be events.

Name
Is Event?
Web API Operation SDK for .NET
Associate
Event: True
Associate records Associate records
Create
Event: True
POST /productpricelevels
See Create
Create records
Delete
Event: True
DELETE /productpricelevels(productpricelevelid)
See Delete
Delete records
Disassociate
Event: True
Disassociate records Disassociate records
Retrieve
Event: True
GET /productpricelevels(productpricelevelid)
See Retrieve
Retrieve records
RetrieveMultiple
Event: True
GET /productpricelevels
See Query data
Query data
Update
Event: True
PATCH /productpricelevels(productpricelevelid)
See Update
Update records
Upsert
Event: False
PATCH /productpricelevels(productpricelevelid)
See Upsert a table row
UpsertRequest

Properties

The following table lists selected properties for the Price List Item (ProductPriceLevel) table.

Property Value
DisplayName Price List Item
DisplayCollectionName Price List Items
SchemaName ProductPriceLevel
CollectionSchemaName ProductPriceLevels
EntitySetName productpricelevels
LogicalName productpricelevel
LogicalCollectionName productpricelevels
PrimaryIdAttribute productpricelevelid
PrimaryNameAttribute productidname
TableType Standard
OwnershipType None

Writable columns/attributes

These columns/attributes return true for either IsValidForCreate or IsValidForUpdate (usually both). Listed by SchemaName.

Amount

Property Value
Description Monetary amount for the price list.
DisplayName Amount
IsValidForForm False
IsValidForRead True
LogicalName amount
RequiredLevel ApplicationRequired
Type Money
ImeMode Disabled
IsBaseCurrency False
MaxValue 100000000000000
MinValue 0
Precision 2
PrecisionSource 1 (Organization.PricingDecimalPrecision)

DiscountTypeId

Property Value
Description Unique identifier of the discount list associated with the price list.
DisplayName Discount List
IsValidForForm False
IsValidForRead True
LogicalName discounttypeid
RequiredLevel None
Type Lookup
Targets discounttype

ImportSequenceNumber

Property Value
Description Sequence number of the import that created this record.
DisplayName Import Sequence Number
IsValidForForm False
IsValidForRead True
LogicalName importsequencenumber
RequiredLevel None
Type Integer
MaxValue 2147483647
MinValue -2147483648

OverriddenCreatedOn

Property Value
Description Date and time that the record was migrated.
DisplayName Record Created On
IsValidForForm False
IsValidForRead True
LogicalName overriddencreatedon
RequiredLevel None
Type DateTime
CanChangeDateTimeBehavior False
DateTimeBehavior UserLocal
Format DateOnly
ImeMode Inactive
SourceTypeMask 0

Percentage

Property Value
Description Percentage for the price list.
DisplayName Percentage
IsValidForForm False
IsValidForRead True
LogicalName percentage
RequiredLevel ApplicationRequired
Type Decimal
ImeMode Disabled
MaxValue 1000000000
MinValue 0
Precision 2
SourceTypeMask 0

PriceLevelId

Property Value
Description Unique identifier of the price level associated with this price list.
DisplayName Price List
IsValidForForm False
IsValidForRead True
LogicalName pricelevelid
RequiredLevel SystemRequired
Type Lookup
Targets pricelevel

PricingMethodCode

Property Value
Description Pricing method applied to the price list.
DisplayName Pricing Method
IsValidForForm False
IsValidForRead True
LogicalName pricingmethodcode
RequiredLevel ApplicationRequired
Type Picklist
DefaultFormValue 1
GlobalChoiceName productpricelevel_pricingmethodcode

PricingMethodCode Choices/Options

Value Label
1 Currency Amount
2 Percent of List
3 Percent Markup - Current Cost
4 Percent Margin - Current Cost
5 Percent Markup - Standard Cost
6 Percent Margin - Standard Cost

ProcessId

Property Value
Description Contains the id of the process associated with the entity.
DisplayName Process Id
IsValidForForm False
IsValidForRead True
LogicalName processid
RequiredLevel None
Type Uniqueidentifier

ProductId

Property Value
Description Product associated with the price list.
DisplayName Product
IsValidForForm False
IsValidForRead True
LogicalName productid
RequiredLevel SystemRequired
Type Lookup
Targets product

ProductPriceLevelId

Property Value
Description Unique identifier of the price list.
DisplayName Product Price List
IsValidForForm False
IsValidForRead True
LogicalName productpricelevelid
RequiredLevel SystemRequired
Type Uniqueidentifier

QuantitySellingCode

Property Value
Description Quantity of the product that must be sold for a given price level.
DisplayName Quantity Selling Option
IsValidForForm False
IsValidForRead True
LogicalName quantitysellingcode
RequiredLevel ApplicationRequired
Type Picklist
DefaultFormValue 1
GlobalChoiceName productpricelevel_quantitysellingcode

QuantitySellingCode Choices/Options

Value Label
1 No Control
2 Whole
3 Whole and Fractional

RoundingOptionAmount

Property Value
Description Rounding option amount for the price list.
DisplayName Rounding Amount
IsValidForForm False
IsValidForRead True
LogicalName roundingoptionamount
RequiredLevel ApplicationRequired
Type Money
ImeMode Disabled
IsBaseCurrency False
MaxValue 100000000000000
MinValue -100000000000000
Precision 2
PrecisionSource 1 (Organization.PricingDecimalPrecision)

RoundingOptionCode

Property Value
Description Option for rounding the price list.
DisplayName Rounding Option
IsValidForForm False
IsValidForRead True
LogicalName roundingoptioncode
RequiredLevel ApplicationRequired
Type Picklist
DefaultFormValue -1
GlobalChoiceName productpricelevel_roundingoptioncode

RoundingOptionCode Choices/Options

Value Label
1 Ends in
2 Multiple of

RoundingPolicyCode

Property Value
Description Policy for rounding the price list.
DisplayName Rounding Policy
IsValidForForm False
IsValidForRead True
LogicalName roundingpolicycode
RequiredLevel ApplicationRequired
Type Picklist
DefaultFormValue -1
GlobalChoiceName productpricelevel_roundingpolicycode

RoundingPolicyCode Choices/Options

Value Label
1 None
2 Up
3 Down
4 To Nearest

StageId

Property Value
Description Contains the id of the stage where the entity is located.
DisplayName (Deprecated) Stage Id
IsValidForForm False
IsValidForRead True
LogicalName stageid
RequiredLevel None
Type Uniqueidentifier

TimeZoneRuleVersionNumber

Property Value
Description For internal use only.
DisplayName Time Zone Rule Version Number
IsValidForForm False
IsValidForRead True
LogicalName timezoneruleversionnumber
RequiredLevel None
Type Integer
MaxValue 2147483647
MinValue -1

TransactionCurrencyId

Property Value
Description Choose the local currency for the record to make sure budgets are reported in the correct currency.
DisplayName Currency
IsValidForForm True
IsValidForRead True
LogicalName transactioncurrencyid
RequiredLevel None
Type Lookup
Targets transactioncurrency

TraversedPath

Property Value
Description A comma separated list of string values representing the unique identifiers of stages in a Business Process Flow Instance in the order that they occur.
DisplayName (Deprecated) Traversed Path
IsValidForForm False
IsValidForRead True
LogicalName traversedpath
RequiredLevel None
Type String
Format Text
FormatName Text
ImeMode Auto
IsLocalizable False
MaxLength 1250

UoMId

Property Value
Description Unique identifier of the unit for the price list.
DisplayName Unit
IsValidForForm False
IsValidForRead True
LogicalName uomid
RequiredLevel ApplicationRequired
Type Lookup
Targets uom

UoMScheduleId

Property Value
Description Unique identifier of the unit schedule for the price list.
DisplayName Unit Schedule ID
IsValidForForm False
IsValidForRead True
LogicalName uomscheduleid
RequiredLevel None
Type Lookup
Targets uomschedule

UTCConversionTimeZoneCode

Property Value
Description Time zone code that was in use when the record was created.
DisplayName UTC Conversion Time Zone Code
IsValidForForm False
IsValidForRead True
LogicalName utcconversiontimezonecode
RequiredLevel None
Type Integer
MaxValue 2147483647
MinValue -1

Read-only columns/attributes

These columns/attributes return false for both IsValidForCreate and IsValidForUpdate. Listed by SchemaName.

Amount_Base

Property Value
Description Value of the Amount in base currency.
DisplayName Amount (Base)
IsValidForForm True
IsValidForRead True
LogicalName amount_base
RequiredLevel None
Type Money
ImeMode Disabled
IsBaseCurrency True
MaxValue 922337203685477
MinValue -922337203685477
Precision 4
PrecisionSource 1 (Organization.PricingDecimalPrecision)

CreatedBy

Property Value
Description Unique identifier of the user who created the price list.
DisplayName Created By
IsValidForForm False
IsValidForRead True
LogicalName createdby
RequiredLevel None
Type Lookup
Targets systemuser

CreatedOn

Property Value
Description Date and time when the price list was created.
DisplayName Created On
IsValidForForm False
IsValidForRead True
LogicalName createdon
RequiredLevel None
Type DateTime
CanChangeDateTimeBehavior False
DateTimeBehavior UserLocal
Format DateAndTime
ImeMode Inactive
SourceTypeMask 0

CreatedOnBehalfBy

Property Value
Description Shows who created the record on behalf of another user.
DisplayName Created By (Delegate)
IsValidForForm True
IsValidForRead True
LogicalName createdonbehalfby
RequiredLevel None
Type Lookup
Targets systemuser

ExchangeRate

Property Value
Description Shows the conversion rate of the record's currency. The exchange rate is used to convert all money fields in the record from the local currency to the system's default currency.
DisplayName Exchange Rate
IsValidForForm True
IsValidForRead True
LogicalName exchangerate
RequiredLevel None
Type Decimal
ImeMode Disabled
MaxValue 100000000000
MinValue 1E-12
Precision 12
SourceTypeMask 0

ModifiedBy

Property Value
Description Unique identifier of the user who last modified the price list.
DisplayName Modified By
IsValidForForm False
IsValidForRead True
LogicalName modifiedby
RequiredLevel None
Type Lookup
Targets systemuser

ModifiedOn

Property Value
Description Date and time when the price list was last modified.
DisplayName Modified On
IsValidForForm False
IsValidForRead True
LogicalName modifiedon
RequiredLevel None
Type DateTime
CanChangeDateTimeBehavior False
DateTimeBehavior UserLocal
Format DateAndTime
ImeMode Inactive
SourceTypeMask 0

ModifiedOnBehalfBy

Property Value
Description Shows who last updated the record on behalf of another user.
DisplayName Modified By (Delegate)
IsValidForForm True
IsValidForRead True
LogicalName modifiedonbehalfby
RequiredLevel None
Type Lookup
Targets systemuser

OrganizationId

Property Value
Description Unique identifier of the organization associated with the price list.
DisplayName Organization
IsValidForForm False
IsValidForRead True
LogicalName organizationid
RequiredLevel SystemRequired
Type Uniqueidentifier

ProductNumber

Property Value
Description User-defined product number.
DisplayName Product ID
IsValidForForm True
IsValidForRead True
LogicalName productnumber
RequiredLevel SystemRequired
Type String
Format Text
FormatName Text
ImeMode Auto
IsLocalizable False
MaxLength 100

RoundingOptionAmount_Base

Property Value
Description Value of the Rounding Amount in base currency.
DisplayName Rounding Amount (Base)
IsValidForForm True
IsValidForRead True
LogicalName roundingoptionamount_base
RequiredLevel None
Type Money
ImeMode Disabled
IsBaseCurrency True
MaxValue 922337203685477
MinValue -922337203685477
Precision 4
PrecisionSource 1 (Organization.PricingDecimalPrecision)

VersionNumber

Property Value
Description Version Number
DisplayName Version Number
IsValidForForm False
IsValidForRead True
LogicalName versionnumber
RequiredLevel None
Type BigInt
MaxValue 9223372036854775807
MinValue -9223372036854775808

Many-to-One relationships

These relationships are many-to-one. Listed by SchemaName.

discount_type_product_price_levels

One-To-Many Relationship: discounttype discount_type_product_price_levels

Property Value
ReferencedEntity discounttype
ReferencedAttribute discounttypeid
ReferencingAttribute discounttypeid
ReferencingEntityNavigationPropertyName discounttypeid
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: Restrict
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

lk_productpricelevel_createdonbehalfby

One-To-Many Relationship: systemuser lk_productpricelevel_createdonbehalfby

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute createdonbehalfby
ReferencingEntityNavigationPropertyName createdonbehalfby
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

lk_productpricelevel_modifiedonbehalfby

One-To-Many Relationship: systemuser lk_productpricelevel_modifiedonbehalfby

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute modifiedonbehalfby
ReferencingEntityNavigationPropertyName modifiedonbehalfby
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

lk_productpricelevelbase_createdby

One-To-Many Relationship: systemuser lk_productpricelevelbase_createdby

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute createdby
ReferencingEntityNavigationPropertyName createdby
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

lk_productpricelevelbase_modifiedby

One-To-Many Relationship: systemuser lk_productpricelevelbase_modifiedby

Property Value
ReferencedEntity systemuser
ReferencedAttribute systemuserid
ReferencingAttribute modifiedby
ReferencingEntityNavigationPropertyName modifiedby
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

price_level_product_price_levels

One-To-Many Relationship: pricelevel price_level_product_price_levels

Property Value
ReferencedEntity pricelevel
ReferencedAttribute pricelevelid
ReferencingAttribute pricelevelid
ReferencingEntityNavigationPropertyName pricelevelid
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: Restrict
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

processstage_productpricelevels

One-To-Many Relationship: processstage processstage_productpricelevels

Property Value
ReferencedEntity processstage
ReferencedAttribute processstageid
ReferencingAttribute stageid
ReferencingEntityNavigationPropertyName stageid_processstage
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: NoCascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

product_price_levels

One-To-Many Relationship: product product_price_levels

Property Value
ReferencedEntity product
ReferencedAttribute productid
ReferencingAttribute productid
ReferencingEntityNavigationPropertyName productid
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: Cascade
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

transactioncurrency_productpricelevel

One-To-Many Relationship: transactioncurrency transactioncurrency_productpricelevel

Property Value
ReferencedEntity transactioncurrency
ReferencedAttribute transactioncurrencyid
ReferencingAttribute transactioncurrencyid
ReferencingEntityNavigationPropertyName transactioncurrencyid
IsHierarchical
CascadeConfiguration Archive: Restrict
Assign: NoCascade
Delete: Restrict
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

unit_of_measure_schedule_product_price_level

One-To-Many Relationship: uomschedule unit_of_measure_schedule_product_price_level

Property Value
ReferencedEntity uomschedule
ReferencedAttribute uomscheduleid
ReferencingAttribute uomscheduleid
ReferencingEntityNavigationPropertyName uomscheduleid
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: RemoveLink
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

unit_of_measurement_product_price_levels

One-To-Many Relationship: uom unit_of_measurement_product_price_levels

Property Value
ReferencedEntity uom
ReferencedAttribute uomid
ReferencingAttribute uomid
ReferencingEntityNavigationPropertyName uomid
IsHierarchical
CascadeConfiguration Archive: NoCascade
Assign: NoCascade
Delete: Restrict
Merge: NoCascade
Reparent: NoCascade
RollupView: NoCascade
Share: NoCascade
Unshare: NoCascade

One-to-Many relationships

These relationships are one-to-many. Listed by SchemaName.

ProductPriceLevel_AsyncOperations

Many-To-One Relationship: asyncoperation ProductPriceLevel_AsyncOperations

Property Value
ReferencingEntity asyncoperation
ReferencingAttribute regardingobjectid
ReferencedEntityNavigationPropertyName ProductPriceLevel_AsyncOperations
IsCustomizable False
AssociatedMenuConfiguration AvailableOffline: True
Behavior: DoNotDisplay
Group: Details
Label:
MenuId: null
Order:
QueryApi: null
ViewId: 00000000-0000-0000-0000-000000000000

ProductPriceLevel_BulkDeleteFailures

Many-To-One Relationship: bulkdeletefailure ProductPriceLevel_BulkDeleteFailures

Property Value
ReferencingEntity bulkdeletefailure
ReferencingAttribute regardingobjectid
ReferencedEntityNavigationPropertyName ProductPriceLevel_BulkDeleteFailures
IsCustomizable False
AssociatedMenuConfiguration AvailableOffline: True
Behavior: DoNotDisplay
Group: Details
Label:
MenuId: null
Order:
QueryApi: null
ViewId: 00000000-0000-0000-0000-000000000000

productpricelevel_MailboxTrackingFolders

Many-To-One Relationship: mailboxtrackingfolder productpricelevel_MailboxTrackingFolders

Property Value
ReferencingEntity mailboxtrackingfolder
ReferencingAttribute regardingobjectid
ReferencedEntityNavigationPropertyName productpricelevel_MailboxTrackingFolders
IsCustomizable True
AssociatedMenuConfiguration AvailableOffline: True
Behavior: DoNotDisplay
Group: Details
Label:
MenuId: null
Order:
QueryApi: null
ViewId: 00000000-0000-0000-0000-000000000000

productpricelevel_PrincipalObjectAttributeAccesses

Many-To-One Relationship: principalobjectattributeaccess productpricelevel_PrincipalObjectAttributeAccesses

Property Value
ReferencingEntity principalobjectattributeaccess
ReferencingAttribute objectid
ReferencedEntityNavigationPropertyName productpricelevel_PrincipalObjectAttributeAccesses
IsCustomizable True
AssociatedMenuConfiguration AvailableOffline: True
Behavior: DoNotDisplay
Group: Details
Label:
MenuId: null
Order:
QueryApi: null
ViewId: 00000000-0000-0000-0000-000000000000

ProductPriceLevel_ProcessSessions

Many-To-One Relationship: processsession ProductPriceLevel_ProcessSessions

Property Value
ReferencingEntity processsession
ReferencingAttribute regardingobjectid
ReferencedEntityNavigationPropertyName ProductPriceLevel_ProcessSessions
IsCustomizable False
AssociatedMenuConfiguration AvailableOffline: True
Behavior: UseCollectionName
Group: Details
Label:
MenuId: null
Order: 110
QueryApi: null
ViewId: 00000000-0000-0000-0000-000000000000

ProductPriceLevel_SyncErrors

Many-To-One Relationship: syncerror ProductPriceLevel_SyncErrors

Property Value
ReferencingEntity syncerror
ReferencingAttribute regardingobjectid
ReferencedEntityNavigationPropertyName ProductPriceLevel_SyncErrors
IsCustomizable True
AssociatedMenuConfiguration AvailableOffline: True
Behavior: DoNotDisplay
Group: Details
Label:
MenuId: null
Order:
QueryApi: null
ViewId: 00000000-0000-0000-0000-000000000000

See also

Dataverse table/entity reference
Dataverse Web API Reference