MedicationAdministration

Description

MedicationAdministration is shown in Patient Finder as the category medication administration, which is also filled by the resource Medication. MedicationAdministration describes the event of a patient consuming or otherwise being administered a medication.

Note on specific fields: (infusionDuration.valueDuration.value) An extension which includes the possibility to add the medication administration infusion duration value and (infusionDuration.valueDuration.unit) unit to the profile.

Instances

An example of a MedicationAdministration resource can be found here: Medication Administration Example 1

An example of the corresponding Medication resource can be found here: Medication Example 1

Profile

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
administeredBySpecialismS I0..1Extension(Reference(Organization))
id0..1string
extensionI0..0Extension
url1..1uriFixed Value
id0..1string
extensionI0..*Extension
valueΣ0..1decimal
comparatorΣ ?!0..1codeBinding
unitΣ0..1string
systemΣ I0..1uri
codeΣ0..1code
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueS Σ0..1string
periodΣ0..1Period
assignerΣ0..1Reference(Organization)
instantiatesΣ0..*uri
partOfΣ0..*Reference(MedicationAdministration | Procedure)
statusS Σ ?!1..1codeBinding
statusReason0..*CodeableConcept
category0..1CodeableConceptBinding
medicationReferenceS Σ0..1Reference(Medication)
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uri
versionΣ0..1string
codeS Σ0..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
subjectS Σ1..1Reference(Patient)
context0..1Reference(Encounter | EpisodeOfCare)
supportingInformation0..*Reference(Resource)
id0..1string
extensionI0..*Extension
startS Σ I0..1dateTime
endΣ I0..1dateTime
effectiveDateTimeS Σ0..1dateTime
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
function0..1CodeableConcept
actorS Σ1..1Reference(Practitioner)
reasonCode0..*CodeableConcept
reasonReference0..*Reference(Condition | Observation | DiagnosticReport)
requestS0..1Reference(MedicationRequest)
device0..*Reference(Device)
note0..*Annotation
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
text0..1string
site0..1CodeableConcept
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uri
versionΣ0..1string
codeS Σ0..1code
displayS Σ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
method0..1CodeableConcept
id0..1string
extensionI0..*Extension
valueS Σ0..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemΣ I0..1uri
codeΣ0..1code
rateRatioRatio
id0..1string
extensionI0..*Extension
valueS Σ0..1decimal
comparatorΣ ?!0..0codeBinding
unitS Σ0..1string
systemΣ I0..1uri
codeΣ0..1code
eventHistory0..*Reference(Provenance)
<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="pf-medication-administration" />
    <url value="https://fhir.iqvia.com/patientfinder/StructureDefinition/pf-medication-administration" />
    <name value="PatientFinderMedicationAdministration" />
    <title value="MedicationAdministration" />
    <status value="draft" />
    <description value="Medication Administration represents the Patient Finder category medication administration. The medication can be referenced as a Medication, or embedded as a CodableConcept. If it is embedded, less information can be stored." />
    <fhirVersion value="4.0.1" />
    <mapping>
        <identity value="fhir-patient-finder-mapping" />
        <name value="FHIR to Patient Finder Mapping" />
    </mapping>
    <kind value="resource" />
    <abstract value="false" />
    <type value="MedicationAdministration" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/MedicationAdministration" />
    <derivation value="constraint" />
    <differential>
        <element id="MedicationAdministration.extension">
            <path value="MedicationAdministration.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <ordered value="false" />
                <rules value="open" />
            </slicing>
            <max value="1" />
            <mustSupport value="true" />
        </element>
        <element id="MedicationAdministration.extension:administeredBySpecialism">
            <path value="MedicationAdministration.extension" />
            <sliceName value="administeredBySpecialism" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Extension" />
                <profile value="https://fhir.iqvia.com/patientfinder/extension/specialism-organization" />
            </type>
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="(Organization) medication administration specialism" />
            </mapping>
        </element>
        <element id="MedicationAdministration.extension:infusionDuration">
            <path value="MedicationAdministration.extension" />
            <sliceName value="infusionDuration" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Extension" />
                <profile value="https://fhir.iqvia.com/patientfinder/extension/pf-infusion-duration-extension" />
            </type>
        </element>
        <element id="MedicationAdministration.extension:infusionDuration.value[x].value">
            <path value="MedicationAdministration.extension.value[x].value" />
            <definition value="This extension is used to add value of the infusion duration." />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration infusion duration value" />
            </mapping>
        </element>
        <element id="MedicationAdministration.extension:infusionDuration.value[x].unit">
            <path value="MedicationAdministration.extension.value[x].unit" />
            <definition value="This extension is used to add unit of the infusion duration." />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration infusion duration unit" />
            </mapping>
        </element>
        <element id="MedicationAdministration.identifier">
            <path value="MedicationAdministration.identifier" />
            <mustSupport value="true" />
        </element>
        <element id="MedicationAdministration.identifier.value">
            <path value="MedicationAdministration.identifier.value" />
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration id" />
            </mapping>
        </element>
        <element id="MedicationAdministration.status">
            <path value="MedicationAdministration.status" />
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration status" />
            </mapping>
        </element>
        <element id="MedicationAdministration.medication[x]">
            <path value="MedicationAdministration.medication[x]" />
            <slicing>
                <discriminator>
                    <type value="type" />
                    <path value="$this" />
                </discriminator>
                <ordered value="false" />
                <rules value="open" />
            </slicing>
        </element>
        <element id="MedicationAdministration.medication[x]:medicationReference">
            <path value="MedicationAdministration.medication[x]" />
            <sliceName value="medicationReference" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Medication" />
            </type>
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration medication reference" />
            </mapping>
        </element>
        <element id="MedicationAdministration.medication[x]:medicationCodeableConcept">
            <path value="MedicationAdministration.medication[x]" />
            <sliceName value="medicationCodeableConcept" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="CodeableConcept" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="MedicationAdministration.medication[x]:medicationCodeableConcept.coding.code">
            <path value="MedicationAdministration.medication[x].coding.code" />
            <mustSupport value="true" />
        </element>
        <element id="MedicationAdministration.medication[x]:medicationCodeableConcept.coding.display">
            <path value="MedicationAdministration.medication[x].coding.display" />
            <mustSupport value="true" />
        </element>
        <element id="MedicationAdministration.subject">
            <path value="MedicationAdministration.subject" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Patient" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="MedicationAdministration.effective[x]">
            <path value="MedicationAdministration.effective[x]" />
            <slicing>
                <discriminator>
                    <type value="type" />
                    <path value="$this" />
                </discriminator>
                <ordered value="false" />
                <rules value="open" />
            </slicing>
        </element>
        <element id="MedicationAdministration.effective[x]:effectivePeriod">
            <path value="MedicationAdministration.effective[x]" />
            <sliceName value="effectivePeriod" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Period" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="MedicationAdministration.effective[x]:effectivePeriod.start">
            <path value="MedicationAdministration.effective[x].start" />
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration administration date" />
            </mapping>
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration start date" />
            </mapping>
        </element>
        <element id="MedicationAdministration.effective[x]:effectiveDateTime">
            <path value="MedicationAdministration.effective[x]" />
            <sliceName value="effectiveDateTime" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="dateTime" />
            </type>
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration administration date" />
            </mapping>
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration start date" />
            </mapping>
        </element>
        <element id="MedicationAdministration.performer">
            <path value="MedicationAdministration.performer" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="(Practitioner) administered by care provider" />
            </mapping>
        </element>
        <element id="MedicationAdministration.performer.actor">
            <path value="MedicationAdministration.performer.actor" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Practitioner" />
            </type>
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration administered by practitioner" />
            </mapping>
        </element>
        <element id="MedicationAdministration.request">
            <path value="MedicationAdministration.request" />
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication request" />
            </mapping>
        </element>
        <element id="MedicationAdministration.dosage.route">
            <path value="MedicationAdministration.dosage.route" />
            <mustSupport value="true" />
        </element>
        <element id="MedicationAdministration.dosage.route.coding.code">
            <path value="MedicationAdministration.dosage.route.coding.code" />
            <mustSupport value="true" />
        </element>
        <element id="MedicationAdministration.dosage.route.coding.display">
            <path value="MedicationAdministration.dosage.route.coding.display" />
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration route of administration" />
            </mapping>
        </element>
        <element id="MedicationAdministration.dosage.dose.value">
            <path value="MedicationAdministration.dosage.dose.value" />
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration dose value" />
            </mapping>
        </element>
        <element id="MedicationAdministration.dosage.dose.unit">
            <path value="MedicationAdministration.dosage.dose.unit" />
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration dose unit" />
            </mapping>
        </element>
        <element id="MedicationAdministration.dosage.rate[x]">
            <path value="MedicationAdministration.dosage.rate[x]" />
            <slicing>
                <discriminator>
                    <type value="type" />
                    <path value="$this" />
                </discriminator>
                <ordered value="false" />
                <rules value="open" />
            </slicing>
        </element>
        <element id="MedicationAdministration.dosage.rate[x]:rateQuantity">
            <path value="MedicationAdministration.dosage.rate[x]" />
            <sliceName value="rateQuantity" />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Quantity" />
                <profile value="http://hl7.org/fhir/StructureDefinition/SimpleQuantity" />
            </type>
        </element>
        <element id="MedicationAdministration.dosage.rate[x]:rateQuantity.value">
            <path value="MedicationAdministration.dosage.rate[x].value" />
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration infusion rate value" />
            </mapping>
        </element>
        <element id="MedicationAdministration.dosage.rate[x]:rateQuantity.unit">
            <path value="MedicationAdministration.dosage.rate[x].unit" />
            <mustSupport value="true" />
            <mapping>
                <identity value="fhir-patient-finder-mapping" />
                <map value="medication administration infusion rate unit" />
            </mapping>
        </element>
    </differential>
