msdyn_purchaseorder EntityType

Record Purchase Orders pertaining to Work Orders or otherwise

Entity Set Path
[organization URI]/api/data/v9.0/msdyn_purchaseorders
Base Type
Display Name
Purchase Order
Primary Key
Primary Key Attribute
Operations Supported


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

Name Type Details
createdon Edm.DateTimeOffset

Shows the date and time when the record was created. The date and time are displayed in the time zone selected in Microsoft Dynamics 365 options.

Display Name: Created On

Read Only
exchangerate Edm.Decimal

Shows the exchange rate for the currency associated with the entity with respect to the base currency.

Display Name: Exchange Rate

Read Only
importsequencenumber Edm.Int32

Shows the sequence number of the import that created this record.

Display Name: Import Sequence Number

modifiedon Edm.DateTimeOffset

Shows the date and time when the record was last updated. The date and time are displayed in the time zone selected in Microsoft Dynamics 365 options.

Display Name: Modified On

Read Only
msdyn_address1 Edm.String

Display Name: Street 1

msdyn_address2 Edm.String

Display Name: Street 2

msdyn_address3 Edm.String

Display Name: Street 3

msdyn_addressname Edm.String

Enter the location to ship the products of this PO to.

Display Name: Address Name

msdyn_amountbilled Edm.Decimal

Display Name: Amount Billed

msdyn_amountbilled_base Edm.Decimal

Shows the value of the amount billed in the base currency.

Display Name: Amount Billed (Base)

Read Only
msdyn_approvalstatus Edm.Int32

Enter the current status of the approval.

Display Name: Approval Status

Default Options
Value Label
690970000 Approved
690970001 Rejected
msdyn_autonumbering Edm.String

Internal field used to generate the next name upon entity creation. It is optionally copied to the msdyn_name field.

Display Name: Auto-Numbering

msdyn_city Edm.String

Display Name: City

msdyn_country Edm.String

Display Name: Country/Region

msdyn_dateexpected Edm.DateTimeOffset

Enter the date you expect to receive your order. Note that products added once the date is specified here will automatically be set to this date.

Display Name: Date Expected

msdyn_internalflags Edm.String

For internal use only.

Display Name: Internal Flags

msdyn_latitude Edm.Double

Display Name: Latitude

msdyn_longitude Edm.Double

Display Name: Longitude

msdyn_name Edm.String

Enter the name of the custom entity.

Display Name: Name

msdyn_postalcode Edm.String

Display Name: Postal Code

msdyn_purchaseorderdate Edm.DateTimeOffset

Shows the date you submitted your order to the vendor. Note this field is for information only.

Display Name: Purchase Order Date

msdyn_purchaseorderid Edm.Guid

Shows the entity instances.

Display Name: Purchase Order

msdyn_shipto Edm.Int32

Enter the location to ship to. If the PO has been associated to a work order or a schedule, you can ship directly to the service account address.

Display Name: Ship To

Default Options
Value Label
690970000 Site
690970001 Business Unit
690970002 Service Account
690970003 Other
msdyn_stateorprovince Edm.String

Display Name: State Or Province

msdyn_systemstatus Edm.Int32

Enter the current status of the purchase order.

Display Name: System Status

Default Options
Value Label
690970000 Draft
690970001 Submitted
690970002 Canceled
690970003 Products Received
690970004 Billed
msdyn_totalamount Edm.Decimal

Display Name: Total Amount

msdyn_totalamount_base Edm.Decimal

Shows the value of the total amount in the base currency.

Display Name: Total Amount (Base)

Read Only
msdyn_vendornote Edm.String

If you wish to display a note for the vendor on this PO specify it here

Display Name: Vendor Note

overriddencreatedon Edm.DateTimeOffset

Shows the date and time that the record was migrated.

Display Name: Record Created On

processid Edm.Guid

Contains the ID of the process associated with the entity.

Display Name: Process Id

statecode Edm.Int32

Status of the Purchase Order

Display Name: Status

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

Reason for the status of the Purchase Order

Display Name: Status Reason

