Uzbekistan Digital Health Platform - Integrations
0.10.0 - draft
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
This page describes how hepatitis registry information is represented as FHIR resources.
The hepatitis registry captures patient details, care episodes, visits, diagnoses, laboratory and ultrasound findings, and questionnaire answers. The data originates from the Viral Hepatitis Registration and Monitoring System and is added to the DHP as individual, atomic FHIR resources. Each section links the governing profile and example resources and maps the recorded information to FHIR fields. The hepatitis profiles inherit UZ Core; their published constraints remain authoritative.
Condition, EpisodeOfCare, and both Observation profiles require one identifier[hepatitisRegistry] with system https://dhp.uz/fhir/core/sid/reg/uz/hepatitis and a value. Questionnaire requires at least one identifier. QuestionnaireResponse fixes the identifier system when that element is present. The registry identifier is the identifier assigned by the source hepatitis registry to the corresponding record, such as a diagnosis, care episode, or test result. system identifies the issuing registry’s namespace, and value holds that record’s identifier in the registry, allowing the FHIR resource to be matched back to its source record. These are record identifiers, separate from the patient’s personal identifiers.
The care episode references the patient and diagnosis. A visit can reference the episode, and the diagnosis references the visit. Observations and questionnaire answers identify their patient independently. The examples share one patient record, and the visit links to the care episode.
The patient record provides identity, demographics, and contact details. HepatitisPatient inherits UZ Core Patient and marks telecom as Must Support; this does not by itself make the field mandatory.
Profile: HepatitisPatient
Example: hepatitis-patient-example
| What is recorded | Terminology | Example code or value | Where it is stored |
|---|---|---|---|
| National identifier | - | 515050500505 |
identifier[nationalId].value |
| Local passport | - | AB1234567 |
identifier[passportLocal].value |
| Health card identifier | - | 01234567890456 |
identifier[healthCardId].value |
| Name | - | Xalida Yusupova Maxmudovna |
name |
| Administrative gender | AdministrativeGenderVS | female |
gender |
| Date of birth | - | 1990-02-01 |
birthDate |
| Telephone | - | 998-90-123-45-45 |
telecom.value |
An EpisodeOfCare groups the ongoing care of a patient registered for hepatitis A, B, C, or D. It links the patient, diagnosis, responsible organization, and care manager.
Profile: HepatitisEpisodeOfCare
Example: hepatitis-episode-of-care-example
| What is recorded | Terminology | Example code or value | Where it is stored |
|---|---|---|---|
| Registry identifier | - | 75dcdd0a-5a68-4cc6-8503-5ab15a42c63b |
identifier[hepatitisRegistry].value |
| Status | EpisodeOfCareStatus | active |
status |
| Service type | EpisodeOfCareTypeVS | episode-of-care-type-cs#mserv-0001-00004 |
type[serviceType] |
| Diagnosis | - | example-hepatitis-condition | diagnosis.condition.reference |
| Diagnosis use | EncounterDiagnosisUse | encounter-diagnosis-use-cs#final |
diagnosis.use |
| Patient | - | hepatitis-patient-example | patient |
| Responsible organization | - | samarkand-infectious-hospital | managingOrganization |
| Care manager | - | example-hepatologist-role | careManager |
| Care period | - | 2026-09-18T09:00:00+05:00 / 2026-11-10T17:00:00+05:00 |
period |
The example remains active; its end date is an expected end. The episode references the acute hepatitis C diagnosis (B17.1).
Encounter records an individual visit. Its required subject references HepatitisPatient; episodeOfCare, when supplied, references HepatitisEpisodeOfCare.
Profile: HepatitisEncounter
Example: hepatitis-encounter-example
| What is recorded | Terminology | Example code or value | Where it is stored |
|---|---|---|---|
| Visit status | EncounterStatusVS | completed |
status |
| Visit class | EncounterClassVS | v3-ActCode#AMB |
class |
| Visit type | EncounterTypeVS | encounter-type-cs#mserv-0001-00004 |
type |
| Patient | - | hepatitis-patient-example | subject |
| Participant role | EncounterParticipantTypeVS | v3-ParticipationType#ATND |
participant.type |
| Clinician | - | example-hepatologist-role | participant.actor |
| Provider | - | samarkand-infectious-hospital | serviceProvider |
| Actual period | - | 2026-09-18T09:45:00+05:00 / 2026-09-18T11:00:00+05:00 |
actualPeriod |
| Planned start | - | 2026-09-18T09:30:00+05:00 |
plannedStartDate |
| Care episode | - | hepatitis-episode-of-care-example | episodeOfCare |
The encounter example links to the care episode through episodeOfCare.
Condition records the diagnosis and clinical status. It references HepatitisPatient and, when present, HepatitisEncounter. The optional outcome extension records the treatment response separately from clinical status.
Profile: HepatitisCondition
Example: example-hepatitis-condition
| What is recorded | Terminology | Example code or value | Where it is stored |
|---|---|---|---|
| Registry identifier | - | 69dcdd0a-5a68-4cc6-8503-5ab15a41c63b |
identifier[hepatitisRegistry].value |
| Diagnosis | ConditionCodeVS | ICD-10#B17.1 |
code |
| Clinical status | ClinicalStatusVS | condition-clinical#active |
clinicalStatus |
| Diagnosis type | DiagnosisTypeVS | diagnosis-type-cs#gencl-0001-00003 |
extension[diagnosisType] |
| Treatment outcome | ConditionOutcomeCodes | SNOMED CT#1137679005 |
extension[http://hl7.org/fhir/StructureDefinition/condition-outcome].valueCodeableConcept |
| Patient | - | hepatitis-patient-example | subject |
| Visit | - | hepatitis-encounter-example | encounter |
| Recorded date | - | 2026-09-18T10:45:00+05:00 |
recordedDate |
| Clinician | - | example-hepatologist-role | participant.actor |
The ConditionOutcome extension records a result or consequence of the condition without implying causality. Its URL is http://hl7.org/fhir/StructureDefinition/condition-outcome. Each occurrence contains one valueCodeableConcept, with an example binding to ConditionOutcomeCodes. Some outcomes may only be assessed after the condition is no longer active.
Laboratory observations identify the test, result, time, patient, and performers. The example records a negative hepatitis A IgM antibody result.
Profile: HepatitisObservationAnalysis
Example: example-hepatitis-observation-analysis
| What is recorded | Terminology | Example code or value | Where it is stored |
|---|---|---|---|
| Registry identifier | - | 85dcdd0a-5a68-4cc6-8503-5ab15a42c63b |
identifier[hepatitisRegistry].value |
| Result status | ObservationStatusVS | final |
status |
| Test | ObservationCodesVS | LOINC#22314-9 |
code |
| Result | v3-ObservationInterpretation | v3-ObservationInterpretation#NEG |
valueCodeableConcept |
| Patient | - | hepatitis-patient-example | subject |
| Observation time | - | 2026-09-18T10:00:00+05:00 |
effectiveDateTime |
| Performers | - | example-hepatologist-role, samarkand-infectious-hospital | performer |
effective[x] allows dateTime or Period. value[x] allows Attachment, Quantity, or CodeableConcept; component values allow string, CodeableConcept, or Quantity. Components also support dataAbsentReason and at most one interpretation. The result coding above is used by the example; it is not a hepatitis-specific required value set for every result.
Each ultrasound observation records a coded finding and a boolean result. The examples record cirrhosis as present and a liver lesion as absent in separate resources.
Profile: HepatitisObservationUltraSound
Example: example-ultrasound-cirrhosis, example-ultrasound-lesion
| What is recorded | Terminology | Example code or value | Where it is stored |
|---|---|---|---|
| Registry identifier | - | 85dcdd0a-5a68-4cc6-8503-5ab15a42c73b |
identifier[hepatitisRegistry].value |
| Result status | ObservationStatusVS | final |
status |
| Finding | HepatitisTypeOfUltraSoundVS | SNOMED CT#19943007 / SNOMED CT#300332007 |
code |
| Presence of finding | - | true / false |
valueBoolean |
| Patient | - | hepatitis-patient-example | subject |
| Observation time | - | 2026-09-18T10:30:00+05:00 |
effectiveDateTime |
| Performers | - | example-hepatologist-role, samarkand-infectious-hospital | performer |
code has a required binding to HepatitisTypeOfUltraSoundVS, which uses SNOMED CT codes with a local designation supplement. effective[x] allows dateTime or Period; value[x] is restricted to boolean.
Questionnaire defines the questions and conditional display rules. The example includes previous hepatitis B/C treatment, medications, and pregnancy trimester.
Profile: HepatitisQuestionnaire
Example: hepatitis-questionnaire
| What is recorded | Terminology | Example code or value | Where it is stored |
|---|---|---|---|
| Identifier | - | HCV-HBV-QS-2026 |
identifier.value |
| Publication status | PublicationStatus | active |
status |
| Subject type | ResourceType | Patient |
subjectType |
| Question identifier | - | hx-tx-hcv-hbv |
item.item.linkId |
| Question type | QuestionnaireItemType | boolean, string, coding |
item.item.type |
| Display condition | QuestionnaireItemOperator | = / true |
item.item.enableWhen.operator / answerBoolean |
| Trimester options | SNOMED CT | 255246003, 255247007, 255248002 |
item.item.answerOption.valueCoding |
The canonical URL is https://dhp.uz/fhir/integrations/Questionnaire/hepatitis-questionnaire. The medications question is enabled when hx-tx-hcv-hbv is true. Trimester choices are inline answer options, not a separate value set.
QuestionnaireResponse links the completed assessment to its questionnaire and patient. Item linkId values preserve the questionnaire hierarchy and identify the questions being answered.
Profile: HepatitisQuestionnaireResponse
Example: example-hcv-response
| What is recorded | Terminology | Example code or value | Where it is stored |
|---|---|---|---|
| Identifier | - | 6f9b9d8e-3b7d-4d87-8f6e-123456789abc |
identifier.value |
| Response status | QuestionnaireResponseStatus | completed |
status |
| Questionnaire | - | hepatitis-questionnaire | questionnaire |
| Patient | - | hepatitis-patient-example | subject |
| Author | - | example-hepatologist-role | author |
| Authored time | - | 2026-09-18T10:15:00+05:00 |
authored |
| Previous treatment | - | true |
item.item.answer.valueBoolean |
| Medication history | - | Sofosbuvir + Daclatasvir |
item.item.answer.valueString |
| Pregnancy trimester | SNOMED CT | 255246003 |
item.item.answer.valueCoding |
The profile constrains subject to HepatitisPatient, author to UZCorePractitionerRole, source to UZCoreRelatedPerson, and partOf to UZCoreSocioeconomicObservation. The example uses the same patient and clinician as the care episode. Answers are nested under groups (item.item.answer); the profile permits boolean, string, and Coding answers at both levels. The medication text is an example response, not a treatment recommendation.
PractitionerRole connects the clinician to the organization. These resources are referenced by the care episode, visit, diagnosis, and observations.
| Resource | Example | Role |
|---|---|---|
| PractitionerRole | example-hepatologist-role | Hepatologist at the provider organization |
| Practitioner | example-hepatologist | Clinician referenced by PractitionerRole |
| Organization | samarkand-infectious-hospital | Care provider and managing organization |