</StructureDefinition>
{
    "resourceType": "StructureDefinition",
    "id": "pf-medication-administration",
    "url": "https://fhir.iqvia.com/patientfinder/StructureDefinition/pf-medication-administration",
    "name": "PatientFinderMedicationAdministration",
    "title": "MedicationAdministration",
    "status": "draft",
    "description": "Medication Administration represents the Patient Finder category medication administration. The medication can be referenced as a Medication, or embedded as a CodableConcept. If it is embedded, less information can be stored.",
    "fhirVersion": "4.0.1",
    "mapping":  [
        {
            "identity": "fhir-patient-finder-mapping",
            "name": "FHIR to Patient Finder Mapping"
        }
    ],
    "kind": "resource",
    "abstract": false,
    "type": "MedicationAdministration",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/MedicationAdministration",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "MedicationAdministration.extension",
                "path": "MedicationAdministration.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "ordered": false,
                    "rules": "open"
                },
                "max": "1",
                "mustSupport": true
            },
            {
                "id": "MedicationAdministration.extension:administeredBySpecialism",
                "path": "MedicationAdministration.extension",
                "sliceName": "administeredBySpecialism",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "https://fhir.iqvia.com/patientfinder/extension/specialism-organization"
                        ]
                    }
                ],
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "(Organization) medication administration specialism"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.extension:infusionDuration",
                "path": "MedicationAdministration.extension",
                "sliceName": "infusionDuration",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "https://fhir.iqvia.com/patientfinder/extension/pf-infusion-duration-extension"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationAdministration.extension:infusionDuration.value[x].value",
                "path": "MedicationAdministration.extension.value[x].value",
                "definition": "This extension is used to add value of the infusion duration.",
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration infusion duration value"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.extension:infusionDuration.value[x].unit",
                "path": "MedicationAdministration.extension.value[x].unit",
                "definition": "This extension is used to add unit of the infusion duration.",
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration infusion duration unit"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.identifier",
                "path": "MedicationAdministration.identifier",
                "mustSupport": true
            },
            {
                "id": "MedicationAdministration.identifier.value",
                "path": "MedicationAdministration.identifier.value",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration id"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.status",
                "path": "MedicationAdministration.status",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration status"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.medication[x]",
                "path": "MedicationAdministration.medication[x]",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "type",
                            "path": "$this"
                        }
                    ],
                    "ordered": false,
                    "rules": "open"
                }
            },
            {
                "id": "MedicationAdministration.medication[x]:medicationReference",
                "path": "MedicationAdministration.medication[x]",
                "sliceName": "medicationReference",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Medication"
                        ]
                    }
                ],
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration medication reference"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.medication[x]:medicationCodeableConcept",
                "path": "MedicationAdministration.medication[x]",
                "sliceName": "medicationCodeableConcept",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "CodeableConcept"
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "MedicationAdministration.medication[x]:medicationCodeableConcept.coding.code",
                "path": "MedicationAdministration.medication[x].coding.code",
                "mustSupport": true
            },
            {
                "id": "MedicationAdministration.medication[x]:medicationCodeableConcept.coding.display",
                "path": "MedicationAdministration.medication[x].coding.display",
                "mustSupport": true
            },
            {
                "id": "MedicationAdministration.subject",
                "path": "MedicationAdministration.subject",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Patient"
                        ]
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "MedicationAdministration.effective[x]",
                "path": "MedicationAdministration.effective[x]",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "type",
                            "path": "$this"
                        }
                    ],
                    "ordered": false,
                    "rules": "open"
                }
            },
            {
                "id": "MedicationAdministration.effective[x]:effectivePeriod",
                "path": "MedicationAdministration.effective[x]",
                "sliceName": "effectivePeriod",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Period"
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "MedicationAdministration.effective[x]:effectivePeriod.start",
                "path": "MedicationAdministration.effective[x].start",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration administration date"
                    },
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration start date"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.effective[x]:effectiveDateTime",
                "path": "MedicationAdministration.effective[x]",
                "sliceName": "effectiveDateTime",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "dateTime"
                    }
                ],
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration administration date"
                    },
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration start date"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.performer",
                "path": "MedicationAdministration.performer",
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "(Practitioner) administered by care provider"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.performer.actor",
                "path": "MedicationAdministration.performer.actor",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Practitioner"
                        ]
                    }
                ],
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration administered by practitioner"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.request",
                "path": "MedicationAdministration.request",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication request"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.dosage.route",
                "path": "MedicationAdministration.dosage.route",
                "mustSupport": true
            },
            {
                "id": "MedicationAdministration.dosage.route.coding.code",
                "path": "MedicationAdministration.dosage.route.coding.code",
                "mustSupport": true
            },
            {
                "id": "MedicationAdministration.dosage.route.coding.display",
                "path": "MedicationAdministration.dosage.route.coding.display",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration route of administration"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.dosage.dose.value",
                "path": "MedicationAdministration.dosage.dose.value",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration dose value"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.dosage.dose.unit",
                "path": "MedicationAdministration.dosage.dose.unit",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration dose unit"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.dosage.rate[x]",
                "path": "MedicationAdministration.dosage.rate[x]",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "type",
                            "path": "$this"
                        }
                    ],
                    "ordered": false,
                    "rules": "open"
                }
            },
            {
                "id": "MedicationAdministration.dosage.rate[x]:rateQuantity",
                "path": "MedicationAdministration.dosage.rate[x]",
                "sliceName": "rateQuantity",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Quantity",
                        "profile":  [
                            "http://hl7.org/fhir/StructureDefinition/SimpleQuantity"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationAdministration.dosage.rate[x]:rateQuantity.value",
                "path": "MedicationAdministration.dosage.rate[x].value",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration infusion rate value"
                    }
                ]
            },
            {
                "id": "MedicationAdministration.dosage.rate[x]:rateQuantity.unit",
                "path": "MedicationAdministration.dosage.rate[x].unit",
                "mustSupport": true,
                "mapping":  [
                    {
                        "identity": "fhir-patient-finder-mapping",
                        "map": "medication administration infusion rate unit"
                    }
                ]
            }
        ]
    }
}
MedicationAdministration
DefinitionDescribes the event of a patient consuming or otherwise being administered a medication. This may be as simple as swallowing a tablet or it may be a long running infusion. Related resources tie this event to the authorizing prescription, and the specific encounter between patient and health care practitioner.
Cardinality0...*
Invariants
  • dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
    contained.contained.empty()
  • dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
    contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
  • dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
    contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
  • dom-5: If a resource is contained in another resource, it SHALL NOT have a security label
    contained.meta.security.empty()
  • dom-6: A resource should have narrative for robust management
    text.`div`.exists()
