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

• Content
• Detailed Descriptions
• Mappings
• JSON
• History

Resource Profile: MedicationDispenseRefill - Mappings

Active as of 2025-03-31

Mappings for the MedicationDispenseRefill resource profile.

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

MedicationDispenseRefill
MedicationDispense
status	869: fixed value = #completed when PRESCRIPTION - REFILL > REFILL - RELEASED DATE/TIME (52-52 > 52.1-17) if not null, 819: fixed value = #in-progress when PRESCRIPTION - REFILL > REFILL - RELEASED DATE/TIME (52-52 > 52.1-17) if null, 1555: fixed value = #in-progress when PRESCRIPTION - RELEASED DATE/TIME (52-31) if null	updated table id (was a dup) , ,
category	2215: fixed value = http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-category#outpatient
medication[x]
medication[x] (medicationCodeableConcept)
coding
system	1561-1: fixed value = urn:oid:2.16.840.1.113883.6.233	generated from mapParameter line 1
code	1561: source value based on PRESCRIPTION - DRUG > DRUG - PSNDF VA PRODUCT NAME ENTRY (52-6 > 50-22)
text	1560: source value based on PRESCRIPTION - DRUG > DRUG - GENERIC NAME (52-6 > 50-.01)	This may not be necessary; we have the product.
subject	1551: reference based on PRESCRIPTION - PATIENT (52-2)
performer
actor	1728: reference based on PRESCRIPTION - REFILL > REFILL - PHARMACIST NAME (52-52 > 52.1-4)
location	1715: reference based on PRESCRIPTION - REFILL > REFILL - DIVISION > OUTPATIENT SITE - DEFAULT ERX CLINIC (52-52 > 52.1-8 > 59-10)	not Clinic (written) but Division (filled)
authorizingPrescription	1553: reference based on PRESCRIPTION - PLACER ORDER # (52-39.3)
type	1709: fixed value = http://terminology.hl7.org/CodeSystem/v3-ActCode#RF
quantity
value	824: source value based on PRESCRIPTION - REFILL > REFILL - QTY (52-52 > 52.1-1)
daysSupply	827: source value based on PRESCRIPTION - REFILL > REFILL - DAYS SUPPLY (52-52 > 52.1-1.1)
whenPrepared	833: source value based on PRESCRIPTION - REFILL > REFILL - RELEASED DATE/TIME (52-52 > 52.1-17)	see original fill note
destination
display	1712: source value based on PRESCRIPTION - REFILL > REFILL - MAIL/WINDOW/PARK (52-52 > 52.1-2), 836: source value based on PRESCRIPTION - REFILL > REFILL - MAIL/WINDOW/PARK (52-52 > 52.1-2)	,
note
text	1718: source value based on PRESCRIPTION - REFILL > REFILL - REMARKS (52-52 > 52.1-3)
dosageInstruction
text	1556: source value based on PRESCRIPTION - SIG (52-10)
patientInstruction	1557: source value based on PRESCRIPTION - PATIENT INSTRUCTIONS (52-114)
doseAndRate
dose[x]
dose[x] (doseQuantity)
value	1558: source value based on PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - DOSAGE ORDERED (52-113 > 52.0113-.01) if number
unit	1559: source value based on PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - UNITS (52-113 > 52.0113-2)
code	1579: terminologyMaps using VF_DoseUnits on PRESCRIPTION - MEDICATION INSTRUCTIONS > MEDICATION INSTRUCTIONS - UNITS (52-113 > 52.0113-2)

Mappings for Clinical Data Warehouse (CDW) ()

