productpricelevel EntityType

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.

Entity Set Path
[organization URI]/api/data/v9.0/productpricelevels
Base Type
Display Name
Price List Item
Primary Key
Primary Key Attribute
Operations Supported


Properties represent fields of data stored in the entity.Some properties are read-only.

Name Type Details
amount Edm.Decimal

Monetary amount for the price list.

Display Name: Amount

amount_base Edm.Decimal

Value of the Amount in base currency.

Display Name: Amount (Base)

Read Only
createdon Edm.DateTimeOffset

Date and time when the price list was created.

Display Name: Created On

Read Only
exchangerate Edm.Decimal

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.

Display Name: Exchange Rate

Read Only
importsequencenumber Edm.Int32

Sequence number of the import that created this record.

Display Name: Import Sequence Number

modifiedon Edm.DateTimeOffset

Date and time when the price list was last modified.

Display Name: Modified On

Read Only
organizationid Edm.Guid

Unique identifier of the organization associated with the price list.

Display Name: Organization

Read Only
overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On

percentage Edm.Decimal

Percentage for the price list.

Display Name: Percentage

pricingmethodcode Edm.Int32

Pricing method applied to the price list.

Display Name: Pricing Method

Default 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 Edm.Guid

Contains the id of the process associated with the entity.

Display Name: Process Id

productnumber Edm.String

User-defined product number.

Display Name: Product ID

Read Only
productpricelevelid Edm.Guid

Unique identifier of the price list.

Display Name: Product Price List

quantitysellingcode Edm.Int32

Quantity of the product that must be sold for a given price level.

Display Name: Quantity Selling Option

Default Options
Value Label
1 No Control
2 Whole
3 Whole and Fractional
roundingoptionamount Edm.Decimal

Rounding option amount for the price list.

Display Name: Rounding Amount

roundingoptionamount_base Edm.Decimal

Value of the Rounding Amount in base currency.

Display Name: Rounding Amount (Base)

Read Only
roundingoptioncode Edm.Int32

Option for rounding the price list.

Display Name: Rounding Option

Default Options
Value Label
1 Ends in
2 Multiple of
roundingpolicycode Edm.Int32

Policy for rounding the price list.

Display Name: Rounding Policy

Default Options
Value Label
1 None
2 Up
3 Down
4 To Nearest
stageid Edm.Guid

Contains the id of the stage where the entity is located.

Display Name: Stage Id

timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

traversedpath Edm.String

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.

Display Name: Traversed Path

utcconversiontimezonecode Edm.Int32

Time zone code that was in use when the record was created.

Display Name: UTC Conversion Time Zone Code

versionnumber Edm.Int64

Version Number

Display Name: Version Number

Read Only

Lookup Properties

Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Retrieve data about lookup properties.

Name Single-valued navigation property Description
_createdby_value createdby

Unique identifier of the user who created the price list.

_createdonbehalfby_value createdonbehalfby

Shows who created the record on behalf of another user.

_discounttypeid_value discounttypeid

Unique identifier of the discount list associated with the price list.

_modifiedby_value modifiedby

Unique identifier of the user who last modified the price list.

_modifiedonbehalfby_value modifiedonbehalfby

Shows who last updated the record on behalf of another user.

_pricelevelid_value pricelevelid

Unique identifier of the price level associated with this price list.

_productid_value productid

Product associated with the price list.

_transactioncurrencyid_value transactioncurrencyid

Choose the local currency for the record to make sure budgets are reported in the correct currency.

_uomid_value uomid

Unique identifier of the unit for the price list.

_uomscheduleid_value uomscheduleid

Unique identifier of the unit schedule for the price list.

Single-valued navigation properties

Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.

Name Type Partner
createdby systemuser lk_productpricelevelbase_createdby
createdonbehalfby systemuser lk_productpricelevel_createdonbehalfby
discounttypeid discounttype discount_type_product_price_levels
modifiedby systemuser lk_productpricelevelbase_modifiedby
modifiedonbehalfby systemuser lk_productpricelevel_modifiedonbehalfby
pricelevelid pricelevel price_level_product_price_levels
productid product product_price_levels
stageid_processstage processstage processstage_productpricelevels
transactioncurrencyid transactioncurrency transactioncurrency_productpricelevel
uomid uom unit_of_measurement_product_price_levels
uomscheduleid uomschedule unit_of_measure_schedule_product_price_level

Collection-valued navigation properties

Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.

Name Type Partner
ProductPriceLevel_AsyncOperations asyncoperation regardingobjectid_productpricelevel
ProductPriceLevel_BulkDeleteFailures bulkdeletefailure regardingobjectid_productpricelevel
productpricelevel_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_productpricelevel
productpricelevel_PrincipalObjectAttributeAccesses principalobjectattributeaccess objectid_productpricelevel
ProductPriceLevel_ProcessSessions processsession regardingobjectid_productpricelevel
ProductPriceLevel_SyncErrors syncerror regardingobjectid_productpricelevel_syncerror


The following solutions include the productpricelevel entity type.

Name Description
Field Service Microsoft Dynamics 365 for Field Service allows organizations of any size to deliver intelligent, world class field service, managing all aspects of the end-to-end field service management cycle. Features include scheduling, mobile, asset management, inventory control, customer notifications, and resource utilization controls that help maximize efficiency and minimize costs.
Product Management Dynamics 365 workload for product management.
Sales Dynamics 365 workload for sales.

See also