HL7 FHIR Implementation Guide: Rwanda HIV
0.1.0 - ci-build International flag

HL7 FHIR Implementation Guide: Rwanda HIV, published by Jembi Health Systems. 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/openhie/Rwanda-HIV/ and changes regularly. See the Directory of published versions

Resource Profile: HIVServiceRequest - Mappings

Active as of 2024-10-11

Mappings for the HIV-lab-order resource profile.

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

HIVServiceRequest
ServiceRequestRequest
   identifierRequest.identifier
   identifier (PLAC)Request.identifier
   instantiatesCanonicalRequest.instantiatesCanonical
   instantiatesUriRequest.instantiatesUri
   basedOnRequest.basedOn
   replacesRequest.replaces
   requisitionRequest.groupIdentifier
   statusRequest.status
   intentRequest.intent
   priorityRequest.priority
   doNotPerformRequest.doNotPerform
   codeRequest.code
   subjectRequest.subject
   encounterRequest.encounter
   occurrence[x]Request.occurrence[x]
   occurrence[x] (occurrenceDateTime)Request.occurrence[x]
   authoredOnRequest.authoredOn
   requesterRequest.requester
   performerTypeRequest.performerType
   performerRequest.performer
   reasonRequest.reason
   insuranceRequest.insurance
   supportingInfoRequest.supportingInfo
   noteRequest.note
   relevantHistoryRequest.relevantHistory

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

HIVServiceRequest
ServiceRequestclinical.general
   identifierFiveWs.identifier
   identifier (PLAC)FiveWs.identifier
   statusFiveWs.status
   intentFiveWs.class
   categoryFiveWs.class
   priorityFiveWs.grade
   codeFiveWs.what[x]
   subjectFiveWs.subject[x]
   focusFiveWs.subject[x]
   encounterFiveWs.context
   occurrence[x]FiveWs.planned
   occurrence[x] (occurrenceDateTime)FiveWs.planned
   authoredOnFiveWs.recorded
   requesterFiveWs.author
   performerTypeFiveWs.actor
   performerFiveWs.actor
   locationFiveWs.actor
   reasonFiveWs.why[x]

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

HIVServiceRequest
ServiceRequestORC
   identifierORC-2, ORC-3, RF1-6 / RF1-11,
   identifier (PLAC)ORC-2, ORC-3, RF1-6 / RF1-11,
      useN/A
      typeCX.5
         codingC*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
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   instantiatesCanonicalVaries by domain
   instantiatesUriVaries by domain
   basedOnORC-8 (plus others)
   replacesHandled by message location of ORC (ORC-1=RO or RU)
   requisitionORC-4
   statusORC-5,RF1-1
   intentN/A
   categoryRF1-5
   priorityTQ1.9, RF1-2
   codePR1-3 / OBR-4 (varies by domain)
      concept
         codingC*E.1-8, C*E.10-22
         textC*E.9. But note many systems use C*E.2 for this
   orderDetailNTE
   quantity[x]NTE
   subjectPID
   encounterPV1
   occurrence[x]TQ1/TQ2, OBR-7/OBR-8
   occurrence[x] (occurrenceDateTime)TQ1/TQ2, OBR-7/OBR-8
   authoredOnORC-9, RF1-7 / RF1-9
   requesterORC-12, PRT
   performerTypePRT, RF1-3
   performerPRT, Practitioner: PRD-2/PRD-7 where PRD-3 = RT; Organization: PRD-10 where PRD-3 = RT
   reasonORC-16, RF1-10
   insuranceIN1/IN2
   supportingInfoAccompanying segments
   specimenSPM
   bodySiteSPM
   bodyStructureSPM
   noteNTE
   patientInstructionNTE
      instruction[x]NTE
   relevantHistoryN/A

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

HIVServiceRequest
ServiceRequestEntity, Role, or Act,Act[moodCode<=INT]
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifier.identifier
   identifier (PLAC).identifier
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
         idn/a
         extensionn/a
         codingunion(., ./translation)
            idn/a
            extensionn/a
            system./codeSystem
            version./codeSystemVersion
            code./code
            displayCV.displayName
            userSelectedCD.codingRationale
         text./originalText[mediaType/code="text/plain"]/data
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   instantiatesCanonical.outboundRelationship[typeCode=DEFN].target
   instantiatesUri.outboundRelationship[typeCode=DEFN].target
   basedOn.outboundRelationship[typeCode=FLFS].target
   replaces.outboundRelationship[typeCode=RPLC].target
   requisition.inboundRelationship(typeCode=COMP].source[moodCode=INT].identifier
   status.status
   intent.moodCode (nuances beyond PRP/PLAN/RQO would need to be elsewhere)
   category.outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="INT"].code
   priority.priorityCode
   doNotPerform.actionNegationInd
   code.code
      idn/a
      extensionn/a
      conceptN/A
         idn/a
         extensionn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
      referenceN/A
   orderDetail
      idn/a
      extensionn/a
      modifierExtensionN/A
      parameter
         idn/a
         extensionn/a
         modifierExtensionN/A
   quantity[x].quantity
   subject.participation[typeCode=SBJ].role
   focusparticipation[typeCode=SBJ]
   encounter.inboundRelationship(typeCode=COMP].source[classCode<=PCPR, moodCode=EVN]
   occurrence[x].effectiveTime
   occurrence[x] (occurrenceDateTime).effectiveTime
   asNeeded[x]boolean: precondition.negationInd (inversed - so negationInd = true means asNeeded=false CodeableConcept: precondition.observationEventCriterion[code="Assertion"].value
   authoredOn.participation[typeCode=AUT].time
   requester.participation[typeCode=AUT].role
   performerType.participation[typeCode=PRF].role[scoper.determinerCode=KIND].code
   performer.participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]
   location.participation[typeCode=LOC].role[scoper.determinerCode=KIND].code
   reason.reasonCode
   insurance.outboundRelationship[typeCode=COVBY].target
   supportingInfo.outboundRelationship[typeCode=PERT].target
   specimen.participation[typeCode=SPC].role
   bodySitetargetSiteCode
   bodyStructuretargetSiteCode
   note.inboundRelationship(typeCode=SUBJ].source[classCode=ANNGEN, moodCode=EVN].value[xsi:type=ST]
   patientInstruction.text
      idn/a
      extensionn/a
      modifierExtensionN/A
      instruction[x].text
   relevantHistory.inboundRelationship(typeCode=SUBJ].source[classCode=CACT, moodCode=EVN]

Mappings for Quality Improvement and Clinical Knowledge (QUICK) (http://siframework.org/cqf)

HIVServiceRequest
ServiceRequest
   identifierClinicalStatement.identifier
   identifier (PLAC)ClinicalStatement.identifier
   statusAction.currentStatus
   codeProcedure.procedureCode
   subjectClinicalStatement.subject
   encounterClinicalStatement.encounter
   occurrence[x]Procedure.procedureSchedule
   occurrence[x] (occurrenceDateTime)Procedure.procedureSchedule
   asNeeded[x]Proposal.prnReason.reason
   authoredOnProposal.proposedAtTime
   requesterClinicalStatement.statementAuthor
   bodySiteProcedure.targetBodySite
   bodyStructureProcedure.targetBodyStructure
   noteClinicalStatement.additionalText