This page is part of the RIVO-Noord Zorgviewer Implementation Guide (v1.11.0: Release) based on FHIR (HL7® FHIR® Standard) R3. This is the current published version. For a full list of available versions, see the Directory of published versions

• Content
• Detailed Descriptions
• Mappings
• XML
• JSON

Resource Profile: MedicationUse - Mappings

Active as of 2025-01-20

Mappings for the MedicationStatement resource profile.

Mappings for HCIM MedicationUse2-v1.0.1(2017EN) (https://zibs.nl/wiki/MedicationUse2-v1.0.1(2017EN))

MedicationUse
MedicationStatement	NL-CM:9.11.21338	MedicationUse
extension
extension (asAgreedIndicator)	NL-CM:9.11.22492	AsAgreedIndicator
extension (prescriber)	NL-CM:9.11.23290	Prescriber
extension (author)
extension (medicationTreatment)
extension (reasonForChangeOrDiscontinuationOfUse)
value[x] (valueCodeableConcept)	NL-CM:9.11.22493	Reden wijzigen of stoppen gebruik
status	NL-CM:9.11.23132	MedicationUseStopType. A ConceptMap (http://nictiz.nl/fhir/ConceptMap/MedicationUseStopTypeCodeLijst-to-MedicationStatementStatus) is available that maps MedicationUseStopTypeCodeLijst to the MedicationStatementStatus value set.
medication[x] (medicationReference)	NL-CM:9.11.21339	ProductUsed
effective[x] (effectivePeriod)	NL-CM:9.11.22663	PeriodOfUse
dateAsserted	NL-CM:9.11.22398	MedicationUseDateTime
taken	NL-CM:9.11.22399	UseIndicator
reasonCode
text	NL-CM:9.11.22491	ReasonForUse
note	NL-CM:9.11.21624	Comment
dosage	NL-CM:9.11.22504	InstructionsForUse

Mappings for HCIM TimeInterval-v1.0(2017EN) (https://zibs.nl/wiki/TimeInterval-v1.0(2017EN))

MedicationUse
MedicationStatement
effective[x]
effective[x] (effectivePeriod)
start	NL-CM:20.3.2	startDateTime
end	NL-CM:20.3.3	endDateTime

Mappings for HCIM InstructionsForUse-v1.1(2017EN) (https://zibs.nl/wiki/InstructionsForUse-v1.1(2017EN))

MedicationUse
MedicationStatement
modifierExtension (repeatPeriodCyclicalSchedule)	NL-CM:9.12.22505	RepeatPeriodCyclicalSchedule
dosage
sequence	NL-CM:9.12.22503	SequenceNumber
text	NL-CM:9.12.9581	Description
additionalInstruction	NL-CM:9.12.19944	AdditionalInstructions
asNeeded[x] (asNeededCodeableConcept)	NL-CM:9.12.22512, NL-CM:9.12.19945	AsNeeded , Condition
route	NL-CM:9.12.19941	RouteOfAdministration
dose[x]	NL-CM:9.12.19940	Dose
maxDosePerPeriod	NL-CM:9.12.19946	MaximumDose
rate[x]	NL-CM:9.12.19942	AdministeringSpeed

Mappings for HCIM BasicElements-v1.0(2017EN) (https://zibs.nl/wiki/BasicElements-v1.0(2017EN))

MedicationUse
MedicationStatement
extension (author)	NL-CM:0.0.7	Author
identifier	NL-CM:0.0.6	IdentificationNumber
effective[x] (effectivePeriod)	NL-CM:0.0.14	DateTime
informationSource	NL-CM:0.0.2	InformationSource
subject	NL-CM:0.0.11	Subject

Mappings for Medication Process v09 (https://decor.nictiz.nl/medicatieproces/mp-html-20181220T121121/ds-2.16.840.1.113883.2.4.3.11.60.20.77.1.3-2016-06-01T000000.html)

Language of Medication Process is Dutch.

MedicationUse
MedicationStatement
extension (medicationTreatment)	mp-dataelement900-22092	Medicamenteuze behandeling

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

MedicationUse
MedicationStatement	..Event
identifier	…identifer
basedOn	…basedOn
partOf	…part of
context	…context
status	…status
medication[x]	…code
medication[x] (medicationReference)	…code
effective[x]	…occurrence[x]
effective[x] (effectivePeriod)	…occurrence[x]
subject	…subject
taken	…notDone
reasonCode	…reasoneCodeableConcept
reasonReference	…reasonReference
note	…note

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

MedicationUse
MedicationStatement	Entity. Role, or Act, SubstanceAdministration
text	Act.text?
contained	N/A
extension
extension (asAgreedIndicator)	n/a, N/A
id	n/a
extension	n/a
url	N/A
value[x]	N/A
value[x] (valueBoolean)	N/A
extension (prescriber)
extension (author)	n/a, N/A
extension (medicationTreatment)	n/a, N/A
extension (reasonForChangeOrDiscontinuationOfUse)	n/a, N/A
id	n/a
extension	n/a
url	N/A
value[x]	N/A
value[x] (valueCodeableConcept)	N/A
identifier	.id
basedOn	.outboundRelationship[typeCode=FLFS].target[classCode=SBADM or PROC or PCPR or OBS, moodCode=RQO orPLAN or PRP]
partOf	.outboundRelationship[typeCode=COMP]/target[classCode=SPLY or SBADM or PROC or OBS,moodCode=EVN]
context	.inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN, code="type of encounter or episode"]
status	.statusCode
category	.inboundRelationship[typeCode=COMP].source[classCode=OBS, moodCode=EVN, code="type of medication usage"].value
id	n/a
extension	n/a
coding	union(., ./translation)
coding (medicationUseCode)	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
medication[x]	.participation[typeCode=CSM].role[classCode=ADMM or MANU]
medication[x] (medicationReference)	.participation[typeCode=CSM].role[classCode=ADMM or MANU]
id	n/a
extension	n/a
reference	N/A
identifier	.identifier
display	N/A
effective[x]	.effectiveTime
effective[x] (effectivePeriod)	.effectiveTime
id	n/a
extension
extension (Duration)	n/a, N/A
id	n/a
extension	n/a
url	N/A
value[x]	N/A
value[x] (valueDuration)	N/A
start	./low
end	./high
dateAsserted	.participation[typeCode=AUT].time
informationSource	.participation[typeCode=INF].role[classCode=PAT, or codes for Practioner or Related Person (if PAT is the informer, then syntax for self-reported =true)
id	n/a
extension (practitionerRole)	n/a, N/A
reference	N/A
identifier	.identifier
display	N/A
subject	.participation[typeCode=SBJ].role[classCode=PAT]
derivedFrom	.outboundRelationship[typeCode=SPRT]/target[classCode=ACT,moodCode=EVN]
taken	.actionNegationInd
reasonNotTaken	.outboundRelationship[typeCode=RSON]/target[classCode=OBS,moodCode=EVN, code="reason not taken"].value
reasonCode	.reasonCode
id	n/a
extension	n/a
coding	union(., ./translation)
text	./originalText[mediaType/code="text/plain"]/data
reasonReference	.outboundRelationship[typeCode=RSON]/target[classCode=OBS,moodCode=EVN, code="reason for use"].value
note	.inboundRelationship[typeCode=SUBJ]/source[classCode=OBS,moodCode=EVN,code="annotation"].value
dosage	refer dosageInstruction mapping
id	n/a
extension	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
asNeeded[x] (asNeededCodeableConcept)	.outboundRelationship[typeCode=PRCN].target[classCode=OBS, moodCode=EVN, code="as needed"].value=boolean or codable concept
site	.approachSiteCode
route	.routeCode
id	n/a
extension	n/a
coding	union(., ./translation)
text	./originalText[mediaType/code="text/plain"]/data
method	.doseQuantity
dose[x]	.doseQuantity
dose[x] (doseQuantity)	.doseQuantity
dose[x] (doseRange)	.doseQuantity
id	n/a
extension	n/a
low	./low
high	./high
maxDosePerPeriod	.maxDoseQuantity
id	n/a
extension	n/a
numerator	.numerator
denominator	.denominator
maxDosePerAdministration	not supported
maxDosePerLifetime	not supported
rate[x]	.rateQuantity

Mappings for W5 Mapping (http://hl7.org/fhir/w5)

MedicationUse
MedicationStatement	clinical.medication
identifier	id
status	status
category	class
medication[x]	what
medication[x] (medicationReference)	what
effective[x]	when.done
effective[x] (effectivePeriod)	when.done
dateAsserted	when.recorded
informationSource	who.source
subject	who
reasonCode	why
reasonReference	why

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

MedicationUse
MedicationStatement
category
coding	C*E.1-8, C*E.10-22
coding (medicationUseCode)	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
effective[x]
effective[x] (effectivePeriod)
start	DR.1
end	DR.2
subject	PID-3-Patient ID List
reasonCode
coding	C*E.1-8, C*E.10-22
text	C*E.9. But note many systems use C*E.2 for this
dosage
route
coding	C*E.1-8, C*E.10-22
text	C*E.9. But note many systems use C*E.2 for this
dose[x]
dose[x] (doseQuantity)
dose[x] (doseRange)
low	NR.1
high	NR.2