US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401 United States of America flag

Publication Build: This will be filled in by the publication tooling

Resource Profile: MedicationDispenseOriginal - Mappings

Active as of 2025-03-31

Mappings for the MedicationDispenseOriginal resource profile.

Scroll down for the Raw FHIR, CDW & SDA mappings (if any).

Note that the CDW and SDA mappings are derived from a look-up based on the VistA source mappings in CDW and VPR SDA.

Mapping Sources

Use Case: MedicationDispense: Original (Source)DRUG (50).01GENERIC NAME22PSNDF VA PRODUCT NAME ENTRYPRESCRIPTION (52)2PATIENT6DRUG7QTY8DAYS SUPPLY10SIG11MAIL/WINDOW/PARK12REMARKS20DIVISION23PHARMACIST31RELEASED DATE/TIME39.3PLACER ORDER #113MEDICATION INSTRUCTIONS114PATIENT INSTRUCTIONSOUTPATIENT SITE (59)10DEFAULT ERX CLINICMEDICATION INSTRUCTIONS (52.0113).01DOSAGE ORDERED2UNITS[number]

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
1708 for review V2F fixed value MedicationDispense.type http://terminology.hl7.org/CodeSystem/v3-ActCode#FF http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
822 for review V2F PRESCRIPTION - PLACER ORDER # (52-39.3) reference MedicationDispense.authorizingPrescription /MedicationRequestOutpatient http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
826 for review V2F PRESCRIPTION - DAYS SUPPLY (52-8) source value MedicationDispense.daysSupply http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
835 for review V2F PRESCRIPTION - MAIL/WINDOW/PARK (52-11) source value MedicationDispense.destination .display http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
842 for review V2F PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - UNITS (52-113 > 52.0113-2) source value MedicationDispense.dosageInstruction .doseAndRate.doseQuantity.unit http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1575 for review V2F PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - UNITS (52-113 > 52.0113-2) terminologyMaps MedicationDispense.dosageInstruction .doseAndRate.doseQuantity.code VF_DoseUnits http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
840 for review V2F PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - DOSAGE ORDERED (52-113 > 52.0113-.01) source value number MedicationDispense.dosageInstruction .doseAndRate.doseQuantity.value http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
839 for review V2F PRESCRIPTION - PATIENT INSTRUCTIONS (52-114) source value MedicationDispense.dosageInstruction .patientInstruction http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
838 for review V2F PRESCRIPTION - SIG (52-10) source value MedicationDispense.dosageInstruction .text http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1545 for review V2F PRESCRIPTION - DRUG > DRUG - PSNDF VA PRODUCT NAME ENTRY (52-6 > 50-22) source value MedicationDispense.medicationCodeableConcept.coding .code .system = urn:oid:2.16.840.1.113883.6.233 http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1545-1 for review V2F fixed value MedicationDispense.medicationCodeableConcept.coding .system urn:oid:2.16.840.1.113883.6.233 generated from mapParameter line 1 http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1544 for review V2F PRESCRIPTION - DRUG > DRUG - GENERIC NAME (52-6 > 50-.01) source value MedicationDispense.medicationCodeableConcept .text This may not be necessary; we have the product. http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
823 for review V2F PRESCRIPTION - QTY (52-7) source value MedicationDispense.quantity .value http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1541 for review V2F PRESCRIPTION - RELEASED DATE/TIME (52-31) fixed value not null MedicationDispense.status #completed http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
820 for review V2F PRESCRIPTION - PATIENT (52-2) reference MedicationDispense.subject /Patient http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
832 for review V2F PRESCRIPTION - RELEASED DATE/TIME (52-31) source value MedicationDispense.whenPrepared WHO Per discussion with Pharma: Josh Miller 5/27/22 updated to WP per discussion with Eric Spahn 2/5/24 http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1668 for review V2F fixed value MedicationDispense.category http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-category#outpatient http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1711 for review V2F PRESCRIPTION - DIVISION > OUTPATIENT SITE - DEFAULT ERX CLINIC (52-20 > 59-10) reference MedicationDispense.location /Location not Clinic (written) but Division (filled) http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1716 for review V2F PRESCRIPTION - REMARKS (52-12) source value MedicationDispense.note .text http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1727 for review V2F PRESCRIPTION - PHARMACIST (52-23) reference MedicationDispense.performer.actor /Practitioner http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1

Mappings for Veterans Health Information Systems Technology and Architecture (VistA) ()

