pricelevel EntityType

Entity that defines pricing levels.

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


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

Name Type Details
begindate Edm.DateTimeOffset

Date on which the price list becomes effective.

Display Name: Start Date

createdon Edm.DateTimeOffset

Date and time when the record was created.

Display Name: Created On

Read Only
description Edm.String

Description of the price list.

Display Name: Description

enddate Edm.DateTimeOffset

Date that is the last day the price list is valid.

Display Name: End Date

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
freighttermscode Edm.Int32

Freight terms for the price list.

Display Name: Freight Terms

Default Options
Value Label
1 Default Value
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 record was modified.

Display Name: Modified On

Read Only
msdyn_breakhoursbillable Edm.Boolean

Display Name: Break Hours Billable

Default Options
Value Label
1 Yes
0 No
msdyn_entity Edm.Int32

Select the entity for this price level.

Display Name: Entity

Default Options
Value Label
192350000 Organization
192350001 Customer
192350002 Sales document
192350003 Project
msdyn_module Edm.Int32

Select the context for this price level i.e whether it is sales prices, cost prices or purchase prices

Display Name: Context

Default Options
Value Label
192350000 Cost
192350001 Purchase
192350002 Sales
name Edm.String

Name of the price list.

Display Name: Name

overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On

paymentmethodcode Edm.Int32

Payment terms to use with the price list.

Display Name: Payment Method

Default Options
Value Label
1 Default Value
pricelevelid Edm.Guid

Unique identifier of the price list.

Display Name: Price List

shippingmethodcode Edm.Int32

Method of shipment for products in the price list.

Display Name: Shipping Method

Default Options
Value Label
1 Default Value
statecode Edm.Int32

Status of the price list.

Display Name: Status

Default Options
Value Label
0 Active
1 Inactive
statuscode Edm.Int32

Reason for the status of the price list.

Display Name: Status Reason

Default Options
Value Label
100001 Active
100002 Inactive
timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

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

Unique identifier of the delegate user who created the pricelevel.

_modifiedby_value modifiedby

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

_modifiedonbehalfby_value modifiedonbehalfby

Unique identifier of the delegate user who last modified the pricelevel.

_msdyn_copiedfrompricelevel_value msdyn_CopiedFromPriceLevel

Shows the price level that this price level was copied from.

_msdyn_timeunit_value msdyn_TimeUnit

Select the default unit of role based time on this price list

_organizationid_value organizationid

Unique identifier for the organization

_transactioncurrencyid_value transactioncurrencyid

