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

ExampleScenario: Lab Order Results (Using a Bundle)

Official URL: http://moh.bw.org/ExampleScenario/LabOrderResults Version: 1.0.0
Active as of 2025-08-20 Computable Name: LabOrderResults

This serves to demonstrate the completion of the lab order by means of lab results, from the Point-of-Service (PoS) application to the FHIR datastore.

Actors

NameTypeDescription
Point of Service System

The entity that documents the lab results.

Interoperability Layer System

The entity that receives the lab results request submitted by the PoS entity.

FHIR Server System

The entity that stores the details for the lab results documented by the PoS entity.

Diagram

​Lab Order Results (Using a Bundle)Point of ServicePoint of ServiceInteroperability LayerInteroperability LayerFHIR ServerFHIR ServerLab ResultsdetailsLab results(payload)Invoke FHIR mediatoractivate FHIRSend data for consumption(payload)response(payload)Success: Invoke IL mediatorendRespond to RequestdetailsResponse(payload)Log the outcomeend

Processes

Process: Lab Results

Pre-conditions:

PoS entity has documented the lab results.

Post-conditions:

FHIR entity has updated the statuses for the Task and ServiceRequest resources by indicating its status as completed. In addition the FHIR entity has created resources for DiagnoisticReport and Observation, which together provide the lab result information.

Process: Lab Results

This scenario demonstrates the process of documenting the results for a given lab order in the FHIR entity.

StepNameDescriptionInitiatorReceiverRequestResponse
1 See subprocessLab Results below
StepNameDescriptionInitiatorReceiverRequestResponse
1.1 Lab results - update (Details: FHIR Restful Interactions code update)

Updated lab order information

 Point of Service Interoperability Layer Lab Order Bundle - Lab Results
1.2 Invoke FHIR mediator

Pass the data to the mediator responsible for calling the endpoint for resulting the lab order in FHIR.

 Interoperability Layer Interoperability Layer
1.3 Send data for consumption - update (Details: FHIR Restful Interactions code update)

Request for FHIR to process the information in the lab results bundle.

 Interoperability Layer FHIR Server FHIR request Outcome response
1.4 Success: Invoke IL mediator

Pass the data to the mediator responsible for calling the endpoint that must send a response back the PoS system who initiated the request to document the lab results in the FHIR entity.

 Interoperability Layer Interoperability Layer
Process: Respond to Request

Pre-conditions:

FHIR entity has processed the request and has issued an outcome response.

Post-conditions:

IL entity has received the outcome response from FHIR and forwarded the response to the PoS system.

Process: Respond to Request

This scenario demonstrates the process for responding to the PoS sytem who submitted the request.

StepNameDescriptionInitiatorReceiverRequestResponse
2 See subprocessRespond to Request below
StepNameDescriptionInitiatorReceiverRequestResponse
2.1 Response

Mediator responds to the request.

 Interoperability Layer Point of Service Outcome response
2.2 Log the outcome

PoS entity logs the outcome issued by the FHIR entity.

 Point of Service Point of Service

Instances

NameTypeContentDescription
Outcome response Endpoint here

FHIR issues an outcome response to each CRUD request.

Lab Order Bundle - Lab Results Bundle - Lab Orders here

The FHIR bundle provided by the PoS entity when submitting the results for a given lab order service request.

This bundle includes the following resources:

FHIR request Endpoint here

FHIR processes each request in the bundle using the HTTP request method defined for each Resource included in the Bundle.