Mappings
  • rim: Entity. Role, or Act
  • workflow: Event
  • rim: SubstanceAdministration
MedicationAdministration.id
DefinitionThe logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
Cardinality0...1
Typestring
SummaryTrue
Comments

The only time that a resource does not have an id is when it is being submitted to the server using a create operation.

MedicationAdministration.meta
DefinitionThe metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.
Cardinality0...1
TypeMeta
SummaryTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
MedicationAdministration.implicitRules
DefinitionA reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.
Cardinality0...1
Typeuri
ModifierTrue
SummaryTrue
Comments

Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
MedicationAdministration.language
DefinitionThe base language in which the resource is written.
Cardinality0...1
Typecode
Binding

A human language.

CommonLanguages (preferred)
Comments

Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
MedicationAdministration.text
DefinitionA human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.
Cardinality0...1
TypeNarrative
Aliasnarrative, html, xhtml, display
Comments

Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: Act.text?
MedicationAdministration.contained
DefinitionThese resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.
Cardinality0...*
TypeResource
Aliasinline resources, anonymous resources, contained resources
Comments

This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.

Mappings
  • rim: N/A
MedicationAdministration.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...1
TypeExtension
Must SupportTrue
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: N/A
MedicationAdministration.extension:administeredBySpecialism
DefinitionThe organization representing the specialism.
Cardinality0...1
TypeExtension(Reference(Organization))
Must SupportTrue
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: N/A
  • rim: n/a
  • fhir-patient-finder-mapping: (Organization) medication administration specialism
MedicationAdministration.extension:infusionDuration
DefinitionThis extension is used to add information about duration value and unit
Cardinality0...1
TypeExtension(Duration)
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: N/A
  • rim: n/a
MedicationAdministration.extension:infusionDuration.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.extension:infusionDuration.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...0
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.extension:infusionDuration.url
DefinitionSource of the definition for the extension code - a logical name or a URL.
Cardinality1...1
Typeuri
Comments

The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

Fixed Value

https://fhir.iqvia.com/patientfinder/extension/pf-infusion-duration-extension

Mappings
  • rim: N/A
