Руководство к использованию стандарта FHIR в ЦИСЗ
0.2.6803 - ci-build

FHIR BY

Официальный URL: https://fhir.by/ImplementationGuide/fhir.by
Draft as of 2026-06-25 Имя: fhirby

Общие сведения

Настоящий интернет-ресурс является руководством по взаимодействию с централизованной информационной системой здравоохранения (далее – ЦИСЗ).

ЦИСЗ – интегрированная информационная система, обеспечивающая централизованное хранение и обработку медицинской информации в области здравоохранения, включая базы (банки) данных, реестры (регистры) в здравоохранении, информационное взаимодействие и доступ в установленном порядке пользователей ЦИСЗ к указанной информации.

Информационное взаимодействие с ЦИСЗ осуществляется по стандарту обмена медицинской информацией HL7 FHIR.

Использование стандарта обмена медицинской информацией FHIR в ЦИСЗ

Стандарт HL7 FHIR в ЦИСЗ предназначен для:

  • упорядочивания и структурирования медицинских данных;

  • определения типов медицинских данных и правил их заполнения в зависимости от случаев системы здравоохранения;

  • установления порядка обмена медицинскими данными между участниками информационного взаимодействия с ЦИСЗ.

При использовании в ЦИСЗ стандарта HL7 FHIR применяется следующая терминология:

  • Ресурс (Resource) – единица медицинских данных, связанная с системой здравоохранения (например, ресурс «Пациент», «Организация» или «Врач»);

  • Профиль (Profile) – тип медицинских данных с определенной структурой и их правилами использования (например, профиль «Анонимный пациент», «Пациент с идентификационным номером» или «Пациент без идентификационного номера»);

  • Правила заполнения (StructureDefinition) – элементы типа медицинских данных и правила их заполнения (например, профиль «Пациент с идентификационным номером» должен содержать такой элемент как «идентификатор», который является обязательным к заполнению и принимает только одно значение);

  • Справочник (ValueSet) – определенный набор значений элемента медицинских данных (например, элемент «Тип медицинской организации» в профиле «Учреждение здравоохранения» может принимать одно из следующих значений: больница, госпиталь, хоспис, поликлиника и пр.).

Порядок информационного взаимодействия с ЦИСЗ (на примере использования стандарта FHIR)

Программные интерфейсы ЦИСЗ защищены сервером авторизации с использованием технологии OAuth 2.0 (см. вкладку “Авторизация в ЦИСЗ”). При каждом вызове методов ЦИСЗ клиентское приложение должно передавать токен доступа в заголовке запроса.

Без авторизации клиентского приложения в ЦИСЗ доступны:

Взаимодействие между локальными или облачными медицинскими информационными системами (далее - МИС) и ЦИСЗ при обмене медицинскими данными осуществляется путем передачи из МИС сформированного пакета медицинских данных о пациенте в ЦИСЗ с помощью метода импорта пакета медицинских данных в ЦИСЗ в виде электронного документа.

Для начала взаимодействия с ЦИСЗ МИС необходимо сформировать пакет медицинских данных.

Сформированный МИС пакет медицинских данных должен представлять собой набор медицинских данных о пациенте, включая сведения о медицинском наблюдении за пациентом и услугах, предоставленных пациенту. Пакет медицинских данных должен быть сформирован в виде FHIR-ресурса Bundle в формате JSON на основании сведений, внесенных медицинским работником в МИС.

Например:

Иванов Иван Иванович заболел, записался на прием к врачу и в назначенное время приехал в учреждение здравоохранения.
В учреждении здравоохранения его принял врач - Сидорова Ольга Викторовна. В ходе приема врач уточнил персональные данные пациента, оценил его жизненно важные показатели (измерил температуру тела и артериальное давление), выставил диагноз и назначил лечение. Все эти данные врач внес в МИС.
img
img

МИС сформировала пакет медицинских данных в виде FHIR-ресурса Bundle в формате JSON-схемы со следующими ресурсами:

  • Patient (пациент);
  • Encounter (Встреча);
  • Observation (Жизненно важные показатели);
  • Condition (Диагноз).

Например:

