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: MedicationDispensePartial - Mappings

Active as of 2025-03-31

Mappings for the MedicationDispensePartial 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: Partial (Source)DRUG (50).01GENERIC NAME22PSNDF VA PRODUCT NAME ENTRYPRESCRIPTION (52)2PATIENT6DRUG10SIG39.3PLACER ORDER #60PARTIAL DATE113MEDICATION INSTRUCTIONS114PATIENT INSTRUCTIONSOUTPATIENT SITE (59)10DEFAULT ERX CLINICPARTIAL DATE (52.2).02MAIL/WINDOW.03REMARKS.04QTY.041DAYS SUPPLY.05PHARMACIST NAME.09DIVISION8RELEASED DATE/TIMEMEDICATION INSTRUCTIONS (52.0113).01DOSAGE ORDERED2UNITS[number][not null]

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
1710 for review V2F fixed value MedicationDispense.type http://terminology.hl7.org/CodeSystem/v3-ActCode#PF http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1713 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - MAIL/WINDOW (52-60 > 52.2-.02) source value MedicationDispense.destination .display http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1565 for review V2F PRESCRIPTION - PLACER ORDER # (52-39.3) reference MedicationDispense.authorizingPrescription /MedicationRequestOutpatient http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
828 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - DAYS SUPPLY (52-60 > 52.2-.041) source value MedicationDispense.daysSupply http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
837 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - MAIL/WINDOW (52-60 > 52.2-.02) source value MedicationDispense.destination .display http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1571 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
1576 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
1570 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
1569 for review V2F PRESCRIPTION - PATIENT INSTRUCTIONS (52-114) source value MedicationDispense.dosageInstruction .patientInstruction http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1568 for review V2F PRESCRIPTION - SIG (52-10) source value MedicationDispense.dosageInstruction .text http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1573 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
1573-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
1572 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
1566 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - QTY (52-60 > 52.2-.04) source value MedicationDispense.quantity .value http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1577 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - RELEASED DATE/TIME (52-60 > 52.2-8) fixed value not null MedicationDispense.status #completed http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1578 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - RELEASED DATE/TIME (52-60 > 52.2-8) fixed value null MedicationDispense.status #in-progress http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1563 for review V2F PRESCRIPTION - PATIENT (52-2) reference MedicationDispense.subject /Patient http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
834 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - RELEASED DATE/TIME (52-60 > 52.2-8) source value MedicationDispense.whenPrepared see original fill note http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1714 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - DIVISION > OUTPATIENT SITE - DEFAULT ERX CLINIC (52-60 > 52.2-.09 > 59-10) reference MedicationDispense.location /Location not Clinic (written) but Division (filled) http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1717 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - REMARKS (52-60 > 52.2-.03) source value MedicationDispense.note .text http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1729 for review V2F PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - PHARMACIST NAME (52-60 > 52.2-.05) reference MedicationDispense.performer.actor /Practitioner http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
2216 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

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

MedicationDispensePartial
MedicationDispense
   status1577: fixed value = #completed when PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - RELEASED DATE/TIME (52-60 > 52.2-8) if not null, 1578: fixed value = #in-progress when PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - RELEASED DATE/TIME (52-60 > 52.2-8) if null,
   category2216: fixed value = http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-category#outpatient
   medication[x]
   medication[x] (medicationCodeableConcept)
      coding
         system1573-1: fixed value = urn:oid:2.16.840.1.113883.6.233

generated from mapParameter line 1

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

This may not be necessary; we have the product.

   subject1563: reference based on PRESCRIPTION - PATIENT (52-2)
   performer
      actor1729: reference based on PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - PHARMACIST NAME (52-60 > 52.2-.05)
   location1714: reference based on PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - DIVISION > OUTPATIENT SITE - DEFAULT ERX CLINIC (52-60 > 52.2-.09 > 59-10)

not Clinic (written) but Division (filled)

   authorizingPrescription1565: reference based on PRESCRIPTION - PLACER ORDER # (52-39.3)
   type1710: fixed value = http://terminology.hl7.org/CodeSystem/v3-ActCode#PF
   quantity
      value1566: source value based on PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - QTY (52-60 > 52.2-.04)
   daysSupply828: source value based on PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - DAYS SUPPLY (52-60 > 52.2-.041)
   whenPrepared834: source value based on PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - RELEASED DATE/TIME (52-60 > 52.2-8)

see original fill note

   destination
      display1713: source value based on PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - MAIL/WINDOW (52-60 > 52.2-.02), 837: source value based on PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - MAIL/WINDOW (52-60 > 52.2-.02),
   note
      text1717: source value based on PRESCRIPTION - PARTIAL DATE > PARTIAL DATE - REMARKS (52-60 > 52.2-.03)
   dosageInstruction
      text1568: source value based on PRESCRIPTION - SIG (52-10)
      patientInstruction1569: source value based on PRESCRIPTION - PATIENT INSTRUCTIONS (52-114)
      doseAndRate
         dose[x]
         dose[x] (doseQuantity)
            value1570: source value based on PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - DOSAGE ORDERED (52-113 > 52.0113-.01) if number
            unit1571: source value based on PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - UNITS (52-113 > 52.0113-2)
            code1576: terminologyMaps using VF_DoseUnits on PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - UNITS (52-113 > 52.0113-2)

Mappings for Clinical Data Warehouse (CDW) ()

MedicationDispensePartial
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) ()

MedicationDispensePartial
MedicationDispense
   statusMedication.Fills
   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
   performer
      actorMedication.Fills
   locationMedication.Fills
   authorizingPrescriptionMedication.ExternalId,Medication.PlacerId
   quantity
      valueMedication.Fills
   daysSupplyMedication.Fills
   whenPreparedMedication.Fills
   destination
      displayMedication.Fills
   note
      textMedication.Fills
   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)

MedicationDispensePartial
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)

MedicationDispensePartial
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)

MedicationDispensePartial
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)

MedicationDispensePartial
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)

MedicationDispensePartial
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