US Veterans Health Administration FHIR Map Set Implementation Guide
1.8.0 - 250901 United States of America flag

US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 1.8.0 See the Directory of published versions

Resource Profile: MedicationDispenseRefill - Mappings

Active as of 2025-09-02

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 #2PATIENT6DRUG10SIG52REFILL113MEDICATION INSTRUCTIONS114PATIENT INSTRUCTIONSOUTPATIENT SITE (59)10DEFAULT ERX CLINICREFILL (52.1)1QTY1.1DAYS SUPPLY2MAIL/WINDOW/PARK3REMARKS4PHARMACIST NAME8DIVISION14RETURNED TO STOCK17RELEASED 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
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
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
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
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
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
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
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
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
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
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 #unknown This can be switched to completed if the API can discover the status from the pharmacy, CMOP, or PoS system. 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
2256 for review V2F PRESCRIPTION - REFILL > REFILL - RETURNED TO STOCK (52-52 > 52.1-14) fixed value not null MedicationDispense.status #cancelled 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
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
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

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