Ethiopia FHIR Implementation Guide - HIV Treatment & Care Services
1.0.0 - ci-build Ethiopia flag

Ethiopia FHIR Implementation Guide - HIV Treatment & Care Services, published by Jembi Health Systems. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/jembi/ethiopia-hiv/ and changes regularly. See the Directory of published versions

Resource Profile: ARVDrugDispensation - Mappings

Draft as of 2024-09-19

Mappings for the arv-medication-dispense resource profile.

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

ARVDrugDispensation
MedicationDispenseEvent
   identifierEvent.identifier
   partOfEvent.partOf
   statusEvent.status
   statusReason[x]Event.statusReason
   medication[x]Event.code
   medication[x] (medicationReference)Event.code
   medication[x] (medicationCodeableConcept)Event.code
   subjectEvent.subject
   contextEvent.context
   performerEvent.performer
      actorEvent.performer.actor
   authorizingPrescriptionEvent.basedOn
   whenHandedOverEvent.occurrence[x]
   noteEvent.note

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

ARVDrugDispensation
MedicationDispenseEntity. Role, or Act, Supply[moodCode=EVN]
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/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] (medicationReference).participation[typeCode=PRD].role
   medication[x] (medicationCodeableConcept).participation[typeCode=PRD].role
      idn/a
      extensionn/a
      codingn/a, CV
      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]
      idn/a
      extensionn/a
      modifierExtensionN/A
      functionparticipation[typeCode=PRF].functionCode
      actor.role
   location.participation[typeCode=LOC].role
   authorizingPrescription.outboundRelationship[typeCode=FLFS].target[moodCode=RQO]
   type.code
   quantity.quantity
      idn/a
      extensionn/a
      valuePQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
      unitPQ.unit
      systemCO.codeSystem, PQ.translation.codeSystem
      codePQ.code, MO.currency, PQ.translation.code
   daysSupplyeffectiveUseTime
      idn/a
      extensionn/a
      valuePQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
      unitPQ.unit
      systemCO.codeSystem, PQ.translation.codeSystem
      codePQ.code, MO.currency, PQ.translation.code
   whenPrepared.effectiveTime[xmi:type=IVL_TS].low
   whenHandedOver.effectiveTime[xmi:type=IVL_TS].high
   destination.participation[typeCode=DST].role
   receiver.participation[typeCode=RCV].role
   note.inboundRelationship[typeCode=SUBJ]/source[classCode=ACT,moodCode=EVN]
   dosageInstruction.outboundRelationship[typeCode=COMP].target[classCode=SBADM, moodCode=INT]
   substitution.outboundRelationship[typeCode=COMP].target[classCode=SUBST, moodCode=EVN]
      idn/a
      extensionn/a
      modifierExtensionN/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)

ARVDrugDispensation
MedicationDispense
   identifierFiveWs.identifier
   statusFiveWs.status
   medication[x]FiveWs.what[x]
   medication[x] (medicationReference)FiveWs.what[x]
   medication[x] (medicationCodeableConcept)FiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   supportingInformationFiveWs.context

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

ARVDrugDispensation
MedicationDispense
   identifierCombinedMedicationDispense.id
   statusCombinedMedicationDispense.SupplyEvent.statusCode
   medication[x]CombinedMedicationRequest.component1.AdministrationRequest.consumable
   medication[x] (medicationReference)CombinedMedicationRequest.component1.AdministrationRequest.consumable
   medication[x] (medicationCodeableConcept)CombinedMedicationRequest.component1.AdministrationRequest.consumable
   authorizingPrescriptionCombinedMedicationDispense.inFulfillmentOf
   typeCombinedMedicationDispense.SupplyEvent.code
   quantityCombinedMedicationDispense.SupplyEvent.quantity
   whenPreparedCombinedMedicationDispense.SupplyEvent.effectiveTime
   whenHandedOverCombinedMedicationDispense.SupplyEvent.effectiveTime
   destinationCombinedMedicationDispense.SupplyEvent.destination
   receiverCombinedMedicationDispense.SupplyEvent.receiver
   substitutionCombinedMedicationDispense.substitutionMade
      typeCombinedMedicationDispense.substitutionMade.code
      reasonCombinedMedicationDispense.substitutionMade.reasonCode
      responsiblePartyCombinedMedicationDispense.substitutionMade.ResponsibleParty

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

ARVDrugDispensation
MedicationDispense
   medication[x]RXD-2-Dispense/Give Code
   medication[x] (medicationReference)RXD-2-Dispense/Give Code
   medication[x] (medicationCodeableConcept)RXD-2-Dispense/Give Code
      codingCE/CNE/CWE subset one of the sets of component 1-3 or 4-6
      textC*E.9. But note many systems use C*E.2 for this
   subjectPID-3-Patient ID List
   authorizingPrescriptionORC-2 Placer Order Number
   typeRXD-33-Dispense Type
   quantityRXD-4-Actual Dispense Amount / RXD-5.1-Actual Dispense Units.code / RXD-5.3-Actual Dispense Units.name of coding system
      valueSN.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
   daysSupplyTQ1.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
      valueSN.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
   whenPreparedRXD-3-Date/Time Dispensed
   whenHandedOverRXD-3-Date/Time Dispensed
   destinationRXD-13 Dispense-to Location; RXD-30 Dispense to Pharmacy; RXD-31 Dispense to Pharmacy Address
   noteRXD-9 Dispense Notes
   substitution
      typeRXO-9-Allow Substitutions / RXE-9-Substitution Status