MedicationDispenseOriginal
MedicationDispense
   status1541: fixed value = #completed when PRESCRIPTION - RELEASED DATE/TIME (52-31) if not null
   category1668: fixed value = http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-category#outpatient
   medication[x]
   medication[x] (medicationCodeableConcept)
      coding
         system1545-1: fixed value = urn:oid:2.16.840.1.113883.6.233

generated from mapParameter line 1

         code1545: source value based on PRESCRIPTION - DRUG > DRUG - PSNDF VA PRODUCT NAME ENTRY (52-6 > 50-22)
      text1544: source value based on PRESCRIPTION - DRUG > DRUG - GENERIC NAME (52-6 > 50-.01)

This may not be necessary; we have the product.

   subject820: reference based on PRESCRIPTION - PATIENT (52-2)
   performer
      actor1727: reference based on PRESCRIPTION - PHARMACIST (52-23)
   location1711: reference based on PRESCRIPTION - DIVISION > OUTPATIENT SITE - DEFAULT ERX CLINIC (52-20 > 59-10)

not Clinic (written) but Division (filled)

   authorizingPrescription822: reference based on PRESCRIPTION - PLACER ORDER # (52-39.3)
   type1708: fixed value = http://terminology.hl7.org/CodeSystem/v3-ActCode#FF
   quantity
      value823: source value based on PRESCRIPTION - QTY (52-7)
   daysSupply826: source value based on PRESCRIPTION - DAYS SUPPLY (52-8)
   whenPrepared832: source value based on PRESCRIPTION - RELEASED DATE/TIME (52-31)

WHO Per discussion with Pharma: Josh Miller 5/27/22 updated to WP per discussion with Eric Spahn 2/5/24

   destination
      display835: source value based on PRESCRIPTION - MAIL/WINDOW/PARK (52-11)
   note
      text1716: source value based on PRESCRIPTION - REMARKS (52-12)
   dosageInstruction
      text838: source value based on PRESCRIPTION - SIG (52-10)
      patientInstruction839: source value based on PRESCRIPTION - PATIENT INSTRUCTIONS (52-114)
      doseAndRate
         dose[x]
         dose[x] (doseQuantity)
            value840: source value based on PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - DOSAGE ORDERED (52-113 > 52.0113-.01) if number
            unit842: source value based on PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - UNITS (52-113 > 52.0113-2)
            code1575: terminologyMaps using VF_DoseUnits on PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - UNITS (52-113 > 52.0113-2)

Mappings for Clinical Data Warehouse (CDW) ()

MedicationDispenseOriginal
MedicationDispense
   medication[x]
   medication[x] (medicationCodeableConcept)
      coding
         codeRxOut.RxOutpat.LocalDrugIEN,RxOut.RxOutpat.NationalDrugIEN,RxOut.RxOutpatFill.LocalDrugIEN,RxOut.RxOutpatFill.NationalDrugIEN Dim.LocalDrug.DrugNameWithoutDoseIEN,Dim.LocalDrug.NationalDrugIEN,Dim.LocalDrug.NationalDrugIEN
      textRxOut.RxOutpat.LocalDrugIEN,RxOut.RxOutpat.NationalDrugIEN,RxOut.RxOutpatFill.LocalDrugIEN,RxOut.RxOutpatFill.NationalDrugIEN Dim.LocalDrug.LocalDrugNameWithDose,Dim.LocalDrug.LocalDrugNameWithDose,RxOut.RxOutpatFill.LocalDrugNameWithDose
   subjectRxOut.ActivityLog.PatientIEN,RxOut.ActivityLogOtherComments.PatientIEN,RxOut.RxOutpat.PatientIEN,RxOut.RxOutpatExt.PatientIEN,RxOut.RxOutpatExt.PatientSID,RxOut.RxOutpatFill.PatientIEN,RxOut.RxOutpatMedInstructions.PatientIEN,RxOut.RxOutpatSig.PatientIEN
   authorizingPrescriptionRxOut.RxOutpat.CPRSOrderEntryNumber
   dosageInstruction
      patientInstructionRxOut.RxOutpatSig.PatientInstructions
      doseAndRate
         dose[x]
         dose[x] (doseQuantity)
            valueRxOut.RxOutpatMedInstructions.DoseOrdered
            unitRxOut.RxOutpatMedInstructions.Unit
            codeRxOut.RxOutpatMedInstructions.Unit

Mappings for Summary Document Architecure (SDA) ()

