MedicationDispense

Represents the dispense of a medication to a patient in response to a medication request or order. This object also includes the instructions for how the medication is to be administered This object is available in API version 54.0 and later.

Supported Calls

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

Fields

Field	Details
ContextId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The encounter that establishes the context for the dispense of a medication. Refers To ClinicalEncounter
DispenseTypeCodeId	Type Polymorphic lookup Properties Create, Filter, Group, Nillable, Sort, Update Description The system-defined code that identifies the dispense event type. For instance, a first fill, trial fill, or refill. Refers To CodeSet CodeSetBundle
DispensedDateTime	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time when the medication was handed over.
HealthcareFacilityId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The location where the dispense occurred. Refers To HealthcareFacility
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The date and time when the record was last referenced.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The date and time when the record was last viewed.
MedAdministrationSettingCategory	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Specifies the setting in which the medication is expected to be administered to the patient. Possible values are: Inpatient Outpatient Community Discharge
MedicationCodeId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The system-defined code that identifies the medication that's dispensed. Refers To CodeSet CodeSetBundle
MedicationId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The medication that's dispensed. Relationship Name Medication Relationship Type Lookup Refers To Medication
Name	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description The name of the record.
PatientId	Type Master-detail reference Properties Create, Filter, Group, Sort Description The patient for whom the medication is dispensed. Refers To Account
PreparedDateTime	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time when the medication was prepared for dispense.
PrimaryMedicationRequestId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The primary medication request that authorized the dispense of the medication. Refers To MedicationRequest
Quantity	Type double Properties Create, Filter, Nillable, Sort, Update Description The quantity of medication that was dispensed.
QuantityUnitId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The unit of the quantity of medication that was dispensed. Refers To UnitOfMeasure
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.
SourceSystemModifiedDateTime	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time when this item was last changed in the source system.
Status	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Specifies the status of the dispense event.
StatusReasonCodeId	Type Polymorphic reference Properties Create, Filter, Group, Nillable, Sort, Update Description The system-defined code that specifies the reason for the specified status. Refers To CodeSet CodeSetBundle
SupplyDaysCount	Type double Properties Create, Filter, Nillable, Sort, Update Description The number of days that the dispensed supply is expected to last.

Additional Information for MedicationStatement in Other Objects

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

Object	Type of Information	Reference Field
Identifier	Associates an identifier value to the medication dispense.	ParentRecordId

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

MedicationDispenseFeed: Feed tracking is available for the object.
MedicationDispenseHistory: History is available for tracked fields of the object.

Salesforce Health Cloud Developer Guide

MedicationDispense

Supported Calls

Fields

Additional Information for MedicationStatement in Other Objects

Associated Objects