WHO SMART Guidelines - HIV
0.4.4 - ci-build

WHO SMART Guidelines - HIV, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.4.4 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-hiv/ and changes regularly. See the Directory of published versions

ExampleScenario: HIV.A.REGISTRATION

Official URL: http://smart.who.int/hiv/ExampleScenario/HIV.A.REGISTRATION Version: 0.4.4
Active as of 2025-07-24 Computable Name: HIV.A.REGISTRATION SCENARIO

Actors

NameTypeDescription
Patient Person
Health Care Provider Person
EMR System

Diagram

​HIV.A.REGISTRATION SCENARIOPatientPatientHealth Care ProviderHealth Care ProviderEMREMRVisit Health facilitydetailsCreate an visit appointment(payload)Gather client details(payload)Validate Client detailsdetailsSearch for client record(payload)Create new client Recordhealthcareprovider -> emr:Review sociodemographic data with clientdeactivate healthcareproviderupdate Client detailsendCheck In Client(payload)

Processes

Process: HIV.A. Registration

The patient visits the clinician for an initial consultation.

Process: Visit Health facility

Description of Step 1

StepNameDescriptionInitiatorReceiverRequestResponse
See subprocessVisit Health facility below
See subprocessValidate Client details below

Alternative Alternative 1 for Step 1

First alternative to Step 1

7 Check In Client - create (Details: FHIR Restful Interactions code create) EMR Patient Patient Resource
StepNameDescriptionInitiatorReceiverRequestResponse
1 Create an visit appointment - create (Details: FHIR Restful Interactions code create) Health Care Provider Patient Encounter Resource
2 Gather client details Patient Health Care Provider Patient Resource
Process: Validate Client details

Description of Step 2

StepNameDescriptionInitiatorReceiverRequestResponse
3 Search for client record - search (Details: FHIR Restful Interactions code search) Health Care Provider EMR SearchParameter Bundle Resource
4 Create new client Record Health Care Provider EMR
5 Review sociodemographic data with client Health Care Provider EMR
6 update Client details - update (Details: FHIR Restful Interactions code update) Health Care Provider EMR

Instances

NameTypeContentDescription
Patient Resource Patient

The Patient involved in the scenario.

SearchParameter Bundle Resource SearchParameter

List patient search bundle

Encounter Resource Encounter

The Encounter where the patient meets with the health worker.