MedicationAdministration.extension:infusionDuration.value[x]
DefinitionValue of extension - must be one of a constrained set of the data types (see [Extensibility](extensibility.html) for a list).
Cardinality1...1
TypeDuration
Must SupportTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: N/A
MedicationAdministration.extension:infusionDuration.value[x].id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.extension:infusionDuration.value[x].extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.extension:infusionDuration.value[x].value
DefinitionThis extension is used to add value of the infusion duration.
Cardinality0...1
Typedecimal
SummaryTrue
Requirements

Precision is handled implicitly in almost all cases of measurement.

Comments

The implicit precision in the value should always be honored. Monetary values have their own rules for handling precision (refer to standard accounting text books).

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: SN.2 / CQ - N/A
  • rim: PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
  • fhir-patient-finder-mapping: medication administration infusion duration value
MedicationAdministration.extension:infusionDuration.value[x].comparator
DefinitionHow the value should be understood and represented - whether the actual value is greater or less than the stated value due to measurement issues; e.g. if the comparator is "<" , then the real value is < stated value.
Cardinality0...1
Typecode
Binding

How the Quantity should be understood and represented.

QuantityComparator (required)
ModifierTrue
SummaryTrue
Requirements

Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: SN.1 / CQ.1
  • rim: IVL properties
MedicationAdministration.extension:infusionDuration.value[x].unit
DefinitionThis extension is used to add unit of the infusion duration.
Cardinality0...1
Typestring
SummaryTrue
Requirements

There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: (see OBX.6 etc.) / CQ.2
  • rim: PQ.unit
  • fhir-patient-finder-mapping: medication administration infusion duration unit
MedicationAdministration.extension:infusionDuration.value[x].system
DefinitionThe identification of the system that provides the coded form of the unit.
Cardinality0...1
Typeuri
SummaryTrue
Requirements

Need to know the system that defines the coded form of the unit.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: (see OBX.6 etc.) / CQ.2
  • rim: CO.codeSystem, PQ.translation.codeSystem
MedicationAdministration.extension:infusionDuration.value[x].code
DefinitionA computer processable form of the unit in some unit representation system.
Cardinality0...1
Typecode
SummaryTrue
Requirements

Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest.

Comments

The preferred system is UCUM, but SNOMED CT can also be used (for customary units) or ISO 4217 for currency. The context of use may additionally require a code from a particular system.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: (see OBX.6 etc.) / CQ.2
  • rim: PQ.code, MO.currency, PQ.translation.code
MedicationAdministration.modifierExtension
DefinitionMay be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality0...*
TypeExtension
ModifierTrue
Aliasextensions, user content
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: N/A
MedicationAdministration.identifier
DefinitionIdentifiers associated with this Medication Administration that are defined by business processes and/or used to refer to it when a direct URL reference to the resource itself is not appropriate. They are business identifiers assigned to this resource by the performer or other systems and remain constant as the resource is updated and propagates from server to server.
Cardinality0...*
TypeIdentifier
Must SupportTrue
Comments

This is a business identifier, not a resource identifier.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.identifier
  • w5: FiveWs.identifier
  • rim: .id
MedicationAdministration.identifier.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.identifier.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.identifier.use
DefinitionThe purpose of this identifier.
Cardinality0...1
Typecode
Binding

Identifies the purpose for this identifier, if known .

IdentifierUse (required)
ModifierTrue
SummaryTrue
Requirements

Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

Comments

Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: N/A
  • rim: Role.code or implied by context
MedicationAdministration.identifier.type
DefinitionA coded type for the identifier that can be used to determine which identifier to use for a specific purpose.
Cardinality0...1
TypeCodeableConcept
Binding

A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

Identifier Type Codes (extensible)
SummaryTrue
Requirements

Allows users to make use of identifiers when the identifier system is not known.

Comments

This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage. Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: CX.5
  • rim: Role.code or implied by context
MedicationAdministration.identifier.system
DefinitionEstablishes the namespace for the value - that is, a URL that describes a set values that are unique.
Cardinality0...1
Typeuri
SummaryTrue
Requirements

There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

Comments

Identifier.system is always case sensitive.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Examples
General

http://www.acme.com/identifiers/patient


Mappings
  • v2: CX.4 / EI-2-4
  • rim: II.root or Role.id.root
  • servd: ./IdentifierType
MedicationAdministration.identifier.value
DefinitionThe portion of the identifier typically relevant to the user and which is unique within the context of the system.
Cardinality0...1
Typestring
Must SupportTrue
SummaryTrue
Comments

If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension. Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Examples
General

123456


Mappings
  • v2: CX.1 / EI.1
  • rim: II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
  • servd: ./Value
  • fhir-patient-finder-mapping: medication administration id
MedicationAdministration.identifier.period
DefinitionTime period during which identifier is/was valid for use.
Cardinality0...1
TypePeriod
SummaryTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: CX.7 + CX.8
  • rim: Role.effectiveTime or implied by context
  • servd: ./StartDate and ./EndDate
MedicationAdministration.identifier.assigner
DefinitionOrganization that issued/manages the identifier.
Cardinality0...1
TypeReference(Organization)
SummaryTrue
Comments

The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: CX.4 / (CX.4,CX.9,CX.10)
  • rim: II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • servd: ./IdentifierIssuingAuthority
MedicationAdministration.instantiates
DefinitionA protocol, guideline, orderset, or other definition that was adhered to in whole or in part by this event.
Cardinality0...*
Typeuri
SummaryTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.instantiates
  • rim: .outboundRelationship[typeCode=DEFN].target[classCode=unspecified]
MedicationAdministration.partOf
DefinitionA larger event of which this particular event is a component or step.
Cardinality0...*
TypeReference(MedicationAdministration | Procedure)
SummaryTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.partOf
  • rim: .outboundRelationship[typeCode=COMP]/target[classCode=SBADM or PROC,moodCode=EVN]
MedicationAdministration.status
DefinitionWill generally be set to show that the administration has been completed. For some long running administrations such as infusions, it is possible for an administration to be started but not completed or it may be paused while some other process is under way.
Cardinality1...1
Typecode
Binding

A set of codes indicating the current status of a MedicationAdministration.

MedicationAdministration Status Codes (required)
Must SupportTrue
ModifierTrue
SummaryTrue
Comments

This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.status
  • w5: FiveWs.status
  • v2: RXA-20-Completion Status
  • rim: .statusCode
  • fhir-patient-finder-mapping: medication administration status
