MedicationRequest

Represents a request or order for the supply of medication, along with information about how it should be administered. This object is available in API version 51.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

Field	Details
AllowedSubstitutionTypeCodeId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The system-defined code that represents the type of substitution that's allowed. This field can’t be used if the CanSubstitute field is set to `true.` Referenced Objects CodeSetBundle
CanSubstitute	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether substitution is okay. If the value for this field is set to `true`, then the AllowedSubstitutionTypeCodeId field can’t be selected.
ClinicalEncounterId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The clinical encounter related to the medication request. Referenced Objects ClinicalEncounter
ClinicalServiceRequestId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description References the service request related to the medication request. Referenced Objects ClinicalServiceRequest
DispenseInterval	Type double Properties Create, Filter, Nillable, Sort, Update Description The minimum interval required between refills.
DispenseIntervalUnitId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The unit for that interval. Referenced Objects UnitOfMeasure
DispenserId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The person who provides the medication. Referenced Objects Account
FillDurationUnitId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The unit for the fill duration. Referenced Objects UnitOfMeasure
FillQuantityUnitId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The unit of the fill quantity. Referenced Objects UnitOfMeasure
InitialFillDuration	Type double Properties Create, Filter, Nillable, Sort, Update Description The length of time the first fill is expected to last.
InitialFillQuantity	Type double Properties Create, Filter, Nillable, Sort, Update Description The quantity to be filled in the first dispense.
IsIgnored	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the request should be ignored.
IsSecondaryInformation	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the request is based on information from a secondary source instead of a primary one. If this field is set to `true`, then the SecondarySourceId field can’t be selected.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The most recent date on which a user referenced this record.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The most recent date on which a user viewed this record.
MedicationAdministrationContextId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The system-defined code that represents the setting in which the medication is administered. Referenced Objects CodeSetBundle
MedicationCodeId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The system-defined code that specifies the medication requested. A record can select either a MedicationId or a MedicationCodeId, but not both. Referenced Objects CodeSetBundle
MedicationId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Lookup to the medication record for the medicine requested. A record can select either a MedicationId or a MedicationCodeId, but not both. Referenced Objects Medication
MedicationRequestGroupId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description A shared identifier common to all medication requests that were authorized more or less simultaneously by a single author. Referenced Objects Identifier
Name	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description The system-generated name of the medication request record.
PatientId	Type Master-detail reference Properties Create, Filter, Group, Sort Description The person who needs the medicine. Referenced Objects Account
PerformerId	Type Polymorphic reference Properties Create, Filter, Group, Nillable, Sort, Update Description The person who will administer the medicine. Referenced Objects Account HealthcareProvider CareRegisteredDevice
PerformerTypeId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The system-defined code that represents the performer's role. For instance, cardiologist, neurosurgeon, etc. Referenced Objects CodeSetBundle
PrescribedDate	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and perhaps time when the prescription was initially written or authored on.
PrescriptionPeriodEnd	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The end date for the prescription's validity.
PrescriptionPeriodStart	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The start date for the prescription's validity.
PreviousPrescriptionId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Reference to previous prescriptions. Referenced Objects MedicationRequest
Priority	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Specifies the priority of the request. Possible values are: `ASAP` `Routine` `Stat` `Urgent`
ReasonCodeId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The code for why the medicine was requested. Referenced Objects CodeSetBundle
ReasonReferenceId	Type Polymorphic reference Properties Create, Filter, Group, Nillable, Sort, Update Description Reference to the condition or obbservation that warranted this medicine. Referenced Objects HealthCondition CareObservation
RefillDuration	Type double Properties Create, Filter, Nillable, Sort, Update Description How long the refill is expected to last.
RefillQuantity	Type double Properties Create, Filter, Nillable, Sort, Update Description The quantity in each refill.
RefillsAllowed	Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The number of refills that are allowed.
RelatedRequestId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description A plan or request that is fulfilled in whole or in part by this medication request. Referenced Objects MedicationRequest
RequesterId	Type Polymorphic reference Properties Create, Filter, Group, Nillable, Sort, Update Description The person who raised the request. Referenced Objects Account HealthcareProvider CareRegisteredDevice
SecondarySourceId	Type Polymorphic reference Properties Create, Filter, Group, Nillable, Sort, Update Description References the person who gave the information for the request. This field can’t be selected if the IsSecondarySource field is set to `true.` Referenced Objects Account HealthcareProvider
SourceSystem	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The name of the system this record came from.
SourceSystemIdentifier	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of this record in its source system.
SourceSystemModified	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date on which this item was last changed in the source system.
Status	Type picklist Properties Create, Filter, Group, Sort, Update Description The status of the medication request. Possible values are: `Active` `Cancelled` `Completed` `Draft` `Entered-in-Error` `On-Hold` `Stopped` `Unknown`
StatusReasonCodeId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The system-defined code that specifies the reason for the status. Referenced Objects CodeSetBundle
SubstitutionReasonCodeId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Specifies why a subsitution is required. Referenced Objects CodeSetBundle
TherapyDuration	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The description of the overall pattern of the administration of the medication to the patient. For instance, Continuos, Acute, Seasonal. Possible values are: `Continuous` `Seasonal` `Short Term`
Type	Type picklist Properties Create, Filter, Group, Sort, Update Description The type of the request. Possible values are: `Filler Order` `Instance Order` `Option` `Order` `Original Order` `Plan` `Proposal` `Reflex Order`

Additional Information for MedicationRequest in Other Objects

In addition to creating a record using these fields, you can add more details to your MedicationRequest record by creating records in certain other objects, and referencing your MedicationRequest record as the parent record. Here’s the list of objects you can associate to MedicationRequest in this way, the type of information they add, and the field they use to reference MedicationRequest.

Object	Type of Information	Reference Field
Identifier	Associates an identifier value to the medication request.	ParentRecordId
PatientMedicationDosage	Associates dosage related information for the medication in the medication request record.	ParentRecordId

Associated Objects

This object has the following associated objects. Unless noted, they are available in the same API version as this object.

MedicationRequestFeed: Feed tracking is available for the object.
MedicationRequestHistory: History is available for tracked fields of the object.

Salesforce Health Cloud Developer Guide

MedicationRequest

Supported Calls

Fields

Additional Information for MedicationRequest in Other Objects

Associated Objects