MedicationDispenseOriginal
MedicationDispense
   medication[x]
   medication[x] (medicationCodeableConcept)
      coding
         codeMedication.DrugProduct,Medication.CMOP Medication.DrugProduct.Identifier2,Medication.DrugProduct.ProductName,Medication.Extension[DrugProductExtension].FederalSchedule
      textMedication.DrugProduct,Medication.CMOP Medication.ComponentMeds[DrugProduct].Description,Medication.ComponentMeds[DrugProduct].OriginalText,Medication.DrugProduct.Description,Medication.DrugProduct.OriginalText,Medication.ATCCode.Code,Medication.Generic.Description,Medication.Route.Description,Medication.OrderCategory.Description,Medication.OriginalText,Medication.OriginalText
   locationMedication.OutpatientSite
   authorizingPrescriptionMedication.ExternalId,Medication.PlacerId
   quantity
      valueMedication.OrderQuantity
   daysSupplyMedication.DaysSupply
   note
      textMedication.Remarks
   dosageInstruction
      patientInstructionMedication.TextInstruction
      doseAndRate
         dose[x]
         dose[x] (doseQuantity)
            valueMedication.DosageSteps,Medication.Route,Medication.DoseQuantity,Medication.DoseUoM,Medication.Duration,Medication.Frequency,Medication.TextInstruction,Medication.Conjunction,Medication.Noun,Medication.UnitsPerDose,Medication.Verb
            unitMedication.DosageSteps,Medication.Route,Medication.DoseQuantity,Medication.DoseUoM,Medication.Duration,Medication.Frequency,Medication.TextInstruction,Medication.Conjunction,Medication.Noun,Medication.UnitsPerDose,Medication.Verb
            codeMedication.DosageSteps,Medication.Route,Medication.DoseQuantity,Medication.DoseUoM,Medication.Duration,Medication.Frequency,Medication.TextInstruction,Medication.Conjunction,Medication.Noun,Medication.UnitsPerDose,Medication.Verb

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

MedicationDispenseOriginal
MedicationDispenseEvent
   identifierEvent.identifier
   partOfEvent.partOf
   statusEvent.status
   statusReason[x]Event.statusReason
   medication[x]Event.code
   medication[x] (medicationCodeableConcept)Event.code
   subjectEvent.subject
   contextEvent.context
   performerEvent.performer
      actorEvent.performer.actor
   authorizingPrescriptionEvent.basedOn
   whenHandedOverEvent.occurrence[x]
   noteEvent.note

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

MedicationDispenseOriginal
MedicationDispenseEntity. Role, or Act, Supply[moodCode=EVN]
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifier.id
   partOf.outboundRelationship[typeCode=COMP]/target[classCode=PROC,moodCode=EVN]
   status.statusCode
   statusReason[x].outboundRelationship[typeCode=RSON]/target[classCode=OBS,moodCode=EVN, code="not done reason"].value
   category.inboundRelationship[typeCode=COMP].source[classCode=OBS, moodCode=EVN, code="type of medication dispense"].value
   medication[x].participation[typeCode=PRD].role
   medication[x] (medicationCodeableConcept).participation[typeCode=PRD].role
      idn/a
      extensionn/a
      codingunion(., ./translation)
         idn/a
         extensionn/a
         system./codeSystem
         version./codeSystemVersion
         code./code
         displayCV.displayName
         userSelectedCD.codingRationale
      text./originalText[mediaType/code="text/plain"]/data
   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
      functionparticipation[typeCode=PRF].functionCode
      actor.role
   location.participation[typeCode=LOC].role
   authorizingPrescription.outboundRelationship[typeCode=FLFS].target[moodCode=RQO]
   type.code
   quantity.quantity
      idn/a
      extensionn/a
      valuePQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
      unitPQ.unit
      systemCO.codeSystem, PQ.translation.codeSystem
      codePQ.code, MO.currency, PQ.translation.code
   daysSupplyeffectiveUseTime
   whenPrepared.effectiveTime[xmi:type=IVL_TS].low
   whenHandedOver.effectiveTime[xmi:type=IVL_TS].high
   destination.participation[typeCode=DST].role
      idn/a
      extensionn/a
      referenceN/A
      typeN/A
      identifier.identifier
      displayN/A
   receiver.participation[typeCode=RCV].role
   note.inboundRelationship[typeCode=SUBJ]/source[classCode=ACT,moodCode=EVN]
      idn/a
      extensionn/a
      author[x]Act.participant[typeCode=AUT].role
      timeAct.effectiveTime
      textAct.text
   dosageInstruction.outboundRelationship[typeCode=COMP].target[classCode=SBADM, moodCode=INT]
      idn/a
      extensionn/a
      modifierExtensionN/A
      sequence.text
      text.text
      additionalInstruction.text
      patientInstruction.text
      timing.effectiveTime
      asNeeded[x].outboundRelationship[typeCode=PRCN].target[classCode=OBS, moodCode=EVN, code="as needed"].value=boolean or codable concept
      site.approachSiteCode
      route.routeCode
      method.doseQuantity
      doseAndRate
         idn/a
         extensionn/a
         dose[x].doseQuantity
         dose[x] (doseQuantity).doseQuantity
            idn/a
            extensionn/a
            valuePQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
            unitPQ.unit
            systemCO.codeSystem, PQ.translation.codeSystem
            codePQ.code, MO.currency, PQ.translation.code
         rate[x].rateQuantity
      maxDosePerPeriod.maxDoseQuantity
      maxDosePerAdministrationnot supported
      maxDosePerLifetimenot supported
   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
   eventHistory.inboundRelationship(typeCode=SUBJ].source[classCode=CACT, moodCode=EVN]

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

