US Veterans Health Administration FHIR Map Set Implementation Guide
1.6.0 - 250701 United States of America flag

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

Resource Profile: MedicationDispenseRefill - Mappings

Active as of 2025-06-20

Mappings for the MedicationDispenseRefill resource profile.

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

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

Mapping Sources

Use Case: MedicationDispense: Refill (Source)Use Case: MedicationDispense: Refill (Source)DRUG (50).01GENERIC NAME22PSNDF VA PRODUCT NAME ENTRYPRESCRIPTION (52).01RX #2PATIENT6DRUG10SIG31RELEASED DATE/TIME52REFILL113MEDICATION INSTRUCTIONS114PATIENT INSTRUCTIONSOUTPATIENT SITE (59)10DEFAULT ERX CLINICREFILL (52.1)1QTY1.1DAYS SUPPLY2MAIL/WINDOW/PARK3REMARKS4PHARMACIST NAME8DIVISION17RELEASED 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
1709 for review V2F fixed value MedicationDispense.type http://terminology.hl7.org/CodeSystem/v3-ActCode#RF http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1712 for review V2F PRESCRIPTION - REFILL > REFILL - MAIL/WINDOW/PARK (52-52 > 52.1-2) source value MedicationDispense.destination .display http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1553 for review V2F PRESCRIPTION - RX # (52-.01) reference MedicationDispense.authorizingPrescription /MedicationRequestOutpatient updated from PLACER ORDER # (CPRS id) http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
827 for review V2F PRESCRIPTION - REFILL > REFILL - DAYS SUPPLY (52-52 > 52.1-1.1) source value MedicationDispense.daysSupply http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
836 for review V2F PRESCRIPTION - REFILL > REFILL - MAIL/WINDOW/PARK (52-52 > 52.1-2) source value MedicationDispense.destination .display http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1559 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
1579 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
1558 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
1557 for review V2F PRESCRIPTION - PATIENT INSTRUCTIONS (52-114) source value MedicationDispense.dosageInstruction .patientInstruction http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1556 for review V2F PRESCRIPTION - SIG (52-10) source value MedicationDispense.dosageInstruction .text http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1561 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
1560 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
824 for review V2F PRESCRIPTION - REFILL > REFILL - QTY (52-52 > 52.1-1) source value MedicationDispense.quantity .value http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
869 for review V2F PRESCRIPTION - REFILL > REFILL - RELEASED DATE/TIME (52-52 > 52.1-17) fixed value not null MedicationDispense.status #completed updated table id (was a dup) http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
819 for review V2F PRESCRIPTION - REFILL > REFILL - RELEASED DATE/TIME (52-52 > 52.1-17) fixed value null MedicationDispense.status #in-progress http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1555 for review V2F PRESCRIPTION - RELEASED DATE/TIME (52-31) fixed value null MedicationDispense.status #in-progress http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1551 for review V2F PRESCRIPTION - PATIENT (52-2) reference MedicationDispense.subject /Patient http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
833 for review V2F PRESCRIPTION - REFILL > REFILL - RELEASED DATE/TIME (52-52 > 52.1-17) source value MedicationDispense.whenPrepared see original fill note http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1715 for review V2F PRESCRIPTION - REFILL > REFILL - DIVISION > OUTPATIENT SITE - DEFAULT ERX CLINIC (52-52 > 52.1-8 > 59-10) reference MedicationDispense.location /Location not Clinic (written) but Division (filled) http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1718 for review V2F PRESCRIPTION - REFILL > REFILL - REMARKS (52-52 > 52.1-3) source value MedicationDispense.note .text http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
1728 for review V2F PRESCRIPTION - REFILL > REFILL - PHARMACIST NAME (52-52 > 52.1-4) reference MedicationDispense.performer.actor /Practitioner http://hl7.org/fhir/StructureDefinition/MedicationDispense | 4.0.1
2215 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 to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameWorkflow PatternRIM MappingFiveWs Pattern MappingV3 Pharmacy Dispense RMIMHL7 v2 Mappingdoco
.. MedicationDispense
Event
Supply[moodCode=EVN]
... id
... meta
... implicitRules
... language
... text
Act.text?
... contained
N/A
... extension
N/A
... modifierExtension
N/A
... identifier
Event.identifier
.id
FiveWs.identifier
CombinedMedicationDispense.id
... partOf
Event.partOf
  • .outboundRelationship[typeCode=COMP]/target[classCode=PROC
  • moodCode=EVN]
... status
Event.status
.statusCode
FiveWs.status
CombinedMedicationDispense.SupplyEvent.statusCode
... statusReason[x]
Event.statusReason
  • .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
... Slices for medication[x]
Event.code
.participation[typeCode=PRD].role
FiveWs.what[x]
CombinedMedicationRequest.component1.AdministrationRequest.consumable
RXD-2-Dispense/Give Code
.... medication[x]:medicationCodeableConcept
Event.code
.participation[typeCode=PRD].role
FiveWs.what[x]
CombinedMedicationRequest.component1.AdministrationRequest.consumable
RXD-2-Dispense/Give Code
..... id
n/a
..... extension
n/a
..... coding
  • union(.
  • ./translation)
  • C*E.1-8
  • C*E.10-22
