Salesforce Docs Portal

MedicationStatement

Represents a record of medication that the patient is currently taking or has taken in the past. 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()

Additional Information for MedicationStatement in Other Objects

In addition to creating a record using these fields, you can add more details to your MedicationStatement record by creating records in certain other objects, and referencing your MedicationStatement 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 statement. ParentRecordId
PatientMedicationDosage Associates dosage related information for the medication in the medication statement record. ParentRecordId

Fields

AssertionDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The date and time the medication statement was made.

CareObservationId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The observation that warranted this medication.
  • Referenced Objects:
    • CareObservation

CaseId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The case associated with the patient's medication statement.

    This field is a relationship field.

  • Relationship Name: Case
  • Refers To: Case

ClinicalEncounterId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The encounter related to the medication statement.
  • Referenced Objects:
    • ClinicalEncounter

DeliverySetting

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the setting in which the medication was administered.
  • Possible values:
    • Community
    • Inpatient
    • Outpatient
    • PatientSpecified

EndDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The stated end date and time for the medication.

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.

MedicationCodeId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that identifies a medication. 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: The medication associated with this medication statement. A record can select either a MedicationId or a MedicationCodeId, but not both.
  • Referenced Objects:
    • Medication

MedicationReasonCodeId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that specifies the reason this medication was taken.
  • Referenced Objects:
    • CodeSetBundle

MedicationReasonId

  • Type: Polymorphic reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The observation, condition, or diagnostic report that warranted the medication.
  • Referenced Objects:
    • HealthCondition
    • CareObservation

MedicationRequestId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A medication request associated with the medication statement.
  • Referenced Objects:
    • MedicationRequest

Name

  • Type: string
  • Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
  • Description: The system-generated name of the medication statement record.

OwnerId

  • Type: reference
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: The owner of the medication statement record. Available in API version 56.0 and later. This is a polymorphic relationship field.
  • Relationship Name: Owner
  • Relationship Type: Lookup
  • Refers To:
    • Group
    • User

ParentMedicationStatementId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The parent medication statement associated with the medication statement.
  • Referenced Objects:
    • MedicationStatement

PatientId

  • Type: Master-detail reference
  • Properties: Create, Filter, Group, Sort
  • Description: A patient that the medication statement refers to.
  • Referenced Objects:
    • Account

ProcedureId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The procedure associated with this medication statement.
  • Referenced Objects:
    • PatientMedicalProcedure

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.

StartDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The stated start date and time for the medication.

StatementSourceId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The person who made the medication statement.

Status

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the status of the medication in this statement.
  • Possible values:
    • Active
    • Completed
    • Entered-in-error
    • Intended
    • Not-taken
    • On-hold
    • Review Pending - This picklist value is available for the Home Health feature in API version 59.0 and later.
    • 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

Associated Objects

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

MedicationStatementChangeEvent (API version 58.0)
Change events are available for the object.
MedicationStatementFeed
Feed tracking is available for the object.
MedicationStatementHistory
History is available for tracked fields of the object.
MedicationStatementOwnerSharingRule (API version 56.0)
Sharing rules are available for the object.
MedicationStatementShare (API version 56.0)
Sharing is available for the object.