RIVO-Noord Zorgviewer Implementation Guide
1.7.0 - CI build Netherlands flag

RIVO-Noord Zorgviewer Implementation Guide, published by RIVO-NN HL7NL. This guide is not an authorized publication; it is the continuous build for version 1.7.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/RIVO-Noord/zorgviewer-ig/ and changes regularly. See the Directory of published versions

Resource Profile: MedicationUse - Mappings

Active as of 2024-11-04

Mappings for the MedicationStatement resource profile.

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

MedicationUse
MedicationStatementNL-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
   statusNL-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
   dateAssertedNL-CM:9.11.22398

MedicationUseDateTime
   takenNL-CM:9.11.22399

UseIndicator
   reasonCode
      textNL-CM:9.11.22491

ReasonForUse
   noteNL-CM:9.11.21624

Comment
   dosageNL-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)
      startNL-CM:20.3.2

startDateTime
      endNL-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
   dosageNL-CM:9.12.22504

InstructionsForUse
      sequenceNL-CM:9.12.22503

SequenceNumber
      textNL-CM:9.12.9581

Description
      additionalInstructionNL-CM:9.12.19944

AdditionalInstructions
      timingNL-CM:9.12.19948

AdministeringSchedule
      asNeeded[x] (asNeededCodeableConcept)NL-CM:9.12.22512, NL-CM:9.12.19945

AsNeeded

,

Condition
      routeNL-CM:9.12.19941

RouteOfAdministration
      dose[x]NL-CM:9.12.19940

Dose
      maxDosePerPeriodNL-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
   identifierNL-CM:0.0.6

IdentificationNumber
   effective[x] (effectivePeriod)NL-CM:0.0.14

DateTime
   informationSourceNL-CM:0.0.2

InformationSource
   subjectNL-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
MedicationStatementEntity. Role, or Act, SubstanceAdministration
   textAct.text?
   containedN/A
   extension
   extension (asAgreedIndicator)n/a, N/A
      idn/a
      extensionn/a
      urlN/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
      idn/a
      extensionn/a
      urlN/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
      idn/a
      extensionn/a
      codingunion(., ./translation)
      coding (medicationUseCode)union(., ./translation)
         idn/a
         extensionn/a
         system./codeSystem
         version./codeSystemVersion
         code./code
         displayCV.displayName
         userSelectedCD.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]
      idn/a
      extensionn/a
      referenceN/A
      identifier.identifier
      displayN/A
   effective[x].effectiveTime
   effective[x] (effectivePeriod).effectiveTime
      idn/a
      extension
      extension (Duration)n/a, N/A
         idn/a
         extensionn/a
         urlN/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)
      idn/a
      extension (practitionerRole)n/a, N/A
      referenceN/A
      identifier.identifier
      displayN/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
      idn/a
      extensionn/a
      codingunion(., ./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
   dosagen/a, .outboundRelationship[typeCode=COMP].target[classCode=SBADM, moodCode=INT]
      idn/a
      extensionn/a
      sequence.text
      text.text
      additionalInstruction.text
      patientInstruction.text
      timingn/a, QSET<TS> (GTS)
      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
         idn/a
         extensionn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
      method.doseQuantity
      dose[x].doseQuantity
      dose[x] (doseQuantity)n/a, PQ, IVL<PQ>, MO, CO, depending on the values
      dose[x] (doseRange).doseQuantity
         idn/a
         extensionn/a
         low./low
         high./high
      maxDosePerPeriod.maxDoseQuantity
         idn/a
         extensionn/a
         numerator.numerator
         denominator.denominator
      maxDosePerAdministrationnot supported
      maxDosePerLifetimenot supported
      rate[x].rateQuantity

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

MedicationUse
MedicationStatementclinical.medication
   identifierid
   statusstatus
   categoryclass
   medication[x]what
   medication[x] (medicationReference)what
   effective[x]when.done
   effective[x] (effectivePeriod)when.done
   dateAssertedwhen.recorded
   informationSourcewho.source
   subjectwho
   reasonCodewhy
   reasonReferencewhy

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

MedicationUse
MedicationStatement
   category
      codingC*E.1-8, C*E.10-22
      coding (medicationUseCode)C*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
   effective[x]
   effective[x] (effectivePeriod)
      startDR.1
      endDR.2
   subjectPID-3-Patient ID List
   reasonCode
      codingC*E.1-8, C*E.10-22
      textC*E.9. But note many systems use C*E.2 for this
   dosage
      timingN/A
      route
         codingC*E.1-8, C*E.10-22
         textC*E.9. But note many systems use C*E.2 for this
      dose[x]
      dose[x] (doseQuantity)SN (see also Range) or CQ
      dose[x] (doseRange)
         lowNR.1
         highNR.2