OpenMRS Core FHIR Implementation Guide
0.1.0 - ci-build

OpenMRS Core FHIR Implementation Guide, published by . This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/openmrs/openmrs-contrib-fhir2-ig/ and changes regularly. See the Directory of published versions

Resource Profile: OMRSMedicationRequest - Mappings

Active as of 2024-12-11

Mappings for the omrs-medication-request resource profile.

Mappings for FHIR vs OMRS FHIR2 (MedicationRequest)

MedicationRequest mapping shows how attributes of the FHIR MedicationRequest Resource map to the attributes of the OpenMRS Drug Order object

OMRSMedicationRequest
MedicationRequestOMRS MedicationRequest

This profile maps HL7 FHIR MedicationRequest to OMRS FHIR2

   idOrder.id
   intentMedicationRequestIntent.ORDER
   priorityOrder.Urgency
   subjectOrder.Patient
   encounterOrder.Encounter
   requesterOrder.Provider
   reasonCodeOrder.OrderReason
   basedOnOrder.PreviousOrder
   noteOrder.commentToFulfiller
   dispenseRequest
      numberOfRepeatsAllowednumRefills
      quantityquantity
   priorPrescriptionOrder.PreviousOrder

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

OMRSMedicationRequest
MedicationRequestRequest
   identifierRequest.identifier
   statusRequest.status
   statusReasonRequest.statusReason
   intentRequest.intent
   priorityRequest.priority
   medication[x]Request.code
   medication[x] (medicationCodeableConcept)Request.code
   subjectRequest.subject
   encounterRequest.context
   supportingInformationRequest.supportingInfo
   authoredOnRequest.authoredOn
   requesterRequest.requester
   performerRequest.performer
   performerTypeRequest.performerType
   reasonCodeRequest.reasonCode
   reasonReferenceRequest.reasonReference
   instantiatesCanonicalRequest.instantiates
   basedOnRequest.basedOn
   groupIdentifierRequest.groupIdentifier
   insuranceRequest.insurance
   noteRequest.note
   dosageInstructionRequest.occurrence[x]
   priorPrescriptionRequest.replaces
   eventHistoryRequest.relevantHistory

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

OMRSMedicationRequest
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] (medicationCodeableConcept)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)
   encounterno mapping
   authoredOnMessage/Body/NewRx/MedicationPrescribed/WrittenDate
   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
      allowed[x]specific values within Message/Body/NewRx/MedicationPrescribed/Substitutions
      reasonnot mapped
   priorPrescriptionnot mapped

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

OMRSMedicationRequest
MedicationRequestEntity. Role, or Act, CombinedMedicationRequest
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifier.id
   status.statusCode
   statusReason.inboundRelationship[typeCode=SUBJ].source[classCode=CACT, moodCode=EVN].reasonCOde
   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
   priority.priorityCode
   doNotPerformSubstanceAdministration.actionNegationInd
   reported[x].participation[typeCode=INF].role
   medication[x]consumable.administrableMedication
   medication[x] (medicationCodeableConcept)consumable.administrableMedication
   subject.participation[typeCode=AUT].role
   encounter.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
   performer.participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]
   performerType.participation[typeCode=PRF].role[scoper.determinerCode=KIND].code
   recorder.participation[typeCode=TRANS].role[classCode=ASSIGNED].code (HealthcareProviderType)
   reasonCodereason.observation.reasonCode
   reasonReferencereason.observation[code=ASSERTION].value
   instantiatesCanonical.outboundRelationship[typeCode=DEFN].target
   instantiatesUri.outboundRelationship[typeCode=DEFN].target
   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
   courseOfTherapyTypeAct.code where classCode = LIST and moodCode = EVN
   insurance.outboundRelationship[typeCode=COVBY].target
   note.inboundRelationship[typeCode=SUBJ]/source[classCode=OBS,moodCode=EVN,code="annotation"].value
   dosageInstructionsee dosageInstruction mapping
   dispenseRequestcomponent.supplyEvent
      idn/a
      extensionn/a
      modifierExtensionN/A
      initialFillSubstanceAdministration -> ActRelationship[sequenceNumber = '1'] -> Supply
         idn/a
         extensionn/a
         modifierExtensionN/A
         quantitySupply.quantity[moodCode=RQO]
         durationSupply.effectivetime[moodCode=RQO]
      dispenseIntervalSupply.effectivetime[moodCode=RQO]
      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
      allowed[x]code
      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 FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

OMRSMedicationRequest
MedicationRequest
   identifierFiveWs.identifier
   statusFiveWs.status
   intentFiveWs.class
   categoryFiveWs.class
   priorityFiveWs.grade
   medication[x]FiveWs.what[x]
   medication[x] (medicationCodeableConcept)FiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context
   supportingInformationFiveWs.context
   authoredOnFiveWs.recorded
   requesterFiveWs.author
   performerFiveWs.actor
   recorderFiveWs.who
   reasonCodeFiveWs.why[x]
   reasonReferenceFiveWs.why[x]
   dispenseRequest
      performerFiveWs.who

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

OMRSMedicationRequest
MedicationRequest
   identifierORC-2-Placer Order Number / ORC-3-Filler Order Number
   medication[x]RXE-2-Give Code / RXO-1-Requested Give Code / RXC-2-Component Code
   medication[x] (medicationCodeableConcept)RXE-2-Give Code / RXO-1-Requested Give Code / RXC-2-Component Code
   subjectPID-3-Patient ID List
   encounterPV1-19-Visit Number
   authoredOnRXE-32-Original Order Date/Time / ORC-9-Date/Time of Transaction
   reasonCodeORC-16-Order Control Code Reason /RXE-27-Give Indication/RXO-20-Indication / RXD-21-Indication / RXG-22-Indication / RXA-19-Indication
   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
      allowed[x]RXO-9-Allow Substitutions / RXE-9-Substitution Status
      reasonRXE-9 Substition status