2nd DSTU Draft For Comment

This page is part of the FHIR Specification (v0.4.0: DSTU 2 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

4.17.5 Resource MedicationStatement - Detailed Descriptions

Detailed Descriptions for the elements in the MedicationStatement resource.

MedicationStatement
Definition

A record of medication being taken by a patient, or that the medication has been given to a patient where the record is the result of a report from the patient or another clinician.

Control1..1
MedicationStatement.identifier
Definition

External identifier - FHIR will generate its own internal IDs (probably URLs) which do not need to be explicitly managed by the resource. The identifier here is one that would be used by another non-FHIR system - for example an automated medication pump would provide a record each time it operated; an administration while the patient was off the ward might be made with a different system and entered after the event. Particularly important if these records have to be updated.

Control0..*
TypeIdentifier
MedicationStatement.patient
Definition

The person or animal who is /was taking the medication.

Control0..1
TypeReference(Patient)
MedicationStatement.informationSource
Definition

The person who provided the information about the taking of this medication.

Control0..1
TypeReference(Patient | Practitioner | RelatedPerson)
MedicationStatement.dateAsserted
Definition

The date when the medication statement was asserted by the information source.

Control0..1
TypedateTime
MedicationStatement.status
Definition

A code specifying the state of the statement. Generally this will be in-progress or completed state.

Control1..1
BindingMedicationStatementStatus: Required: http://hl7.org/fhir/medication-statement-status (A set of codes indicating the current status of a MedicationStatement)
Typecode
MedicationStatement.wasNotGiven
Definition

Set this to true if the record is saying that the medication was NOT taken.

Control0..1
Typeboolean
Is Modifiertrue
Meaning if MissingIf this is missing, then the medication was taken
MedicationStatement.reasonNotGiven
Definition

A code indicating why the medication was not taken.

Control0..*
BindingMedicationAdministrationNegationReason: Example: See http://hl7.org/fhir/vs/reason-medication-not-given-codes (A set of codes indicating the reason why the MedicationAdministration is negated.)
TypeCodeableConcept
InvariantsDefined on this element
mst-1: Reason not given is only permitted if wasNotGiven is true (xpath: not(exists(f:reasonNotGiven) and f:wasNotGiven/@value='false'))
Affect this element
mst-1: Reason not given is only permitted if wasNotGiven is true (xpath: not(exists(f:reasonNotGiven) and f:wasNotGiven/@value='false'))
To DoIs this in the 80% for medication statement?.
MedicationStatement.reasonForUse[x]
Definition

A reason for why the medication is being/was taken.

Control0..1
TypeCodeableConcept|Reference(Condition)
InvariantsDefined on this element
mst-2: Reason for use is only permitted if wasNotGiven is false (xpath: not(exists(f:reasonForUse[x]) and f:wasNotGiven/@value='true'))
MedicationStatement.effective[x]
Definition

The interval of time during which it is being asserted that the patient was taking the medication (or was not taking, when the 'wasNotGiven' attribute is true).

Control0..1
TypedateTime|Period
Comments

If the medication is still being taken at the time the statement is recorded, the "end" date will be omitted.

MedicationStatement.note
Definition

Provides extra information about the medication statement that is not conveyed by the other attributes.

Control0..1
Typestring
MedicationStatement.medication
Definition

Identifies the medication being administered. This is either a link to a resource representing the details of the medication or a simple attribute carrying a code that identifies the medication from a known list of medications.

Control0..1
TypeReference(Medication)
Comments

Note: do not use Medication.name to describe the medication this statement concerns. When the only available information is a text description of the medication, Medication.code.text should be used.

MedicationStatement.dosage
Definition

Indicates how the medication is/was used by the patient.

Control0..*
MedicationStatement.dosage.text
Definition

Free text dosage instructions can be used for cases where the instructions are too complex to code. When coded instructions are present, the free text instructions may still be present for display to humans taking or administering the medication.

Control0..1
Typestring
MedicationStatement.dosage.schedule
Definition

The timing schedule for giving the medication to the patient. The Schedule data type allows many different expressions, for example. "Every 8 hours"; "Three times a day"; "1/2 an hour before breakfast for 10 days from 23-Dec 2011:"; "15 Oct 2013, 17 Oct 2013 and 1 Nov 2013".

Control0..1
TypeTiming
MedicationStatement.dosage.asNeeded[x]
Definition

If set to true or if specified as a CodeableConcept, indicates that the medication is only taken when needed within the specified schedule rather than at every scheduled dose. If a CodeableConcept is present, it indicates the pre-condition for taking the Medication.

Control0..1
BindingMedicationAsNeededReason: A coded concept identifying the pre-condition that should hold prior to consuming a medication dose. For example "pain", "30 minutes prior to sexual intercourse", "on flare-up", etc.
Typeboolean|CodeableConcept
MedicationStatement.dosage.site
Definition

A coded specification of the anatomic site where the medication first enters the body.

Control0..1
BindingMedicationAdministrationSite: Example: See http://hl7.org/fhir/vs/approach-site-codes (A coded concept describing the site location the medicine enters into or onto the body)
TypeCodeableConcept
MedicationStatement.dosage.route
Definition

A code specifying the route or physiological path of administration of a therapeutic agent into or onto a subject.

Control0..1
BindingRouteOfAdministration: Example: See http://hl7.org/fhir/vs/route-codes (A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject.)
TypeCodeableConcept
MedicationStatement.dosage.method
Definition

A coded value indicating the method by which the medication is introduced into or onto the body. Most commonly used for injections. Examples: Slow Push; Deep IV.

Terminologies used often pre-coordinate this term with the route and or form of administration.

Control0..1
BindingMedicationAdministrationMethod: Example: See http://hl7.org/fhir/vs/administration-method-codes (A coded concept describing the technique by which the medicine is administered)
TypeCodeableConcept
MedicationStatement.dosage.quantity
Definition

The amount of therapeutic or other substance given at one administration event.

Control0..1
TypeQuantity
MedicationStatement.dosage.rate
Definition

Identifies the speed with which the substance is introduced into the subject. Typically the rate for an infusion. 200ml in 2 hours.

Control0..1
TypeRatio
MedicationStatement.dosage.maxDosePerPeriod
Definition

The maximum total quantity of a therapeutic substance that may be administered to a subject over the period of time. E.g. 1000mg in 24 hours.

Control0..1
TypeRatio
To DoIs this in the 80% for medication statement?.