MedicationDispenseRefill
MedicationDispense
medication[x]
medication[x] (medicationCodeableConcept)
coding
code	RxOut.RxOutpat.LocalDrugIEN,RxOut.RxOutpat.NationalDrugIEN,RxOut.RxOutpatFill.LocalDrugIEN,RxOut.RxOutpatFill.NationalDrugIEN Dim.LocalDrug.DrugNameWithoutDoseIEN,Dim.LocalDrug.NationalDrugIEN,Dim.LocalDrug.NationalDrugIEN
text	RxOut.RxOutpat.LocalDrugIEN,RxOut.RxOutpat.NationalDrugIEN,RxOut.RxOutpatFill.LocalDrugIEN,RxOut.RxOutpatFill.NationalDrugIEN Dim.LocalDrug.LocalDrugNameWithDose,Dim.LocalDrug.LocalDrugNameWithDose,RxOut.RxOutpatFill.LocalDrugNameWithDose
subject	RxOut.ActivityLog.PatientIEN,RxOut.ActivityLogOtherComments.PatientIEN,RxOut.RxOutpat.PatientIEN,RxOut.RxOutpatExt.PatientIEN,RxOut.RxOutpatExt.PatientSID,RxOut.RxOutpatFill.PatientIEN,RxOut.RxOutpatMedInstructions.PatientIEN,RxOut.RxOutpatSig.PatientIEN
authorizingPrescription	RxOut.RxOutpat.CPRSOrderEntryNumber
dosageInstruction
patientInstruction	RxOut.RxOutpatSig.PatientInstructions
doseAndRate
dose[x]
dose[x] (doseQuantity)
value	RxOut.RxOutpatMedInstructions.DoseOrdered
unit	RxOut.RxOutpatMedInstructions.Unit
code	RxOut.RxOutpatMedInstructions.Unit

Mappings for Summary Document Architecure (SDA) ()

MedicationDispenseRefill
MedicationDispense
status	Medication.RefillNumber,Medication.EBilling,Medication.Fills,Medication.LastFilled
medication[x]
medication[x] (medicationCodeableConcept)
coding
code	Medication.DrugProduct,Medication.CMOP Medication.DrugProduct.Identifier2,Medication.DrugProduct.ProductName,Medication.Extension[DrugProductExtension].FederalSchedule
text	Medication.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
actor	Medication.RefillNumber,Medication.EBilling,Medication.Fills,Medication.LastFilled
location	Medication.RefillNumber,Medication.EBilling,Medication.Fills,Medication.LastFilled
authorizingPrescription	Medication.ExternalId,Medication.PlacerId
quantity
value	Medication.RefillNumber,Medication.EBilling,Medication.Fills,Medication.LastFilled
daysSupply	Medication.RefillNumber,Medication.EBilling,Medication.Fills,Medication.LastFilled
whenPrepared	Medication.RefillNumber,Medication.EBilling,Medication.Fills,Medication.LastFilled
destination
display	Medication.RefillNumber,Medication.EBilling,Medication.Fills,Medication.LastFilled
note
text	Medication.RefillNumber,Medication.EBilling,Medication.Fills,Medication.LastFilled
dosageInstruction
patientInstruction	Medication.TextInstruction
doseAndRate
dose[x]
dose[x] (doseQuantity)
value	Medication.DosageSteps,Medication.Route,Medication.DoseQuantity,Medication.DoseUoM,Medication.Duration,Medication.Frequency,Medication.TextInstruction,Medication.Conjunction,Medication.Noun,Medication.UnitsPerDose,Medication.Verb
unit	Medication.DosageSteps,Medication.Route,Medication.DoseQuantity,Medication.DoseUoM,Medication.Duration,Medication.Frequency,Medication.TextInstruction,Medication.Conjunction,Medication.Noun,Medication.UnitsPerDose,Medication.Verb
code	Medication.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)

MedicationDispenseRefill
MedicationDispense	Event
identifier	Event.identifier
partOf	Event.partOf
status	Event.status
statusReason[x]	Event.statusReason
medication[x]	Event.code
medication[x] (medicationCodeableConcept)	Event.code
subject	Event.subject
context	Event.context
performer	Event.performer
actor	Event.performer.actor
authorizingPrescription	Event.basedOn
whenHandedOver	Event.occurrence[x]
note	Event.note

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