{ "resourceType": "Bundle", "id": "BundleFull", "meta": { "profile": [ "https://fhir.by/AbstractArea/StructureDefinition/Bundle/MedicationDocument" ] }, "identifier": { "system": "https://fhir.by/ValueSet/urn:ietf:rfc:3986", "value": "urn:uuid:0c3151bd-1cbf-4d64-b04d-cd9187a4c6t9" }, "type": "document", "timestamp": "2024-04-07T11:12:21Z", "entry": [ { "fullUrl": "Composition/CompositionFullBundle", "resource": { "resourceType": "Composition", "id": "CompositionFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/CompDocument" ] }, "status": "registered", "type": { "coding": [ { "system": "https://fhir.by/ValueSet/CompositionType", "code": "general", "display": "Общая медицинская информация" } ] }, "subject": [ { "reference": "Patient/PatientFullBundle" } ], "encounter": { "reference": "Encounter/EncounterFullBundle" }, "date": "2024-04-07T11:12:21Z", "author": [ { "reference": "Practitioner/ExampleDoctor" } ], "title": "CompDocument для наполненного Bundle", "custodian": { "reference": "Organization/OrganizationCISM" }, "event": [ { "detail": [ { "reference": { "reference": "Condition/DiagnosisrFullBundle" } } ] }, { "detail": [ { "reference": { "reference": "Observation/HeightFullBundle" } } ] }, { "detail": [ { "reference": { "reference": "Observation/WeightFullBundle" } } ] }, { "detail": [ { "reference": { "reference": "Observation/BMIFullBundle" } } ] }, { "detail": [ { "reference": { "reference": "Observation/ArterialBloodPressureFullBundle" } } ] }, { "detail": [ { "reference": { "reference": "Observation/HeartRateFullBundle" } } ] }, { "detail": [ { "reference": { "reference": "Observation/TemperatureFullBundle" } } ] } ] } }, { "fullUrl": "Patient/PatientFullBundle", "resource": { "resourceType": "Patient", "id": "PatientFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/PatientWithIdentificationNumber" ] }, "identifier": [ { "type": { "coding": [ { "system": "https://fhir.by/ValueSet/PersonalDocumentType", "code": "INP" } ] }, "value": "7001112A009PB3", "period": { "start": "2024-01-31" } }, { "extension": [ { "extension": [ { "url": "https://fhir.by/StructureDefinition/PassportIssuedString", "valueString": "Центральным РУВД г Минска, 11.08.2021" }, { "url": "https://fhir.by/StructureDefinition/PassportIssuedDate", "valueDate": "2021-08-11" }, { "url": "https://fhir.by/StructureDefinition/PassportIssuedCode", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/OCAM", "code": "106" } ] } } ], "url": "https://fhir.by/StructureDefinition/PassportIssued" } ], "use": "usual", "type": { "coding": [ { "system": "https://fhir.by/ValueSet/PersonalDocumentType", "code": "Passport-RB" } ] }, "value": "MP1234579" } ], "active": true, "name": [ { "family": "Иванов", "given": [ "Василий", "Васильевич" ], "period": { "start": "2024-01-31" } } ], "telecom": [ { "system": "phone", "value": "89001234567" } ], "gender": "male", "birthDate": "1989-01-31", "deceasedBoolean": false, "address": [ { "extension": [ { "url": "https://fhir.by/StructureDefinition/CoutryForAddresses", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/CitizenshipCode", "code": "BY", "display": "Беларусь" } ] } }, { "url": "https://fhir.by/StructureDefinition/StreetGeoRegistry", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/StreetGeoRegistry", "code": "72609920778", "display": "Переулок Снежный" } ] } }, { "url": "https://fhir.by/StructureDefinition/ApartmetnRoom", "valueString": "кв. 11" } ], "use": "home", "text": "Могилевская область, г.Могилев, Переулок Гоголя, д.19", "postalCode": "212011" } ] } }, { "fullUrl": "Encounter/EncounterFullBundle", "resource": { "resourceType": "Encounter", "id": "EncounterFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/EncounterGeneral" ] }, "status": "completed", "class": [ { "coding": [ { "system": "https://fhir.by/ValueSet/VSTermsOfService", "code": "1" } ] } ], "priority": { "coding": [ { "system": "https://fhir.by/ValueSet/HealthCareForms", "code": "emergency" } ] }, "type": [ { "coding": [ { "system": "https://fhir.by/ValueSet/TypeOfHealthCare", "code": "primary" } ] } ], "subject": { "reference": "Patient/PatientFullBundle", "display": "Иванов Иван Иванович" }, "serviceProvider": { "reference": "Organization/OrganizationCISM" }, "participant": [ { "actor": { "reference": "PractitionerRole/ExampleTherapist", "display": "Филатов Олег Михайлович" } } ], "actualPeriod": { "start": "2024-04-07T11:12:21Z", "end": "2024-04-07T11:25:21Z" }, "diagnosis": [ { "condition": [ { "reference": { "reference": "Condition/DiagnosisrFullBundle" } } ], "use": [ { "coding": [ { "system": "https://fhir.by/ValueSet/TypeOfDiagnosis", "code": "mainDiagnosis" } ] } ] } ] } }, { "fullUrl": "Condition/DiagnosisrFullBundle", "resource": { "resourceType": "Condition", "id": "DiagnosisrFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/FinalDiagnosis" ] }, "extension": [ { "url": "https://fhir.by/StructureDefinition/KindOfDiagnosis", "valueCodeableConcept": { "coding": [ { "system": "https://fhir.by/ValueSet/KindOfDiagnosisCode", "code": "Final" } ] } }, { "url": "https://fhir.by/StructureDefinition/AssertedDate", "valueDateTime": "2024-04-07" } ], "clinicalStatus": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/condition-clinical", "code": "active" } ] }, "code": { "coding": [ { "system": "https://fhir.by/ValueSet/InternClassificDiseases10", "code": "E11" } ], "text": "E11 - Сахарный диабет 2 типа" }, "subject": { "reference": "Patient/PatientFullBundle", "display": "Иванов Иван Иванович" }, "onsetDateTime": "2024-04-07", "recordedDate": "2024-04-07", "participant": [ { "actor": { "reference": "PractitionerRole/ExampleTherapist", "display": "Филатов Олег Михайлович" } } ] } }, { "fullUrl": "Observation/HeightFullBundle", "resource": { "resourceType": "Observation", "id": "HeightFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/AnthropometricDataBy" ] }, "status": "registered", "category": [ { "coding": [ { "code": "exam", "userSelected": false } ] } ], "code": { "coding": [ { "system": "https://fhir.by/ValueSet/AnthropoMetricCodes", "code": "body-height" } ] }, "subject": { "reference": "Patient/PatientFullBundle", "display": "Иванов Иван Иванович" }, "encounter": { "reference": "Encounter/EncounterFullBundle" }, "effectiveDateTime": "2024-04-07T11:12:21Z", "performer": [ { "reference": "PractitionerRole/ExampleTherapist", "display": "Филатов Олег Михайлович" } ], "valueQuantity": { "value": 180, "unit": "cm", "system": "http://unitsofmeasure.org", "code": "cm" } } }, { "fullUrl": "Observation/WeightFullBundle", "resource": { "resourceType": "Observation", "id": "WeightFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/AnthropometricDataBy" ] }, "status": "registered", "category": [ { "coding": [ { "code": "exam", "userSelected": false } ] } ], "code": { "coding": [ { "system": "https://fhir.by/ValueSet/AnthropoMetricCodes", "code": "body-weight" } ] }, "subject": { "reference": "Patient/PatientFullBundle", "display": "Иванов Иван Иванович" }, "encounter": { "reference": "Encounter/EncounterFullBundle" }, "effectiveDateTime": "2024-04-07T11:12:21Z", "performer": [ { "reference": "PractitionerRole/ExampleTherapist", "display": "Филатов Олег Михайлович" } ], "valueQuantity": { "value": 90, "unit": "kg", "system": "http://unitsofmeasure.org", "code": "kg" } } }, { "fullUrl": "Observation/BMIFullBundle", "resource": { "resourceType": "Observation", "id": "BMIFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/AnthropometricDataBy" ] }, "status": "registered", "category": [ { "coding": [ { "code": "exam", "userSelected": false } ] } ], "code": { "coding": [ { "system": "https://fhir.by/ValueSet/AnthropoMetricCodes", "code": "body-mass-index" } ] }, "subject": { "reference": "Patient/PatientFullBundle", "display": "Иванов Иван Иванович" }, "encounter": { "reference": "Encounter/EncounterFullBundle" }, "effectiveDateTime": "2024-04-07T11:12:21Z", "performer": [ { "reference": "PractitionerRole/ExampleTherapist", "display": "Филатов Олег Михайлович" } ], "valueQuantity": { "value": 30 } } }, { "fullUrl": "Observation/ArterialBloodPressureFullBundle", "resource": { "resourceType": "Observation", "id": "ArterialBloodPressureFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/VitalSignsBy" ] }, "status": "registered", "category": [ { "coding": [ { "code": "vital-signs", "userSelected": false } ] } ], "code": { "coding": [ { "system": "https://fhir.by/ValueSet/VitalSignsCodes", "code": "arterial-blood-pressure" } ] }, "subject": { "reference": "Patient/PatientFullBundle", "display": "Иванов Иван Иванович" }, "encounter": { "reference": "Encounter/EncounterFullBundle" }, "effectiveDateTime": "2024-04-07T11:12:21Z", "performer": [ { "reference": "PractitionerRole/ExampleTherapist", "display": "Филатов Олег Михайлович" } ], "component": [ { "code": { "coding": [ { "system": "https://fhir.by/ValueSet/VitalSignsCodes", "code": "systolic-arterial-blood-pressure" } ] }, "valueQuantity": { "value": 140, "unit": "mm[Hg]", "system": "http://unitsofmeasure.org", "code": "mm[Hg]" } }, { "code": { "coding": [ { "system": "https://fhir.by/ValueSet/VitalSignsCodes", "code": "diastolic-arterial-blood-pressure" } ] }, "valueQuantity": { "value": 95, "unit": "mm[Hg]", "system": "http://unitsofmeasure.org", "code": "mm[Hg]" } } ] } }, { "fullUrl": "Observation/HeartRateFullBundle", "resource": { "resourceType": "Observation", "id": "HeartRateFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/VitalSignsBy" ] }, "status": "registered", "category": [ { "coding": [ { "code": "vital-signs", "userSelected": false } ] } ], "code": { "coding": [ { "system": "https://fhir.by/ValueSet/VitalSignsCodes", "code": "heart-rate" } ] }, "subject": { "reference": "Patient/PatientFullBundle", "display": "Иванов Иван Иванович" }, "encounter": { "reference": "Encounter/EncounterFullBundle" }, "effectiveDateTime": "2024-04-07T11:12:21Z", "performer": [ { "reference": "PractitionerRole/ExampleTherapist", "display": "Филатов Олег Михайлович" } ], "valueQuantity": { "value": 80, "unit": "/min", "system": "http://unitsofmeasure.org", "code": "/min" } } }, { "fullUrl": "Observation/TemperatureFullBundle", "resource": { "resourceType": "Observation", "id": "TemperatureFullBundle", "meta": { "profile": [ "https://fhir.by/StructureDefinition/VitalSignsBy" ] }, "status": "registered", "category": [ { "coding": [ { "code": "vital-signs", "userSelected": false } ] } ], "code": { "coding": [ { "system": "https://fhir.by/ValueSet/VitalSignsCodes", "code": "body-temperature" } ] }, "subject": { "reference": "Patient/PatientFullBundle", "display": "Иванов Иван Иванович" }, "encounter": { "reference": "Encounter/EncounterFullBundle" }, "effectiveDateTime": "2024-04-07T11:12:21Z", "performer": [ { "reference": "PractitionerRole/ExampleTherapist", "display": "Филатов Олег Михайлович" } ], "valueQuantity": { "value": 36.5, "unit": "Cel", "system": "http://unitsofmeasure.org", "code": "Cel" } } } ] }

После формирования пакета медицинских данных осуществляется непосредственное взаимодействие МИС с ЦИСЗ путем передачи сформированного пакета медицинских данных из МИС с помощью метода импорта пакета медицинских данных в ЦИСЗ.

img

Получение МИС ОЗ медицинских данных о пациенте из ЦИСЗ осуществляется с помощью одного из следующих методов:

  • метод предоставления сводной информации о пациенте по идентификатору пациента;

  • метод предоставления заданной медицинской информации о пациенте по идентификатору ресурса;

  • метод поиска заданного типа медицинской информации о пациенте.

▲ Вверх