Botswana FHIR Implementation Guide
1.0.0 - ci-build Botswana flag

Botswana FHIR Implementation Guide, 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/botswana-hie-fhir-ig/ and changes regularly. See the Directory of published versions

Resource Profile: BwPatient - Mappings

Active as of 2026-10-13

Mappings for the bw-patient resource profile.

Mappings to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameFiveWs Pattern MappingRIM MappingInterface PatternCDA (R2)HL7 V2 MappingLOINC code for the elementdoco
Patient
administrative.individual
  • Entity
  • Role
  • or Act
  • Patient[classCode=PAT]
ParticipantLiving
ClinicalDocument.recordTarget.patientRole
Patient / id
Patient / meta
Patient / implicitRules
Patient / language
Patient / text
Act.text?
Patient / contained
N/A
Patient / extension
N/A
Patient / modifierExtension
N/A
Patient / Slices for identifier
FiveWs.identifier
id
Participant.identifier
.id
PID-3
Patient / Slices for identifier / identifier:MRN
FiveWs.identifier
id
Participant.identifier
.id
PID-3
Patient / Slices for identifier / identifier:MRN / id
n/a
Patient / Slices for identifier / identifier:MRN / extension
n/a
Patient / Slices for identifier / identifier:MRN / use
Role.code or implied by context
N/A
Patient / Slices for identifier / identifier:MRN / type
Role.code or implied by context
CX.5
Patient / Slices for identifier / identifier:MRN / system
II.root or Role.id.root
CX.4 / EI-2-4
Patient / Slices for identifier / identifier:MRN / value
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
CX.1 / EI.1
Patient / Slices for identifier / identifier:MRN / period
Role.effectiveTime or implied by context
CX.7 + CX.8
Patient / Slices for identifier / identifier:MRN / assigner
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
Patient / Slices for identifier / identifier:OMANG
FiveWs.identifier
id
Participant.identifier
.id
PID-3
Patient / Slices for identifier / identifier:OMANG / id
n/a
Patient / Slices for identifier / identifier:OMANG / extension
n/a
Patient / Slices for identifier / identifier:OMANG / use
Role.code or implied by context
N/A
Patient / Slices for identifier / identifier:OMANG / type
Role.code or implied by context
CX.5
Patient / Slices for identifier / identifier:OMANG / system
II.root or Role.id.root
CX.4 / EI-2-4
Patient / Slices for identifier / identifier:OMANG / value
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
CX.1 / EI.1
Patient / Slices for identifier / identifier:OMANG / period
Role.effectiveTime or implied by context
CX.7 + CX.8
Patient / Slices for identifier / identifier:OMANG / assigner
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
Patient / Slices for identifier / identifier:Birth
FiveWs.identifier
id
Participant.identifier
.id
PID-3
Patient / Slices for identifier / identifier:Birth / id
n/a
Patient / Slices for identifier / identifier:Birth / extension
n/a
Patient / Slices for identifier / identifier:Birth / use
Role.code or implied by context
N/A
Patient / Slices for identifier / identifier:Birth / type
Role.code or implied by context
CX.5
Patient / Slices for identifier / identifier:Birth / system
II.root or Role.id.root
CX.4 / EI-2-4
Patient / Slices for identifier / identifier:Birth / value
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
CX.1 / EI.1
Patient / Slices for identifier / identifier:Birth / period
Role.effectiveTime or implied by context
CX.7 + CX.8
Patient / Slices for identifier / identifier:Birth / assigner
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
Patient / Slices for identifier / identifier:Passport
FiveWs.identifier
id
Participant.identifier
.id
PID-3
Patient / Slices for identifier / identifier:Passport / id
n/a
Patient / Slices for identifier / identifier:Passport / extension
n/a
Patient / Slices for identifier / identifier:Passport / use
Role.code or implied by context
N/A
Patient / Slices for identifier / identifier:Passport / type
Role.code or implied by context
CX.5
Patient / Slices for identifier / identifier:Passport / system
II.root or Role.id.root
CX.4 / EI-2-4
Patient / Slices for identifier / identifier:Passport / value
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
CX.1 / EI.1
Patient / Slices for identifier / identifier:Passport / period
Role.effectiveTime or implied by context
CX.7 + CX.8
Patient / Slices for identifier / identifier:Passport / assigner
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
Patient / Slices for identifier / identifier:Immigration
FiveWs.identifier
id
Participant.identifier
.id
PID-3
Patient / Slices for identifier / identifier:Immigration / id
n/a
Patient / Slices for identifier / identifier:Immigration / extension
n/a
Patient / Slices for identifier / identifier:Immigration / use
Role.code or implied by context
N/A
Patient / Slices for identifier / identifier:Immigration / type
Role.code or implied by context
CX.5
Patient / Slices for identifier / identifier:Immigration / system
II.root or Role.id.root
CX.4 / EI-2-4
Patient / Slices for identifier / identifier:Immigration / value
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
CX.1 / EI.1
Patient / Slices for identifier / identifier:Immigration / period
Role.effectiveTime or implied by context
CX.7 + CX.8
Patient / Slices for identifier / identifier:Immigration / assigner
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
Patient / Slices for identifier / identifier:Internal
FiveWs.identifier
id
Participant.identifier
.id
PID-3
Patient / Slices for identifier / identifier:Internal / id
n/a
Patient / Slices for identifier / identifier:Internal / extension
n/a
Patient / Slices for identifier / identifier:Internal / use
Role.code or implied by context
N/A
Patient / Slices for identifier / identifier:Internal / type
Role.code or implied by context
CX.5
Patient / Slices for identifier / identifier:Internal / system
II.root or Role.id.root
CX.4 / EI-2-4
Patient / Slices for identifier / identifier:Internal / value
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
CX.1 / EI.1
Patient / Slices for identifier / identifier:Internal / period
Role.effectiveTime or implied by context
CX.7 + CX.8
Patient / Slices for identifier / identifier:Internal / assigner
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
Patient / Slices for identifier / identifier:PIMS
FiveWs.identifier
id
Participant.identifier
.id
PID-3
Patient / Slices for identifier / identifier:PIMS / id
n/a
Patient / Slices for identifier / identifier:PIMS / extension
n/a
Patient / Slices for identifier / identifier:PIMS / use
Role.code or implied by context
N/A
Patient / Slices for identifier / identifier:PIMS / type
Role.code or implied by context
CX.5
Patient / Slices for identifier / identifier:PIMS / system
II.root or Role.id.root
CX.4 / EI-2-4
Patient / Slices for identifier / identifier:PIMS / value
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
CX.1 / EI.1
Patient / Slices for identifier / identifier:PIMS / period
Role.effectiveTime or implied by context
CX.7 + CX.8
Patient / Slices for identifier / identifier:PIMS / assigner
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
Patient / Slices for identifier / identifier:OpenMRS
FiveWs.identifier
id
Participant.identifier
.id
PID-3
Patient / Slices for identifier / identifier:OpenMRS / id
n/a
Patient / Slices for identifier / identifier:OpenMRS / extension
n/a
Patient / Slices for identifier / identifier:OpenMRS / use
Role.code or implied by context
N/A
Patient / Slices for identifier / identifier:OpenMRS / type
Role.code or implied by context
CX.5
Patient / Slices for identifier / identifier:OpenMRS / system
II.root or Role.id.root
CX.4 / EI-2-4
Patient / Slices for identifier / identifier:OpenMRS / value
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
CX.1 / EI.1
Patient / Slices for identifier / identifier:OpenMRS / period
Role.effectiveTime or implied by context
CX.7 + CX.8
Patient / Slices for identifier / identifier:OpenMRS / assigner
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
Patient / active
FiveWs.status
statusCode
Participant.active
n/a
Patient / name
name
Participant.name
.patient.name
  • PID-5
  • PID-9
