Botswana FHIR Implementation Guide
1.0.0 - ci-build
Botswana FHIR Implementation Guide
1.0.0 - ci-build
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
| Official URL: http://moh.bw.org/StructureDefinition/practitioner | Version: 1.0.0 | |||
| Active as of 2026-10-13 | Computable Name: BwPractitioner | |||
Represents the practitioner who participated in the health related service.
Usages:
You can also check for usages in the FHIR IG Statistics
Description of Profiles, Differentials, Snapshots and how the different presentations work.
| Name | Flags | Card. | Type | Description & Constraints Filter:  |
|---|---|---|---|---|
  Practitioner |
0..* | Practitioner | A person with a formal responsibility in the provisioning of healthcare or related services | |
  implicitRules |
0..1 | uri | A set of rules under which this content was created | |
| contained |
0..* | Resource | Contained, inline Resources | |
 modifierExtension |
0..* | Extension | Extensions that cannot be ignored | |
  Slices for identifier |
1..* | Identifier | An identifier for the person as this agent Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
   identifier:OMANG |
0..1 | Identifier | An identifier for the person as this agent | |
  use |
0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | |
| system |
1..1 | uri | The namespace for the identifier value Required Pattern: http://moh.bw.org/identifier/omang | |
 value |
C | 1..1 | string | The value that is unique Example General: 123456 |
| active |
0..1 | boolean | Whether this practitioner's record is in active use | |
 name |
1..* | HumanName | The name(s) associated with the practitioner | |
| use |
0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name. | |
| family |
1..1 | string | Family name (often called 'Surname') | |
 given |
1..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name | |
| telecom |
1..* | ContactPoint | A contact detail for the practitioner (that apply to all roles) | |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Practitioner.identifier:OMANG.use | Base | required | IdentifierUse | 📍5.0.0 | FHIR Std. |
| Practitioner.name.use | Base | required | NameUse | 📍5.0.0 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Practitioner | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Practitioner | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Practitioner | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Practitioner | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Practitioner | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
This structure is derived from Practitioner
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Practitioner |
Practitioner | |||
| Slices for identifier |
1..* | Identifier | An identifier for the person as this agent Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
| identifier:OMANG |
0..1 | Identifier | An identifier for the person as this agent | |
 system |
1..1 | uri | The namespace for the identifier value Required Pattern: http://moh.bw.org/identifier/omang | |
| value |
1..1 | string | The value that is unique | |
| name |
1..* | HumanName | The name(s) associated with the practitioner | |
| family |
1..1 | string | Family name (often called 'Surname') | |
| given |
1..* | string | Given names (not always 'first'). Includes middle names | |
| telecom |
1..* | ContactPoint | A contact detail for the practitioner (that apply to all roles) | |
| Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| Practitioner |
0..* | Practitioner | A person with a formal responsibility in the provisioning of healthcare or related services | |||||
| id |
0..1 | id | Logical id of this artifact | |||||
| meta |
0..1 | Meta | Metadata about the resource | |||||
| implicitRules |
0..1 | uri | A set of rules under which this content was created | |||||
| language |
0..1 | code | Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language
| |||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
| contained |
0..* | Resource | Contained, inline Resources | |||||
 extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored | |||||
| Slices for identifier |
1..* | Identifier | An identifier for the person as this agent Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |||||
| identifier:OMANG |
0..1 | Identifier | An identifier for the person as this agent | |||||
| id |
0..1 | id | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| use |
0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | |||||
| type |
0..1 | CodeableConcept | Description of identifier Binding: IdentifierTypeCodes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | |||||
| system |
1..1 | uri | The namespace for the identifier value Required Pattern: http://moh.bw.org/identifier/omang | |||||
| value |
C | 1..1 | string | The value that is unique Example General: 123456 | ||||
| period |
0..1 | Period | Time period when id is/was valid for use | |||||
 assigner |
0..1 | Reference(Organization) | Organization that issued id (may be just text) | |||||
| active |
0..1 | boolean | Whether this practitioner's record is in active use | |||||
| name |
1..* | HumanName | The name(s) associated with the practitioner | |||||
| id |
0..1 | id | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| use |
0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name. | |||||
| text |
0..1 | string | Text representation of the full name | |||||
| family |
1..1 | string | Family name (often called 'Surname') | |||||
| given |
1..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name | |||||
| prefix |
0..* | string | Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name | |||||
| suffix |
0..* | string | Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name | |||||
| period |
0..1 | Period | Time period when name was/is in use | |||||
| telecom |
1..* | ContactPoint | A contact detail for the practitioner (that apply to all roles) | |||||
| gender |
0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. | |||||
| birthDate |
0..1 | date | The date on which the practitioner was born | |||||
 deceased[x] |