...... id
n/a
...... extension
n/a
...... system
./codeSystem
C*E.3
...... version
./codeSystemVersion
C*E.7
...... code
./code
C*E.1
...... display
CV.displayName
C*E.2 - but note this is not well followed
...... userSelected
CD.codingRationale
Sometimes implied by being first
..... text
./originalText[mediaType/code="text/plain"]/data
C*E.9. But note many systems use C*E.2 for this
... subject
Event.subject
.participation[typeCode=SBJ].role[classCode=PAT]
FiveWs.subject
PID-3-Patient ID List
... context
Event.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)]
FiveWs.context
... performer
Event.performer
.participation[typeCode=PRF]
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... function
participation[typeCode=PRF].functionCode
.... actor
Event.performer.actor
.role
... location
.participation[typeCode=LOC].role
... authorizingPrescription
Event.basedOn
.outboundRelationship[typeCode=FLFS].target[moodCode=RQO]
CombinedMedicationDispense.inFulfillmentOf
ORC-2 Placer Order Number
... type
.code
CombinedMedicationDispense.SupplyEvent.code
RXD-33-Dispense Type
... quantity
.quantity
CombinedMedicationDispense.SupplyEvent.quantity
RXD-4-Actual Dispense Amount / RXD-5.1-Actual Dispense Units.code / RXD-5.3-Actual Dispense Units.name of coding system
.... id
n/a
.... extension
n/a
.... value
  • PQ.value
  • CO.value
  • MO.value
  • IVL.high or IVL.low depending on the value
SN.2 / CQ - N/A
.... comparator
IVL properties
SN.1 / CQ.1
.... unit
PQ.unit
(see OBX.6 etc.) / CQ.2
.... system
  • CO.codeSystem
  • PQ.translation.codeSystem
(see OBX.6 etc.) / CQ.2
.... code
  • PQ.code
  • MO.currency
  • PQ.translation.code
(see OBX.6 etc.) / CQ.2
... daysSupply
effectiveUseTime
  • TQ1.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
... whenPrepared
type=IVL_TS].low
CombinedMedicationDispense.SupplyEvent.effectiveTime
RXD-3-Date/Time Dispensed
... whenHandedOver
Event.occurrence[x]
type=IVL_TS].high
CombinedMedicationDispense.SupplyEvent.effectiveTime
RXD-3-Date/Time Dispensed
... destination
.participation[typeCode=DST].role
CombinedMedicationDispense.SupplyEvent.destination
RXD-13 Dispense-to Location; RXD-30 Dispense to Pharmacy; RXD-31 Dispense to Pharmacy Address
.... id
n/a
.... extension
n/a
.... reference
N/A
.... type
N/A
.... identifier
.identifier
.... display
N/A
... receiver
.participation[typeCode=RCV].role
CombinedMedicationDispense.SupplyEvent.receiver
... note
Event.note
  • .inboundRelationship[typeCode=SUBJ]/source[classCode=ACT
  • moodCode=EVN]
RXD-9 Dispense Notes
.... id
n/a
.... extension
n/a
.... author[x]
Act.participant[typeCode=AUT].role
N/A
.... time
Act.effectiveTime
N/A
.... text
Act.text
N/A
... dosageInstruction
  • .outboundRelationship[typeCode=COMP].target[classCode=SBADM
  • moodCode=INT]
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... sequence
.text
TQ1-1
.... text
.text
RXO-6; RXE-21
.... additionalInstruction
.text
RXO-7
.... patientInstruction
.text
RXO-7
.... timing
.effectiveTime
.... asNeeded[x]
  • .outboundRelationship[typeCode=PRCN].target[classCode=OBS
  • moodCode=EVN
  • code="as needed"].value=boolean or codable concept
TQ1-9
.... site
.approachSiteCode
RXR-2
.... route
.routeCode
RXR-1
.... method
.doseQuantity
RXR-4
.... doseAndRate
TQ1-2
..... id
n/a
..... extension
n/a
..... type
RXO-21; RXE-23
..... Slices for dose[x]
.doseQuantity
  • RXO-2
  • RXE-3
...... dose[x]:doseQuantity
.doseQuantity
  • RXO-2
  • RXE-3
....... id
n/a
....... extension
n/a
....... value
  • PQ.value
  • CO.value
  • MO.value
  • IVL.high or IVL.low depending on the value
SN.2 / CQ - N/A
....... comparator
IVL properties
SN.1 / CQ.1
....... unit
PQ.unit
(see OBX.6 etc.) / CQ.2
....... system
  • CO.codeSystem
  • PQ.translation.codeSystem
(see OBX.6 etc.) / CQ.2
....... code
  • PQ.code
  • MO.currency
  • PQ.translation.code
(see OBX.6 etc.) / CQ.2
..... rate[x]
.rateQuantity
  • RXE22
  • RXE23
  • RXE-24
.... maxDosePerPeriod
.maxDoseQuantity
  • RXO-23
  • RXE-19
.... maxDosePerAdministration
not supported
.... maxDosePerLifetime
not supported
... substitution
  • .outboundRelationship[typeCode=COMP].target[classCode=SUBST
  • moodCode=EVN]
CombinedMedicationDispense.substitutionMade
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... wasSubstituted
.actionNegationInd
.... type
.code
CombinedMedicationDispense.substitutionMade.code
RXO-9-Allow Substitutions / RXE-9-Substitution Status
.... reason
.reasonCode
CombinedMedicationDispense.substitutionMade.reasonCode
.... responsibleParty
.participation[typeCode=PFM].role[classCode=ASSIGN]
CombinedMedicationDispense.substitutionMade.ResponsibleParty
... detectedIssue
  • .inboundRelationship[typeCode=SUBJ]/source[classCode=ALRT
  • moodCode=EVN].value
... eventHistory
  • .inboundRelationship(typeCode=SUBJ].source[classCode=CACT
  • moodCode=EVN]

doco Documentation for this format