US Meds Implementation Guide (Release 1.2.0)

This page is part of the US-Medication FHIR IG (v1.2.0: STU 2) based on FHIR R3. This is the current published version in it's permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Mappings for the StructureDefinition-medicationdispense Profile.

Mappings for Workflow Mapping (http://hl7.org/fhir/workflow)

MedicationDispenseProfile
MedicationDispense..Event
   identifier…identifier
   partOf…part of
   status…status
   medication[x]…code
   subject…subject
   context…context
   performer…performer
      actor….actor
      onBehalfOf….onBehalfOf
   authorizingPrescription…basedOn
   whenHandedOver…occurrenceDateTime
   note…note
   notDone…notDone
   notDoneReason[x]…notDoneReason

Mappings for RIM Mapping (http://hl7.org/v3)

MedicationDispenseProfile
MedicationDispenseEntity. Role, or Act
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifier.id
   partOf.outboundRelationship[typeCode=COMP]/target[classCode=PROC,moodCode=EVN]
   status.statusCode
   category.inboundRelationship[typeCode=COMP].source[classCode=OBS, moodCode=EVN, code="type of medication dispense"].value
   medication[x].participation[typeCode=PRD].role
   subject.participation[typeCode=SBJ].role[classCode=PAT]
   context.inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN, code="type of encounter or episode"]
   supportingInformation.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)]
   performer.participation[typeCode=PRF]
      idn/a
      extensionn/a
      modifierExtensionN/A
      actor.role
      onBehalfOf.role.scopingOrganization
   authorizingPrescription.outboundRelationship[typeCode=FLFS].target[moodCode=RQO]
   type.code
   quantity.quantity
   daysSupplyeffectiveUseTime
   whenPrepared.effectiveTime[xmi:type=IVL_TS].low
   whenHandedOver.effectiveTime[xmi:type=IVL_TS].high
   destination.participation[typeCode=DST].role
   receiver.participation[typeCode=RCV].role
   note.inboundRelationship[typeCode=SUBJ]/source[classCode=ACT,moodCode=EVN]
   dosageInstruction.outboundRelationship[typeCode=COMP].target[classCode=SBADM, moodCode=INT]
   substitution.outboundRelationship[typeCode=COMP].target[classCode=SUBST, moodCode=EVN]
      idn/a
      extensionn/a
      modifierExtensionN/A
      wasSubstituted.actionNegationInd
      type.code
      reason.reasonCode
      responsibleParty.participation[typeCode=PFM].role[classCode=ASSIGN]
   detectedIssue.inboundRelationship[typeCode=SUBJ]/source[classCode=ALRT,moodCode=EVN].value
   notDone.actionNegationInd
   notDoneReason[x].outboundRelationship[typeCode=RSON]/target[classCode=OBS,moodCode=EVN, code="not done reason"].value
   eventHistory.inboundRelationship(typeCode=SUBJ].source[classCode=CACT, moodCode=EVN]

Mappings for W5 Mapping (http://hl7.org/fhir/w5)

MedicationDispenseProfile
MedicationDispenseclinical.medication
   identifierid
   statusstatus
   medication[x]what
   subjectwho.focus
   supportingInformationcontext

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

MedicationDispenseProfile
MedicationDispense
   medication[x]RXD-2-Dispense/Give Code
   subjectPID-3-Patient ID List
   authorizingPrescriptionORC-2 Placer Order Number
   typeRXD-33-Dispense Type
   quantityRXD-4-Actual Dispense Amount / RXD-5.1-Actual Dispense Units.code / RXD-5.3-Actual Dispense Units.name of coding system
   daysSupplyTQ1.6 Timing/Quantity Segment Service Duration. Prior to v2.5, ORC.7.3 Common Order Segment / Quantity/Timing / Duration component. This is a formatted string, first character for the time unit (e.g., D=days), followed by the value. For example, “D14” represents “14 days supply” From v2.5 on, TQ1.6 Timing/Quantity Segment / Service Duration. This is a CQ data type (<Quantity (NM)> ^ <Units (CWE)>), thus for days supply, assuming the unit of measure is “days”, the numeric value is TQ1.6.1 (…|14^ For backwards compatibility, ORC.7 was permitted through v2.6. Both forms (field and segment) may be present in v2.5, v2.5.1, and v2.6
   whenPreparedRXD-3-Date/Time Dispensed
   whenHandedOverRXD-3-Date/Time Dispensed
   destinationRXD-13 Dispense-to Location; RXD-30 Dispense to Pharmacy; RXD-31 Dispense to Pharmacy Address
   noteRXD-9 Dispense Notes
   substitution
      typeRXO-9-Allow Substitutions / RXE-9-Substitution Status