Unique identifier of the currency associated with the price level.

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_pricelevelbase_createdby
createdonbehalfby systemuser lk_pricelevel_createdonbehalfby
modifiedby systemuser lk_pricelevelbase_modifiedby
modifiedonbehalfby systemuser lk_pricelevel_modifiedonbehalfby
msdyn_CopiedFromPriceLevel pricelevel msdyn_pricelevel_pricelevel_CopiedFromPriceLevel
msdyn_TimeUnit uom msdyn_uom_pricelevel_TimeUnit
organizationid organization organization_price_levels
transactioncurrencyid transactioncurrency transactioncurrency_pricelevel

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
msdyn_organizationalunit_pricelevel msdyn_organizationalunit msdyn_organizationalunit_pricelevel
msdyn_pricelevel_entitlement_PriceListToApply entitlement new_PriceListToApply
msdyn_pricelevel_msdyn_accountpricelist_PriceList msdyn_accountpricelist msdyn_PriceList
msdyn_pricelevel_msdyn_actual_PriceList msdyn_actual msdyn_PriceList
msdyn_pricelevel_msdyn_agreement_PriceList msdyn_agreement msdyn_pricelist
msdyn_pricelevel_msdyn_agreementbookingproduct_PriceList msdyn_agreementbookingproduct msdyn_pricelist
msdyn_pricelevel_msdyn_agreementbookingservice_PriceList msdyn_agreementbookingservice msdyn_pricelist
msdyn_pricelevel_msdyn_agreementinvoiceproduct_PriceList msdyn_agreementinvoiceproduct msdyn_pricelist
msdyn_pricelevel_msdyn_contactpricelist_PriceList msdyn_contactpricelist msdyn_PriceList
msdyn_pricelevel_msdyn_estimateline_PriceList msdyn_estimateline msdyn_PriceList
msdyn_pricelevel_msdyn_fieldservicepricelistitem_PriceList msdyn_fieldservicepricelistitem msdyn_pricelist
msdyn_pricelevel_msdyn_invoicelinetransaction_PriceList msdyn_invoicelinetransaction msdyn_PriceList
msdyn_pricelevel_msdyn_journalline_PriceList msdyn_journalline msdyn_PriceList
msdyn_pricelevel_msdyn_opportunitylinetransaction_PriceList msdyn_opportunitylinetransaction msdyn_PriceList
msdyn_pricelevel_msdyn_opportunitypricelist_PriceList msdyn_opportunitypricelist msdyn_PriceList
msdyn_pricelevel_msdyn_orderlinetransaction_PriceList msdyn_orderlinetransaction msdyn_PriceList
msdyn_pricelevel_msdyn_orderpricelist_PriceList msdyn_orderpricelist msdyn_PriceList
msdyn_pricelevel_msdyn_projectparameterpricelist_PriceList msdyn_projectparameterpricelist msdyn_PriceList
msdyn_pricelevel_msdyn_projectpricelist_PriceList msdyn_projectpricelist msdyn_PriceList
msdyn_pricelevel_msdyn_quotebookingproduct_PriceList msdyn_quotebookingproduct msdyn_pricelist
msdyn_pricelevel_msdyn_quotebookingservice_PriceList msdyn_quotebookingservice msdyn_pricelist
msdyn_pricelevel_msdyn_quotelinetransaction_PriceList msdyn_quotelinetransaction msdyn_PriceList
msdyn_pricelevel_msdyn_quotepricelist_PriceList msdyn_quotepricelist msdyn_PriceList
msdyn_pricelevel_msdyn_resourcecategorypricelevel_PriceList msdyn_resourcecategorypricelevel msdyn_PriceList
msdyn_pricelevel_msdyn_rma_PriceList msdyn_rma msdyn_pricelist
msdyn_pricelevel_msdyn_rmaproduct_PriceList msdyn_rmaproduct msdyn_pricelist
msdyn_pricelevel_msdyn_transactioncategorypricelevel_PriceList msdyn_transactioncategorypricelevel msdyn_PriceList
msdyn_pricelevel_msdyn_workorder_PriceList msdyn_workorder msdyn_pricelist
msdyn_pricelevel_msdyn_workorderproduct_PriceList msdyn_workorderproduct msdyn_pricelist
msdyn_pricelevel_msdyn_workorderservice_PriceList msdyn_workorderservice msdyn_pricelist
msdyn_pricelevel_msdyn_workordertype_PriceList msdyn_workordertype msdyn_pricelist
msdyn_pricelevel_opportunityproduct_PriceList opportunityproduct msdyn_pricelist
msdyn_pricelevel_pricelevel_CopiedFromPriceLevel pricelevel msdyn_CopiedFromPriceLevel
msdyn_pricelevel_quotedetail_PriceList quotedetail msdyn_PriceList
price_level_accounts account defaultpricelevelid
price_level_contacts contact defaultpricelevelid
price_level_invoices invoice pricelevelid
price_level_opportunties opportunity pricelevelid
price_level_orders salesorder pricelevelid
price_level_product_price_levels productpricelevel pricelevelid
price_level_products product pricelevelid
price_level_quotes quote pricelevelid
PriceLevel_AsyncOperations asyncoperation regardingobjectid_pricelevel
PriceLevel_BulkDeleteFailures bulkdeletefailure regardingobjectid_pricelevel
pricelevel_connections1 connection record1id_pricelevel
pricelevel_connections2 connection record2id_pricelevel
pricelevel_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_pricelevel
pricelevel_principalobjectattributeaccess principalobjectattributeaccess objectid_pricelevel
PriceLevel_ProcessSessions processsession regardingobjectid_pricelevel
PriceLevel_SyncErrors syncerror regardingobjectid_pricelevel_syncerror
PriceList_Campaigns campaign pricelistid


The following operations can be used with the pricelevel entity type.

Name Binding
GetDefaultPriceLevel Collection


The following solutions include the pricelevel 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.
Product Management Patch Dynamics 365 workload for product management.
Project Service Automation Microsoft Dynamics 365 for Project Service Automation is an end-to-end solution that helps sales and delivery teams engage customers and deliver billable projects on time and within budget. Project Service gives you the tools you need to: Estimate, quote, and contract work; Plan and assign resources; Enable team collaboration; Capture time, expense, and progress data for real-time insights and accurate invoicing.

See also