MedicationDispenseOriginal
MedicationDispense
   identifierFiveWs.identifier
   statusFiveWs.status
   medication[x]FiveWs.what[x]
   medication[x] (medicationCodeableConcept)FiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   supportingInformationFiveWs.context

Mappings for V3 Pharmacy Dispense RMIM (http://www.hl7.org/v3/PORX_RM020070UV)

MedicationDispenseOriginal
MedicationDispense
   identifierCombinedMedicationDispense.id
   statusCombinedMedicationDispense.SupplyEvent.statusCode
   medication[x]CombinedMedicationRequest.component1.AdministrationRequest.consumable
   medication[x] (medicationCodeableConcept)CombinedMedicationRequest.component1.AdministrationRequest.consumable
   authorizingPrescriptionCombinedMedicationDispense.inFulfillmentOf
   typeCombinedMedicationDispense.SupplyEvent.code
   quantityCombinedMedicationDispense.SupplyEvent.quantity
   whenPreparedCombinedMedicationDispense.SupplyEvent.effectiveTime
   whenHandedOverCombinedMedicationDispense.SupplyEvent.effectiveTime
   destinationCombinedMedicationDispense.SupplyEvent.destination
   receiverCombinedMedicationDispense.SupplyEvent.receiver
   substitutionCombinedMedicationDispense.substitutionMade
      typeCombinedMedicationDispense.substitutionMade.code
      reasonCombinedMedicationDispense.substitutionMade.reasonCode
      responsiblePartyCombinedMedicationDispense.substitutionMade.ResponsibleParty

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

MedicationDispenseOriginal
MedicationDispense
   medication[x]RXD-2-Dispense/Give Code
   medication[x] (medicationCodeableConcept)RXD-2-Dispense/Give Code
      codingC*E.1-8, C*E.10-22
         systemC*E.3
         versionC*E.7
         codeC*E.1
         displayC*E.2 - but note this is not well followed
         userSelectedSometimes implied by being first
      textC*E.9. But note many systems use C*E.2 for this
   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
      valueSN.2 / CQ - N/A
      unit(see OBX.6 etc.) / CQ.2
      system(see OBX.6 etc.) / CQ.2
      code(see OBX.6 etc.) / CQ.2
   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
      author[x]N/A
      timeN/A
      textN/A
   dosageInstruction
      sequenceTQ1-1
      textRXO-6; RXE-21
      additionalInstructionRXO-7
      patientInstructionRXO-7
      asNeeded[x]TQ1-9
      siteRXR-2
      routeRXR-1
      methodRXR-4
      doseAndRateTQ1-2
         typeRXO-21; RXE-23
         dose[x]RXO-2, RXE-3
         dose[x] (doseQuantity)RXO-2, RXE-3
            valueSN.2 / CQ - N/A
            unit(see OBX.6 etc.) / CQ.2
            system(see OBX.6 etc.) / CQ.2
            code(see OBX.6 etc.) / CQ.2
         rate[x]RXE22, RXE23, RXE-24
      maxDosePerPeriodRXO-23, RXE-19
   substitution
      typeRXO-9-Allow Substitutions / RXE-9-Substitution Status