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
На этой странице представлены переводы с языка оригинала, на котором былонаписано руководство. Информацию об этих переводах и инструкции попредоставлению отзывов о переводах можно найти здесь.
Машинный перевод, требуется проверка человеком. Эта страница автоматически переведена с английского языка с помощью искусственного интеллекта и пока не проверена редактором. При любых расхождениях приоритет имеет оригинальная англоязычная версия.
На этой странице описано, как листок нетрудоспособности (ЛН) представляется в виде ресурсов FHIR.
Листок нетрудоспособности фиксирует период временной нетрудоспособности пациента: на каком основании он выдан, лежащий в основе диагноз, как долго он действует, кто его выдал и жизненный цикл случая. Данные поступают из системы электронных медицинских документов и добавляются в DHP в виде отдельных, атомарных FHIR-ресурсов. Ресурсы соответствуют профилям листка нетрудоспособности, ссылки на которые приведены в каждом разделе, а в остальных случаях - UZ Core или стандартным профилям FHIR.
Большинство понятий, которые несёт листок нетрудоспособности, специфичны для узбекского документа (основание, категория, городская принадлежность, место происшествия, степень родства, нарушения режима, заключения) и не имеют стандартных эквивалентов, поэтому они используют локальные коды, хранящиеся в собственной CodeSystem с узбекскими, русскими и английскими обозначениями. Там, где существует стандартное понятие, оно используется напрямую: SNOMED CT для кода наблюдения, ICD-10 для диагноза, HL7 request-status для статуса жизненного цикла и HL7 v3-ActCode для режима лечения - каждое доступно через справочник, привязанный к соответствующему полю. В каждом разделе ниже приведены управляющий профиль, конкретный пример ресурса и таблица со справочником и примером кода для каждого поля, содержащего код.
Типичная запись связывает воедино: случай нетрудоспособности, который и является самим листком, дополнительные атрибуты, зафиксированные по нему, и - для листков по уходу за членом семьи - лицо, за которым осуществляется уход. Случай указывает пациента, которому выдан листок, и медицинских работников, которые его выдали.
Сам листок. CarePlan представляет случай нетрудоспособности на протяжении всего его жизненного цикла; addresses содержит и основание для выдачи листка, и диагноз по ICD-10, а статус жизненного цикла отслеживается в расширении workflow-status.
Профиль: SickLeaveCarePlan
Пример: SickLeaveCarePlanExample
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Номер листка | - | 01ТШ 005591125 |
identifier[series] |
| Категория | SickLeaveCategoryVS | sick-leave-category-cs#mserv-0005-00001 (Лист нетрудоспособности) |
category |
| Основание | CarePlanReasonVS | care-plan-reason-cs#emdoc-0001-0001 (заболевание) |
addresses[reason] |
| Диагноз (ICD-10) | ICD10VS | ICD-10#J11.0 |
addresses[diagnosis] |
| Статус жизненного цикла | CarePlanStatusVS | request-status#completed (Закрыт) |
extension[workflowStatus] + базовый status (заполняются оба) |
| История статусов | CarePlanStatusVS | по одной записи на каждый прошедший статус с периодом его действия | extension[statusHistory] |
| Тип диагноза | diagnosis-type-vs | diagnosis-type-cs#gencl-0001-00008 (заключительный диагноз) |
extension[diagnosisUse] |
| Дата открытия | - | 2025-08-20 |
created |
| Период действия | - | с 2025-08-20 по 2025-08-24 |
period |
| Выдавший врач | - | ссылка на Practitioner | contributor |
| Заведующий отделением | - | ссылка на Practitioner | custodian |
| Пациент | - | ссылка на Patient | subject |
| Лицо, за которым осуществляется уход | - | ссылка на RelatedPerson | extension[relatedPerson] |
Основание и диагноз различаются по кодовой системе, из которой они берутся: основания - из care-plan-reason-cs, диагнозы - из ICD-10. extension[relatedPerson] и extension[diagnosisUse] заполняются только тогда, когда это уместно (уход за членом семьи и типизация диагноза соответственно). Как записывается статус жизненного цикла случая, описано далее.
Случай нетрудоспособности проходит несколько шагов рабочего процесса между открытием и закрытием. Каждая запись содержит оба статуса одновременно: укрупнённый стандартный CarePlan.status, которого требует FHIR - draft, active, revoked, completed, entered-in-error - и точный узбекский шаг рабочего процесса в extension[workflowStatus], который в этом профиле обязателен (1..1) и поэтому всегда заполнен. Оба берут коды из CarePlanStatusVS, который объединяет стандартные коды request-status с локальными шагами care-plan-status-local-cs. Когда текущий шаг является одним из пяти стандартных состояний, workflowStatus просто повторяет стандартный код; более детальные шаги (отправлен на утверждение, возвращён, направлен во ВТЭК, дополнен данными ВТЭК, продлён) не имеют стандартного эквивалента и присутствуют только в workflowStatus.
Каждый workflowStatus сопоставляется ровно с одним стандартным status, поэтому потребитель, игнорирующий расширение, всё равно прочитает корректное укрупнённое состояние. Полное сопоставление:
| Шаг рабочего процесса | workflowStatus |
status (базовый) |
|---|---|---|
| Черновик | request-status#draft |
draft |
| Открыт / действует | request-status#active |
active |
| Деактивирован | request-status#revoked |
revoked |
| Закрыт / завершён | request-status#completed |
completed |
| Введено по ошибке | request-status#entered-in-error |
entered-in-error |
| Отправлен на утверждение | care-plan-status-local-cs#emdoc-0002-0004 |
draft |
| Возвращён | care-plan-status-local-cs#emdoc-0002-0005 |
draft |
| Направлен во ВТЭК | care-plan-status-local-cs#emdoc-0002-0002 |
draft |
| Дополнен данными ВТЭК | care-plan-status-local-cs#emdoc-0002-0003 |
draft |
| Продлён | care-plan-status-local-cs#emdoc-0002-0001 |
active |
Локальные шаги сводятся к draft, пока листок ещё находится в работе (ожидает утверждения, возвращён на исправление, рассматривается ВТЭК); только Продлён сохраняет случай в состоянии active. Для пяти стандартных состояний status и workflowStatus содержат один и тот же код.
CarePlan.status и extension[workflowStatus] всегда содержат текущее состояние случая. При каждой смене статуса добавляется запись extension[statusHistory] для только что завершившегося шага - с его кодом и period, в течение которого он действовал - так что сохраняется вся хронология (отправлен на утверждение → открыт → закрыт). В примере эта история записана.
Дополнительные атрибуты, которые несёт листок нетрудоспособности помимо самого случая - городская принадлежность, место происшествия, режим лечения, нарушения режима, заключения и так далее - фиксируются как единый Observation, который связан с CarePlan через basedOn. Каждый атрибут - это один component, определяемый своим кодом из SickLeaveComponentVS; тип значения различается в зависимости от компонента (кодируемый, логический или dateTime).
Профиль: SickLeaveObservation
Пример: sickleave-observation-01
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| Код наблюдения | - | SNOMED CT#224459001 (On sick leave from work) |
code |
| Случай, к которому относится | - | ссылка на SickLeaveCarePlan | basedOn |
| Городская принадлежность | CarePlanBelongingVS | care-plan-belonging-cs#emdoc-0003-0001 (городская принадлежность) |
component[cityBelonging] |
| Место происшествия | PlaceOfIncidentVS | place-of-incident-cs#emdoc-0004-0002 (в повседневной жизни) |
component[placeOfIncident] |
| Прибыл из другого города | - | false (boolean) |
component[fromAnotherCity] |
| Инфекционный контакт | - | false (boolean) |
component[infectiousContact] |
| Степень родства | RelationDegreeVS | relation-degree-cs#emdoc-0005-0001 (мать) |
component[kinshipDegree] |
| Режим лечения | EncounterClassVS | v3-ActCode#AMB (амбулаторный) |
component[regime] |
| Нарушение режима | RegimenViolationVS | regimen-violation-cs#emdoc-0007-0005 (другие нарушения) |
component[regimenViolation] |
| Дата временного перевода на другую работу | - | 2025-08-25 (dateTime) |
component[tempJobTransfer] |
| Заключения | ConclusionsVS | conclusions-cs#emdoc-0008-0001 |
component[conclusions] |
| Дата верификации | - | 2025-08-22 (dateTime) |
component[verificationDate] |
Режим лечения использует HL7 v3-ActCode (AMB, IMP) там, где стандарт подходит, и добавляет локальные коды для режимов, которые стандарт не покрывает (например, санаторный); все остальные кодируемые компоненты используют локальный код, поскольку эти понятия специфичны для узбекского листка. Компоненты необязательны - заполняйте только те, которые записаны в листке.
Когда листок нетрудоспособности выдан для ухода за больным членом семьи (например, за ребёнком до 14 лет или ребёнком-инвалидом), лицо, за которым осуществляется уход, записывается как RelatedPerson, связанный со случаем через extension[relatedPerson].
Профиль: SickLeaveRelatedPerson
Пример: relatedperson-01, на который ссылается случай ухода за членом семьи SickLeaveFamilyCareExample через extension[relatedPerson]
| Записываемая информация | Справочник | Пример кода | Где хранится |
|---|---|---|---|
| ФИО | - | Boltayev Damir Ketmonovich |
name |
| Пол | administrative-gender | male |
gender |
Уточнение пола (когда other) |
gender-other-vs | - | gender.extension[otherGender] |
| Дата рождения | - | 1950-01-01 |
extension[birthdate] |
| Пациент, за которым осуществляется уход | - | ссылка на Patient | patient |
gender.extension[otherGender] используется только для уточнения административного пола, когда gender имеет значение other.
На эти ресурсы ссылаются записи выше. subject ограничен профилем UZ Core Patient; ссылки на медицинских работников не профилированы, а contributor / custodian также допускают PractitionerRole, Organization или CareTeam.
| Ресурс | Как указывается | Пример | Роль |
|---|---|---|---|
| Patient | UZCorePatient | example | Лицо, которому выдан листок нетрудоспособности (subject) |
| Practitioner | Practitioner (или PractitionerRole / Organization / CareTeam) |
examplePractitioner | Врач, выдавший листок (contributor) |
| Practitioner | Practitioner (или PractitionerRole / Organization / CareTeam) |
exampleCustodian | Заведующий отделением, ответственный за листок (custodian) |