Руководство к использованию стандарта FHIR в ЦИСЗ
0.2.6803 - ci-build
Цель: сторонние ЛИС должны реализовать метод, обеспечивающий предоставление штрихкодов лабораторных подразделений МИС при формировании направлений.
Для подробной информации см. Необходимая реализация метода получения штрихкода на стороне ЛИС
Цель: сохранить информацию о возможностях подразделения лаборатории, включая сведения об исследованиях, показателях и их доступности.
REST:
POST [INTEGRATION_URL]/Lis/PostLaboratoryLocation
Для подробной информации см. Сохранение информации о Организации-лаборатории.
Цель: получить список организаций, имеющих право направлять исследования в данную лабораторную организацию.
REST:
GET [INTEGRATION_URL]/Lis/GetAssignerOrganizations
Для получения подробной информации см. Получение информации о направляющих организациях.
Цель: получить список организаций, имеющих право направлять исследования в данную лабораторную организацию.
REST:
GET [INTEGRATION_URL]/Lis/GetAssignerResearches
Для получения подробной информации см. Получение исследований прикрепленных к организации.
Цель: отредактировать список исследований лаборатории, доступных для выбранной направляющей организации.
REST:
POST [INTEGRATION_URL]/Lis/PostAssignerResearch и [INTEGRATION_URL]/Lis/RemoveAssignerResearch
Для получения подробной информации см. Разрешить направляющей организации направлять направление на исследование в лабораторию и Запретить направляющей организации направлять направление на исследование в лабораторию
Цель: поиск направлений с применением фильтров по статусу, дате и лаборатории. Поиск направлений доступен в контекте пациента или организации.
FHIR-запрос:
GET [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest?status=draft&performer=Organization/ORG_ID&authoredOn=ge2024-01-01&authoredOn=le2024-01-31
где:
compartmentType - тип контекста (Patient или Organization);
compartmentResourceId - идентификатор контекста.
Цель: обновить статус направления на “принято” (draft), что означает, что направление получено лабораторией. Обновление статуса направления доступно в контекте пациента или организации.
FHIR:
POST [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}/$set-status
где:
compartmentType - тип контекста (Patient или Organization);
compartmentResourceId - идентификатор контекста;
id - идентификатор направления.
Для получения подробной информации см. Операция смены статуса ресурса ServiceRequest
Цель: получить образцы биоматериала, связанные с направлением в контекте пациента или организации.
FHIR-запрос:
GET [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/Specimen?based-on=ServiceRequest/SR_ID
где:
compartmentType - тип контекста (Patient или Organization);
compartmentResourceId - идентификатор контекста.
Штрихкод в extension:barcode.
Цель: Обновить статус направления на “в работе” (on-hold), что означает, что направление находится в процессе выполнения. Обновление статуса направления доступно в контекте пациента или организации.
FHIR:
POST [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}/$set-status
где:
compartmentType - тип контекста (Patient или Organization);
compartmentResourceId - идентификатор контекста;
id - идентификатор направления.
Для получения подробной информации см. Операция смены статуса ресурса ServiceRequest
Цель: передать результаты исследований в ИЭМК.
FHIR-ресурсы:
Observation — показателиDiagnosticReport — заключениеDocumentReference — PDFFHIR-операция:
POST [FHIR_BASE]/Bundle/$import
Тело запроса: Bundle profile = MedicationDocument с ресурсами ObservationLabTest/ObservationLabMicroorganism, DiagnosticReport, DocumentReference
Цель: узнать, какие лаборатории доступны для направления, какие виды исследований они принимают, и какие условия маршрутизации действуют.
Запрос:
GET [INTEGRATION_URL]/Mis/GetOrganizationRoutes
Для получения подробной информации см. Получение информации о возможностях маршрутизации направлений на лабораторные исследования для пользователя направляющей организации.
Цель: корректно заполнить направление на лабораторное исследование.
Для получения подробной информации см. Сопоставление полей ServiceRequest для лабораторных направлений.
Цель: получить уникальный идентификатор (штрихкод) для образца, связанного с направлением. Штрихкод необходим для заполнения образца биоматериала SpecimenLab
Запрос:
POST [INTEGRATION_URL]/Mis/GetBarcode
Для получения подробной информации см. Получить штрихкод из подразделения лаборатории.
Цель: корректно заполнить образец биоматериала для лабораторного исследования.
Для получения подробной информации см. Сопоставление полей Specimen для лабораторных направлений.
Цель: импорт направления и образца.
FHIR-операция:
POST [FHIR_BASE]/Bundle/$import
Content-Type: application/fhir+json
Тело запроса: Bundle profile = MedicationDocument с ресурсами ServiceRequestLab, SpecimenLab
Цель: получить результаты направления.
Получение Observation по пациенту:
GET [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/Observation?patient=Patient/001
Получение DiagnosticReport по ID направления:
GET [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/DiagnosticReport?based-on=ServiceRequest/SR_ID
Получение DiagnosticReport по периоду:
GET [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/DiagnosticReport?date=ge2024-01-01&date=le2024-12-31
где:
compartmentType - тип контекста (Patient или Organization);
compartmentResourceId - идентификатор контекста.
sequenceDiagram
actor P as Пациент
actor D as Врач
actor N as Медсестра
participant M as МИС
participant R as Маршрутизатор
participant I as ЦИСЗ
%% Этап 1: Инициация обследования
Note over P,I: 1. Инициация обследования
P->>D: Обращается за помощью
D->>M: Открывает карточку пациента
M->>R: Запрашивает доступные маршруты
R-->>M: Возвращает список маршрутов
D->>M: Создаёт направление на исследование
M->>M: Сопоставляет поля ServiceRequest
M->>I: Регистрирует ServiceRequestLab (status: active)
%% Этап 2: Подготовка к забору биоматериала
Note over P,I: 2. Подготовка к забору биоматериала
P->>N: Приходит в процедурный кабинет
N->>M: Открывает карточку пациента
N->>M: Запрашивает список направлений пациента
M->>I: Получает ServiceRequestLab
I-->>M: Возвращает направления
M->>N: Показывает список направлений пациента
N->>M: Берёт направление в работу
M->>R: Запрашивает штрихкод для образца
R-->>M: Возвращает штрихкод
%% Этап 3: Проведение забора биоматериала
Note over P,I: 3. Проведение забора биоматериала
N->>M: Фиксирует факт забора биоматериала
M->>M: Сопоставляет поля Specimen
M->>I: Регистрирует SpecimenLab (status: available)
%% Этап 4: Получение результатов и отображение
Note over P,I: 4. Получение результатов и отображение
alt В мед. учреждении
P->>D: Приходит в мед. учреждение
D->>M: Открывает карточку пациента
D->>M: Запрашивает заключения пациента
alt По ID направления
M->>I: Запрашивает DiagnosticReport по ServiceRequest
I-->>M: Возвращает DiagnosticReport
else По периоду
M->>I: Запрашивает DiagnosticReport за период
I-->>M: Возвращает список DiagnosticReport
end
M->>D: Отображает результаты врачу
else В ЛКП
P->>I: Просматривает направления и заключения
end
Метод: GET
URL: [INTEGRATION_URL]/Lis/GetAssignerOrganizations
Авторизация: Bearer <access_token>
Описание: Метод возвращает список организаций, которым разрешено направлять исследования в текущую лабораторную организацию. Текущая организация-лаборатория определяется на основании идентификатора, извлекаемого из Bearer-токена, передаваемого в заголовке Authorization.
Входные параметры (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | Page | integer | 0..1 | Номер страницы | 1 |
| 2 | RowsPerPage | integer | 0..1 | Количество записей на странице | 200 |
| 3 | Descending | boolean | 0..1 | Признак сортировки по убыванию | true |
| 4 | SortBy | string | 0..1 | Поле, по которому выполняется сортировка | “id” |
Пример запроса:
https://staging.cisz.by/api/uslt/integration/Lis/GetAssignerOrganizations?Page=1&RowsPerPage=200&Descending=true
Выходные параметры (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | data | array of objects | 0..* | Массив организаций | |
| 1.1 | data[].id | string | 1..1 | Идентификатор организации, из НСИ | “14736518-cc34-4e2e-8d60-204955589577” |
| 1.2 | data[].name | string | 1..1 | Название организации, из НСИ | “Открытое акционерное общество "Агентство сервисизации и реинжиниринга"” |
| 1.3 | data[].alias | string | 1..1 | Краткое название | “ОАО "Агентство сервисизации и реинжиниринга"” |
| 1.4 | data[].phones | array of string | 0..* | Телефоны организации | [“+375 17 287-81-87”] |
| 1.5 | data[].address | string | 0..1 | Адрес организации | “Минск, г. Минск, Улица Голодеда, д. 8 к.1” |
| 2 | totalCount | integer | 1..1 | Общее количество организаций, которым разрешено направлять исследования в текущую лабораторную организацию | 1 |
Пример ответа:
{
"data": [
{
"id": "a1a103d1-bf02-4c95-818a-3e3bc32cabe0",
"name": "Государственное научное учреждение \"ОБЪЕДИНЕННЫЙ ИНСТИТУТ ПРОБЛЕМ ИНФОРМАТИКИ НАЦИОНАЛЬНОЙ АКАДЕМИИ НАУК БЕЛАРУСИ\"",
"alias": "ГНУ ОИПИ",
"phones": [
"+375-29-937-99-92"
],
"address": "Гомельская область, г. Гомель, Проспект Октября, д. 201"
},
{
"id": "14736518-cc34-4e2e-8d60-204955589577",
"name": "Открытое акционерное общество \"Агентство сервисизации и реинжиниринга\"",
"alias": "ОАО \"Агентство сервисизации и реинжиниринга\"",
"phones": [
"+375 17 287-81-87"
],
"address": "Минск, г. Минск, Улица Голодеда, д. 8 к.1"
}
],
"totalCount": 2
}
Метод: GET
URL: [INTEGRATION_URL]/Lis/GetAssignerResearches
Авторизация: Bearer <access_token>
Описание: Метод возвращает перечень исследований, выполняемых в подразделениях в текущей организации-лаборатории, которые доступны для указанной направляющей организации. Идентификатор организации-лаборатории определяется из Bearer-токена, передаваемого в заголовке Authorization.
Входные параметры (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | Assigner | string | 1..1 | Идентификатор направляющей организации, из НСИ | “14736518-cc34-4e2e-8d60-204955589577” |
Пример запроса:
https://staging.cisz.by/api/uslt/integration/Lis/GetAssignerResearches?Assigner=14736518-cc34-4e2e-8d60-204955589577
Выходные параметры (JSON-array of objects):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | assigner | string | 1..1 | Идентификатор направляющей организации, из НСИ | “14736518-cc34-4e2e-8d60-204955589577” |
| 2 | laboratoryLocation | string | 1..1 | Идентификатор подразделения лаборатории, из НСИ | “cd4cfe89-b88d-4b0e-9c60-e79d32823fc6” |
| 3 | research | string | 1..1 | Идентификатор исследования в рамках подразделения | “1” |
Пример ответа:
[
{
"assigner": "14736518-cc34-4e2e-8d60-204955589577",
"laboratoryLocation": "cd4cfe89-b88d-4b0e-9c60-e79d32823fc6",
"research": "1"
}
]
Метод: POST
URL: https://[LIS_API_BARCODE_URL]
Авторизация: Bearer <access_token>
Описание: Метод позволяет получить штрихкод подразделения лаборатории для направления из МИСа.
Поля patientId, cito и collectedAt являются необязательными и используются исключительно для формирования визуальной информации при печати штрихкода.
Тело запроса (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | laboratoryId | string | 1..1 | Идентификатор организации с лабораторией, из НСИ | “a1a103d1-bf02-4c95-818a-3e3bc32cabe0” |
| 2 | locationId | string | 1..1 | Идентификатор подразделения лаборатории, из НСИ | “cd4cfe89-b88d-4b0e-9c60-e79d32823fc6” |
| 3 | researchId | string | 1..1 | Идентификатор исследования в подразделении | “1” |
| 4 | patientId | string | 0..1 | Идентификатор пациента, из ИЭМК | “pa-d677fe01-1398-11f0-a898-63e81911aed6” |
| 5 | cito | boolean | 0..1 | Срочность исследования | true |
| 6 | collectedAt | dateTime | 0..1 | День сбора биоматериала | “2025-10-24” |
Пример запроса:
{
"laboratoryId": "a1a103d1-bf02-4c95-818a-3e3bc32cabe0",
"locationId": "cd4cfe89-b88d-4b0e-9c60-e79d32823fc6",
"researchId": "1",
"patientId": "pa-d677fe01-1398-11f0-a898-63e81911aed6",
"cito": true,
"collectedAt": "2025-10-24"
}
Выходные параметры (JSON-object)
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | sid | string | 1..1 | Идентификатор SID | “000070” |
| 2 | barcodeType | string | 1..1 | Тип штрих-кода | “C128” |
| 3 | ratio | string | 1..1 | Соотношение толщины широких и узких линий штрих-кода | “2” |
| 4 | zoom | string | 1..1 | Масштаб/увеличение размера штрих-кода | “1” |
| 5 | array of bytes | 1..1 | Штрихкод в виде pdf | “JVBERi0xLjUNCiXi48/TDQozIDAgb2JqDQo8PCAvVHlwZSAvWE….” |
Пример ответа:
{
"sid": "000070",
"barcodeType": "C128",
"ratio": "2",
"zoom": "1",
"pdf": "JVBERi0xLjUNCiXi48/TDQozIDAgb2JqDQo8PCAvVHlwZSAvWE9iamVjdCAvU3VidHlw..."
}
Метод: POST
URL: [INTEGRATION_URL]/Lis/PostLaboratoryLocation
Авторизация: Bearer <access_token>
Описание: Метод сохраняет информацию о возможностях подразделения лаборатории, включая сведения об исследованиях, показателях и их доступности.
Тело запроса (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | Page | integer | 0..1 | Номер страницы | 1 |
| 1 | id | string | 1..1 | Идентификатор подразделения лаборатории, из НСИ | “7c1bdab2-877a-4397-a753-4eb44a729f58” |
| 2 | barcodeUrl | string | 1..1 | Ссылка на получение штрихкода реализованная в API ЛИС | “https://[LIS_API_BARCODE_URL]” |
| 3 | researches | array of objects | 0..* | Список исследований | |
| 3.1 | researches[].externalId | string | 1..1 | Идентификатор исследования в рамках подразделения лаборатории | “13” |
| 3.2 | researches[].externalName | string | 1..1 | Наименование исследования в рамках подразделения лаборатории | “Клинический анализ мочи (расширенный)” |
| 3.3 | researches[].code | string | 1..1 | Код исследования в справочнике лабораторных исследований https://fhir.by/ValueSet/TypesOfLabTests | “1.2” |
| 3.4 | researches[].abbreviation | string | 1..1 | Аббревиатура исследования | “КАМ” |
| 3.5 | researches[].isActive | boolean | 1..1 | Доступность исследования | true |
| 3.6 | researches[].banReason | string | 0..1 | Причина недоступности исследования (если есть) | |
| 3.7 | researches[].episodeLimit | integer | 0..1 | Максимальное количество назначений в рамках медицинского эпизода | 3 |
| 3.8 | researches[].tests | array of objects | 0..* | Список показателей | |
| 3.8.1 | researches[].tests[].externalId | string | 1..1 | Идентификатор показателя в рамках подразделения лаборатории | “103” |
| 3.8.2 | researches[].tests[].code | string | 1..1 | Код показателя в справочнике лабораторных исследований https://fhir.by/ValueSet/TypesOfLabTests | “1.2.15” |
| 3.8.3 | researches[].tests[].abbreviation | string | 1..1 | Аббревиатура показателя | “Билирубин” |
| 3.8.4 | researches[].tests[].isActive | boolean | 1..1 | Доступность показателя | true |
| 3.8.5 | researches[].tests[].banReason | string | 0..1 | Причина недоступности показателя | |
| 3.8.6 | researches[].tests[].sample | object | 0..1 | Вид биологического материала | |
| 3.8.6.1 | researches[].tests[].sample.code | string | 1..1 | Код биоматериала в справочнике видов биологического материала https://fhir.by/ValueSet/VSBiologicalMaterial | “12.3.1” |
| 3.8.7 | researches[].tests[].unit | object | 0..1 | Единицы измерения | |
| 3.8.7.1 | researches[].tests[].unit.code | string | 1..1 | Код единиц измерения в справочнике единиц измерения для лабораторных исследований https://fhir.by/ValueSet/OlisUnitsOfMeasurement | “62” |
| 3.8.8 | researches[].tests[].methods | array of objects | 0..* | Методы исследования | |
| 3.8.8.1 | researches[].tests[].methods[].code | string | 1..1 | Код метода исследования в справочнике лабораторных методов исследования https://fhir.by/ValueSet/OlisMethodsSplit | “137” |
| 3.8.9 | researches[].researchRestrictions | array of objects | 0..* | Ограничение на исследование | |
| 3.8.9.1 | researches[].researchRestrictions[].externalId | integer | 1..1 | Идентификатор ограничения на исследования в рамках подразделения лаборатории | 10 |
| 3.8.9.2 | researches[].researchRestrictions[].gender | integer | 1..1 | Пол пациента: 0 - male, 1 - female, 2 - other, 3 - unknown | 0 |
| 3.8.9.3 | researches[].researchRestrictions[].ageStart | timeSpan | 1..1 | Возраст от ([дни].[часы]:[минуты]:[секунды]) | “365.00:00:00” (1 год) |
| 3.8.9.4 | researches[].researchRestrictions[].ageEnd | timeSpan | 1..1 | Возраст до ([дни].[часы]:[минуты]:[секунды]) | “3650.00:00:00” (10 лет) |
Пример запроса:
{
"id": "7c1bdab2-877a-4397-a753-4eb44a729f58",
"barcodeUrl": "http://olis-report-api.uslt.svc.cluster.local/Print/printBarcode",
"researches": [
{
"externalId": "13",
"externalName": "Клинический анализ мочи (расширенный)",
"code": "1.2",
"abbreviation": "КАМ",
"isActive": true,
"banReason": null,
"episodeLimit": 3,
"tests": [
{
"externalId": "103",
"code": "1.2.15",
"abbreviation": "Билирубин",
"isActive": true,
"banReason": null,
"sample": {
"code": "12.3.1"
},
"unit": {
"code": "62"
},
"methods": [
{
"code": "137"
}
]
}
],
"researchRestrictions": [
{
"externalId": 10,
"gender": 0,
"ageStart": "365.00:00:00",
"ageEnd": "3650.00:00:00"
}
]
}
]
}
Пример ответа: 200 OK {}
Метод: POST
URL: [INTEGRATION_URL]/Lis/PostAssignerResearch
Авторизация: Bearer <access_token>
Описание: Метод позволяет лабораторной организации разрешить направляющей организации направлять пациентов на выполнение одного конкретного исследования в данной лаборатории.
Тело запроса (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | assigner | string | 1..1 | Идентификатор направляющей организации, из НСИ | “14736518-cc34-4e2e-8d60-204955589577” |
| 2 | laboratoryLocation | string | 1..1 | Идентификатор подразделения лаборатории, из НСИ | “cd4cfe89-b88d-4b0e-9c60-e79d32823fc6” |
| 3 | research | string | 1..1 | Идентификатор исследования в рамках подразделения | “1” |
Пример запроса:
{
"assigner": "14736518-cc34-4e2e-8d60-204955589577",
"laboratoryLocation": "cd4cfe89-b88d-4b0e-9c60-e79d32823fc6",
"research": "1"
}
Пример ответа: 200 OK {}
Метод: POST
URL: [INTEGRATION_URL]/Lis/RemoveAssignerResearch
Авторизация: Bearer <access_token>
Описание: Метод позволяет лабораторной организации отозвать ранее выданное разрешение направляющей организации на направление пациентов на одно конкретное исследование в данной лаборатории.
Тело запроса (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | assigner | string | 1..1 | Идентификатор направляющей организации, из НСИ | “14736518-cc34-4e2e-8d60-204955589577” |
| 2 | laboratoryLocation | string | 1..1 | Идентификатор подразделения лаборатории, из НСИ | “cd4cfe89-b88d-4b0e-9c60-e79d32823fc6” |
| 3 | research | string | 1..1 | Идентификатор исследования в рамках подразделения | “1” |
Пример запроса:
{
"assigner": "14736518-cc34-4e2e-8d60-204955589577",
"laboratoryLocation": "cd4cfe89-b88d-4b0e-9c60-e79d32823fc6",
"research": "1"
}
Пример ответа: 200 OK {}
Метод: GET
URL: [INTEGRATION_URL]/Mis/GetOrganizationRoutes
Авторизация: Bearer <access_token>
Описание: Метод возвращает информацию о возможностях маршрутизации направлений на лабораторные исследования для пользователя направляющей организации. Идентификатор организации определяется из Bearer-токена, передаваемого в заголовке Authorization.
Входные параметры (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | Page | integer | 0..1 | Номер страницы | 1 |
| 2 | RowsPerPage | integer | 0..1 | Количество записей на странице | 200 |
| 3 | Descending | boolean | 0..1 | Признак сортировки по убыванию | true |
| 4 | SortBy | string | 0..1 | Поле, по которому выполняется сортировка | “id” |
Пример запроса:
https://staging.cisz.by/api/uslt/integration/Mis/GetOrganizationRoutes?Page=1&RowsPerPage=200&Descending=true
Выходные параметры (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | data | array of objects | 0..* | Массив маршрутов | |
| 1.1 | data[].id | integer | 1..1 | Уникальный идентификатор записи | 2 |
| 1.2 | data[].assigner | object | 1..1 | Назначающая организация (МИС) | |
| 1.2.1 | data[].assigner.id | string | 1..1 | Идентификатор МИС, из НСИ | “a1a103d1-bf02-4c95-818a-3e3bc32cabe0” |
| 1.2.2 | data[].assigner.name | string | 1..1 | Название МИС, из НСИ | “Государственное научное учреждение "ОБЪЕДИНЕННЫЙ ИНСТИТУТ ПРОБЛЕМ ИНФОРМАТИКИ НАЦИОНАЛЬНОЙ АКАДЕМИИ НАУК БЕЛАРУСИ"” |
| 1.2.3 | data[].assigner.alias | string | 1..1 | Краткое название | “ГНУ ОИПИ” |
| 1.2.4 | data[].assigner.phones | array of strings | 0..* | Телефоны МИС | [“+375-29-937-99-92”] |
| 1.2.5 | data[].assigner.address | string | 0..1 | Адрес МИС | “Гомельская область, г. Гомель, Проспект Октября, д. 201” |
| 1.3 | data[].laboratory | object | 1..1 | Организация с лабораторией (ЛИС) | |
| 1.3.1 | data[].laboratory[].id | string | 1..1 | Идентификатор ЛИС, из НСИ | “14736518-cc34-4e2e-8d60-204955589577” |
| 1.3.2 | data[].laboratory[].name | string | 1..1 | Название ЛИС, из НСИ | “Открытое акционерное общество "Агентство сервисизации и реинжиниринга"” |
| 1.3.3 | data[].laboratory[].alias | string | 1..1 | Краткое название | “ОАО "Агентство сервисизации и реинжиниринга"” |
| 1.3.4 | data[].laboratory[].phones | array of strings | 0..* | Телефоны ЛИС | [ “+375 17 287-81-87” ] |
| 1.3.5 | data[].laboratory[].address | string | 1..1 | Адрес ЛИС | “Минск, г. Минск, Улица Голодеда, д. 8 к.1” |
| 1.4 | data[].laboratoryLocations | object | 0..* | Список подразделений | |
| 1.4.1 | data[].laboratoryLocations[].id | string | 1..1 | Идентификатор подразделения, из НСИ | “7c1bdab2-877a-4397-a753-4eb44a729f58” |
| 1.4.2 | data[].laboratoryLocations[].location | object | 1..1 | Подразделение лаборатории | |
| 1.4.2.1 | data[].laboratoryLocations[].location.id | string | 1..1 | Идентификатор подразделения, из НСИ | “7c1bdab2-877a-4397-a753-4eb44a729f58” |
| 1.4.2.2 | data[].laboratoryLocations[].location.name | string | 1..1 | Название подразделения, из НСИ | “КДЛ лаборатория” |
| 1.4.2.3 | data[].laboratoryLocations[].location.alias | string | 0..1 | Краткое название | “КДЛ” |
| 1.4.2.4 | data[].laboratoryLocations[].location.parentId | string | 0..1 | Название родительского подразделения | “a86bc980-00cb-4714-aea6-7422a3ce02af” |
| 1.4.2.5 | data[].laboratoryLocations[].location.childs | array of strings | 0..* | Название дочернего подразделения | |
| 1.4.3 | data[].laboratoryLocations[].researches | array of objects | 0..* | Список исследований | |
| 1.4.3.1 | data[].laboratoryLocations[].researches[].externalId | string | 1..1 | Идентификатор исследования в рамках подразделения лаборатории | “13” |
| 1.4.3.2 | data[].laboratoryLocations[].researches[].externalName | string | 1..1 | Наименование исследования в рамках подразделения лаборатории | “Клинический анализ мочи (расширенный)” |
| 1.4.3.3 | data[].laboratoryLocations[].researches[].code | string | 1..1 | Код исследования в справочнике лабораторных исследований https://fhir.by/ValueSet/TypesOfLabTests | “1.2” |
| 1.4.3.4 | data[].laboratoryLocations[].researches[].display | string | 1..1 | Наименование исследования в справочнике лабораторных исследований https://fhir.by/ValueSet/TypesOfLabTests | “Клинический анализ мочи” |
| 1.4.3.5 | data[].laboratoryLocations[].researches[].abbreviation | string | 1..1 | Аббревиатура исследования | “КАМ” |
| 1.4.3.6 | data[].laboratoryLocations[].researches[].isActive | boolean | 1..1 | Доступность исследования | true |
| 1.4.3.7 | data[].laboratoryLocations[].researches[].banReason | string | 0..1 | Причина недоступности исследования (если есть) | |
| 1.4.3.8 | data[].laboratoryLocations[].researches[].episodeLimit | integer | 0..1 | Максимальное количество назначений в рамках медицинского эпизода | 3 |
| 1.4.3.9 | data[].laboratoryLocations[].researches[].tests | array of objects | 0..* | Список показателей | |
| 1.4.3.9.1 | data[].laboratoryLocations[].researches[].tests[].externalId | string | 1..1 | Идентификатор показателя в рамках подразделения лаборатории | “103” |
| 1.4.3.9.2 | data[].laboratoryLocations[].researches[].tests[].code | string | 1..1 | Код показателя в справочнике лабораторных исследований | “1.2.15” |
| 1.4.3.9.3 | data[].laboratoryLocations[].researches[].tests[].display | string | 1..1 | Наименование показателя в справочнике лабораторных исследований https://fhir.by/ValueSet/TypesOfLabTests | “Билирубин полуколичественно” |
| 1.4.3.9.4 | data[].laboratoryLocations[].researches[].tests[].abbreviation | string | 1..1 | Аббревиатура показателя | “Билирубин” |
| 1.4.3.9.5 | data[].laboratoryLocations[].researches[].tests[].isActive | boolean | 1..1 | Доступность показателя | true |
| 1.4.3.9.6 | data[].laboratoryLocations[].researches[].tests[].banReason | string | 0..1 | Причина недоступности показателя (если есть) | |
| 1.4.3.9.7 | data[].laboratoryLocations[].researches[].tests[].sample | object | 0..1 | Вид биологического материала | |
| 1.4.3.9.7.1 | data[].laboratoryLocations[].researches[].tests[].sample.code | string | 1..1 | Код биоматериала в справочнике видов биологического материала https://fhir.by/ValueSet/VSBiologicalMaterial | “12.3.1” |
| 1.4.3.9.7.2 | data[].laboratoryLocations[].researches[].tests[].sample.display | string | 1..1 | Наименование биоматериала в справочнике видов биологического материала https://fhir.by/ValueSet/VSBiologicalMaterial | “Моча” |
| 1.4.3.9.8 | data[].laboratoryLocations[].researches[].tests[].unit | object | 0..1 | Единицы измерения | |
| 1.4.3.9.8.1 | data[].laboratoryLocations[].researches[].tests[].unit.code | string | 1..1 | Код единицы измерения в справочнике единиц измерения для лабораторных исследований https://fhir.by/ValueSet/OlisUnitsOfMeasurement | “62” |
| 1.4.3.9.8.2 | data[].laboratoryLocations[].researches[].tests[].unit.display | string | 1..1 | Наименование единицы измерения в справочнике единиц измерения для лабораторных исследований https://fhir.by/ValueSet/OlisUnitsOfMeasurement | “мг/дл” |
| 1.4.3.9.9 | data[].laboratoryLocations[].researches[].tests[].methods | array of objects | 0..* | Методы исследования | |
| 1.4.3.9.9.1 | data[].laboratoryLocations[].researches[].tests[].methods[].code | string | 1..1 | Код метода исследования в справочнике лабораторных методов исследования https://fhir.by/ValueSet/OlisMethodsSplit | “137” |
| 1.4.3.9.9.2 | data[].laboratoryLocations[].researches[].tests[].methods[].display | string | 1..1 | Наименование метода исследования в справочнике лабораторных методов исследования https://fhir.by/ValueSet/OlisMethodsSplit | “Тест-полоски, метод "сухой химии"” |
| 1.4.3.10 | data[].laboratoryLocations[].researches[].researchRestrictions | array of objects | 0..* | Ограничения на исследование | |
| 1.4.3.10.1 | data[].laboratoryLocations[].researches[].researchRestrictions[].id | integer | 1..1 | Идентификатор ограничения на исследование в рамках подразделения | 10 |
| 1.4.3.10.2 | data[].laboratoryLocations[].researches[].researchRestrictions[].gender | integer | 1..1 | Пол пациента: 0 - male, 1 - female, 2 - other, 3 - unknown | 0 |
| 1.4.3.10.3 | data[].laboratoryLocations[].researches[].researchRestrictions[].ageStart | timeSpan | 1..1 | Возраст от ([дни].[часы]:[минуты]:[секунды]) | “365.00:00:00” (1 год) |
| 1.4.3.10.4 | data[].laboratoryLocations[].researches[].researchRestrictions[].ageEnd | timeSpan | 1..1 | Возраст до ([дни].[часы]:[минуты]:[секунды]) | “3650.00:00:00” (10 лет) |
| 2 | totalCount | integer | 1..1 | Общее количество маршрутов, доступных для направляющей организации | 1 |
Пример ответа:
"data": [
{
"id": 8,
"assigner": {
"id": "a1a103d1-bf02-4c95-818a-3e3bc32cabe0",
"name": "Государственное научное учреждение \"ОБЪЕДИНЕННЫЙ ИНСТИТУТ ПРОБЛЕМ ИНФОРМАТИКИ НАЦИОНАЛЬНОЙ АКАДЕМИИ НАУК БЕЛАРУСИ\"",
"alias": "ГНУ ОИПИ",
"phones": [
"+375-29-937-99-92"
],
"address": "Гомельская область, г. Гомель, Проспект Октября, д. 201"
},
"laboratory": {
"id": "14736518-cc34-4e2e-8d60-204955589577",
"name": "Открытое акционерное общество \"Агентство сервисизации и реинжиниринга\"",
"alias": "ОАО \"Агентство сервисизации и реинжиниринга\"",
"phones": [
"+375 17 287-81-87"
],
"address": "Минск, г. Минск, Улица Голодеда, д. 8 к.1"
},
"laboratoryLocations": [
{
"id": "7c1bdab2-877a-4397-a753-4eb44a729f58",
"location": {
"id": "7c1bdab2-877a-4397-a753-4eb44a729f58",
"name": "КДЛ лаборатория",
"alias": null,
"parentId": "a86bc980-00cb-4714-aea6-7422a3ce02af",
"childs": []
},
"researches": [
{
"externalId": "13",
"externalName": "Клинический анализ мочи (расширенный)",
"code": "1.2",
"display": "Клинический анализ мочи",
"abbreviation": "КАМ",
"isActive": true,
"episodeLimit": 3,
"tests": [
{
"externalId": "103",
"code": "1.2.15",
"display": "Билирубин полуколичественно",
"abbreviation": "Билирубин",
"isActive": true,
"banReason": null,
"sample": {
"code": "12.3.1",
"display": "Моча"
},
"unit": {
"code": "62",
"display": "мг/дл"
},
"methods": [
{
"code": "137",
"display": "Тест-полоски, метод \"сухой химии\""
}
]
}
],
"researchRestrictions": [
{
"externalId": 10,
"gender": 0,
"ageStart": "365.00:00:00",
"ageEnd": "3650.00:00:00"
}
]
}
]
}
]
}
],
"totalCount": 1
}
Метод: POST
URL: [INTEGRATION_URL]/Mis/GetBarcode
Авторизация: Bearer <access_token>
Описание: Метод позволяет получить штрихкод подразделения лаборатории для направления из МИСа.
Тело запроса (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | laboratoryId | string | 1..1 | Идентификатор организации с лабораторией, из НСИ | “a1a103d1-bf02-4c95-818a-3e3bc32cabe0” |
| 2 | locationId | string | 1..1 | Идентификатор подразделения лаборатории, из НСИ | “cd4cfe89-b88d-4b0e-9c60-e79d32823fc6” |
| 3 | researchId | string | 1..1 | Идентификатор исследования в подразделении | “1” |
| 4 | patientId | string | 0..1 | Идентификатор пациента, из НСИ | “pa-d677fe01-1398-11f0-a898-63e81911aed6” |
| 5 | cito | boolean | 0..1 | Срочность исследования | true |
| 6 | collectedAt | dateTime | 0..1 | День сбора биоматериала | “2025-10-24” |
Пример запроса:
{
"laboratoryId": "a1a103d1-bf02-4c95-818a-3e3bc32cabe0",
"locationId": "cd4cfe89-b88d-4b0e-9c60-e79d32823fc6",
"researchId": "1",
"patientId": "pa-d677fe01-1398-11f0-a898-63e81911aed6",
"cito": true,
"collectedAt": "2025-10-24"
}
Выходные параметры (JSON-object)
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | sid | string | 1..1 | Идентификатор SID | “000070” |
| 2 | barcodeType | string | 1..1 | Тип штрих-кода | “C128” |
| 3 | ratio | string | 1..1 | Соотношение толщины широких и узких линий штрих-кода | “2” |
| 4 | zoom | string | 1..1 | Масштаб/увеличение размера штрих-кода | “1” |
| 5 | array of bytes | 1..1 | Штрихкод в виде pdf | “JVBERi0xLjUNCiXi48/TDQozIDAgb2JqDQo8PCAvVHlwZSAvWE….” |
Пример ответа:
{
"sid": "000070",
"barcodeType": "C128",
"ratio": "2",
"zoom": "1",
"pdf": "JVBERi0xLjUNCiXi48/TDQozIDAgb2JqDQo8PCAvVHlwZSAvWE9iamVjdCAvU3VidHlw..."
}
Метод: POST
URL: [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}/$set-status
Авторизация: Bearer <access_token>
Описание: Операция позволяет изменить статус ресурса ServiceRequestLab. Может выполняться в контексте организации или в контексте пациента. Только организация в которой создали направление или организация назначенная исполнителем в направлении имеет право изменять статус ресурса.
Допустимые переходы статусов
Для направляющей организации:
| № | Из статуса | В статус |
|---|---|---|
| 1 | active | revoked |
| 2 | draft | revoked |
Для организации-лаборатории:
| № | Из статуса | В статус |
|---|---|---|
| 1 | active | draft |
| 2 | draft | on-hold |
| 3 | draft | entered-in-error |
| 4 | on-hold | draft |
| 5 | on-hold | entered-in-error |
| 6 | on-hold | complete |
Входные параметры (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | compartmentType | string | 1..1 | Тип контекста (Organization или Patient) | “Organization” |
| 2 | compartmentResourceId | string | 1..1 | Идентификатор контекста | “a1a103d1-bf02-4c95-818a-3e3bc32cabe0” |
| 3 | id | string | 1..1 | Идентификатор ресурса ServiceRequestLab | “lt-6f7e619e-b4a6-11f0-9a35-6655202d800b” |
Примеры запросов
Пример запроса в контексте организации:
https://staging.cisz.by/api/fhir/Organization/a1a103d1-bf02-4c95-818a-3e3bc32cabe0/ServiceRequest/lt-6f7e619e-b4a6-11f0-9a35-6655202d800b/$set-status
Body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "status",
"valueCode": "on-hold"
}
]
}
Пример запроса в контексте пациента:
https://staging.cisz.by/api/fhir/Patient/pa-cfebde10-4f3f-11f0-a990-7bfa228de4df/ServiceRequest/lt-6f7e619e-b4a6-11f0-9a35-6655202d800b/$set-status
Body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "status",
"valueCode": "on-hold"
}
]
}
Результат выполнения В случае успешного выполнения операции система возвращает ресурс ServiceRequestLab с информацией об успешном выполнении изменения статуса направления. HTTP code 200 OK В случае ошибки возвращается ресурс OperationOutcome с информацией об ошибке.
Пример ошибки:
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"code": "not-found",
"diagnostics": "Resource type 'ServiceRequest' with id 'lt-34ad5218-b4ac-11f0-a471-13750e8e6e78' couldn't be found."
}
]
}
Метод: POST
URL: [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}/$set-status
Авторизация: Bearer <access_token>
Описание: Операция предназначена для отмены ресурса ServiceRequestLab путём перевода его в статус entered-in-error. Схема выполнения операции аналогична стандартной операции смены статуса, описанной выше. Отличие состоит в том, что при переводе ресурса в статус entered-in-error в тело запроса обязательно передаётся дополнительный параметр, указывающий причину отмены.
Входные параметры (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | compartmentType | string | 1..1 | Тип контекста (Organization или Patient) | “Organization” |
| 2 | compartmentResourceId | string | 1..1 | Идентификатор контекста | “a1a103d1-bf02-4c95-818a-3e3bc32cabe0” |
| 3 | id | string | 1..1 | Идентификатор ресурса ServiceRequestLab | “lt-6f7e619e-b4a6-11f0-9a35-6655202d800b” |
Примеры запросов
Пример запроса в контексте организации:
https://staging.cisz.by/api/fhir/Organization/a1a103d1-bf02-4c95-818a-3e3bc32cabe0/ServiceRequest/lt-6f7e619e-b4a6-11f0-9a35-6655202d800b/$set-status
Body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "status",
"valueCode": "entered-in-error"
},
{
"name": "declineReason",
"valueCode": "7"
}
]
}
Пример запроса в контексте пациента:
https://staging.cisz.by/api/fhir/Patient/pa-cfebde10-4f3f-11f0-a990-7bfa228de4df/ServiceRequest/lt-6f7e619e-b4a6-11f0-9a35-6655202d800b/$set-status
Body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "status",
"valueCode": "entered-in-error"
},
{
"name": "declineReason",
"valueCode": "7"
}
]
}
Результат выполнения В случае успешного выполнения операции система возвращает ресурс ServiceRequestLab обновлённым статусом entered-in-error. HTTP code 200 OK В случае отсутствия параметра declineReason возвращается ресурс OperationOutcome с описанием ошибки.
Пример ошибки:
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"code": "invalid",
"diagnostics": "Incorrect operation parameters"
}
]
}
Метод: POST
URL: [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/ServiceRequest/{id}/$update-order
Авторизация: Bearer <access_token>
Описание: Операция предназначена для обновления набора тестов (показателей), связанных с ресурсом ServiceRequestLab. При выполнении операции существующий список тестов полностью перезаписывается на основании данных, переданных в теле запроса. Операция доступна для направлений со статусом active или draft Операция выполняется в контектсе направляющей организации.
Входные параметры (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | compartmentType | string | 1..1 | Тип контекста | “Organization” |
| 2 | compartmentResourceId | string | 1..1 | Идентификатор контекста | “a1a103d1-bf02-4c95-818a-3e3bc32cabe0” |
| 3 | id | string | 1..1 | Идентификатор ресурса ServiceRequestLab | “lt-6f7e619e-b4a6-11f0-9a35-6655202d800b” |
Тело запроса
Тело запроса передаётся в виде ресурса Parameters с массивом параметров parameter, каждый из которых определяет один тест (показатель), включаемый в ServiceRequestLab.
Описание полей parameter
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | name | string | 1..1 | Идентификатор исследования в рамках подразделения лаборатории | “96” |
| 2 | valueString | string | 1..1 | Код исследования в справочнике лабораторных исследований https://fhir.by/ValueSet/TypesOfLabTests | “2.1.36” |
Пример запроса в контексте организации:
https://staging.cisz.by/api/fhir/Organization/a1a103d1-bf02-4c95-818a-3e3bc32cabe0/ServiceRequest/lt-6f7e619e-b4a6-11f0-9a35-6655202d800b/$update-order
Body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "96",
"valueString": "2.1.36"
},
{
"name": "97",
"valueString": "2.1.34"
}
]
}
Результат выполнения
В случае успешного выполнения операции система возвращает ресурс ServiceRequestLab с информацией об успешном выполнении изменения списка тестов. HTTP code 200 OK.
В случае ошибки возвращается ресурс OperationOutcome с информацией об ошибке.
Пример ошибки:
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"code": "invalid",
"diagnostics": "Invalid ServiceRequest status"
}
]
}
Метод: POST
URL: [FHIR_BASE]/{compartmentType}/{compartmentResourceId}/Specimen/{id}/$set-status
Авторизация: Bearer <access_token>
Описание: Операция позволяет изменить статус ресурса Specimen. Операция может выполняться в контектсе организации или в контексте пациента. Только организация в которой создали направление или организация назначенная исполнителем в направлении имеет право изменять статус ресурса.
Входные параметры (JSON-object):
| № | Обозначение | Тип данных | Обязательность | Наименование | Пример |
|---|---|---|---|---|---|
| 1 | compartmentType | string | 1..1 | Тип контекста | “Organization” |
| 2 | compartmentResourceId | string | 1..1 | Идентификатор контекста | “a1a103d1-bf02-4c95-818a-3e3bc32cabe0” |
| 3 | id | string | 1..1 | Идентификатор ресурса SpecimenLab | “lt-3e0a7129-b4ac-11f0-9a35-6655202d800b” |
Пример запроса в контексте организации:
https://staging.cisz.by/api/fhir/Organization/a1a103d1-bf02-4c95-818a-3e3bc32cabe0/Specimen/lt-3e0a7129-b4ac-11f0-9a35-6655202d800b/$set-status
Body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "status",
"valueCode": "unsatisfactory"
}
]
}
Пример запроса в контексте пациента:
https://staging.cisz.by/api/fhir/Patient/pa-cfebde10-4f3f-11f0-a990-7bfa228de4df/Specimen/lt-6f7e619e-b4a6-11f0-9a35-6655202d800b/$set-status
Body:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "status",
"valueCode": "unsatisfactory"
}
]
}
Результат выполнения
В случае успешного выполнения операции система возвращает ресурс SpecimenLab с информацией об успешном выполнении изменения статуса образца биоматериала. HTTP code 200 OK.
В случае ошибки возвращается ресурс OperationOutcome с информацией об ошибке.
Пример ошибки:
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"code": "invalid",
"diagnostics": "Invalid Specimen status"
}
]
}
| № | Поле ServiceRequest | Что вставлять | Обязательность | Комментарий | |
|---|---|---|---|---|---|
| 1 | meta.profile | https://fhir.by/StructureDefinition/ServiceRequestLab |
1..1 | ||
| 2 | extension:specialty | https://fhir.by/StructureDefinition/ServiceRequestLab |
#C018 |
1..1 | По умолчанию #C018. |
| 3 | extension:pregnancyWeek | 0..1 | Неделя беременности пациента, если применимо. | ||
| 4 | extension:fromOrganization | 1..1 | Идентификатор направляющей организации из НСИ. | ||
| 5 | extension:redirected | true |
0..1 | Указывается при перенаправлении направления. | |
| 6 | identifier.value | 1..1 | Идентификатор направления в рамках направляющей организации. | ||
| 7 | identifier.assigner.extension:locationReference | 1..1 | Идентификатор подразделения направляющей организации. | ||
| 8 | identifier.assigner.reference | 1..1 | Идентификатор направляющей организации. | ||
| 9 | basedOn.reference | 0..1 | Заполняется в случае перенаправления. Идентификатор первоначального направления | ||
| 10 | status | active |
1..1 | Всегда active при создании. |
|
| 11 | intent | order |
1..1 | По умолчанию order |
|
| 12 | priority | routine / urgent |
1..1 | ||
| 13 | code.extension:externalId | data[].laboratoryLocations[].researches[].externalId |
1..1 | Идентификатор исследования для выбранного подразделения лаборатории (из сервиса маршрутизации). | |
| 14 | code.concept:coding.system | https://fhir.by/ValueSet/TypesOfLabTests |
1..1 | ||
| 15 | code.concept:coding.code | 1..1 | Код исследования из ValueSet (соответствует data[].laboratoryLocations[].researches[] в сервисе маршрутизации). |
||
| 16 | orderDetail.parameter.extension:externalId | data[].laboratoryLocations[].researches[].tests[].externalId |
1..1 | Идентификатор показателя для выбранного подразделения лаборатории (из сервиса маршрутизации). | |
| 17 | orderDetail.parameter.code.coding.system | https://fhir.by/ValueSet/ParamLabServiceRequest |
1..1 | ||
| 18 | orderDetail.parameter.code.coding.code | #test |
1..1 | По умолчанию #test | |
| 19 | orderDetail.parameter.valueCodeableConcept.coding.system | http://fhir.by/ValueSet/TypesOfLabTests |
1..1 | ||
| 20 | orderDetail.parameter.valueCodeableConcept.coding.code | 1..1 | Код показателя из ValueSet (соответствует data[].laboratoryLocations[].researches[].tests[].code). |
||
| 21 | subject.reference | 1..1 | Идентификатор пациента в ИЭМК. | ||
| 22 | encounter.reference | 0..1 | Ссылка на визит/прием врача, при котором создано направление. | ||
| 23 | occurrenceDateTime | 0..1 | Когда должно быть оказано запрошенное исследование | ||
| 24 | authoredOn | 1..1 | Дата и время создания направления. | ||
| 25 | requester.reference | 1..1 | Идентификатор медработника, создавшего направление. | ||
| 26 | performer.reference | data[].laboratory[].id |
1..1 | Идентификатор выбранной лаборатории из сервиса маршрутизации. | |
| 27 | location.reference.reference | data[].laboratoryLocations[].id |
1..1 | Идентификатор выбранного подразделения лаборатории. | |
| 28 | reason.reference | 0..1 | Основание для создания направления | ||
| 29 | note | 0..1 | Комментарий к направлению. |
| № | Поле Specimen | Что вставлять | Обязательность | Комментарий |
|---|---|---|---|---|
| 1 | meta.profile | https://fhir.by/StructureDefinition/SpecimenLab |
1..1 | |
| 2 | extension:barcode | 1..1 | sid из метода получения штрихкода из подразделения лаборатории [INTEGRATION_URL]/Mis/GetBarcode. |
|
| 3 | identifier.value | 1..1 | Идентификатор образца биоматериала в рамках создавшей биатериал организации. | |
| 4 | identifier.assigner.extension:locationReference | 1..1 | Идентификатор подразделения создавшего биоматериал организации. | |
| 5 | identifier.assigner.reference | 1..1 | Идентификатор создавшей организации. | |
| 6 | status | available |
1..1 | Всегда available при создании. |
| 7 | type.coding.system | https://fhir.by/ValueSet/VSBiologicalMaterial |
1..1 | |
| 8 | type.coding.code | 1..1 | Код вида биологического материала из ValueSet | |
| 9 | subject.reference | 1..1 | Идентификатор пациента в ИЭМК. | |
| 10 | parent.reference | 0..* | Заполняется в случае разделения пробирки. Идентификатор первоначального образца | |
| 11 | request.reference | 1..1 | Идентификатор направления | |
| 12 | collection.collector.reference | 1..1 | Идентификатор медработника, получившего биоматериал | |
| 13 | collection.collectedDateTime | 1..1 | Время взятия биологического материала | |
| 14 | collection.quantity.value | 0..1 | Колличество биоматериала | |
| 14 | collection.quantity.system | https://fhir.by/ValueSet/OlisUnitsOfMeasurement |
0..1 | |
| 15 | collection.quantity.code | 0..1 | Код единицы измерения из ValueSet | |
| 16 | collection.quantity.unit | 0..1 | Представление единицы измерения | |
| 17 | collection.bodySite.concept:coding.system | https://fhir.by/ValueSet/AnatomicalTerminology |
0..1 | |
| 18 | collection.bodySite.concept:coding.code | 0..1 | Код анатомической области, откуда взят биологический материал из ValueSet | |
| 19 | note | 0..1 | Комментарий к образцу. |
Скачать коллекцию ч.1 Скачать коллекцию ч.2
| № п/п | Ситуация | Текст сообщения об ошибке для технических специалистов | Текст сообщения об ошибке в человекочитаемом формате |
|---|---|---|---|
| 1 | При попытке отправить ресурс ServiceRequest, в котором значение authoredOn больше текущей даты, будет возвращена ошибка: | Значение ServiceRequest.authoredOn не может быть больше текущей даты. | Дата создания направления не может быть позднее текущей даты. |
| 2 | При попытке отправить ресурс ServiceRequest, в котором значение occurrenceDateTime меньше значения authoredOn, будет возвращена ошибка: | Значение ServiceRequest.occurrenceDateTime не может быть меньше значения ServiceRequest.authoredOn. | Дата выполнения услуги не может быть раньше даты создания направления. |
| 3 | При попытке отправить ресурс ServiceRequest, в котором значение location не относится к организации, указанной в performer, будет возвращена ошибка: | Значение ServiceRequest.location должно соответствовать организации, указанной в ServiceRequest.performer. Указанное место оказания услуги не принадлежит указанной организации. | Указанное подразделение оказания услуги не относится к организации, выбранной в качестве исполнителя. |