MedicationAdministration.statusReason
DefinitionA code indicating why the administration was not performed.
Cardinality0...*
TypeCodeableConcept
Binding

A set of codes indicating the reason why the MedicationAdministration is negated.

SNOMEDCTReasonMedicationNotGivenCodes (example)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.statusReason
  • v2: RXA-9-Administration Notes / RXA-18 Substance/Treatment Refusal Reason
  • rim: .outboundRelationship[typeCode=RSON]/target[classCode=OBS,moodCode=EVN, code="reason not given"].value
MedicationAdministration.category
DefinitionIndicates where the medication is expected to be consumed or administered.
Cardinality0...1
TypeCodeableConcept
Binding

A coded concept describing where the medication administered is expected to occur.

MedicationAdministration Category Codes (preferred)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: .inboundRelationship[typeCode=COMP].source[classCode=OBS, moodCode=EVN, code="type of medication usage"].value
MedicationAdministration.medication[x]
DefinitionIdentifies the medication that was 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.
Cardinality1...1
TypeCodeableConcept
Binding

Codes identifying substance or product that can be administered.

SNOMEDCTMedicationCodes (example)
SummaryTrue
Comments

If only a code is specified, then it needs to be a code for a specific product. If more information is required, then the use of the medication resource is recommended. For example, if you require form or lot number, then you must reference the Medication resource.

SlicingUnordered, Open, by $this(Type)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.code
  • w5: FiveWs.what[x]
  • v2: RXA-5-Administered Code
  • rim: .participation[typeCode=CSM].role[classCode=ADMM]
MedicationAdministration.medication[x]:medicationReference
DefinitionIdentifies the medication that was 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.
Cardinality0...1
TypeReference(Medication)
Must SupportTrue
SummaryTrue
Comments

If only a code is specified, then it needs to be a code for a specific product. If more information is required, then the use of the medication resource is recommended. For example, if you require form or lot number, then you must reference the Medication resource.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.code
  • w5: FiveWs.what[x]
  • v2: RXA-5-Administered Code
  • rim: .participation[typeCode=CSM].role[classCode=ADMM]
  • fhir-patient-finder-mapping: medication administration medication reference
MedicationAdministration.medication[x]:medicationCodeableConcept
DefinitionIdentifies the medication that was 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.
Cardinality0...1
TypeCodeableConcept
Binding

Codes identifying substance or product that can be administered.

SNOMEDCTMedicationCodes (example)
Must SupportTrue
SummaryTrue
Comments

If only a code is specified, then it needs to be a code for a specific product. If more information is required, then the use of the medication resource is recommended. For example, if you require form or lot number, then you must reference the Medication resource.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.code
  • w5: FiveWs.what[x]
  • v2: RXA-5-Administered Code
  • rim: .participation[typeCode=CSM].role[classCode=ADMM]
MedicationAdministration.medication[x]:medicationCodeableConcept.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.medication[x]:medicationCodeableConcept.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.medication[x]:medicationCodeableConcept.coding
DefinitionA reference to a code defined by a terminology system.
Cardinality0...*
TypeCoding
SummaryTrue
Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.1-8, C*E.10-22
  • rim: union(., ./translation)
  • orim: fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding
MedicationAdministration.medication[x]:medicationCodeableConcept.coding.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.medication[x]:medicationCodeableConcept.coding.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.medication[x]:medicationCodeableConcept.coding.system
DefinitionThe identification of the code system that defines the meaning of the symbol in the code.
Cardinality0...1
Typeuri
SummaryTrue
Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.3
  • rim: ./codeSystem
  • orim: fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem
MedicationAdministration.medication[x]:medicationCodeableConcept.coding.version
DefinitionThe version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured, and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged.
Cardinality0...1
Typestring
SummaryTrue
Comments

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.7
  • rim: ./codeSystemVersion
  • orim: fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion
MedicationAdministration.medication[x]:medicationCodeableConcept.coding.code
DefinitionA symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).
Cardinality0...1
Typecode
Must SupportTrue
SummaryTrue
Requirements

Need to refer to a particular code in the system.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.1
  • rim: ./code
  • orim: fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code
MedicationAdministration.medication[x]:medicationCodeableConcept.coding.display
DefinitionA representation of the meaning of the code in the system, following the rules of the system.
Cardinality0...1
Typestring
Must SupportTrue
SummaryTrue
Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.2 - but note this is not well followed
  • rim: CV.displayName
  • orim: fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName
MedicationAdministration.medication[x]:medicationCodeableConcept.coding.userSelected
DefinitionIndicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).
Cardinality0...1
Typeboolean
SummaryTrue
Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: Sometimes implied by being first
  • rim: CD.codingRationale
  • orim: fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]
MedicationAdministration.medication[x]:medicationCodeableConcept.text
DefinitionA human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
Cardinality0...1
Typestring
SummaryTrue
Requirements

The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.

Comments

Very often the text is the same as a displayName of one of the codings.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.9. But note many systems use C*E.2 for this
  • rim: ./originalText[mediaType/code="text/plain"]/data
  • orim: fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText
MedicationAdministration.subject
DefinitionThe person or animal or group receiving the medication.
Cardinality1...1
TypeReference(Patient)
Must SupportTrue
SummaryTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.subject
  • w5: FiveWs.subject[x]
  • v2: PID-3-Patient ID List
  • rim: .participation[typeCode=SBJ].role[classCode=PAT]
  • w5: FiveWs.subject
MedicationAdministration.context
DefinitionThe visit, admission, or other contact between patient and health care provider during which the medication administration was performed.
Cardinality0...1
TypeReference(Encounter | EpisodeOfCare)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.context
  • w5: FiveWs.context
  • v2: PV1-19-Visit Number
  • rim: .inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN, code="type of encounter or episode"]
MedicationAdministration.supportingInformation
DefinitionAdditional information (for example, patient height and weight) that supports the administration of the medication.
Cardinality0...*
TypeReference(Resource)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • w5: FiveWs.context
  • rim: .outboundRelationship[typeCode=PERT].target[A_SupportingClinicalStatement CMET minimal with many different choices of classCodes(ORG, ENC, PROC, SPLY, SBADM, OBS) and each of the act class codes draws from one or more of the following moodCodes (EVN, DEF, INT PRMS, RQO, PRP, APT, ARQ, GOL)]