0..1 | Indicates if the practitioner is deceased or not | ||||||
| deceasedBoolean |
boolean | |||||||
| deceasedDateTime |
dateTime | |||||||
| address |
0..* | Address | Address(es) of the practitioner that are not role specific (typically home address) | |||||
| photo |
0..* | Attachment | Image of the person | |||||
| qualification |
0..* | BackboneElement | Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||
| identifier |
0..* | Identifier | An identifier for this qualification for the practitioner | |||||
| code |
1..1 | CodeableConcept | Coded representation of the qualification Binding: hl7VS-degreeLicenseCertificate (example): Specific qualification the practitioner has to provide a service. | |||||
| period |
0..1 | Period | Period during which the qualification is valid | |||||
| issuer |
0..1 | Reference(Organization) | Organization that regulates and issues the qualification | |||||
 communication |
0..* | BackboneElement | A language which may be used to communicate with the practitioner | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||
| language |
1..1 | CodeableConcept | The language code used to communicate with the practitioner Binding: AllLanguages (required): IETF language tag for a human language
| |||||
| preferred |
0..1 | boolean | Language preference indicator | |||||
| Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Practitioner.language | Base | required | All Languages | 📍5.0.0 | FHIR Std. |
| Practitioner.identifier:OMANG.use | Base | required | IdentifierUse | 📍5.0.0 | FHIR Std. |
| Practitioner.identifier:OMANG.type | Base | extensible | Identifier Type Codes | 📍5.0.0 | FHIR Std. |
| Practitioner.name.use | Base | required | NameUse | 📍5.0.0 | FHIR Std. |
| Practitioner.gender | Base | required | AdministrativeGender | 📍5.0.0 | FHIR Std. |
| Practitioner.qualification.code | Base | example | hl7VS-degreeLicenseCertificate | 📦3.0.0 | THO v7.4 |
| Practitioner.communication.language | Base | required | All Languages | 📍5.0.0 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Practitioner | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Practitioner | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Practitioner | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Practitioner | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Practitioner | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
This structure is derived from Practitioner
Summary
Mandatory: 5 elements(2 nested mandatory elements)
Must-Support: 1 element
Slices
This structure defines the following Slices:
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Practitioner |
0..* | Practitioner | A person with a formal responsibility in the provisioning of healthcare or related services | |
| implicitRules |
0..1 | uri | A set of rules under which this content was created | |
| contained |
0..* | Resource | Contained, inline Resources | |
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored | |
| Slices for identifier |
1..* | Identifier | An identifier for the person as this agent Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
| identifier:OMANG |
0..1 | Identifier | An identifier for the person as this agent | |
| use |
0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | |
| system |
1..1 | uri | The namespace for the identifier value Required Pattern: http://moh.bw.org/identifier/omang | |
| value |
C | 1..1 | string | The value that is unique Example General: 123456 |
| active |
0..1 | boolean | Whether this practitioner's record is in active use | |
| name |
1..* | HumanName | The name(s) associated with the practitioner | |
| use |
0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name. | |
| family |
1..1 | string | Family name (often called 'Surname') | |
| given |
1..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name | |
| telecom |
1..* | ContactPoint | A contact detail for the practitioner (that apply to all roles) | |
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Practitioner.identifier:OMANG.use | Base | required | IdentifierUse | 📍5.0.0 | FHIR Std. |
| Practitioner.name.use | Base | required | NameUse | 📍5.0.0 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Practitioner | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Practitioner | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Practitioner | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Practitioner | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Practitioner | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Differential View
This structure is derived from Practitioner
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Practitioner |
Practitioner | |||
| Slices for identifier |
1..* | Identifier | An identifier for the person as this agent Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
| identifier:OMANG |
0..1 | Identifier | An identifier for the person as this agent | |
| system |
1..1 | uri | The namespace for the identifier value Required Pattern: http://moh.bw.org/identifier/omang | |
| value |
1..1 | string | The value that is unique | |
| name |
1..* | HumanName | The name(s) associated with the practitioner | |
| family |
1..1 | string | Family name (often called 'Surname') | |
| given |
1..* | string | Given names (not always 'first'). Includes middle names | |
| telecom |
1..* | ContactPoint | A contact detail for the practitioner (that apply to all roles) | |
| Documentation for this format | ||||
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| Practitioner |
0..* | Practitioner | A person with a formal responsibility in the provisioning of healthcare or related services | |||||
| id |
0..1 | id | Logical id of this artifact | |||||
| meta |
0..1 | Meta | Metadata about the resource | |||||
| implicitRules |
0..1 | uri | A set of rules under which this content was created | |||||
| language |
0..1 | code | Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language
| |||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
| contained |
0..* | Resource | Contained, inline Resources | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored | |||||
| Slices for identifier |
1..* | Identifier | An identifier for the person as this agent Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |||||
| identifier:OMANG |
0..1 | Identifier | An identifier for the person as this agent | |||||
| id |
0..1 | id | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| use |
0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known . | |||||
| type |
0..1 | CodeableConcept | Description of identifier Binding: IdentifierTypeCodes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. | |||||
| system |
1..1 | uri | The namespace for the identifier value Required Pattern: http://moh.bw.org/identifier/omang | |||||
| value |
C | 1..1 | string | The value that is unique Example General: 123456 | ||||
| period |
0..1 | Period | Time period when id is/was valid for use | |||||
| assigner |
0..1 | Reference(Organization) | Organization that issued id (may be just text) | |||||
| active |
0..1 | boolean | Whether this practitioner's record is in active use | |||||
| name |
1..* | HumanName | The name(s) associated with the practitioner | |||||
| id |
0..1 | id | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
| use |
0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name. | |||||
| text |
0..1 | string | Text representation of the full name | |||||
| family |
1..1 | string | Family name (often called 'Surname') | |||||
| given |
1..* | string | Given names (not always 'first'). Includes middle names This repeating element order: Given Names appear in the correct order for presenting the name | |||||
| prefix |
0..* | string | Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name | |||||
| suffix |
0..* | string | Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name | |||||
| period |
0..1 | Period | Time period when name was/is in use | |||||
| telecom |
1..* | ContactPoint | A contact detail for the practitioner (that apply to all roles) | |||||
| gender |
0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. | |||||
| birthDate |
0..1 | date | The date on which the practitioner was born | |||||
| deceased[x] |
0..1 | Indicates if the practitioner is deceased or not | ||||||
| deceasedBoolean |
boolean | |||||||
| deceasedDateTime |
dateTime | |||||||
| address |
0..* | Address | Address(es) of the practitioner that are not role specific (typically home address) | |||||
| photo |
0..* | Attachment | Image of the person | |||||
| qualification |
0..* | BackboneElement | Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||
| identifier |
0..* | Identifier | An identifier for this qualification for the practitioner | |||||
| code |
1..1 | CodeableConcept | Coded representation of the qualification Binding: hl7VS-degreeLicenseCertificate (example): Specific qualification the practitioner has to provide a service. | |||||
| period |
0..1 | Period | Period during which the qualification is valid | |||||
| issuer |
0..1 | Reference(Organization) | Organization that regulates and issues the qualification | |||||
| communication |
0..* | BackboneElement | A language which may be used to communicate with the practitioner | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||
| language |
1..1 | CodeableConcept | The language code used to communicate with the practitioner Binding: AllLanguages (required): IETF language tag for a human language
| |||||
| preferred |
0..1 | boolean | Language preference indicator | |||||
| Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Practitioner.language | Base | required | All Languages | 📍5.0.0 | FHIR Std. |
| Practitioner.identifier:OMANG.use | Base | required | IdentifierUse | 📍5.0.0 | FHIR Std. |
| Practitioner.identifier:OMANG.type | Base | extensible | Identifier Type Codes | 📍5.0.0 | FHIR Std. |
| Practitioner.name.use | Base | required | NameUse | 📍5.0.0 | FHIR Std. |
| Practitioner.gender | Base | required | AdministrativeGender | 📍5.0.0 | FHIR Std. |
| Practitioner.qualification.code | Base | example | hl7VS-degreeLicenseCertificate | 📦3.0.0 | THO v7.4 |
| Practitioner.communication.language | Base | required | All Languages | 📍5.0.0 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Practitioner | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Practitioner | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Practitioner | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Practitioner | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Practitioner | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
This structure is derived from Practitioner
Summary
Mandatory: 5 elements(2 nested mandatory elements)
Must-Support: 1 element
Slices
This structure defines the following Slices:
Other representations of profile: CSV, Excel, Schematron