RIVO-Noord Zorgviewer Implementation Guide
1.10.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.10.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: MedicationAgreement - Mappings

Active as of 2024-12-18

Mappings for the MedicationRequest resource profile.

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

MedicationAgreement
MedicationRequestNL-CM:9.6.9580

MedicationAgreement

   extension (periodOfUse)NL-CM:9.6.19936

PeriodOfUse

   extension (usageDuration)NL-CM:9.6.19936

PeriodOfUse

   extension (additionalInformation)NL-CM:9.6.23283

MedicationAgreementAdditionalInformation

   modifierExtension (stopType)NL-CM:9.6.19954

MedicationAgreementStopType

   medication[x] (medicationReference)NL-CM:9.6.19925

AgreedMedicine

   authoredOnNL-CM:9.6.19757

MedicationAgreementDateTime

   requesterNL-CM:9.6.1030

Prescriber

   reasonCodeNL-CM:9.6.22094

RedenMedicatieafspraak

   reasonReferenceNL-CM:9.6.23133

PrescriptionReason. Mapping for zib-Problem

   noteNL-CM:9.6.22273

Comment

   dosageInstructionNL-CM:9.6.23240

InstructionsForUse

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

MedicationAgreement
MedicationRequest
   modifierExtension (repeatPeriodCyclicalSchedule)NL-CM:9.12.22505

RepeatPeriodCyclicalSchedule

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

MedicationAgreement
MedicationRequest
   identifierNL-CM:0.0.6

IdentificationNumber

   subjectNL-CM:0.0.11

Subject

   requesterNL-CM:0.0.7

Author

   dosageInstructionNL-CM:0.0.14

DateTime

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.

MedicationAgreement
MedicationRequest
   extension (medicationTreatment)mp-dataelement900-22092

Medicamenteuze behandeling

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

MedicationAgreement
MedicationRequest..Request
   identifier…identifer
   definition…definition
   basedOn…basedOn
   groupIdentifier…groupIdentifier
   status…status
   intent…intent
   priority…priority
   medication[x]…code
   medication[x] (medicationReference)…code
   subject…subject
   context…context
   authoredOn…authoredOn
   requester…requester
      agent….agent
      onBehalfOf….onBehalfOf
   reasonCode…reasonCode
   reasonReference…reasonReference
   note…note
   priorPrescription…replaces
   eventHistory…relevantHistory