MedicationAdministration.effective[x]
DefinitionA specific date/time or interval of time during which the administration took place (or did not take place, when the 'notGiven' attribute is true). For many administrations, such as swallowing a tablet the use of dateTime is more appropriate.
Cardinality1...1
TypedateTime
SummaryTrue
SlicingUnordered, Open, by $this(Type)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.occurrence[x]
  • w5: FiveWs.done[x]
  • v2: RXA-3-Date/Time Start of Administration / RXA-4-Date/Time End of Administration
  • rim: .effectiveTime
MedicationAdministration.effective[x]:effectivePeriod
DefinitionA specific date/time or interval of time during which the administration took place (or did not take place, when the 'notGiven' attribute is true). For many administrations, such as swallowing a tablet the use of dateTime is more appropriate.
Cardinality0...1
TypePeriod
Must SupportTrue
SummaryTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.occurrence[x]
  • w5: FiveWs.done[x]
  • v2: RXA-3-Date/Time Start of Administration / RXA-4-Date/Time End of Administration
  • rim: .effectiveTime
MedicationAdministration.effective[x]:effectivePeriod.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.effective[x]:effectivePeriod.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.effective[x]:effectivePeriod.start
DefinitionThe start of the period. The boundary is inclusive.
Cardinality0...1
TypedateTime
Must SupportTrue
SummaryTrue
Comments

If the low element is missing, the meaning is that the low boundary is not known.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: DR.1
  • rim: ./low
  • fhir-patient-finder-mapping: medication administration administration date
  • fhir-patient-finder-mapping: medication administration start date
MedicationAdministration.effective[x]:effectivePeriod.end
DefinitionThe end of the period. If the end of the period is missing, it means no end was known or planned at the time the instance was created. The start may be in the past, and the end date in the future, which means that period is expected/planned to end at that time.
Cardinality0...1
TypedateTime
SummaryTrue
Comments

The high value includes any matching date/time. i.e. 2012-02-03T10:00:00 is in a period that has an end value of 2012-02-03.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: DR.2
  • rim: ./high
MedicationAdministration.effective[x]:effectiveDateTime
DefinitionA specific date/time or interval of time during which the administration took place (or did not take place, when the 'notGiven' attribute is true). For many administrations, such as swallowing a tablet the use of dateTime is more appropriate.
Cardinality0...1
TypedateTime
Must SupportTrue
SummaryTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.occurrence[x]
  • w5: FiveWs.done[x]
  • v2: RXA-3-Date/Time Start of Administration / RXA-4-Date/Time End of Administration
  • rim: .effectiveTime
  • fhir-patient-finder-mapping: medication administration administration date
  • fhir-patient-finder-mapping: medication administration start date
MedicationAdministration.performer
DefinitionIndicates who or what performed the medication administration and how they were involved.
Cardinality0...*
TypeBackboneElement
SummaryTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.performer
  • w5: FiveWs.actor
  • v2: RXA-10-Administering Provider / PRT-5-Participation Person: PRT-4-Participation='AP' (RXA-10 is deprecated)
  • rim: .participation[typeCode=PRF]
  • fhir-patient-finder-mapping: (Practitioner) administered by care provider
MedicationAdministration.performer.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.performer.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.performer.modifierExtension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality0...*
TypeExtension
ModifierTrue
SummaryTrue
Aliasextensions, user content, modifiers
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: N/A
MedicationAdministration.performer.function
DefinitionDistinguishes the type of involvement of the performer in the medication administration.
Cardinality0...1
TypeCodeableConcept
Binding

A code describing the role an individual played in administering the medication.

MedicationAdministration Performer Function Codes (example)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.performer.function
  • rim: participation[typeCode=PRF].functionCode
MedicationAdministration.performer.actor
DefinitionIndicates who or what performed the medication administration.
Cardinality1...1
TypeReference(Practitioner)
Must SupportTrue
SummaryTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.performer.actor
  • rim: .role
  • fhir-patient-finder-mapping: medication administration administered by practitioner
MedicationAdministration.reasonCode
DefinitionA code indicating why the medication was given.
Cardinality0...*
TypeCodeableConcept
Binding

A set of codes indicating the reason why the MedicationAdministration was made.

ReasonMedicationGivenCodes (example)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.reasonCode
  • v2: RXE-27 Give Indication
  • rim: .reasonCode
MedicationAdministration.reasonReference
DefinitionCondition or observation that supports why the medication was administered.
Cardinality0...*
TypeReference(Condition | Observation | DiagnosticReport)
Comments

This is a reference to a condition that is the reason for the medication request. If only a code exists, use reasonCode.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.reasonReference
  • w5: FiveWs.why[x]
  • rim: .outboundRelationship[typeCode=RSON]/target[classCode=OBS,moodCode=EVN, code="reason for use ASSERTION"].value
  • w3c.prov: no mapping
MedicationAdministration.request
DefinitionThe original request, instruction or authority to perform the administration.
Cardinality0...1
TypeReference(MedicationRequest)
Must SupportTrue
Comments

This is a reference to the MedicationRequest where the intent is either order or instance-order. It should not reference MedicationRequests where the intent is any other value.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.basedOn
  • v2: ORC-2-Placer Order Number / ORC-3-Filler Order Number
  • rim: InFullfillmentOf->SubstanceAdministration
  • fhir-patient-finder-mapping: medication request
MedicationAdministration.device
DefinitionThe device used in administering the medication to the patient. For example, a particular infusion pump.
Cardinality0...*
TypeReference(Device)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: PRT-10 Participation Device / RXR-3 Administrative Device
  • rim: device->Access OR device->AssignedDevice
MedicationAdministration.note
DefinitionExtra information about the medication administration that is not conveyed by the other attributes.
Cardinality0...*
TypeAnnotation
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • workflow: Event.note
  • rim: .inboundRelationship[typeCode=SUBJ]/source[classCode=OBS,moodCode=EVN,code="annotation"].value
MedicationAdministration.dosage
DefinitionDescribes the medication dosage information details e.g. dose, rate, site, route, etc.
Cardinality0...1
TypeBackboneElement
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • mad-1: SHALL have at least one of dosage.dose or dosage.rate[x]
    dose.exists() or rate.exists()
Mappings
  • rim: component->SubstanceAdministrationEvent