MedicationDispenseRefill
MedicationDispense	Entity. Role, or Act, Supply[moodCode=EVN]
text	Act.text?
contained	N/A
extension	N/A
modifierExtension	N/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
id	n/a
extension	n/a
coding	union(., ./translation)
id	n/a
extension	n/a
system	./codeSystem
version	./codeSystemVersion
code	./code
display	CV.displayName
userSelected	CD.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]
id	n/a
extension	n/a
modifierExtension	N/A
function	participation[typeCode=PRF].functionCode
actor	.role
location	.participation[typeCode=LOC].role
authorizingPrescription	.outboundRelationship[typeCode=FLFS].target[moodCode=RQO]
type	.code
quantity	.quantity
id	n/a
extension	n/a
value	PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
unit	PQ.unit
system	CO.codeSystem, PQ.translation.codeSystem
code	PQ.code, MO.currency, PQ.translation.code
daysSupply	effectiveUseTime
whenPrepared	.effectiveTime[xmi:type=IVL_TS].low
whenHandedOver	.effectiveTime[xmi:type=IVL_TS].high
destination	.participation[typeCode=DST].role
id	n/a
extension	n/a
reference	N/A
type	N/A
identifier	.identifier
display	N/A
receiver	.participation[typeCode=RCV].role
note	.inboundRelationship[typeCode=SUBJ]/source[classCode=ACT,moodCode=EVN]
id	n/a
extension	n/a
author[x]	Act.participant[typeCode=AUT].role
time	Act.effectiveTime
text	Act.text
dosageInstruction	.outboundRelationship[typeCode=COMP].target[classCode=SBADM, moodCode=INT]
id	n/a
extension	n/a
modifierExtension	N/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
id	n/a
extension	n/a
dose[x]	.doseQuantity
dose[x] (doseQuantity)	.doseQuantity
id	n/a
extension	n/a
value	PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
unit	PQ.unit
system	CO.codeSystem, PQ.translation.codeSystem
code	PQ.code, MO.currency, PQ.translation.code
rate[x]	.rateQuantity
maxDosePerPeriod	.maxDoseQuantity
maxDosePerAdministration	not supported
maxDosePerLifetime	not supported
substitution	.outboundRelationship[typeCode=COMP].target[classCode=SUBST, moodCode=EVN]
id	n/a
extension	n/a
modifierExtension	N/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)

MedicationDispenseRefill
MedicationDispense
identifier	FiveWs.identifier
status	FiveWs.status
medication[x]	FiveWs.what[x]
medication[x] (medicationCodeableConcept)	FiveWs.what[x]
subject	FiveWs.subject[x], FiveWs.subject
supportingInformation	FiveWs.context

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

MedicationDispenseRefill
MedicationDispense
identifier	CombinedMedicationDispense.id
status	CombinedMedicationDispense.SupplyEvent.statusCode
medication[x]	CombinedMedicationRequest.component1.AdministrationRequest.consumable
medication[x] (medicationCodeableConcept)	CombinedMedicationRequest.component1.AdministrationRequest.consumable
authorizingPrescription	CombinedMedicationDispense.inFulfillmentOf
type	CombinedMedicationDispense.SupplyEvent.code
quantity	CombinedMedicationDispense.SupplyEvent.quantity
whenPrepared	CombinedMedicationDispense.SupplyEvent.effectiveTime
whenHandedOver	CombinedMedicationDispense.SupplyEvent.effectiveTime
destination	CombinedMedicationDispense.SupplyEvent.destination
receiver	CombinedMedicationDispense.SupplyEvent.receiver
substitution	CombinedMedicationDispense.substitutionMade
type	CombinedMedicationDispense.substitutionMade.code
reason	CombinedMedicationDispense.substitutionMade.reasonCode
responsibleParty	CombinedMedicationDispense.substitutionMade.ResponsibleParty

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

MedicationDispenseRefill
MedicationDispense
medication[x]	RXD-2-Dispense/Give Code
medication[x] (medicationCodeableConcept)	RXD-2-Dispense/Give Code
coding	C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
text	C*E.9. But note many systems use C*E.2 for this
subject	PID-3-Patient ID List
authorizingPrescription	ORC-2 Placer Order Number
type	RXD-33-Dispense Type
quantity	RXD-4-Actual Dispense Amount / RXD-5.1-Actual Dispense Units.code / RXD-5.3-Actual Dispense Units.name of coding system
value	SN.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
daysSupply	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	RXD-3-Date/Time Dispensed
whenHandedOver	RXD-3-Date/Time Dispensed
destination	RXD-13 Dispense-to Location; RXD-30 Dispense to Pharmacy; RXD-31 Dispense to Pharmacy Address
note	RXD-9 Dispense Notes
author[x]	N/A
time	N/A
text	N/A
dosageInstruction
sequence	TQ1-1
text	RXO-6; RXE-21
additionalInstruction	RXO-7
patientInstruction	RXO-7
asNeeded[x]	TQ1-9
site	RXR-2
route	RXR-1
method	RXR-4
doseAndRate	TQ1-2
type	RXO-21; RXE-23
dose[x]	RXO-2, RXE-3
dose[x] (doseQuantity)	RXO-2, RXE-3
value	SN.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
maxDosePerPeriod	RXO-23, RXE-19
substitution
type	RXO-9-Allow Substitutions / RXE-9-Substitution Status