Default Options
Value Label
1 Active
2 Inactive
timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

traversedpath Edm.String

Shows a comma-separated list of string values that represent the unique identifiers of stages in a business process flow instance in the order that they occur.

Display Name: Traversed Path

utcconversiontimezonecode Edm.Int32

Shows the 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 record.

_createdonbehalfby_value createdonbehalfby

Shows who created the record on behalf of another user.

_modifiedby_value modifiedby

Unique identifier of the user who modified the record.

_modifiedonbehalfby_value modifiedonbehalfby

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

_msdyn_approvedrejectedby_value msdyn_approvedrejectedby

The user who approved or rejected this PO

_msdyn_booking_value msdyn_booking

If purchase order is being ordered directly to a booking specify here. Note, when specified, by default all products will receive directly to booking.

_msdyn_orderedby_value msdyn_orderedby

Unique identifier for User associated with Purchase Order.

_msdyn_paymentterm_value msdyn_paymentterm

The payment terms for this PO

_msdyn_receivetowarehouse_value msdyn_receivetowarehouse

Warehouse where products of this PO will be received to

_msdyn_requestedbyresource_value msdyn_requestedbyresource

Resource that requested the purchase

_msdyn_shipvia_value msdyn_shipvia

Method of shipment by vendor

_msdyn_substatus_value msdyn_substatus

Purchase Order Substatus

_msdyn_vendor_value msdyn_vendor

Vendor you wish to purchase from

_msdyn_workorder_value msdyn_workorder

If purchase order is being ordered directly to a work order specify here. Note, when specified, by default all products will receive directly to work order.

_ownerid_value ownerid

Owner Id

_owningbusinessunit_value owningbusinessunit

Unique identifier for the business unit that owns the record

_owningteam_value owningteam

Unique identifier for the team that owns the record.

_owninguser_value owninguser

Unique identifier for the user that owns the record.

_stageid_value stageid

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

_transactioncurrencyid_value transactioncurrencyid