MedicationAdministration.dosage.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.dosage.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.dosage.modifierExtension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality0...*
TypeExtension
ModifierTrue
SummaryTrue
Aliasextensions, user content, modifiers
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: N/A
MedicationAdministration.dosage.text
DefinitionFree text dosage can be used for cases where the dosage administered is too complex to code. When coded dosage is present, the free text dosage may still be present for display to humans. The dosage instructions should reflect the dosage of the medication that was administered.
Cardinality0...1
Typestring
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: .text
MedicationAdministration.dosage.site
DefinitionA coded specification of the anatomic site where the medication first entered the body. For example, "left arm".
Cardinality0...1
TypeCodeableConcept
Binding

A coded concept describing the site location the medicine enters into or onto the body.

SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (example)
Comments

If the use case requires attributes from the BodySite resource (e.g. to identify and track separately) then use the standard extension bodySite. May be a summary code, or a reference to a very precise definition of the location, or both.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: RXR-2 Administration Site / RXR-6 Administration Site Modifier
  • rim: .approachSiteCode
MedicationAdministration.dosage.route
DefinitionA code specifying the route or physiological path of administration of a therapeutic agent into or onto the patient. For example, topical, intravenous, etc.
Cardinality0...1
TypeCodeableConcept
Binding

A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject.

SNOMEDCTRouteCodes (example)
Must SupportTrue
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: RXR-1-Route
  • rim: .routeCode
MedicationAdministration.dosage.route.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.dosage.route.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.dosage.route.coding
DefinitionA reference to a code defined by a terminology system.
Cardinality0...*
TypeCoding
SummaryTrue
Requirements

Allows for alternative encodings within a code system, and translations to other code systems.

Comments

Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.1-8, C*E.10-22
  • rim: union(., ./translation)
  • orim: fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding
MedicationAdministration.dosage.route.coding.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.dosage.route.coding.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.dosage.route.coding.system
DefinitionThe identification of the code system that defines the meaning of the symbol in the code.
Cardinality0...1
Typeuri
SummaryTrue
Requirements

Need to be unambiguous about the source of the definition of the symbol.

Comments

The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.3
  • rim: ./codeSystem
  • orim: fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem
MedicationAdministration.dosage.route.coding.version
DefinitionThe version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured, and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged.
Cardinality0...1
Typestring
SummaryTrue
Comments

Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.7
  • rim: ./codeSystemVersion
  • orim: fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion
MedicationAdministration.dosage.route.coding.code
DefinitionA symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).
Cardinality0...1
Typecode
Must SupportTrue
SummaryTrue
Requirements

Need to refer to a particular code in the system.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.1
  • rim: ./code
  • orim: fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code
MedicationAdministration.dosage.route.coding.display
DefinitionA representation of the meaning of the code in the system, following the rules of the system.
Cardinality0...1
Typestring
Must SupportTrue
SummaryTrue
Requirements

Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.2 - but note this is not well followed
  • rim: CV.displayName
  • orim: fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName
  • fhir-patient-finder-mapping: medication administration route of administration
MedicationAdministration.dosage.route.coding.userSelected
DefinitionIndicates that this coding was chosen by a user directly - e.g. off a pick list of available items (codes or displays).
Cardinality0...1
Typeboolean
SummaryTrue
Requirements

This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

Comments

Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: Sometimes implied by being first
  • rim: CD.codingRationale
  • orim: fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]
MedicationAdministration.dosage.route.text
DefinitionA human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
Cardinality0...1
Typestring
SummaryTrue
Requirements

The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.

Comments

Very often the text is the same as a displayName of one of the codings.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: C*E.9. But note many systems use C*E.2 for this
  • rim: ./originalText[mediaType/code="text/plain"]/data
  • orim: fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText
MedicationAdministration.dosage.method
DefinitionA coded value indicating the method by which the medication is intended to be or was introduced into or on the body. This attribute will most often NOT be populated. It is most commonly used for injections. For example, Slow Push, Deep IV.
Cardinality0...1
TypeCodeableConcept
Binding

A coded concept describing the technique by which the medicine is administered.

SNOMEDCTAdministrationMethodCodes (example)
Comments

One of the reasons this attribute is not used often, is that the method is often pre-coordinated with the route and/or form of administration. This means the codes used in route or form may pre-coordinate the method in the route code or the form code. The implementation decision about what coding system to use for route or form code will determine how frequently the method code will be populated e.g. if route or form code pre-coordinate method code, then this attribute will not be populated often; if there is no pre-coordination then method code may be used frequently.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: RXR-4-Administration Method
  • rim: .methodCode
MedicationAdministration.dosage.dose
DefinitionThe amount of the medication given at one administration event. Use this value when the administration is essentially an instantaneous event such as a swallowing a tablet or giving an injection.
Cardinality0...1
TypeSimpleQuantity
Comments

If the administration is not instantaneous (rate is present), this can be specified to convey the total amount administered over period of time of a single administration.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: RXA-6 Administered Amount / RXA-7 Administered Units
  • rim: .doseQuantity
MedicationAdministration.dosage.dose.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.dosage.dose.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.dosage.dose.value
DefinitionThe value of the measured amount. The value includes an implicit precision in the presentation of the value.
Cardinality0...1
Typedecimal
Must SupportTrue
SummaryTrue
Requirements

Precision is handled implicitly in almost all cases of measurement.

Comments

The implicit precision in the value should always be honored. Monetary values have their own rules for handling precision (refer to standard accounting text books).

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: SN.2 / CQ - N/A
  • rim: PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
  • fhir-patient-finder-mapping: medication administration dose value
MedicationAdministration.dosage.dose.comparator
DefinitionNot allowed to be used in this context
Cardinality0...0
Typecode
Binding

How the Quantity should be understood and represented.

QuantityComparator (required)
ModifierTrue
SummaryTrue
Requirements

Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: SN.1 / CQ.1
  • rim: IVL properties
MedicationAdministration.dosage.dose.unit
DefinitionA human-readable form of the unit.
Cardinality0...1
Typestring
Must SupportTrue
SummaryTrue
Requirements

There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: (see OBX.6 etc.) / CQ.2
  • rim: PQ.unit
  • fhir-patient-finder-mapping: medication administration dose unit
MedicationAdministration.dosage.dose.system
DefinitionThe identification of the system that provides the coded form of the unit.
Cardinality0...1
Typeuri
SummaryTrue
Requirements