Patient / name / id
n/a
Patient / name / extension
n/a
Patient / name / use
unique(./use)
  • XPN.7
  • but often indicated by which field contains the name
Patient / name / text
./formatted
implied by XPN.11
Patient / name / family
./part[partType = FAM]
XPN.1/FN.1
Patient / name / given
./part[partType = GIV]
XPN.2 + XPN.3
Patient / name / prefix
./part[partType = PFX]
XPN.5
Patient / name / suffix
./part[partType = SFX]
XPN/4
Patient / name / period
./usablePeriod[type="IVL<TS>"]
XPN.13 + XPN.14
Patient / telecom
telecom
ParticipantContactable.telecom
.telecom
  • PID-13
  • PID-14
  • PID-40
Patient / gender
player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
ParticipantLiving.gender
.patient.administrativeGenderCode
PID-8
Patient / birthDate
player[classCode=PSN|ANM and determinerCode=INSTANCE]/birthTime
ParticipantLiving.birthDate
.patient.birthTime
PID-7
21112-8
Patient / deceased[x]
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime
n/a
PID-30 (bool) and PID-29 (datetime)
Patient / address
addr
ParticipantContactable.address
.addr
PID-11
Patient / maritalStatus
player[classCode=PSN]/maritalStatusCode
.patient.maritalStatusCode
PID-16
Patient / multipleBirth[x]
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthInd
  • player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber
n/a
  • PID-24 (bool)
  • PID-25 (integer)
Patient / photo
player[classCode=PSN|ANM and determinerCode=INSTANCE]/desc
ParticipantLiving.photo
n/a
OBX-5 - needs a profile
Patient / contact
player[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]
n/a
Patient / contact / id
n/a
Patient / contact / extension
n/a
Patient / contact / modifierExtension
N/A
Patient / contact / relationship
code
n/a
  • NK1-7
  • NK1-3
Patient / contact / name
name
n/a
NK1-2
Patient / contact / telecom
telecom
n/a
  • NK1-5
  • NK1-6
  • NK1-40
Patient / contact / address
addr
n/a
NK1-4
Patient / contact / gender
player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
n/a
NK1-15
Patient / contact / organization
scoper
n/a
  • NK1-13
  • NK1-30
  • NK1-31
  • NK1-32
  • NK1-41
Patient / contact / period
effectiveTime
n/a
Patient / communication
LanguageCommunication
ParticipantLiving.communication
patient.languageCommunication
Patient / communication / id
n/a
Patient / communication / extension
n/a
Patient / communication / modifierExtension
N/A
Patient / communication / language
player[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code
.languageCode
  • PID-15
  • LAN-2
Patient / communication / preferred
preferenceInd
.preferenceInd
PID-15
Patient / generalPractitioner
subjectOf.CareEvent.performer.AssignedEntity
n/a
PD1-4
Patient / managingOrganization
scoper
.providerOrganization
Patient / link
outboundLink
n/a
Patient / link / id
n/a
Patient / link / extension
n/a
Patient / link / modifierExtension
N/A
Patient / link / other
id
n/a
  • PID-3
  • MRG-1
Patient / link / type
typeCode
n/a

doco Documentation for this format