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

Руководство к использованию стандарта FHIR в ЦИСЗ - Local Development build (v0.1.1558) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Home

Официальный URL: https://fhir.by/ImplementationGuide/fhir.by Version: 0.1.1558
Draft as of 2024-08-22 Имя: fhirby

Введение

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

  • структурирования медицинских данных, связанных с системой здравоохранения;
  • обмена указанных медицинских данных между различными участниками системы здравоохранения.

Стандарт FHIR предназначен для:

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

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

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

Использование стандарта FHIR в ЦИСЗ

Стандарт FHIR в ЦИСЗ используется в целях:

  • описание модели медицинских данных о пациенте;
  • определения порядка и правил взаимодействия с ЦИСЗ.

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

  • структурирования медицинских данных, используемых в системе здравоохранения Республики Беларусь;
  • определения типов указанных медицинских данных и их правил использования в зависимости от практики и требований законодательства системы здравоохранения Республики Беларусь;
  • регламентирования порядка обмена медицинскими данными между ЦИСЗ и МИС участников системы здравоохранения Республики Беларусь.

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

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

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

Например:

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

В МИС создался пакет медицинских данных в виде FHIR-ресурса Bundle, со следующими ресурсами: Patient (пациент), Organization (Организация), Encounter (Встреча), Observation (Жизненно важные показатели) и Condition (Диагноз). Сформированный пакет медицинских данных создался в МИС в виде JSON-схемы.

Например:

{
    "resourceType": "Bundle",
    "id": "ExampleBundleMedicationDocument",
    "meta": {
        "profile": [
            "https://fhir.by/AbstractArea/StructureDefinition/Bundle/MedicationDocument"
        ]
    },
    "identifier": {
        "system": "urn:ietf:rfc:3986",
        "value": "urn:uuid:0c3151bd-1cbf-4d64-b04d-cd9187a4c6e0"
    },
    "type": "document",
    "timestamp": "2024-05-28T22:12:21Z",
    "entry": [
        {
            "fullUrl": "Composition/CompDocument01",
            "resource": {
                "resourceType": "Composition",
                "id": "CompDocument01",
                "meta": {
                    "profile": [
                        "https://fhir.by/StructureDefinition/CompDocument"
                    ]
                },
                "status": "final",
                "type": {
                    "coding": [
                        {
                            "system": "http://loinc.org",
                            "code": "28655-9"
                        }
                    ],
                    "text": "Discharge Summary from Responsible Clinician"
                },
                "subject": [
                    {
                        "reference": "Patient/Patient01",
                        "display": "Петр Иванович Иванов"
                    }
                ],
                "date": "2013-02-01T12:30:02Z",
                "author": [
                    {
                        "reference": "Practitioner/Practitioner01",
                        "display": "Павлов Петр Иванович"
                    }
                ],
                "title": "Discharge Summary",
                "custodian": {
                    "reference": "Organization/OrganizationBy01"
                }
            }
        },
        {
            "fullUrl": "Patient/Patient01",
            "resource": {
                "resourceType": "Patient",
                "id": "Patient01",
                "meta": {
                    "profile": [
                        "https://fhir.by/StructureDefinition/PatientWithIdentificationNumber"
                    ]
                },
                "identifier": [
                    {
                        "type": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSDocNumbersBy",
                                    "code": "INP"
                                }
                            ]
                        },
                        "value": "3310587a067pb8",
                        "period": {
                            "start": "2024-12-31"
                        }
                    }
                ],
                "active": true,
                "name": [
                    {
                        "family": "Иванов",
                        "given": [
                            "Петр",
                            "Иванович"
                        ],
                        "period": {
                            "start": "2024-12-31"
                        }
                    }
                ],
                "telecom": [
                    {
                        "system": "phone",
                        "value": "89001234567"
                    }
                ],
                "gender": "male",
                "birthDate": "1990-12-31",
                "deceasedBoolean": false,
                "address": [
                    {
                        "city": " Minsk",
                        "state": "Minskaya oblast",
                        "country": "BY"
                    }
                ]
            }
        },
        {
            "fullUrl": "Practitioner/Practitioner01",
            "resource": {
                "resourceType": "Practitioner",
                "id": "Practitioner01",
                "meta": {
                    "profile": [
                        "https://fhir.by/StructureDefinition/PractitionerBy"
                    ]
                },
                "identifier": [
                    {
                        "type": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSDocNumbersBy",
                                    "code": "INP"
                                }
                            ]
                        },
                        "value": "3310587a067pb8"
                    }
                ],
                "name": [
                    {
                        "family": "Павлов",
                        "given": [
                            "Петр",
                            "Иванович"
                        ]
                    }
                ],
                "deceasedBoolean": false
            }
        },
        {
            "fullUrl": "RelatedPerson/RelatedPerson01",
            "resource": {
                "resourceType": "RelatedPerson",
                "id": "RelatedPerson01",
                "meta": {
                    "profile": [
                        "https://fhir.by/StructureDefinition/RelatedPersonPermanentBy"
                    ]
                },
                "identifier": [
                    {
                        "type": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSDocNumbersBy",
                                    "code": "INP"
                                }
                            ]
                        },
                        "value": "33100587A067PB8",
                        "period": {
                            "start": "2024-12-31"
                        }
                    }
                ],
                "active": true,
                "patient": {
                    "reference": "Patient/Patient01"
                },
                "relationship": [
                    {
                        "coding": [
                            {
                                "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                                "code": "WIFE"
                            }
                        ]
                    }
                ],
                "name": [
                    {
                        "family": "Иванова",
                        "given": [
                            "Анна",
                            "Васильевна"
                        ]
                    }
                ],
                "telecom": [
                    {
                        "system": "phone",
                        "value": "89001234567"
                    }
                ],
                "gender": "female",
                "birthDate": "1990-12-31"
            }
        },
        {
            "fullUrl": "Organization/OrganizationBy01",
            "resource": {
                "resourceType": "Organization",
                "id": "OrganizationBy01",
                "meta": {
                    "profile": [
                        "https://fhir.by/StructureDefinition/OrganizationBy"
                    ]
                },
                "extension": [
                    {
                        "url": "https://fhir.by/StructureDefinition/HealthCareLevel",
                        "valueCodeableConcept": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSHealthCareLevel",
                                    "code": "2"
                                }
                            ]
                        }
                    },
                    {
                        "url": "https://fhir.by/StructureDefinition/FormOfOwnership",
                        "valueCodeableConcept": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSOwnershipCodesOKFS0022019",
                                    "code": "110"
                                }
                            ]
                        }
                    },
                    {
                        "url": "https://fhir.by/StructureDefinition/RespondentRegistrationNumber",
                        "valueString": "123456789012"
                    },
                    {
                        "url": "https://fhir.by/StructureDefinition/IsSubordinated",
                        "valueCodeableConcept": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSIsSubordinated",
                                    "code": "MZ"
                                }
                            ]
                        }
                    },
                    {
                        "url": "https://fhir.by/StructureDefinition/HigherLevelOrganization",
                        "valueCodeableConcept": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSHigherLevelOrganization",
                                    "code": "Comitet"
                                }
                            ]
                        }
                    },
                    {
                        "url": "https://fhir.by/StructureDefinition/TermsOfService",
                        "valueCodeableConcept": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSTermsOfService",
                                    "code": "ambulatory"
                                }
                            ]
                        }
                    },
                    {
                        "url": "https://fhir.by/StructureDefinition/TermsOfService",
                        "valueCodeableConcept": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSTermsOfService",
                                    "code": "daily"
                                }
                            ]
                        }
                    },
                    {
                        "url": "https://fhir.by/StructureDefinition/TermsOfService",
                        "valueCodeableConcept": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSTermsOfService",
                                    "code": "outside"
                                }
                            ]
                        }
                    },
                    {
                        "url": "https://fhir.by/StructureDefinition/TypeOfHealthCare",
                        "valueCodeableConcept": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSTypeOfHealthCare",
                                    "code": "primary"
                                }
                            ]
                        }
                    },
                    {
                        "extension": [
                            {
                                "url": "https://fhir.by/StructureDefinition/OrganizationRegistrationStart",
                                "valueDate": "2003-12-11"
                            },
                            {
                                "url": "https://fhir.by/StructureDefinition/OrganizationRegInRegistr",
                                "valueDate": "2003-12-11"
                            },
                            {
                                "url": "https://fhir.by/StructureDefinition/OrganizationActInRegistr",
                                "valueDateTime": "2024-05-07"
                            }
                        ],
                        "url": "https://fhir.by/StructureDefinition/OrganizationRegistration"
                    },
                    {
                        "url": "https://fhir.by/StructureDefinition/TypeOfOrganization",
                        "valueCodeableConcept": {
                            "coding": [
                                {
                                    "system": "https://fhir.by/CodeSystem/CSTypeOfOrganization",
                                    "code": "ambulatory"
                                }
                            ]
                        }
                    }
                ],
                "identifier": [
                    {
                        "system": "https://egr.gov.by/",
                        "value": "190503864",
                        "period": {
                            "start": "2003-12-11"
                        }
                    }
                ],
                "active": true,
                "name": "учреждение здравоохранения «1-я центральная районная клиническая поликлиника Центрального района г. Минска»",
                "alias": [
                    "УЗ 1-я ЦРП г. Минска"
                ],
                "contact": [
                    {
                        "telecom": [
                            {
                                "system": "phone",
                                "value": "+375172001896"
                            },
                            {
                                "system": "url",
                                "value": "1crp.by"
                            }
                        ],
                        "address": {
                            "extension": [
                                {
                                    "url": "https://fhir.by/StructureDefinition/CodeSDATO",
                                    "valueString": "123456789012"
                                }
                            ],
                            "line": [
                                "г.Минск, ул.Сухая 6, ст.м.Фрунзенская"
                            ],
                            "postalCode": "220004"
                        }
                    }
                ]
            }
        },
        {
            "fullUrl": "Encounter/ExampleEncounterGeneral01",
            "resource": {
                "resourceType": "Encounter",
                "id": "ExampleEncounterGeneral01",
                "meta": {
                    "profile": [
                        "https://fhir.by/StructureDefinition/EncounterGeneral"
                    ]
                },
                "status": "completed",
                "class": [
                    {
                        "coding": [
                            {
                                "system": "https://fhir.by/CodeSystem/CSTermsOfService",
                                "code": "ambulatory"
                            }
                        ]
                    }
                ],
                "priority": {
                    "coding": [
                        {
                            "system": "https://fhir.by/CodeSystem/CSHealthCareForms",
                            "code": "emergency"
                        }
                    ]
                },
                "type": [
                    {
                        "coding": [
                            {
                                "system": "https://fhir.by/CodeSystem/CSTypeOfHealthCare",
                                "code": "primary"
                            }
                        ]
                    }
                ],
                "subject": {
                    "reference": "Patient/Patient01",
                    "display": "Петр Сидорович Иванов"
                },
                "participant": [
                    {
                        "actor": {
                            "reference": "Practitioner/Practitioner01"
                        }
                    }
                ],
                "actualPeriod": {
                    "start": "2024-05-28T22:12:21Z",
                    "end": "2024-05-28T22:24:21Z"
                },
                "diagnosis": [
                    {
                        "condition": [
                            {
                                "reference": {
                                    "reference": "Condition/ExampleDiagnosisVeins01"
                                }
                            }
                        ],
                        "use": [
                            {
                                "coding": [
                                    {
                                        "system": "https://fhir.by/CodeSystem/CSTypeOfDiagnosis",
                                        "code": "mainDiagnosis"
                                    }
                                ]
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

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

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

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

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

Пример в виде postman коллекций

Ссылка Описание
Скачать Переменные ЦИСЗ.
Скачать Пример взаимодействия с ЦИСЗ
Скачать Коллекция “Проверка пакета медицинских данных без импорта информации”.
Скачать Коллекция “Получение возможностей сервера”