Mappings for Mapping to NCPDP SCRIPT 10.6 (http://ncpdp.org/SCRIPT10_6)

MedicationAgreement
MedicationRequestMessage/Body/NewRx
   identifierMessage/Header/PrescriberOrderNumber
   statusno mapping
   categoryMessage/Body/NewRx/MedicationPrescribed/Directions or Message/Body/NewRx/MedicationPrescribed/StructuredSIG
   medication[x]Message/Body/NewRx/MedicationPrescribed Medication.code.coding.code = Message/Body/NewRx/MedicationPrescribed/DrugCoded/ProductCode Medication.code.coding.system = Message/Body/NewRx/MedicationPrescribed/DrugCoded/ProductCodeQualifier Medication.code.coding.display = Message/Body/NewRx/MedicationPrescribed/DrugDescription
   medication[x] (medicationReference)Message/Body/NewRx/MedicationPrescribed Medication.code.coding.code = Message/Body/NewRx/MedicationPrescribed/DrugCoded/ProductCode Medication.code.coding.system = Message/Body/NewRx/MedicationPrescribed/DrugCoded/ProductCodeQualifier Medication.code.coding.display = Message/Body/NewRx/MedicationPrescribed/DrugDescription
   subjectMessage/Body/NewRx/Patient (need detail to link to specific patient … Patient.Identification in SCRIPT)
   contextno mapping
   authoredOnMessage/Body/NewRx/MedicationPrescribed/WrittenDate
   requester
      agentMessage/Body/NewRx/Prescriber (need detail to link to specific prescriber … Prescriber.Identification in SCRIPT)
   reasonCodeMessage/Body/NewRx/MedicationPrescribed/Diagnosis/Primary/Value
   reasonReferenceno mapping
   noteMessage/Body/NewRx/MedicationPrescribed/Note
   dispenseRequestMessage/Body/NewRx/MedicationPrescribed/ExpirationDate
      validityPeriodMessage/Body/NewRx/MedicationPrescribed/Refills
      numberOfRepeatsAllowedMessage/Body/NewRx/MedicationPrescribed/Quantity
      quantityMessage/Body/NewRx/MedicationPrescribed/DaysSupply
      expectedSupplyDurationMessage/Body/NewRx/MedicationPrescribed/Substitutions
   substitutionspecific values within Message/Body/NewRx/MedicationPrescribed/Substitutions
      allowedspecific values within Message/Body/NewRx/MedicationPrescribed/Substitutions
      reasonnot mapped
   priorPrescriptionnot mapped

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

MedicationAgreement
MedicationRequestEntity. Role, or Act, CombinedMedicationRequest
   textAct.text?
   containedN/A
   extension
   extension (periodOfUse)
   extension (usageDuration)n/a, N/A
   extension (additionalInformation)n/a, N/A
      idn/a
      extensionn/a
      urlN/A
      value[x]N/A
      value[x] (valueCodeableConcept)N/A
   extension (medicationTreatment)n/a, N/A
   extension (nl-core-episodeofcare)n/a, N/A
   modifierExtension
   modifierExtension (stopType)
      idn/a
      extensionn/a
      urlN/A
      value[x]N/A
      value[x] (valueCodeableConcept)N/A
   identifier.id
   definition.outboundRelationship[typeCode=DEFN].target[classCode=unspecified]
   basedOn.outboundRelationship[typeCode=FLFS].target[classCode=SBADM or PROC or PCPR or OBS, moodCode=RQO orPLAN or PRP]
   groupIdentifier.outboundRelationship(typeCode=COMP].target[classCode=SBADM, moodCode=INT].id
   status.statusCode
   intent.moodCode (nuances beyond PRP/PLAN/RQO would need to be elsewhere)
   category.inboundRelationship[typeCode=COMP].source[classCode=OBS, moodCode=EVN, code="type of medication usage"].value
      idn/a
      extensionn/a
      codingunion(., ./translation)
      coding (medicationAgreementCode)union(., ./translation)
         idn/a
         extensionn/a
         system./codeSystem
         version./codeSystemVersion
         code./code
         displayCV.displayName
         userSelectedCD.codingRationale
      text./originalText[mediaType/code="text/plain"]/data
   priority.priorityCode
   medication[x]consumable.administrableMedication
   medication[x] (medicationReference)consumable.administrableMedication
      idn/a
      extensionn/a
      referenceN/A
      identifier.identifier
      displayN/A
   subject.participation[typeCode=AUT].role
   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)]
   authoredOnauthor.time
   requester.participation[typeCode=AUT].role
      idn/a
      extensionn/a
      modifierExtensionN/A
      agent.player
         idn/a
         extension (practitionerRole)n/a, N/A
         referenceN/A
         identifier.identifier
         displayN/A
      onBehalfOf.scoper
   recorder.participation[typeCode=TRANS].role[classCode=ASSIGNED].code (HealthcareProviderType)
      idn/a
      extension (practitionerRole)n/a, N/A
      referenceN/A
      identifier.identifier
      displayN/A
   reasonCodereason.observation.reasonCode
   reasonReferencereason.observation[code=ASSERTION].value
   note.inboundRelationship[typeCode=SUBJ]/source[classCode=OBS,moodCode=EVN,code="annotation"].value
   dosageInstructionn/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
   dispenseRequestcomponent.supplyEvent
      idn/a
      extensionn/a
      modifierExtensionN/A
      validityPeriodeffectiveTime
      numberOfRepeatsAllowedrepeatNumber
      quantityquantity
      expectedSupplyDurationexpectedUseTime
      performer.outboundRelationship[typeCode=COMP].target[classCode=SPLY, moodCode=RQO] .participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]
   substitutionsubjectOf.substitutionPersmission
      idn/a
      extensionn/a
      modifierExtensionN/A
      allowedcode
      reasonreasonCode
   priorPrescription.outboundRelationship[typeCode=?RPLC or ?SUCC]/target[classCode=SBADM,moodCode=RQO]
   detectedIssue.inboundRelationship[typeCode=SUBJ]/source[classCode=ALRT,moodCode=EVN].value
   eventHistory.inboundRelationship(typeCode=SUBJ].source[classCode=CACT, moodCode=EVN]

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

MedicationAgreement
MedicationRequestclinical.medication
   identifierid
   statusstatus
   intentclass
   categoryclass
   prioritygrade
   medication[x]what
   medication[x] (medicationReference)what
   subjectwho.focus
   contextcontext
   supportingInformationcontext
   authoredOnwhen.recorded
   requesterwho.author
   recorderwho
   reasonCodewhy
   reasonReferencewhy
   dispenseRequest
      performerwho

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

MedicationAgreement
MedicationRequest
   identifierORC-2-Placer Order Number / ORC-3-Filler Order Number
   category
      codingC*E.1-8, C*E.10-22
      coding (medicationAgreementCode)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
   medication[x]RXE-2-Give Code / RXO-1-Requested Give Code / RXC-2-Component Code
   medication[x] (medicationReference)RXE-2-Give Code / RXO-1-Requested Give Code / RXC-2-Component Code
   subjectPID-3-Patient ID List
   contextPV1-19-Visit Number
   authoredOnRXE-32-Original Order Date/Time / ORC-9-Date/Time of Transaction
   requester
      agentRXE-13-Ordering Provider's DEA Number / RXO-14-Ordering Provider's DEA Number / RXE-14-Pharmacist/Treatment Supplier's Verifier ID / RXO-15-Pharmacist/Treatment Supplier's Verifier ID / ORC-12-Ordering Provider / PRT-5-Participation Person: PRT-4-Participation='OP' (all but last deprecated)
   reasonCodeORC-16-Order Control Code Reason /RXE-27-Give Indication/RXO-20-Indication / RXD-21-Indication / RXG-22-Indication / RXA-19-Indication
   dosageInstruction
      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
   dispenseRequest
      numberOfRepeatsAllowedRXE-12-Number of Refills
      quantityRXD-4-Actual Dispense Amount / RXD-5.1-Actual Dispense Units.code / RXD-5.3-Actual Dispense Units.name of coding system
   substitution
      allowedRXO-9-Allow Substitutions / RXE-9-Substitution Status
      reasonRXE-9 Substition status