Unique identifier of the currency associated with the entity.

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_msdyn_purchaseorder_createdby
createdonbehalfby systemuser lk_msdyn_purchaseorder_createdonbehalfby
modifiedby systemuser lk_msdyn_purchaseorder_modifiedby
modifiedonbehalfby systemuser lk_msdyn_purchaseorder_modifiedonbehalfby
msdyn_approvedrejectedby systemuser msdyn_systemuser_msdyn_purchaseorder_ApprovedRejectedBy
msdyn_booking bookableresourcebooking msdyn_bookableresourcebooking_msdyn_purchaseorder_Booking
msdyn_orderedby systemuser msdyn_systemuser_msdyn_purchaseorder_OrderedBy
msdyn_paymentterm msdyn_paymentterm msdyn_msdyn_paymentterm_msdyn_purchaseorder_PaymentTerm
msdyn_receivetowarehouse msdyn_warehouse msdyn_msdyn_warehouse_msdyn_purchaseorder_ReceivetoWarehouse
msdyn_requestedbyresource bookableresource msdyn_bookableresource_msdyn_purchaseorder_RequestedByResource
msdyn_shipvia msdyn_shipvia msdyn_msdyn_shipvia_msdyn_purchaseorder_ShipVia
msdyn_substatus msdyn_purchaseordersubstatus msdyn_msdyn_purchaseordersubstatus_msdyn_purchaseorder_SubStatus
msdyn_vendor account msdyn_account_msdyn_purchaseorder_Vendor
msdyn_workorder msdyn_workorder msdyn_msdyn_workorder_msdyn_purchaseorder_WorkOrder
ownerid principal owner_msdyn_purchaseorder
owningbusinessunit businessunit business_unit_msdyn_purchaseorder
owningteam team team_msdyn_purchaseorder
owninguser systemuser user_msdyn_purchaseorder
stageid processstage processstage_msdyn_purchaseorder
transactioncurrencyid transactioncurrency TransactionCurrency_msdyn_purchaseorder

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
bpf_msdyn_purchaseorder_msdyn_bpf_2c5fe86acc8b414b8322ae571000c799 msdyn_bpf_2c5fe86acc8b414b8322ae571000c799 bpf_msdyn_purchaseorderid
msdyn_msdyn_purchaseorder_msdyn_purchaseorderbill_PurchaseOrder msdyn_purchaseorderbill msdyn_purchaseorder
msdyn_msdyn_purchaseorder_msdyn_purchaseorderproduct_PurchaseOrder msdyn_purchaseorderproduct msdyn_purchaseorder
msdyn_msdyn_purchaseorder_msdyn_purchaseorderreceipt_PurchaseOrder msdyn_purchaseorderreceipt msdyn_purchaseorder
msdyn_msdyn_purchaseorder_msdyn_purchaseorderreceiptproduct_PurchaseOrder msdyn_purchaseorderreceiptproduct msdyn_purchaseorder
msdyn_msdyn_purchaseorder_msdyn_rtv_OriginalPO msdyn_rtv msdyn_originalpurchaseorder
msdyn_purchaseorder_ActivityPointers activitypointer regardingobjectid_msdyn_purchaseorder
msdyn_purchaseorder_Annotations annotation objectid_msdyn_purchaseorder
msdyn_purchaseorder_Appointments appointment regardingobjectid_msdyn_purchaseorder_appointment
msdyn_purchaseorder_AsyncOperations asyncoperation regardingobjectid_msdyn_purchaseorder
msdyn_purchaseorder_BulkDeleteFailures bulkdeletefailure regardingobjectid_msdyn_purchaseorder
msdyn_purchaseorder_connections1 connection record1id_msdyn_purchaseorder
msdyn_purchaseorder_connections2 connection record2id_msdyn_purchaseorder
msdyn_purchaseorder_DuplicateBaseRecord duplicaterecord baserecordid_msdyn_purchaseorder
msdyn_purchaseorder_DuplicateMatchingRecord duplicaterecord duplicaterecordid_msdyn_purchaseorder
msdyn_purchaseorder_Emails email regardingobjectid_msdyn_purchaseorder_email
msdyn_purchaseorder_Faxes fax regardingobjectid_msdyn_purchaseorder_fax
msdyn_purchaseorder_Letters letter regardingobjectid_msdyn_purchaseorder_letter
msdyn_purchaseorder_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_msdyn_purchaseorder
msdyn_purchaseorder_msdyn_approvals msdyn_approval regardingobjectid_msdyn_purchaseorder_msdyn_approval
msdyn_purchaseorder_msdyn_bookingalerts msdyn_bookingalert regardingobjectid_msdyn_purchaseorder_msdyn_bookingalert
msdyn_purchaseorder_PhoneCalls phonecall regardingobjectid_msdyn_purchaseorder_phonecall
msdyn_purchaseorder_PrincipalObjectAttributeAccesses principalobjectattributeaccess objectid_msdyn_purchaseorder
msdyn_purchaseorder_ProcessSession processsession regardingobjectid_msdyn_purchaseorder
msdyn_purchaseorder_RecurringAppointmentMasters recurringappointmentmaster regardingobjectid_msdyn_purchaseorder_recurringappointmentmaster
msdyn_purchaseorder_ServiceAppointments serviceappointment regardingobjectid_msdyn_purchaseorder_serviceappointment
msdyn_purchaseorder_SharePointDocumentLocations sharepointdocumentlocation regardingobjectid_msdyn_purchaseorder
msdyn_purchaseorder_SocialActivities socialactivity regardingobjectid_msdyn_purchaseorder_socialactivity
msdyn_purchaseorder_SyncErrors syncerror regardingobjectid_msdyn_purchaseorder
msdyn_purchaseorder_Tasks task regardingobjectid_msdyn_purchaseorder_task


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

Name Binding
GrantAccess Not Bound
IsValidStateTransition Not Bound
ModifyAccess Not Bound
RetrievePrincipalAccess Not Bound
RetrieveSharedPrincipalsAndAccess Not Bound
RevokeAccess Not Bound


The following solutions include the msdyn_purchaseorder 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.

See also