Руководство к использованию стандарта FHIR в ЦИСЗ
0.2.6803 - ci-build
Руководство к использованию стандарта FHIR в ЦИСЗ
0.2.6803 - ci-build
Централизованная информационная система здравоохранения (ЦИСЗ) использует ресурс Patient стандарта FHIR для учёта пациентов. В версии 1.3 основным способом создания был импорт в составе пакета медицинской информации, а в версии 1.4 предпочтительным стал метод непосредственного создания и редактирования через HTTP POST. Оба способа поддерживаются, но для новых интеграций рекомендуется использовать POST.
Настоящая инструкция предназначена для трёх категорий пользователей:
Перед созданием нового пациента всегда следует выполнять поиск, чтобы избежать дублирования информации.
В случае, если пациент или его законный представитель предъявляет документ, удостоверяющий личность, содержащий ИН, следует использовать значение ИН как ключевой идентификатор для поиска.
Выполнение поиска:
Если пациент найден и его данные полностью совпадают с реальными, используйте найденного пациента для дальнейшей работы.
Для пациентов, у которых есть актуальный документ, содержащий ИН, необходимо использовать только профиль Пациент и в качестве ключевого идентификатора использовать ИН (INP).
На усмотрение клиента МИС возможно использование дополнительных идентификаторов UMD для идентификации медицинской карты в МИС. Такой идентификатор может быть создан для одного пациента в единичном экземпляре для одной организации. Иные идентификаторы (паспорт, свидетельство о рождении и прочее) могут быть использованы для сохранения информации, если это необходимо для оказания медицинской помощи.
Достоверность введённых данных является ответственностью работника.
Для случаев, когда ИН у пациента отсутствует или не доступен, следует выполнить поиск по полному совпадению ФИО и даты рождения из документа, удостоверяющего личность, со слов пациента или его представителя.
Выполнение поиска:
Если пациент найден, он один и его данные полностью совпадают с реальными, используйте найденного пациента для дальнейшей работы.
Если найдено несколько пациентов, следует сверить другие данные, такие как адрес, номер телефона, пол.
!!! Необходимо уточнить эту информацию у пациента и сравнить с полученными из ЦИСЗ данными, не следует предоставлять данные, которые были получены из ЦИСЗ для выбора пациенту.
В случае отсутствия в ЦИСЗ пациента с такими ФИО и датой рождения, приступайте к созданию нового пациента.
Для пациентов, у которых есть актуальный документ, содержащий идентификатор из следующего перечня:
необходимо использовать профиль Пациент без ИН, внести предоставленный идентификатор из документа и присвоить идентификатор UMD (ключевой). Такой идентификатор может быть создан в единичном экземпляре для одной организации.
Достоверность введённых данных является ответственностью работника.
Для создания пациента в случае анонимного обращения следует использовать профиль Анонимный пациент.
Такой пациент создаётся только на период оказания медицинской помощи анонимно, если это требуется для передачи информации с использованием ЦИСЗ (например, лабораторных, инструментальных исследований, стационарного лечения согласно НПА).
Данные заполняются со слов пациента, без внесения подлинных фамилии, собственного имени, отчества (если таковое имеется), места жительства (места пребывания) пациента в медицинские документы. Для такой записи необходимо использовать идентификатор, формируемый в МИС автоматически (уникальное значение для одной организации). Этот идентификатор может быть передан лицу в виде QR кода или в другом представлении для последующего получения результатов исследований и осмотров. ______________
В зависимости от ситуации пациент создаётся по одному из трёх профилей:
| Профиль | Когда использовать | Обязательные идентификаторы |
|---|---|---|
Пациент |
Гражданин РБ или иностранец, имеющий ИН | INP (уникальный) |
Пациент без ИН |
Лицо без ИН | UMD (уникальный в пределах организации) |
Анонимный пациент |
Анонимное обращение | ANO (уникальный в пределах организации) |
Общие правила заполнения (для всех профилей):
INP, UMD, FDN, ANO не могут быть изменены после создания;coding.display будут автоматически заменены на актуальные значения из подсистемы НСИ ЦИСЗ.
______________Создание нового пациента:
Запрос:
POST [FHIR_BASE]/Patient
Authorization: Bearer <токен_доступа>
Content-Type: application/fhir+json
Body: ресурс Patient (JSON)
Пример тела запроса для профиля Пациент (с ИН):
{
"resourceType": "Patient",
"meta": {
"profile": ["https://fhir.by/StructureDefinition/PatientWithIdentificationNumber"]
},
"identifier": [
{
"type": {
"coding": [
{
"system": "https://fhir.by/ValueSet/PersonalDocumentType",
"code": "INP"
}
]
},
"value": "1234567890123"
}
],
"name": [
{
"family": "Иванов",
"given": ["Иван", "Иванович"]
}
],
"gender": "male",
"birthDate": "1980-01-01",
"telecom": [
{
"system": "phone",
"value": "+375291234567"
}
]
}
Особенности:
id не заполняется (будет проигнорировано);meta.versionId и meta.lastUpdated игнорируются;201 Created и Parameters с полями:
ProcessingStatus = Created;ResourceId – внутренний id пациента в ЦИСЗ;Patient – созданный ресурс.Ответ (успех):
{
"resourceType": "Parameters",
"parameter": [
{ "name": "ProcessingStatus", "valueString": "Created" },
{ "name": "ResourceId", "valueString": "pa-123" },
{ "name": "Patient", "resource": { ... } }
]
}
Возможные ошибки:
400 Bad Request – невалидный ресурс, несоответствие профилю, ошибка верификации ИН;401/403 – проблемы авторизации;409 Conflict – идентификатор INP/UMD уже существует.Редактирование пациента (update):
Для изменения данных уже существующего пациента используйте тот же эндпоинт POST /Patient, но в теле запроса обязательно укажите:
meta.versionId (полученный при предыдущем чтении);INP, UMD).Пример запроса на редактирование:
{
"resourceType": "Patient",
"id": "pa-123",
"meta": {
"versionId": "5",
"profile": ["https://fhir.by/StructureDefinition/PatientWithIdentificationNumber"]
},
"identifier": [
{
"type": { "coding": [{"system": "https://fhir.by/ValueSet/PersonalDocumentType", "code": "INP"}] },
"value": "1234567890123"
}
],
"name": [ /* новые данные */ ],
...
}
Ответ (успех): 200 OK с ProcessingStatus = Updated.
Конфликт версий: если versionId не указан или устарел, ЦИСЗ вернёт 409 Conflict.
Поиск перед созданием/редактированием:
Рекомендуется сначала выполнить GET-запрос:
GET [FHIR_BASE]/Patient?identifier=1234567890123
или
GET [FHIR_BASE]/Patient?name=Иванов Иван&birthdate=1980-01-01
Если Bundle содержит ресурс – используйте его id и versionId.
Если ресурсы не найдены – создавайте нового пациента.
При использовании метода Импорта пакета медицинских данных о пациенте, ресурс пациента создаётся или редактируется через профиль Пациент, Пациент без ИН или Анонимный пациент.
Алгоритм:
Patient из ЦИСЗ (метод Получение информации о пациенте).Patient необходимого профиля.Patient в состав пакета (Bundle) вместе с другими ресурсами. Все ссылки на пациента внутри пакета должны указывать на Patient.id.Пример ресурса Patient:
{
"resourceType": "Patient",
"id": "0b2e6c9f-0f65-438d-83be-72d233a30f86",
"meta": {
"profile": [
"https://fhir.by/StructureDefinition/PatientWithIdentificationNumber"
]
},
"extension": [
{
"extension": [
{
"url": "https://fhir.by/StructureDefinition/ConsentPersonalDataBoolean",
"valueBoolean": true
},
{
"url": "https://fhir.by/StructureDefinition/ConsentPersonalDataPeriod",
"valuePeriod": {
"start": "2023-08-01"
}
}
],
"url": "https://fhir.by/StructureDefinition/ConsentPersonalData"
}
],
"identifier": [
{
"use": "usual",
"type": {
"coding": [
{
"system": "https://fhir.by/ValueSet/PersonalDocumentType",
"code": "INP"
}
]
},
"value": "6001112A009PB3"
},
{
{
"extension": [
{
"extension": [
{
"url": "https://fhir.by/StructureDefinition/PassportIssuedString",
"valueString": "Центральным РУВД г Минска, 14.03.2022"
},
{
"url": "https://fhir.by/StructureDefinition/PassportIssuedDate",
"valueDate": "2022-03-14"
},
{
"url": "https://fhir.by/StructureDefinition/PassportIssuedCode",
"valueCodeableConcept": {
"coding": [
{
"system": "https://fhir.by/ValueSet/OCAM",
"code": "710"
}
]
}
}
],
"url": "https://fhir.by/StructureDefinition/PassportIssued"
}
],
"use": "usual",
"type": {
"coding": [
{
"system": "https://fhir.by/ValueSet/PersonalDocumentType",
"code": "Passport-RB"
}
]
},
"value": "MP3334469"
}
],
"active": true,
"name": [
{
"family": "Юхо",
"given": [
"Татьяна",
"Викторовна"
]
}
],
"telecom": [
{
"system": "phone",
"value": "80332289767"
}
],
"gender": "female",
"birthDate": "1999-07-25",
"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": "726099207786084259",
"display": "11"
}
]
}
},
{
"url": "https://fhir.by/StructureDefinition/ApartmentRoom",
"valueString": "кв. 19"
}
],
"use": "home",
"text": "Могилевская область, г. Могилев, Переулок Снежный, д. 11",
"postalCode": "212037"
}
]
}
Пошаговая инструкция при оформлении пациента:
Пациент (с ИН);Пациент без ИН. В качестве ключевого идентификатора используйте UMD (номер медицинской карты), а в дополнительных идентификаторах укажите номер документа;Анонимный пациент (ANO).Пациент);Особые случаи:
FDN и UMD как ключевой идентификатор;Особенности работы без централизованной регистратуры: вы можете создавать пациентов непосредственно в МИС на месте оказания помощи.
Пациент без ИН;UIP;После того, как пациент придёт в сознание и/или предоставит документы, вы сможете дополнить карту пациента ФИО, датой рождения, адресом регистрации или проживания, идентификаторами документов через редактирование.
В случае, если пациент идентифицирован и имеет ИН (предоставил документ, удостоверяющий личность), для него необходимо создать новую карту по профилю Пациент (с ИН). Так же, по результатам идентификации, возможна ситуация, что пациент уже был зарегистрирован в ЦИСЗ ранее. В любом случае требуется выполнить объединение данных пациента - > МЕТОД НЕ РАЗРАБОТАН.
Пациент без ИН с идентификатором UMD;В случае, если пациент идентифицирован и имеет ИН (предоставил документ, удостоверяющий личность), для него необходимо создать новую карту по профилю Пациент (с ИН). Так же, по результатам идентификации, возможна ситуация, что пациент уже был зарегистрирован в ЦИСЗ ранее. В любом случае требуется выполнить объединение данных пациента - > МЕТОД НЕ РАЗРАБОТАН.
Пациент без ИН;UMD (номер карты вашей организации), а в качестве дополнительного идентификатора – FDN (номер документа, удостоверяющего личность иностранного гражданина);Возможные причины:
Алгоритм действий:
Не следует вносить данные пациента в ЦИСЗ, если он отказывается от обработки персональных данных в МИС.
Рекомендации по заполнению полей при создании нового пациента:
Пациент и Пациент без ИН;Что делать, если после создания оказалось, что пациент уже есть:
| Тип | Описание | Где используется | Уникальность |
|---|---|---|---|
INP |
Идентификационный номер гражданина РБ (личный номер) - ключевой идентификатор пациента в ЦИСЗ | Профиль Пациент |
Глобально в ЦИСЗ |
FDN |
Номер иностранного документа (паспорт, удостоверение беженца и др.) | Профиль Пациент без ИН |
Не проверяется на уникальность |
UMD |
Номер медицинского документа (карты, свидетельства о рождении/смерти) | Профиль Пациент без ИН |
В пределах организации |
UIP |
Внутренний номер неидентифицированного пациента | Профиль Пациент без ИН |
В пределах организации |
ANO |
Анонимный идентификатор | Профиль Анонимный пациент |
В пределах организации |
IPA |
Страховой номер индивидуального лицевого счета (не заполняется на стороне МИС) | Профили Пациент и Пациент без ИН |
Глобально уникальный |