Uzbekistan Digital Health Platform - Integrations
0.10.0 - draft
This page is part of the Uzbekistan Digital Health Platform - Integrations (v0.10.0: Releases Draft) based on FHIR (HL7® FHIR® Standard) v5.0.0. This is the current published version. For a full list of available versions, see the Directory of published versions
The patient's social status is represented using the UZ Core Socioeconomic Observation profile.
Examples: example-narcology-socioeconomic
The observation identifies the social-status observation using SNOMED CT concept 82996008. The patient's actual social status is recorded in valueCodeableConcept using SocialStatusVS.
| Information to record | Value set | Example code | Stored in |
|---|---|---|---|
| Observation status | ObservationStatus | final |
status |
| Observation type | SocioeconomicObservationCodesVS | SNOMED CT#82996008 |
code |
| Social status | SocialStatusVS | regis0010.00003 (Employed) |
valueCodeableConcept |
| Patient | - | reference to UZCorePatient | subject |
| Observation date | - | 2026-03-12 |
effectiveDateTime |
| Performer | - | reference to UZCorePractitionerRole | performer |
The following social-status codes are used in the Narcology Registry:
| Code | Description |
|---|---|
regis0010.00001 |
Учащийся |
regis0010.00003 |
Работающий / Employed |
regis0010.00004 |
Неработающий |
regis0010.00006 |
Пенсионер |
The subject references the patient whose social status is being recorded.
The patient's narcology registration and dynamic observation group are represented using the Narcology Episode Of Care profile.
Examples: example-narcology-episode-of-care
The episode records the patient's registration status, dynamic observation group, diagnoses associated with the episode, patient, managing organization, registration period, and responsible practitioner role.
| Information to record | Value set | Example code | Stored in |
|---|---|---|---|
| Identifier | - | https://dhp.uz/fhir/core/sid/reg/uz/narco |
identifier |
| Registration status | EpisodeOfCareStatusVS | active |
status |
| Dynamic observation group | NarcologyPsychiatryEpisodeOfCareTypeGroupVS | narcr0001-00001 |
type[group] |
| Diagnosis | ConditionCodeVS | F15.1 |
diagnosis.condition |
| Diagnosis use | Encounter Diagnosis Use | working |
diagnosis.use |
| Patient | - | reference to UZCorePatient | patient |
| Managing organization | - | reference to UZCoreOrganization | managingOrganization |
| Registration date | - | 2026-03-10 |
period.start |
| Care manager | - | reference to UZCorePractitionerRole | careManager |
When the patient is registered in the Narcology Registry, the episode status is active.
When the patient is removed from registration, the episode status should be finished.
The dynamic observation group is represented using the group slice on EpisodeOfCare.type.
The defined narcology and psychiatry episode-of-care group codes are:
| Code | SNOMED CT code | RU | UZ | ENG |
|---|---|---|---|---|
narcr0001-00001 |
302805002 |
Профилактическая группа | Profilaktik guruh | Preventive group |
narcr0001-00002 |
225419007 |
Диспансерная группа | Dispanser guruhi | Dispensary group |
psycr0001-00001 |
52748007 |
Стационарное принудительное лечение | Majburiy statsionar davolanish | Compulsory inpatient treatment |
The SNOMED CT mappings are defined by the Narcology and Psychiatry EpisodeOfCare Type Groups to SNOMED CT.
When recording a diagnosis associated with the narcology episode, implementers should use the applicable code from ConditionCodeVS.
The specified diagnosis codes are:
| Clinical condition | Code system | Code | When to record |
|---|---|---|---|
| Harmful use of other stimulants, including caffeine | ICD-10 | F15.1 |
Record when this narcology diagnosis applies to the patient |
| HIV disease resulting in other conditions | ICD-10 | B23 |
Record as a separate Condition when HIV is selected or identified in the Narcology Registry |
| Tuberculosis of respiratory system | ICD-10 | A15.7 |
Record as a separate Condition when tuberculosis is selected or identified in the Narcology Registry |
If disability is present, a separate Condition should be created using SNOMED CT code 21134002 (Disability).
The episode may contain multiple diagnoses. Each diagnosis.condition references the corresponding UZ Core Condition.
A patient's medical visit within the Narcology Registry is represented using the UZ Core Encounter profile.
Examples: example-narcology-encounter
The encounter represents the medical visit recorded by the healthcare provider and may be associated with the patient's EpisodeOfCare.
| Information to record | Value set | Example code | Stored in |
|---|---|---|---|
| Encounter status | Encounter Status | completed |
status |
| Patient | - | reference to UZCorePatient | subject |
| Episode of care | - | reference to NarcologyEpisodeOfCare | episodeOfCare |
| Actual encounter period | - | 2026-03-10T10:00:00Z – 2026-03-10T11:00:00Z |
actualPeriod |
| Participant type | Participant Type | ATND |
participant.type |
| Encounter practitioner | - | reference to UZCorePractitionerRole | participant.actor |
| Encounter type | - | mserv-0001-00004 (Treatment services) |
type[nationalType] |
| Diagnosis | ConditionCodeVS | F15.1 |
diagnosis.condition |
| Diagnosis use | Encounter Diagnosis Use | final |
diagnosis.use |
The encounter status may be:
in-progresson-holdcompletedcancelledentered-in-errorThe episodeOfCare reference associates the encounter with the patient's narcology registration episode.
An encounter may contain multiple diagnoses. Each diagnosis references a UZ Core Condition and may have an associated diagnosis-use value.
The medical-consultation commission's decision is represented using the NarcologyObservation profile.
Examples: example-narcology-commission
The profile is used to contain notes, findings, and recommendations issued by the Medical Advisory Commission.
| Information to record | Value set | Example code | Stored in |
|---|---|---|---|
| Observation status | Observation Status | final |
status |
| Commission decision type | NarcologyTypeResourceVS | type-res-0002-0001 |
code |
| Patient | - | reference to UZCorePatient | subject |
| Encounter | - | reference to UZCoreEncounter | encounter |
| Commission decision date | - | 2026-03-12 |
effectiveDateTime |
| Commission member | - | reference to UZCorePractitionerRole | performer |
| Commission result | - | Dispensary observation is required. The patient is to be reviewed again in six months. |
valueString |
The commission decision type is:
| Code | SNOMED CT code | RU | UZ | ENG |
|---|---|---|---|---|
type-res-0002-0001 |
444804000 |
Решение комиссии | Komissiya qarori | The commission's decision |
The corresponding terminology is defined in TypeResourceCS, and the SNOMED CT mapping is defined by the Type Resource to SNOMED CT ConceptMap.
Each commission member is recorded as a separate performer reference. The decision the commission reached is recorded in valueString, which is required by this profile.
A narcology-related clinical condition is represented using the UZ Core Condition profile.
Examples: example-narcology-condition
The Condition records the clinical status, diagnosis, patient, related encounter, registration date, and organization providing the information.
| Information to record | Value set | Example code | Stored in |
|---|---|---|---|
| Clinical status | Condition Clinical Status Codes | active |
clinicalStatus |
| Disability severity | DisabilityVS | applicable disability severity | severity |
| Diagnosis | ConditionCodeVS | F15.1 |
code |
| Patient | - | reference to UZCorePatient | subject |
| Encounter | - | reference to UZCoreEncounter | encounter |
| Registration date | - | 2026-03-10 |
recordedDate |
| Information provider | - | reference to UZCoreOrganization | participant.actor |
The clinical status is required.
When the condition is currently applicable to the patient, its status should be active.
When the condition is no longer applicable, the condition status should be changed according to the appropriate FHIR clinical-status semantics, for example resolved where applicable.
Implementers should use the applicable diagnosis code from ConditionCodeVS.
The Narcology Registry uses the following specified diagnosis codes:
| Condition | Code system | Code | When to record |
|---|---|---|---|
| Harmful use of other stimulants, including caffeine | ICD-10 | F15.1 |
Record when this narcology diagnosis applies to the patient |
| HIV disease resulting in other conditions | ICD-10 | B23 |
Record as a separate Condition when HIV is selected or identified in the Narcology Registry |
| Tuberculosis of respiratory system | ICD-10 | A15.7 |
Record as a separate Condition when tuberculosis is selected or identified in the Narcology Registry |
| Disability | SNOMED CT | 21134002 |
Record as a separate Condition when disability is present |
If HIV or tuberculosis is not selected in the Narcology Registry, the corresponding additional Condition should not be created.
Each condition is associated with the patient through subject.
When a condition is identified or managed during a specific medical encounter, the encounter reference may be populated.
The following rules apply to disability:
severity should only be populated when disability is present and the applicable severity is known.Condition should be created.21134002 (Disability).subject.Important narcology registry information that healthcare providers should be aware of is represented using the NarcologyPsychiatryFlag profile.
Examples: example-narcology-flag
The Flag resource is used to record registry flags such as social danger and compulsory treatment.
| Information to record | Value set | Example code | Stored in |
|---|---|---|---|
| Flag status | FlagStatusVS | active |
status |
| Registry flag | NarcologyPsychiatryRegistryFlagVS | registri0001-00002 |
code |
| Patient | - | reference to UZCorePatient | subject |
| Validity period | - | 2026-03-12 |
period |
| Encounter | - | reference to UZCoreEncounter | encounter |
| Author | - | reference to UZCorePractitionerRole | author |
The flag status is required and may be:
activeinactiveentered-in-errorThe registry flag codes are:
| Code | SNOMED CT code | SNOMED name | RU | UZ | ENG |
|---|---|---|---|---|---|
registri0001-00001 |
129707006 |
At increased risk for other-directed violence (finding) | Социальная опасность | Ijtimoiy xavflilik | Social danger / Social risk |
registri0001-00002 |
303163003 |
Treatments administered under the provisions of the law (regime/therapy) | Принудительное лечение | Majburiy davolanish | Compulsory treatment |
registri0001-00003 |
303163003 |
Treatments administered under the provisions of the law (regime/therapy) | Принудительное амбулаторное лечение | Majburiy ambulatoriya sharoitida davolanish | Compulsory outpatient treatment |
registri0001-00005 |
1193838006 |
Legal guardian status (observable entity) | Под опекой | Vasiylik ostida | Legal guardian status |
registri0001-00006 |
21134002 |
Disability (finding) | Инвалидность | Nogironlik | Disability |
psycr0001-00001 |
52748007 |
Involuntary hospital admission (procedure) | Стационарное принудительное лечение | Majburiy statsionar davolanish | Compulsory inpatient treatment |
The complete mapping is defined by the Narcology and Psychiatry Registry Flags to SNOMED CT.
The subject identifies the patient to whom the registry flag applies.
The encounter may be used to associate the flag with a specific medical encounter.
The author references the practitioner role responsible for recording the flag.
The terminology used by the Narcology Registry resources is summarized below.
| Terminology | Resource / Element | Purpose |
|---|---|---|
| SocialStatusVS | Observation.valueCodeableConcept |
Patient's social status |
| SocioeconomicObservationCodesVS | Observation.code |
Identifies the social-status observation |
| NarcologyPsychiatryEpisodeOfCareTypeGroupVS | EpisodeOfCare.type[group] |
Dynamic observation group |
| EpisodeOfCareStatusVS | EpisodeOfCare.status |
Narcology registration lifecycle |
| NarcologyTypeResourceVS | Observation.code |
Medical-consultation commission decision |
| ConditionCodeVS | Condition.code |
Narcology diagnosis |
| DisabilityVS | Condition.severity |
Disability-related severity |
| NarcologyPsychiatryRegistryFlagVS | Flag.code |
Narcology registry flags |
| FlagStatusVS | Flag.status |
Flag lifecycle |
A typical Narcology Registry record may connect the resources as follows:
Patient is the central subject.EpisodeOfCare.Encounter.These resources are linked through patient, episode-of-care, encounter, organization, and practitioner-role references to represent the patient's narcology registration, clinical diagnoses, social status, medical encounters, commission decisions, and important registry flags.