O‘zbekiston Raqamli sog‘liqni saqlash platformasi
0.10.0 - draft Uzbekistan bayroqcha

This page is part of the Uzbekistan Digital Health Platform (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

OperationDefinition: Populate a patient from state registries by identifier

Rasmiy URL: https://dhp.uz/fhir/core/OperationDefinition/patient-populate Versiya: 0.10.0
Draft 2026-08-13 holatiga ko‘ra Kompyuterda qayta ishlanadigan nom: PatientPopulate

Creates a Patient resource from an identity document, populating it with data from the state registries of natural persons. The operation takes the identifier as a system + code + value triple (with birthDate where needed), resolves it to a PINFL (NI), and retrieves the citizen's details by that PINFL. The operation is idempotent: if a Patient with that PINFL already exists in the system it is returned without calling any external source and without creating a duplicate; otherwise a new Patient resource is created with an assigned identifier and version. The operation is invoked at type level (Patient/$populate) with POST and a Parameters body. The response is the Patient resource itself, not Parameters.

Language: uz

URL: [base]/Patient/$populate

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INsystem1..1uri

Identification system of the document (Identifier.system). Permitted values: http://terminology.hl7.org/CodeSystem/v2-0203, https://dhp.uz/fhir/core/sid/pid/uz/ni (PINFL), https://dhp.uz/fhir/core/sid/pid/uz/ppn/local (biometric passport / ID card), https://dhp.uz/fhir/core/sid/pid/uz/ppn/intl (international passport), https://dhp.uz/fhir/core/sid/pid/uz/bct (birth certificate). Passed as valueUri.

INcode1..1code

Document type: NI - PINFL, PPN - passport or ID card, BCT - birth certificate. Passed as valueCode.

INvalue1..1string

Document value: the PINFL for NI, the passport series and number for PPN, the birth certificate series and number for BCT. Passed as valueString.

INbirthDate0..1date

Date of birth in YYYY-MM-DD format. Mandatory when code is PPN, because the PINFL is resolved from the passport together with the date of birth. Optional for the other document types, where it is used as an additional matching criterion. Passed as valueDate.

OUTreturn1..1Patient

The Patient resource that was created, or the one that already existed, populated with data from the state registries.

The document codes NI (PINFL), PPN (passport / ID card) and BCT (birth certificate) are supported; the case of code does not matter. For NI the value is checked locally for correctness. For PPN the birthDate parameter is mandatory - the PINFL is resolved from the series and number together with the date of birth. For BCT the value is split into series and number, which resolve the PINFL. The system value must be one of the permitted identification systems; an unknown system or code results in an OperationOutcome with code invalid. The citizen's address is requested separately and is optional: if it is unavailable, the Patient is still created, but without address details. If the citizen is not found in the external registries, or the data retrieved is invalid, no resource is created and an error is returned. The operation follows the same model as Person/$populate.