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/abertnamanya/openmrs-contrib-fhir2-ig/ and changes regularly. See the Directory of published versions

• Content
• Detailed Descriptions
• Mappings
• Examples
• XML
• JSON
• TTL

Resource Profile: OMRSEncounter - Mappings

Active as of 2024-12-11

Mappings for the omrs-encounter resource profile.

Mappings for FHIR HL7 vs OMRS FHIR2 (Encounter)

Encounter is an FHIR resource that is used to represent an Interaction between a patient and healthcare provider(s) for the purpose of providing healthcare services or assessing the health status of a patient. Encounter FHIR resources are mapped to both OpenMrs Encounter and Visit Objects.

OMRSEncounter
Encounter	OMRS Encounter	This profile maps to Encounter in OMRS FHIR2
id	Encounter.uuid
status	Encounter.status
subject	Encounter.patient
participant	Encounter.encounterProvider
location	Encounter.location

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

OMRSEncounter
Encounter	Event
identifier	Event.identifier
status	Event.status
type	Event.code
serviceType	Event.code
subject	Event.subject
episodeOfCare	Event.context
basedOn	Event.basedOn
participant	Event.performer
type	Event.performer.function
individual	Event.performer.actor
appointment	Event.basedOn
period	Event.occurrence[x]
length	Event.occurrence[x]
reasonCode	Event.reasonCode
reasonReference	Event.reasonCode
diagnosis
condition	Event.reasonReference
location
location	Event.location
serviceProvider	Event.performer.actor
partOf	Event.partOf

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

OMRSEncounter
Encounter	Entity. Role, or Act, Encounter[@moodCode='EVN']
meta
id	n/a
extension	n/a
text	Act.text?
contained	N/A
extension	N/A
modifierExtension	N/A
identifier	.id
status	.statusCode
statusHistory	n/a
id	n/a
extension	n/a
modifierExtension	N/A
status	n/a
period	n/a
class	.inboundRelationship[typeCode=SUBJ].source[classCode=LIST].code
classHistory	n/a
id	n/a
extension	n/a
modifierExtension	N/A
class	n/a
period	n/a
type	.code
serviceType	n/a
priority	.priorityCode
subject	.participation[typeCode=SBJ]/role[classCode=PAT]
episodeOfCare	n/a
basedOn	.reason.ClinicalDocument
participant	.participation[typeCode=PFM]
id	n/a
extension	n/a
modifierExtension	N/A
type	.functionCode
period	.time
individual	.role
appointment	.outboundRelationship[typeCode=FLFS].target[classCode=ENC, moodCode=APT]
period	.effectiveTime (low & high)
length	.lengthOfStayQuantity
reasonCode	.reasonCode
reasonReference	.reasonCode
diagnosis	.outboundRelationship[typeCode=RSON]
id	n/a
extension	n/a
modifierExtension	N/A
condition	.outboundRelationship[typeCode=RSON].target
use	n/a
rank	.outboundRelationship[typeCode=RSON].priority
account	.pertains.A_Account
hospitalization	.outboundRelationship[typeCode=COMP].target[classCode=ENC, moodCode=EVN]
id	n/a
extension	n/a
modifierExtension	N/A
preAdmissionIdentifier	.id
origin	.participation[typeCode=ORG].role
admitSource	.admissionReferralSourceCode
reAdmission	n/a
dietPreference	.outboundRelationship[typeCode=COMP].target[classCode=SBADM, moodCode=EVN, code="diet"]
specialCourtesy	.specialCourtesiesCode
specialArrangement	.specialArrangementCode
destination	.participation[typeCode=DST]
dischargeDisposition	.dischargeDispositionCode
location	.participation[typeCode=LOC]
id	n/a
extension	n/a
modifierExtension	N/A
location	.role
status	.role.statusCode
period	.time
serviceProvider	.particiaption[typeCode=PFM].role
partOf	.inboundRelationship[typeCode=COMP].source[classCode=COMP, moodCode=EVN]

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

OMRSEncounter
Encounter
identifier	FiveWs.identifier
status	FiveWs.status
class	FiveWs.class
type	FiveWs.class
priority	FiveWs.grade
subject	FiveWs.subject[x], FiveWs.subject
episodeOfCare	FiveWs.context
participant
individual	FiveWs.who
period	FiveWs.done[x]
reasonCode	FiveWs.why[x]
reasonReference	FiveWs.why[x]
diagnosis
condition	FiveWs.why[x]
location
location	FiveWs.where[x]

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

OMRSEncounter
Encounter
identifier	PV1-19
status	No clear equivalent in HL7 v2; active/finished could be inferred from PV1-44, PV1-45, PV2-24; inactive could be inferred from PV2-16
class	PV1-2
type	PV1-4 / PV1-18
serviceType	PV1-10
priority	PV2-25
subject	PID-3
episodeOfCare	PV1-54, PV1-53
participant	ROL
type	ROL-3 (or maybe PRT-4)
period	ROL-5, ROL-6 (or maybe PRT-5)
individual	ROL-4
appointment	SCH-1 / SCH-2
period	PV1-44, PV1-45
length	(PV1-45 less PV1-44) iff ( (PV1-44 not empty) and (PV1-45 not empty) ); units in minutes
reasonCode	EVN-4 / PV2-3 (note: PV2-3 is nominally constrained to inpatient admissions; HL7 v2 makes no vocabulary suggestions for PV2-3; would not expect PV2 segment or PV2-3 to be in use in all implementations )
reasonReference	EVN-4 / PV2-3 (note: PV2-3 is nominally constrained to inpatient admissions; HL7 v2 makes no vocabulary suggestions for PV2-3; would not expect PV2 segment or PV2-3 to be in use in all implementations )
diagnosis
condition	Resources that would commonly referenced at Encounter.indication would be Condition and/or Procedure. These most closely align with DG1/PRB and PR1 respectively.
hospitalization
preAdmissionIdentifier	PV1-5
admitSource	PV1-14
reAdmission	PV1-13
dietPreference	PV1-38
specialCourtesy	PV1-16
specialArrangement	PV1-15 / OBR-30 / OBR-43
destination	PV1-37
dischargeDisposition	PV1-36
location
location	PV1-3 / PV1-6 / PV1-11 / PV1-42 / PV1-43
serviceProvider	PL.6 & PL.1