msdyn_rtv EntityType

Records RTVs for products to be retuned to vendors

Entity Set Path
[organization URI]/api/data/v9.0/msdyn_rtvs
Base Type
Display Name
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: Address 1

msdyn_address2 Edm.String

Display Name: Address 2

msdyn_address3 Edm.String

Display Name: Address 3

msdyn_city Edm.String

Display Name: City

msdyn_country Edm.String

Display Name: Country/Region

msdyn_latitude Edm.Double

Display Name: Latitude

msdyn_longitude Edm.Double

Display Name: Longitude

msdyn_name Edm.String

Shows the unique number for identifying this RTV record.

Display Name: RTV Number

msdyn_postalcode Edm.String

Display Name: Postal Code

msdyn_referenceno Edm.String

Display Name: Reference No

msdyn_requestdate Edm.DateTimeOffset

Enter the date when return was requested.

Display Name: Request Date

msdyn_returndate Edm.DateTimeOffset

Enter the date items were returned to vendor.

Display Name: Return Date

msdyn_rtvid Edm.Guid

Shows the entity instances.

Display Name: RTV

msdyn_stateorprovince Edm.String

Display Name: State Or Province

msdyn_systemstatus Edm.Int32

Enter the current status of the RTV.

Display Name: System Status

Default Options
Value Label
690970000 Draft
690970001 Approved
690970002 Shipped
690970003 Received
690970004 Canceled
msdyn_totalamount Edm.Decimal

Shows the total Amount to be credited on this RTV.

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_vendorrma Edm.String

RMA from Vendor

Display Name: Vendor RMA

overriddencreatedon Edm.DateTimeOffset

Shows the date and time that the record was migrated.

Display Name: Record Created On

statecode Edm.Int32

Status of the RTV

Display Name: Status

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

Reason for the status of the RTV

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

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_approveddeclinedby_value msdyn_approveddeclinedby

The user who approved or rejected this return

_msdyn_booking_value msdyn_booking

Unique identifier for Resource Booking associated with RTV.

_msdyn_originalpurchaseorder_value msdyn_originalpurchaseorder

Purchase Order from where items are originating

_msdyn_originatingrma_value msdyn_originatingrma

Originating RMA if items were returned from customer

_msdyn_returnedby_value msdyn_returnedby

User processing this return

_msdyn_shipvia_value msdyn_shipvia

Method of Shipment to Vendor

_msdyn_substatus_value msdyn_substatus

RTV Sub-Status

_msdyn_taxcode_value msdyn_taxcode

Tax code vendor charges you

_msdyn_vendor_value msdyn_vendor

Vendor where items will be returned

_msdyn_vendorcontact_value msdyn_vendorcontact

Contact person at Vendor

_msdyn_workorder_value msdyn_workorder

Unique identifier for Work Order associated with RTV.

_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.

_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_rtv_createdby
createdonbehalfby systemuser lk_msdyn_rtv_createdonbehalfby
modifiedby systemuser lk_msdyn_rtv_modifiedby
modifiedonbehalfby systemuser lk_msdyn_rtv_modifiedonbehalfby
msdyn_approveddeclinedby systemuser msdyn_systemuser_msdyn_rtv_ApprovedDeclinedBy
msdyn_booking bookableresourcebooking msdyn_bookableresourcebooking_msdyn_rtv_Booking
msdyn_originalpurchaseorder msdyn_purchaseorder msdyn_msdyn_purchaseorder_msdyn_rtv_OriginalPO
msdyn_originatingrma msdyn_rma msdyn_msdyn_rma_msdyn_rtv_OriginatingRMA
msdyn_returnedby systemuser msdyn_systemuser_msdyn_rtv_ReturnedBy
msdyn_shipvia msdyn_shipvia msdyn_msdyn_shipvia_msdyn_rtv_ShipVia
msdyn_substatus msdyn_rtvsubstatus msdyn_msdyn_rtvsubstatus_msdyn_rtv_SubStatus
msdyn_taxcode msdyn_taxcode msdyn_msdyn_taxcode_msdyn_rtv_TaxCode
msdyn_vendor account msdyn_account_msdyn_rtv_Vendor
msdyn_vendorcontact contact msdyn_contact_msdyn_rtv_VendorContact
msdyn_workorder msdyn_workorder msdyn_msdyn_workorder_msdyn_rtv_WorkOrder
ownerid principal owner_msdyn_rtv
owningbusinessunit businessunit business_unit_msdyn_rtv
owningteam team team_msdyn_rtv
owninguser systemuser user_msdyn_rtv
transactioncurrencyid transactioncurrency TransactionCurrency_msdyn_rtv

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_msdyn_rtv_msdyn_rmareceiptproduct_RTV msdyn_rmareceiptproduct msdyn_rtv
msdyn_msdyn_rtv_msdyn_rtvproduct_RTV msdyn_rtvproduct msdyn_rtv
msdyn_rtv_ActivityPointers activitypointer regardingobjectid_msdyn_rtv
msdyn_rtv_Annotations annotation objectid_msdyn_rtv
msdyn_rtv_Appointments appointment regardingobjectid_msdyn_rtv_appointment
msdyn_rtv_AsyncOperations asyncoperation regardingobjectid_msdyn_rtv
msdyn_rtv_BulkDeleteFailures bulkdeletefailure regardingobjectid_msdyn_rtv
msdyn_rtv_connections1 connection record1id_msdyn_rtv
msdyn_rtv_connections2 connection record2id_msdyn_rtv
msdyn_rtv_DuplicateBaseRecord duplicaterecord baserecordid_msdyn_rtv
msdyn_rtv_DuplicateMatchingRecord duplicaterecord duplicaterecordid_msdyn_rtv
msdyn_rtv_Emails email regardingobjectid_msdyn_rtv_email
msdyn_rtv_Faxes fax regardingobjectid_msdyn_rtv_fax
msdyn_rtv_Letters letter regardingobjectid_msdyn_rtv_letter
msdyn_rtv_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_msdyn_rtv
msdyn_rtv_msdyn_approvals msdyn_approval regardingobjectid_msdyn_rtv_msdyn_approval
msdyn_rtv_msdyn_bookingalerts msdyn_bookingalert regardingobjectid_msdyn_rtv_msdyn_bookingalert
msdyn_rtv_PhoneCalls phonecall regardingobjectid_msdyn_rtv_phonecall
msdyn_rtv_PrincipalObjectAttributeAccesses principalobjectattributeaccess objectid_msdyn_rtv
msdyn_rtv_ProcessSession processsession regardingobjectid_msdyn_rtv
msdyn_rtv_RecurringAppointmentMasters recurringappointmentmaster regardingobjectid_msdyn_rtv_recurringappointmentmaster
msdyn_rtv_ServiceAppointments serviceappointment regardingobjectid_msdyn_rtv_serviceappointment
msdyn_rtv_SharePointDocumentLocations sharepointdocumentlocation regardingobjectid_msdyn_rtv
msdyn_rtv_SocialActivities socialactivity regardingobjectid_msdyn_rtv_socialactivity
msdyn_rtv_SyncErrors syncerror regardingobjectid_msdyn_rtv
msdyn_rtv_Tasks task regardingobjectid_msdyn_rtv_task


The following operations can be used with the msdyn_rtv 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_rtv 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