Need to know the system that defines the coded form of the unit.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: (see OBX.6 etc.) / CQ.2
  • rim: CO.codeSystem, PQ.translation.codeSystem
MedicationAdministration.dosage.dose.code
DefinitionA computer processable form of the unit in some unit representation system.
Cardinality0...1
Typecode
SummaryTrue
Requirements

Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest.

Comments

The preferred system is UCUM, but SNOMED CT can also be used (for customary units) or ISO 4217 for currency. The context of use may additionally require a code from a particular system.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: (see OBX.6 etc.) / CQ.2
  • rim: PQ.code, MO.currency, PQ.translation.code
MedicationAdministration.dosage.rate[x]
DefinitionIdentifies the speed with which the medication was or will be introduced into the patient. Typically, the rate for an infusion e.g. 100 ml per 1 hour or 100 ml/hr. May also be expressed as a rate per unit of time, e.g. 500 ml per 2 hours. Other examples: 200 mcg/min or 200 mcg/1 minute; 1 liter/8 hours.
Cardinality0...1
TypeRatio
Comments

If the rate changes over time, and you want to capture this in MedicationAdministration, then each change should be captured as a distinct MedicationAdministration, with a specific MedicationAdministration.dosage.rate, and the date time when the rate change occurred. Typically, the MedicationAdministration.dosage.rate element is not used to convey an average rate.

SlicingUnordered, Open, by $this(Type)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: RXA-12-Administered Per (Time Unit)
  • rim: .rateQuantity
MedicationAdministration.dosage.rate[x]:rateQuantity
DefinitionThe comparator is not used on a SimpleQuantity
Cardinality0...1
TypeSimpleQuantity
Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • qty-3: If a code for the unit is present, the system SHALL also be present
    code.empty() or system.exists()
  • sqty-1: The comparator is not used on a SimpleQuantity
    comparator.empty()
Mappings
  • v2: RXA-12-Administered Per (Time Unit)
  • rim: .rateQuantity
  • rim: n/a
  • v2: SN (see also Range) or CQ
  • rim: PQ, IVL<PQ>, MO, CO, depending on the values
MedicationAdministration.dosage.rate[x]:rateQuantity.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration.dosage.rate[x]:rateQuantity.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
MedicationAdministration.dosage.rate[x]:rateQuantity.value
DefinitionThe value of the measured amount. The value includes an implicit precision in the presentation of the value.
Cardinality0...1
Typedecimal
Must SupportTrue
SummaryTrue
Requirements

Precision is handled implicitly in almost all cases of measurement.

Comments

The implicit precision in the value should always be honored. Monetary values have their own rules for handling precision (refer to standard accounting text books).

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: SN.2 / CQ - N/A
  • rim: PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
  • fhir-patient-finder-mapping: medication administration infusion rate value
MedicationAdministration.dosage.rate[x]:rateQuantity.comparator
DefinitionNot allowed to be used in this context
Cardinality0...0
Typecode
Binding

How the Quantity should be understood and represented.

QuantityComparator (required)
ModifierTrue
SummaryTrue
Requirements

Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: SN.1 / CQ.1
  • rim: IVL properties
MedicationAdministration.dosage.rate[x]:rateQuantity.unit
DefinitionA human-readable form of the unit.
Cardinality0...1
Typestring
Must SupportTrue
SummaryTrue
Requirements

There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: (see OBX.6 etc.) / CQ.2
  • rim: PQ.unit
  • fhir-patient-finder-mapping: medication administration infusion rate unit
MedicationAdministration.dosage.rate[x]:rateQuantity.system
DefinitionThe identification of the system that provides the coded form of the unit.
Cardinality0...1
Typeuri
SummaryTrue
Requirements

Need to know the system that defines the coded form of the unit.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: (see OBX.6 etc.) / CQ.2
  • rim: CO.codeSystem, PQ.translation.codeSystem
MedicationAdministration.dosage.rate[x]:rateQuantity.code
DefinitionA computer processable form of the unit in some unit representation system.
Cardinality0...1
Typecode
SummaryTrue
Requirements

Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest.

Comments

The preferred system is UCUM, but SNOMED CT can also be used (for customary units) or ISO 4217 for currency. The context of use may additionally require a code from a particular system.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • v2: (see OBX.6 etc.) / CQ.2
  • rim: PQ.code, MO.currency, PQ.translation.code
MedicationAdministration.eventHistory
DefinitionA summary of the events of interest that have occurred, such as when the administration was verified.
Cardinality0...*
TypeReference(Provenance)
Comments

This might not include provenances for all versions of the request – only those deemed “relevant” or important. This SHALL NOT include the Provenance associated with this current version of the resource. (If that provenance is deemed to be a “relevant” change, it will need to be added as part of a later update. Until then, it can be queried directly as the Provenance that points to this version using _revinclude All Provenances should have some historical version of this Request as their subject.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: .inboundRelationship(typeCode=SUBJ].source[classCode=CACT, moodCode=EVN]

Attribute list

Attribute Description Example
identifier.value The code that identifies the medication administration in the source system 'medication-administration-example-1'
request A reference to the MedicationRequest that requested this administration 'medication-request-example-1'
medicationReference A reference to the Medication administered 'medication-example-1'
medicationCodeableConcept.coding.display A textual representation of the medication administered 'parcatamol 50mg'
effectivePeriod.start The date when the medication is (scheduled to be) administered '2021-01-01T12:00:00Z'
effectiveDateTime The date when the medication is (scheduled to be) administered '2021-01-01T12:00:00Z'
performer.actor A reference to the practitioner who administered the medication 'practitioner-example-1'
status The status of the medication administration 'completed', 'in progress'
dosage.dose.value The dosage of medication administered '5'
dosage.dose.unit The unit of the dosage of medication administered 'mg'
dosage.rateQuantity.value The dose quantity per unit of time '50'
dosage.rateQuantity.unit The unit of the dosage quantity per unit of time ml/h'
dosage.route.coding.display The route of the substance into the body "Oral"
extension[administered_by_specialism] A reference to the specialism responsible for the medication administration 'specialism-example-1'
extension[infusionDuration].valueDuration.value The value of medication administration infusion duration '30'
extension[infusionDuration].valueDuration.unit The value of medication administration infusion duration 'minutes'