Обновленный Сервис записи на приём к врачу (версия 3.0) предназначен для предоставления услуг записи посредством информационного взаимодействия ИС через API Интеграционной платформы.
Услуга «Запись на прием к врачу по направлению» в рамках обновленного сервиса записи на прием к врачу (версия 3.0) предоставляет возможность оформления записи на прием к врачу в электронном виде по направлениям с использованием информационного взаимодействия с подсистемой «Управление очередями на оказание медицинской помощи» (УО) и обеспечивает поддержку федеральных требований оказания данной услуги через КУ ФЭР (ЕПГУ - Госуслуги).
Участниками процесса в рамках услуги «Запись на прием к врачу по направлению» являются:
- СЗПВ;
- Клиент СЗПВ (инициатор оформления записи);
- УО (источник данных о направлении);
- МИС целевой МО (владелец расписания медицинских ресурсов для записи по направлению).
На Рисунке 1 представлена схема информационного взаимодействия в рамках сценария оформления записи по услуге «Запись на приём к врачу по направлению».
Рисунок 1. Схема информационного взаимодействия в рамках сценария оформления записи по услуге «Запись на приём к врачу по направлению»
Краткое описание протокола взаимодействия приведено в разделе 3.
Описание методов в рамках услуги «Запись на прием к врачу по направлению» приведено в разделе 4.
Описание протокола взаимодействия
Общая информация о сервисе
Информационный обмен осуществляется в соответствии со стандартом FHIR® (Fast Healthcare Interoperability Resources), разработанным организацией HL7. Используемая версия FHIR Release 4, 4.0.1. Подробное описание стандарта доступно по следующим ссылкам:
В качестве протокола взаимодействия используется REST (использование REST-протокола в FHIR® – см. https://hl7.org/fhir/http.html).
Требования к авторизации
При информационном взаимодействии с СЗПВ необходимо передавать в заголовке сообщения авторизационный токен в формате:
Authorization: N3[пробел][GUID системы]
GUID системы выдается разработчику МИС администратором Интеграционной платформы.
Использование справочников
Справочники, используемые в СЗПВ, опубликованы в «Сервисе Терминологии». Описание сервиса Терминологии и правила взаимодействия с ним приведены по ссылке: http://api.netrika.ru/docs.php?article=Terminology.
Для каждого справочника в Настоящем документе указан его OID (объектный идентификатор). Перечень присвоенных корневых OID:
1.2.643.5.1.13.2.1 - Корневой OID справочников, размещённых в Федеральном реестре НСИ (http://nsi.rosminzdrav.ru/);
1.2.643.2.69.1.1.1 – Корневой OID для справочников подсистемы НСИ Регионального фрагмента.
Передача параметров, использующих значения справочников, не указанных в стандарте FHIR, осуществляется в следующей структуре:
"coding": [
{
"system": "urn:oid:[OID справочника в сервисе Терминологии]",
"code": "[код значения]"
}
]
При передаче параметров, использующих значения внутренних справочников FHIR, указывается только код значения (справочники стандарта FHIR также опубликованы в сервисе Терминологии).
Справочники, используемые в рамках услуги «Запись на прием к врачу по направлению»:
- Справочник «ЛПУ» Интеграционной платформы
- «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066)
- «Статус направления» (OID 1.2.643.2.69.1.1.1.50)
- «Тип направления» (OID 1.2.643.2.69.1.1.1.55)
- «Составной профиль помощи» (OID 1.2.643.2.69.1.1.1.56)
- «Вид исследования» (OID 1.2.643.2.69.1.1.1.57)
- «Область исследования» (OID 1.2.643.2.69.1.1.1.58)
- «Справочник МО региона» (OID 1.2.643.2.69.1.1.1.64)
- «Роль в направлении пациента» (OID 1.2.643.2.69.1.1.1.66)
- «Номенклатура должностей медицинских работников и фармацевтических работников» (OID 1.2.643.5.1.13.2.1.1.607)
- «Классификатор половой принадлежности» (OID 1.2.643.5.1.13.2.1.1.156)
- «Тип контакта» (OID 1.2.643.2.69.1.1.1.27)
- «Статус диагноза» (OID 1.2.643.2.69.1.1.1.26)
- «МКБ10 ред.СПб КЗ» (OID 1.2.643.2.69.1.1.1.2)
- «Тип адреса» (OID 1.2.643.2.69.1.1.1.28)
- «Классификатор категорий льгот» (OID 1.2.643.2.69.1.1.1.7)
- «Составной тип документа» (OID 1.2.643.2.69.1.1.1.59)
- «Реестр страховых медицинских организаций (ФОМС)» (OID 1.2.643.5.1.13.2.1.1.635)
- «Регион» (OID 1.2.643.2.69.1.1.1.51)
- «Вид медицинской помощи» (OID 1.2.643.2.69.1.1.1.52)
- «Форма медицинской помощи» (OID 1.2.643.2.69.1.1.1.54)
- «Условия медицинской помощи» (OID 1.2.643.2.69.1.1.1.53)
- «Источник аннулирования» (OID 1.2.643.2.69.1.1.1.49)
- «Причина аннулирования» (OID 1.2.643.2.69.1.1.1.60)
- «Справочник соответствия кодов МО Росминздрав и ФФОМС» (OID 1.2.643.2.69.1.1.1.87)
- Справочник «Роль пользователя»
- Справочник «Источники записи» (OID 1.2.643.2.69.1.1.1.115)
- «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102)
- Справочник «Статус записи на прием»
- Справочник типа ресурса Location http://terminology.hl7.org/CodeSystem/location-physical-type
- Справочник «Тип документа» (OID 1.2.643.2.69.1.1.1.6)
- «ФРМО. Справочник отделений и кабинетов» (OID 1.2.643.5.1.13.13.99.2.115)
- Справочник причин приёма https://terminology.hl7.org/1.0.0/CodeSystem-v2-0276.html
- Справочник ошибок Сервиса записи на прием (OID 1.2.643.2.69.1.1.1.166)
Cервис выдачи идентификаторов процесса
Для обеспечения возможности связывания данных методов сервиса записи на прием, вызванных в рамках одного процесса, на стороне сервиса сбора и хранения информации, необходимо, чтобы клиент СЗПВ передавал в рамках вызова метода идентификатор процесса, полученный от сервиса выдачи идентификаторов процесса (далее СВИП). Под процессом в данном случае понимается сценарий, состоящий из последовательного вызова методов СЗПВ с целью получения услуги предоставляемой СЗПВ. Каждый раз, когда начинается новый процесс, должен быть получен новый идентификатор процесса. Под процессом обычно понимается некоторый use case, который обеспечивает СЗПВ.
Данный идентификатор требуется передавать в Header запроса метода сервиса записи на прием в следующем формате:
Processid: YourProcessId
Примеры use case'ов, обеспечиваемых СЗПВ (v 3.0 - FHIR):
- Запись по направлению. Состоит из методов: $searchslots, $setappointment.
- Запись на вакцинацию. Состоит из методов: $getpatientid, $searchmedicalresources, $searchslots, $setappointment.
- Запись по диспансерному наблюдению. Состоит из методов: $getpatientid, $getdispensaryobservationinfo, $searchmedicalresources, $searchslots, $setappointment.
- Запись по направлению. Состоит из методов: $searchslots, $setappointment.
- Отмена записи. Состоит из методов: $cancelappointment.
- Уведомление об изменении статуса записи. Состоит из методов: $changenotification.
Каждый идентификатор процесса имеет ограничение срока жизни. Это сделано для того, чтобы не допустить ситуации, при которой один идентификатор процесса будет использоваться неопределённо долго, а также для обеспечения утилизации идентификаторов процесса, которые уже не могут участвовать в обмене данными (в этом случае считается, что пользовательский сеанс уже завершён и сервис может не ожидать новых запросов с данным токеном). Время жизни токена обычно выбирается достаточно продолжительным (порядка 3 часов) для того, чтобы пользовательская сессия не успела завершиться до окончания срока действия токена, однако, если это произошло, то нужно либо заново получить новый токен, либо принудительно завершить пользовательский сеанс и начать use case c самого начала.
При получении запроса метода с идентификатором процесса сервис записи на прием определяет с помощью СВИП актуальность указанного идентификатора процесса. В случае, если идентификатор процесса просрочен или был передан некорректно, СЗПВ сгенерирует своё значение, которое будет передано в сервис сбора и хранения информации в качестве идентификатора процесса, цепочка при этом разорвётся.
Описание методов СВИП:
- Метод получения идентификатора процесса
Адрес: /api/token
HTTP-метод: GET
Данный метод используется для получения клиентом сервиса записи на прием идентификатора процесса.
В запросе метода отсутствуют входные параметры.
Формат ответа метода:
{
"success": true,
"resultcode": 0,
"message": null,
"content": "YourProcessId"
}
, где наполнение параметра content – идентификатор процесса.
- Метод получения данных по идентификатору процесса (авторизационной сессии)
Адрес: /api/session?token=
HTTP-метод: GET
Данный метод используется для проверки актуальности и получения данных по идентификатору процесса (авторизационной сессии).
В запросе метода указывается идентификатор процесса в формате [base]/api/session?token=[YourProcessId]
Формат ответа метода:
{"content":
Unknown macro: {"token"}
}
, где
наполнение параметра token – идентификатор процесса,
наполнение параметра startDate - дата начала действия идентификатора процесса,
наполнение параметра endDate - дата истечения срока действия идентификатора процесса.
Описание методов сервиса
Список методов сервиса
Сервис записи на приём к врачу в части услуги «Запись на приём к врачу по направлению» содержит следующие методы: _Выбор_района_(GetDistrictList)
- Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots);|#_Выбор_ЛПУ_(GetLPUList)
- Осуществление записи на приём к врачу по направлению ($setappointment);
- Отмена записи на приём к врачу по направлению ($cancelappointment);
- Уведомление о факте записи на приём по направлению ($notify);
- Уведомление об изменении записи на приём по направлению ($changenotification);
- Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo).
Обязательность параметров, используемых в запросах, указана в соответствующих таблицах. При этом используются следующие обозначения:
- 0..1 - параметр необязательный, максимальное количество экземпляров один;
- 0..* – параметр необязательный, максимальное количество экземпляров не ограничено;
- 1..1 – параметр обязательный, экземпляр один;
- 1..2 – параметр обязательный, экземпляр один или два;
- 1..3 – параметр обязательный, экземпляр один, два или три;
- 1..* – параметр обязательный, максимальное количество экземпляров не ограничено;
- 2..2 – параметр обязательный, два экземпляра.
Значения параметров методов, имеющих тип Datetime, необходимо передавать в формате UTC с указанием таймзоны. Если таймзона не указана, то в рамках сервиса считается, что передано локальное время (региональное), и сервис работает с переданным значением как с "датой, для которой не указана таймзона".
Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)
Данный метод используется для поиска в целевой МО доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению. В качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$searchslots.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 2 представлена схема информационного взаимодействия в рамках метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)».
<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="a1a932e1-0f36-4b29-bbb1-88c7ee1e1988"><ac:parameter ac:name="">_Ref12878762</ac:parameter></ac:structured-macro>Рисунок 2. Схема информационного взаимодействия в рамках метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)»
Описание схемы:
- Клиент СЗПВ отправляет запрос метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)» в СЗПВ. Состав параметров запроса представлен в Таблице 1.
- СЗПВ отправляет запрос метода SearchOne в сервис УО для получения данных о направлении.
- УО передает ответ метода SearchOne в СЗПВ с данными о направлении.
- В случае, если направление имеет статус 1, 2, 3, 4, 5 или 6 (по данным из шага 3), СЗПВ отправляет запрос метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)» в целевое ЛПУ, определенное на шаге 3. Состав параметров запроса представлен в Таблице 1.
- Целевое ЛПУ передает ответ метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.1.2.
- СЗПВ передает ответ метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.1.2.
Описание параметров запроса
В Таблице 1 представлено описание параметров запроса метода $searchslots.
Таблица 1 – Описание параметров запроса метода $searchslots
Параметры |
Кратность |
Тип |
Описание |
---|---|---|---|
organizationId |
0..1 |
string |
Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы. |
referralId |
1..1 |
string |
Номер направления (идентификатор направления в сервисе УО) |
patientSurname |
0..1 |
string |
Фамилия пациента (заполняется как в выданном направлении) |
Описание выходных данных
В ответе метода от целевой МО передается информация о доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению в формате Bundle типа collection. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы, кроме Patient, должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:
"fullUrl": "Тип ресурса/id ресурса"
например, "fullUrl": "Schedule/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание представлено в Таблице 2.
Таблица 2 – Описание ресурсов, входящих в состав Bundle
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
---|---|---|---|
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
|
Schedule |
Ссылка на PractitionerRole; |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты). |
|
PractitionerRole |
Ссылка на Organization (целевая МО); |
В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией для осуществления записи на прием) |
|
Practitioner |
|
В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС) |
|
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). |
|
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале) для оформления записи по направлению |
|
Parameters |
Ссылка на Schedule |
Ресурс предназначен для описания причины при отсутствии расписания |
Схема структуры Bundle приведена на Рисунке 3.
Рисунок 4. Структура ответа метода $searchslots
Описание ресурсов, входящих в состав Bundle
Patient
Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 3 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 3 - Параметры ресурса Patient
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Patient. |
|
identifier |
1..1 |
Identifier |
Идентификатор пациента в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора пациента в МИС МО. |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Пример фрагмента Bundle по ресурсу Patient приведен в разделе 4.2.4.
Schedule
Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 4 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 4 - Параметры ресурса Schedule
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Schedule. |
|
identifier |
1..1 |
Identifier |
Идентификатор расписания медицинского ресурса в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора расписания медицинского ресурса в МИС МО. |
|
actor |
1..3 |
Reference |
Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location) |
|
comment |
|
|
Код причины отсутствия свободных талонов в запрашиваемом периоде. |
Пример фрагмента Bundle по ресурсу Schedule приведен в разделе 4.2.4.
PractitionerRole
Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 5 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 5 - Параметры ресурса PractitionerRole
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса PractitionerRole. |
|
extention |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
|
2.1 |
extention.url |
1..1 |
uri |
Передаётся значение « https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group » |
2.2 |
extention.valueCodeableConcept |
0..1 |
CodeableConcept |
|
2.2.1 |
extention.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1.1 |
extention.valueCodeableConcept.coding. system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан») |
2.2.1.2 |
extention.valueCodeableConcept.coding. code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». |
identifier |
1..1 |
Identifier |
Идентификатор ресурса PractitionerRole в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса PractitionerRole в МИС МО. |
|
practitioner |
1..1 |
Reference(Practitioner) |
Ссылка на медицинского работника (ресурс Practitioner) |
|
organization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
|
code |
1..1 |
CodeableConcept |
Информация о должности медицинского работника |
|
code.coding |
3..3 |
Coding |
Информация о должности медицинского работника |
|
code.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о должности медицинского работника:
|
|
code.coding.code |
1..1 |
code |
Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника. |
|
code.coding.display |
1..1 |
string |
Наименование врачебной должности из справочника врачебных должностей целевой МИС МО. |
|
specialty |
1..1 |
CodeableConcept |
Информация о специальности медицинского работника |
|
specialty.coding |
2..2 |
Coding |
Информация о специальности медицинского работника |
|
specialty.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о специальности медицинского работника:
|
|
specialty.coding.code |
1..1 |
code |
Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника. |
|
specialty.coding.display |
1..1 |
string |
Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО. |
|
specialty.text |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности). |
|
availabilityExceptions |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к данному врачу). |
Пример фрагмента Bundle по ресурсу PractitionerRole приведен в разделе 4.2.4.
Practitioner
Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 6 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 6 - Параметры ресурса Practitioner
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Practitioner. |
|
identifier |
2..2 |
Identifier |
Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС) |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора или для СНИЛСа. |
|
name |
1..1 |
HumanName |
ФИО медицинского работника |
|
name.family |
1..1 |
string |
Фамилия. |
|
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. |
Пример фрагмента Bundle по ресурсу Practitioner приведен в разделе 4.2.4.
Location
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 7 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 7 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Location. |
|
identifier |
1..1 |
Identifier |
Идентификатор ресурса Location в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Location в МИС МО |
|
address |
1..1 |
Address |
Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём |
|
address.text |
1..1 |
string |
Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой. |
|
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
|
coding.system |
1..1 |
uri |
Указывается значение « http://terminology.hl7.org/CodeSystem/location-physical-type » |
|
coding.code |
1..1 |
code |
Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО) |
|
coding.display |
1..1 |
string |
Указывается значение «Building» |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Пример фрагмента Bundle по ресурсу Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём, приведен в разделе 4.2.4.
В Таблице 8 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 8 - Параметры ресурса Location (описание кабинета МО)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Location. |
|
extention |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
|
2.1 |
extention.url |
1..1 |
uri |
Передаётся значение « https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group » |
2.2 |
extention.valueCodeableConcept |
1..1 |
CodeableConcept |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
2.2.1 |
extention.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1.1 |
extention.valueCodeableConcept.coding. system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан») |
2.2.1.2 |
extention.valueCodeableConcept.coding. code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». |
identifier |
2..2 |
Identifier |
Идентификатор ресурса Location в МИС МО и OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 |
|
name |
1..1 |
string |
Наименование кабинета. |
|
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
|
coding.system |
1..1 |
uri |
Указывается значение « http://terminology.hl7.org/CodeSystem/location-physical-type » |
|
coding.code |
1..1 |
code |
Указывается значение «ro». |
|
coding.display |
1..1 |
string |
Указывается значение «Room» |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
|
partOf |
0..1 |
Reference(Location) |
Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания) |
Примеры фрагмента Bundle по ресурсу Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника) приведены в разделе 4.2.4.
Slot
Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по направлению.
В Таблице 9 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 9 - Параметры ресурса Slot
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Slot. |
|
identifier |
1..1 |
Identifier |
Идентификатор талона в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора талона в МИС МО. |
|
schedule |
1..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
|
status |
1..1 |
code |
Указывается значение «free» |
|
start |
1..1 |
instant |
Дата и время начала приема |
|
end |
1..1 |
instant |
Дата и время окончания приема |
|
comment |
0..1 |
string |
Номер талона в очереди. |
Пример фрагмента Bundle по ресурсу Slot приведен в разделе 4.2.4.
Parameters
Ресурс Parameters предназначен для описания причины отсутствия расписания (в отдельных параметрах по требованиям КУ ФЭР стр.137 v3.1.0).
В Таблица 10 представлено описание параметров ресурса Parameters. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 10 - Параметры ресурса Parameters
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Parameters. |
|
parameter |
0..* |
Identifier |
Параметры МО |
|
Parameter.MO_name |
1..1 |
string |
Название МО |
|
Parameter.MO_Address |
1..1 |
string |
Адресс МО |
|
Parameter.MO_Phone |
1..1 |
string |
Номер телефона МО |
|
referenceSchedule |
0..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
Пример фрагмента Bundle по ресурсу Parameters приведен в разделе 4.2.4.
Осуществление записи на приём к врачу по направлению ($setappointment)
Данный метод используется для осуществления в целевой МО записи на приём к врачу по направлению.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$setappointment.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 5 представлена схема информационного взаимодействия в рамках метода «Осуществление записи на приём к врачу по направлению ($setappointment)».
<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="dacc05b4-4a7b-497b-a5d6-86fa49839556"><ac:parameter ac:name="">_Ref43131662</ac:parameter></ac:structured-macro>Рисунок 5. Схема информационного взаимодействия в рамках метода «Осуществление записи на приём к врачу по направлению ($setappointment)»
Описание схемы:
- Клиент СЗПВ отправляет запрос метода «Осуществление записи на приём к врачу по направлению ($setappointment)» в СЗПВ. Состав параметров запроса представлен в Таблице 10.
- СЗПВ отправляет запрос метода SearchOne в сервис УО для получения данных о направлении.
- УО передает ответ метода SearchOne в СЗПВ с данными о направлении.
- В случае, если направление имеет статус 1, 2, 3, 4, 5 или 6 (по данным из шага 3), СЗПВ отправляет запрос метода «Осуществление записи на приём к врачу по направлению ($setappointment)» в целевое ЛПУ, определенное на шаге 3. Состав параметров запроса представлен в Таблице 10.
- Целевое ЛПУ передает ответ метода «Осуществление записи на приём к врачу по направлению ($setappointment)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.2.2.
- СЗПВ передает ответ метода «Осуществление записи на приём к врачу по направлению ($setappointment)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.2.2.
Описание параметров запроса
В Таблице 10 представлено описание параметров запроса метода $setappointment.
Таблица 11 – Описание параметров запроса метода $setappointment
Параметры |
Кратность |
Тип |
Описание |
---|---|---|---|
organizationId |
1..1 |
string |
Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы |
referralId |
1..1 |
string |
Номер направления (идентификатор направления в сервисе УО) |
patientId |
1..1 |
string |
Идентификатор пациента из соответствующего справочника целевой МИС |
slotId |
1..1 |
string |
Идентификатор талона для записи из соответствующего справочника целевой МИС |
previousSlotId |
0..1 |
string |
Идентификатор талона записи на прием, по которой необходимо произвести перенос даты и времени (указывается идентификатор талона по существующей записи на прием) |
Описание выходных данных
В ответе метода от целевой МО передается информация об успешной или неуспешной операции оформления записи на приём к врачу по направлению.
В случае успешной операции по оформлению записи на приём к врачу по направлению, в ответе метода передаётся ресурс OperationOutcome в формате «All OK» (пример ответа метода для успешной операции приведен в разделе 4.2.4).
В случае неуспешной операции по оформлению записи на приём к врачу по направлению, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.2.4).
Отмена записи на приём к врачу по направлению ($cancelappointment)
Данный метод используется для осуществления в целевой МО отмены записи на приём к врачу по направлению.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$cancelappointment.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 6 представлена схема информационного взаимодействия в рамках метода «Отмена записи на приём к врачу по направлению ($cancelappointment)».
<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="833b4fb2-31dd-439b-b55f-c3a414f19b53"><ac:parameter ac:name="">_Ref45036601</ac:parameter></ac:structured-macro>Рисунок 6. Схема информационного взаимодействия в рамках метода «Отмена записи на приём к врачу по направлению ($cancelappointment)»
Описание схемы:
- Клиент СЗПВ отправляет запрос метода «Отмена записи на приём к врачу по направлению ($cancelappointment)» в СЗПВ. Состав параметров запроса представлен в Таблице 11.
- СЗПВ отправляет запрос метода «Отмена записи на приём к врачу по направлению ($cancelappointment)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 11.
- Целевое ЛПУ передает ответ метода «Отмена записи на приём к врачу по направлению ($cancelappointment)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.3.2.
- СЗПВ передает ответ метода «Отмена записи на приём к врачу по направлению ($cancelappointment)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.3.2.
Описание параметров запроса
В Таблице 11 представлено описание параметров запроса метода $cancelappointment.
Таблица 12 – Описание параметров запроса метода $cancelappointment
Параметры |
Кратность |
Тип |
Описание |
---|---|---|---|
organizationId |
1..1 |
string |
Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы |
patientId |
1..1 |
string |
Идентификатор пациента из соответствующего справочника целевой МИС |
slotId |
1..1 |
string |
Идентификатор талона для записи из соответствующего справочника целевой МИС |
Описание выходных данных
В ответе метода от целевой МО передается информация об успешной или неуспешной операции отмены записи на приём к врачу по направлению.
В случае успешной операции по отмене записи на приём к врачу по направлению, в ответе метода передаётся ресурс OperationOutcome в формате «All OK» (пример ответа метода для успешной операции приведен в разделе 4.3.4).
В случае неуспешной операции по отмене записи на приём к врачу по направлению, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.3.4).
Уведомление о факте записи на приём по направлению ($notify)
Данный метод предназначен для передачи в СЗПВ сведений обо всех фактах записи на приём по направлениям в рамках МО. При передаче данных о факте записи на приём по направлению необходимо передавать дату и время осуществления записи на приём.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$notify.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 7 представлена схема информационного взаимодействия в рамках метода «Уведомление о факте записи на приём по направлению ($notify)».
<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="13e4c8a2-7573-412c-ad51-b8b4110be0ee"><ac:parameter ac:name="">_Ref48057844</ac:parameter></ac:structured-macro>Рисунок 7. Схема информационного взаимодействия в рамках метода «Уведомление о факте записи на приём по направлению ($notify)»
Описание схемы:
- Целевое ЛПУ отправляет запрос метода «Уведомление о факте записи на приём по направлению ($notify)» в СЗПВ. Состав параметров запроса метода представлен в разделе 4.5.1.
- СЗПВ передает ответ метода «Уведомление о факте записи на приём по направлению ($notify)» в целевое ЛПУ. Состав параметров ответа метода представлен в Таблице 23.
Описание параметров запроса
В запросе метода от целевой МО передается информация о ресурсах, описывающих факт записи на приём по направлению, в формате Bundle типа transaction. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы, кроме Patient и Organization (как ресурс, описывающий участника информационного обмена, осуществившего запись на приём), должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization как ресурс, описывающий целевую МО), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:
"fullUrl": "Тип ресурсаid ресурса"
например, "fullUrl": "Schedule/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи, где медицинским ресурсом выступает медицинский работник, представлено в Таблице 12.
Таблица 12 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
---|---|---|---|
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
|
Schedule |
Ссылка на PractitionerRole; |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает медицинский работник). |
|
PractitionerRole |
Ссылка на Organization (целевая МО); |
В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией по осуществлению записи на прием) |
|
Practitioner |
|
В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС) |
|
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о месте приема конкретного медицинского работника). |
|
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по направлению |
|
Appointment |
Ссылка на Organization (участник информационного обмена, осуществивший запись на приём); |
В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём и номер направления). |
|
Organization (участник информационного обмена, осуществивший запись на приём) |
|
В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём |
Схема структуры Bundle для факта записи, где медицинским ресурсом выступает медицинский работник, приведена на Рисунке 8.
Рисунок 8. Структура Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи, где медицинским ресурсом выступает кабинет, представлено в Таблице 13.
Таблица 13 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
---|---|---|---|
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
|
Schedule |
Ссылка на Location |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает кабинет). |
|
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги). |
|
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по направлению |
|
Appointment |
Ссылка на Organization (участник информационного обмена, осуществивший запись на приём); |
В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём и номер направления). |
|
Organization (участник информационного обмена, осуществивший запись на приём) |
|
В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём |
Схема структуры Bundle для факта записи, где медицинским ресурсом выступает кабинет, приведена на Рисунке 9.
Рисунок 10. Структура ответа метода $notify
Описание ресурсов, входящих в состав Bundle
Patient
Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 14 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 14 - Параметры ресурса Patient
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Patient. |
|
identifier |
1..4 |
Identifier |
Идентификатор пациента (идентификатор пациента в МИС МО, СНИЛС пациента, серия и номер полиса пациента, серия и номер документа, удостоверяющего личность пациента). |
|
identifier.system |
1..1 |
string |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора или для документа. |
|
name |
1..1 |
HumanName |
ФИО пациента |
|
name.family |
1..1 |
string |
Фамилия. |
|
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. |
|
telecom |
0..* |
ContactPoint |
Контактные телефоны пациента |
|
telecom.system |
1..1 |
code |
Передаётся значение «phone» |
|
telecom.value |
1..1 |
string |
Номер телефона. |
|
telecom.use |
1..1 |
code |
Передаётся одно из начений:
|
|
gender |
0..1 |
code |
Код пола пациента (справочник FHIR. OID: 1.2.643.2.69.1.1.1.40) |
|
birthDate |
1..1 |
date |
Дата рождения пациента |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Пример фрагмента Bundle по ресурсу Patient приведен в разделе 4.5.3.
Schedule
Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 15 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 15 - Параметры ресурса Schedule
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Schedule. |
|
identifier |
1..1 |
Identifier |
Идентификатор расписания медицинского ресурса в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора расписания медицинского ресурса в МИС МО. |
|
actor |
1..3 |
Reference |
Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location) |
Пример фрагмента Bundle по ресурсу Schedule приведен в разделе 4.5.3.
PractitionerRole
Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 16 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 16 - Параметры ресурса PractitionerRole
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса PractitionerRole. |
|
extention |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
|
2.1 |
extention.url |
1..1 |
uri |
Передаётся значение « https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group » |
2.2 |
extention.valueCodeableConcept |
|
|
|
2.2.1 |
extention.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1.1 |
extention.valueCodeableConcept.coding. system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан») |
2.2.1.2 |
extention.valueCodeableConcept.coding. code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». |
identifier |
1..1 |
Identifier |
Идентификатор ресурса PractitionerRole в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса PractitionerRole в МИС МО. |
|
practitioner |
1..1 |
Reference(Practitioner) |
Ссылка на медицинского работника (ресурс Practitioner) |
|
organization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
|
code |
1..1 |
CodeableConcept |
Информация о должности медицинского работника |
|
code.coding |
3..3 |
Coding |
Информация о должности медицинского работника |
|
code.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о должности медицинского работника:
|
|
code.coding.code |
1..1 |
code |
Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника. |
|
code.coding.display |
1..1 |
string |
Наименование врачебной должности из справочника врачебных должностей целевой МИС МО. |
|
specialty |
1..1 |
CodeableConcept |
Информация о специальности медицинского работника |
|
specialty.coding |
2..2 |
Coding |
Информация о специальности медицинского работника |
|
specialty.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о специальности медицинского работника:
|
|
specialty.coding.code |
1..1 |
code |
Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника. |
|
specialty.coding.display |
1..1 |
string |
Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО. |
|
specialty.text |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности). |
|
availabilityExceptions |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к данному врачу). |
Пример фрагмента Bundle по ресурсу PractitionerRole приведен в разделе 4.5.3.
Practitioner
Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 17 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 17 - Параметры ресурса Practitioner
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Practitioner. |
|
identifier |
2..2 |
Identifier |
Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС) |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора или для СНИЛСа. |
|
name |
1..1 |
HumanName |
ФИО медицинского работника |
|
name.family |
1..1 |
string |
Фамилия. |
|
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. |
Пример фрагмента Bundle по ресурсу Practitioner приведен в разделе 4.5.3.
Location
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 18 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 18 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Location. |
|
identifier |
1..1 |
Identifier |
Идентификатор ресурса Location в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Location в МИС МО |
|
address |
1..1 |
Address |
Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём |
|
address.text |
1..1 |
string |
Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой. |
|
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
|
coding.system |
1..1 |
uri |
Указывается значение « http://terminology.hl7.org/CodeSystem/location-physical-type » |
|
coding.code |
1..1 |
code |
Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО) |
|
coding.display |
1..1 |
string |
Указывается значение «Building» |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Пример фрагмента Bundle по ресурсу Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём, приведен в разделе 4.5.3.
В Таблице 19 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 19 - Параметры ресурса Location (описание кабинета МО)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Location. |
|
extention |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
|
2.1 |
extention.url |
1..1 |
uri |
Передаётся значение « https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group » |
2.2 |
extention.valueCodeableConcept |
1..1 |
CodeableConcept |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
2.2.1 |
extention.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1.1 |
extention.valueCodeableConcept.coding. system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан») |
2.2.1.2 |
extention.valueCodeableConcept.coding. code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». |
identifier |
2..2 |
Identifier |
Идентификатор ресурса Location в МИС МО и OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 |
|
name |
1..1 |
string |
Наименование кабинета. |
|
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
|
coding.system |
1..1 |
uri |
Указывается значение « http://terminology.hl7.org/CodeSystem/location-physical-type » |
|
coding.code |
1..1 |
code |
Указывается значение «ro». |
|
coding.display |
1..1 |
string |
Указывается значение «Room» |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
|
partOf |
0..1 |
Reference(Location) |
Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания) |
Примеры фрагмента Bundle по ресурсу Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника) приведены в разделе 4.5.3.
Slot
Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по направлению.
В Таблице 20 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 20 - Параметры ресурса Slot
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Slot. |
|
identifier |
1..1 |
Identifier |
Идентификатор талона в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора талона в МИС МО. |
|
schedule |
1..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
|
status |
1..1 |
code |
Указывается значение «busy» |
|
start |
1..1 |
instant |
Дата и время начала приема |
|
end |
1..1 |
instant |
Дата и время окончания приема |
|
comment |
0..1 |
string |
Номер талона в очереди. |
Пример фрагмента Bundle по ресурсу Slot приведен в разделе 4.5.3.
Appointment
Ресурс Appointment предназначен для передачи данных о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём и номер направления).
В Таблице 21 представлено описание параметров ресурса Appointment. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 21 - Параметры ресурса Appointment
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Appointment. |
|
identifier |
1..1 |
Identifier |
Идентификатор ресурса Appointment в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Appointment в МИС МО. |
|
status |
1..1 |
code |
Статус записи на приём. |
|
serviceType |
1..1 |
CodeableConcept |
Информация об услугах, на которые произведена запись (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070) |
|
coding.system |
1..* |
uri |
Указывается значение «urn:oid:1.2.643.5.1.13.13.11.1070» |
|
coding.code |
1..* |
code |
Указывается код из справочника «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070 |
|
supportingInformation |
1..1 |
Reference(Organization) |
Ссылка на данные по участнику информационного взаимодействия, осуществившего запись на приём |
|
start |
1..1 |
dateTime |
Дата и время начала приема |
|
end |
1..1 |
dateTime |
Дата и время окончания приема |
|
slot |
1..1 |
Reference(Slot) |
Ссылка на ресурс Slot (талон) |
|
created |
1..1 |
dateTime |
Дата осуществления записи на прием |
|
basedOn |
1..1 |
Reference(ServiceRequest) |
Номер направления. |
|
participant |
2..2 |
CodeableConcept |
Информация об участниках оказания услуги (пациент и кабинет/медицинский ресурс) |
|
actor.reference |
1..1 |
Reference(Patient, Location, PractitionerRole) |
Ссылка на ресурс Patient (пациент); |
|
status |
1..1 |
code |
Статус участника. Указывается значение «accepted» |
Пример фрагмента Bundle по ресурсу Appointment приведен в разделе 4.5.3.
Organization
Ресурс Organization предназначен для передачи данных об участнике информационного обмена, осуществившего запись на приём.
В Таблице 22 представлено описание параметров ресурса Organization. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 22 - Параметры ресурса Organization
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Organization. |
|
identifier |
1..1 |
Identifier |
Участник информационного взаимодействия, осуществивший запись |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Указывается публичный GUID |
|
type |
1..1 |
CodeableConcept |
Источник записи |
|
coding.system |
1..* |
uri |
Указывается значение «urn:oid:1.2.643.2.69.1.1.1.115» |
|
coding.code |
1..* |
code |
Указывается значение из справочника «Источники записи» |
Пример фрагмента Bundle по ресурсу Organization приведен в разделе 4.5.3.
Описание выходных данных
В Таблице 23 представлено описание выходных данных метода $notify.
Таблица 23 – Описание выходных данных метода $notify
Параметры |
Кратность |
Тип |
Описание |
---|---|---|---|
notificationId |
1..1 |
string |
Идентификатор уведомления о записи |
Уведомление об изменении записи на приём по направлению ($changenotification)
Данный метод предназначен для передачи в СЗПВ изменений ранее переданных методом $notify фактов записи на приём по направлению (например, изменился статус записи на приём по направлению).
Предполагается следующий сценарий использования метода «Уведомление об изменении записи на приём по направлению ($changenotification)»:
- МИС МО передает сведения в СЗПВ обо всех записях на приём по направлению путем вызова метода $notify для каждой записи.
- СЗПВ присваивает идентификатор уведомлению и возвращает его в ответе метода $notify.
- МИС МО сохраняет полученный идентификатор уведомления для последующего использования.
- После того, как произошло изменение записи на приём по направлению, МИС МО передает обновлённые сведения о записи по уже известному идентификатору уведомления путем вызова метода $changenotification для каждой записи.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$changenotification.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 11 представлена схема информационного взаимодействия в рамках метода «Уведомление об изменении записи на приём по направлению ($changenotification)».
<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="f949367d-4f3b-4970-8c0c-6dc60a93ceb2"><ac:parameter ac:name="">_Ref48066812</ac:parameter></ac:structured-macro>Рисунок 11. Схема информационного взаимодействия в рамках метода «Уведомление об изменении записи на приём по направлению ($changenotification)»
Описание схемы:
- Целевое ЛПУ отправляет запрос метода «Уведомление об изменении записи на приём по направлению ($changenotification)» в СЗПВ. Состав параметров запроса метода представлен в разделе 4.6.1.
- СЗПВ передает ответ метода «Уведомление об изменении записи на приём по направлению ($changenotification)» в целевое ЛПУ. Состав параметров ответа метода представлен в разделе 4.6.2.
Описание параметров запроса
В запросе метода от целевой МО передается информация о ресурсах, описывающих факт записи на приём по направлению (включая изменённую информацию), в формате Bundle типа transaction. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы, кроме Patient и Organization (как ресурс, описывающий участника информационного обмена, осуществившего запись на приём), должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization как ресурс, описывающий целевую МО), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:
"fullUrl": "[Тип ресурса]/[id ресурса]"
например, "fullUrl": "Schedule/31f34a1f-2984-43cc-b2c1-33cd077370de".
В рамках ресурса Bundle необходимо передавать параметр id с наполнением полученного ранее идентификатора уведомления о записи посредством метода «Уведомление о факте записи на приём по направлению ($notify)» (выходной параметр «notificationId»).
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи (включая изменённую информацию), где медицинским ресурсом выступает медицинский работник, представлено в Таблице 24.
Таблица 24 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
---|---|---|---|
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
|
Schedule |
Ссылка на PractitionerRole; |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает медицинский работник). |
|
PractitionerRole |
Ссылка на Organization (целевая МО); |
В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией по осуществлению записи на прием) |
|
Practitioner |
|
В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС) |
|
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о месте приема конкретного медицинского работника). |
|
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по направлению |
|
Appointment |
Ссылка на Organization (участник информационного обмена, осуществивший запись на приём); |
В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём, дата изменения записи на приём и номер направления). |
|
Organization (участник информационного обмена, осуществивший запись на приём) |
|
В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём |
Схема структуры Bundle для факта записи (включая изменённую информацию), где медицинским ресурсом выступает медицинский работник, приведена на Рисунке 12.
Рисунок 12. Структура Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи (включая изменённую информацию), где медицинским ресурсом выступает кабинет, представлено в Таблице 25.
Таблица 25 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
---|---|---|---|
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
|
Schedule |
Ссылка на Location |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает кабинет). |
|
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги). |
|
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по направлению |
|
Appointment |
Ссылка на Organization (участник информационного обмена, осуществивший запись на приём); |
В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём, дата изменения записи на приём и номер направления). |
|
Organization (участник информационного обмена, осуществивший запись на приём) |
|
В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём |
Схема структуры Bundle для факта записи (включая изменённую информацию), где медицинским ресурсом выступает кабинет, приведена на Рисунке 13.
Рисунок 14. Структура ответа метода $changenotification
Описание ресурсов, входящих в состав Bundle
Patient
Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 26 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 26 - Параметры ресурса Patient
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Patient. |
|
identifier |
1..4 |
Identifier |
Идентификатор пациента (идентификатор пациента в МИС МО, СНИЛС пациента, серия и номер полиса пациента, серия и номер документа, удостоверяющего личность пациента). |
|
identifier.system |
1..1 |
string |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора или для документа. |
|
name |
1..1 |
HumanName |
ФИО пациента |
|
name.family |
1..1 |
string |
Фамилия. |
|
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. |
|
telecom |
0..* |
ContactPoint |
Контактные телефоны пациента |
|
telecom.system |
1..1 |
code |
Передаётся значение «phone» |
|
telecom.value |
1..1 |
string |
Номер телефона. |
|
telecom.use |
1..1 |
code |
Передаётся одно из начений:
|
|
gender |
0..1 |
code |
Код пола пациента (справочник FHIR. OID: 1.2.643.2.69.1.1.1.40) |
|
birthDate |
1..1 |
date |
Дата рождения пациента |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Пример фрагмента Bundle по ресурсу Patient приведен в разделе 4.6.3.
Schedule
Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 27 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 27 - Параметры ресурса Schedule
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Schedule. |
|
identifier |
1..1 |
Identifier |
Идентификатор расписания медицинского ресурса в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора расписания медицинского ресурса в МИС МО. |
|
actor |
1..3 |
Reference |
Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location) |
Пример фрагмента Bundle по ресурсу Schedule приведен в разделе 4.6.3.
PractitionerRole
Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 28 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 28 - Параметры ресурса PractitionerRole
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса PractitionerRole. |
|
extention |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
|
2.1 |
extention.url |
1..1 |
uri |
Передаётся значение « https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group » |
2.2 |
extention.valueCodeableConcept |
|
|
|
2.2.1 |
extention.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1.1 |
extention.valueCodeableConcept.coding. system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан») |
2.2.1.2 |
extention.valueCodeableConcept.coding. code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». |
identifier |
1..1 |
Identifier |
Идентификатор ресурса PractitionerRole в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса PractitionerRole в МИС МО. |
|
practitioner |
1..1 |
Reference(Practitioner) |
Ссылка на медицинского работника (ресурс Practitioner) |
|
organization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
|
code |
1..1 |
CodeableConcept |
Информация о должности медицинского работника |
|
code.coding |
3..3 |
Coding |
Информация о должности медицинского работника |
|
code.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о должности медицинского работника:
|
|
code.coding.code |
1..1 |
code |
Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника. |
|
code.coding.display |
1..1 |
string |
Наименование врачебной должности из справочника врачебных должностей целевой МИС МО. |
|
specialty |
1..1 |
CodeableConcept |
Информация о специальности медицинского работника |
|
specialty.coding |
2..2 |
Coding |
Информация о специальности медицинского работника |
|
specialty.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о специальности медицинского работника:
|
|
specialty.coding.code |
1..1 |
code |
Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника. |
|
specialty.coding.display |
1..1 |
string |
Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО. |
|
specialty.text |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности). |
|
availabilityExceptions |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к данному врачу). |
Пример фрагмента Bundle по ресурсу PractitionerRole приведен в разделе 4.6.3.
Practitioner
Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 29 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 29 - Параметры ресурса Practitioner
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Practitioner. |
|
identifier |
2..2 |
Identifier |
Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС) |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора или для СНИЛСа. |
|
name |
1..1 |
HumanName |
ФИО медицинского работника |
|
name.family |
1..1 |
string |
Фамилия. |
|
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. |
Пример фрагмента Bundle по ресурсу Practitioner приведен в разделе 4.6.3.
Location
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 30 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 30 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Location. |
|
identifier |
1..1 |
Identifier |
Идентификатор ресурса Location в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Location в МИС МО |
|
address |
1..1 |
Address |
Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём |
|
address.text |
1..1 |
string |
Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой. |
|
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
|
coding.system |
1..1 |
uri |
Указывается значение « http://terminology.hl7.org/CodeSystem/location-physical-type » |
|
coding.code |
1..1 |
code |
Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО) |
|
coding.display |
1..1 |
string |
Указывается значение «Building» |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Пример фрагмента Bundle по ресурсу Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём, приведен в разделе 4.6.3.
В Таблице 31 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 31 - Параметры ресурса Location (описание кабинета МО)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Location. |
|
extention |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
|
2.1 |
extention.url |
1..1 |
uri |
Передаётся значение « https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group » |
2.2 |
extention.valueCodeableConcept |
1..1 |
CodeableConcept |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
2.2.1 |
extention.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1.1 |
extention.valueCodeableConcept.coding. system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан») |
2.2.1.2 |
extention.valueCodeableConcept.coding. code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». |
identifier |
2..2 |
Identifier |
Идентификатор ресурса Location в МИС МО и OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 |
|
name |
1..1 |
string |
Наименование кабинета. |
|
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
|
coding.system |
1..1 |
uri |
Указывается значение « http://terminology.hl7.org/CodeSystem/location-physical-type » |
|
coding.code |
1..1 |
code |
Указывается значение «ro». |
|
coding.display |
1..1 |
string |
Указывается значение «Room» |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
|
partOf |
0..1 |
Reference(Location) |
Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания) |
Примеры фрагмента Bundle по ресурсу Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника) приведены в разделе 4.6.3.
Slot
Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по направлению.
В Таблице 32 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 32 - Параметры ресурса Slot
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Slot. |
|
identifier |
1..1 |
Identifier |
Идентификатор талона в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора талона в МИС МО. |
|
schedule |
1..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
|
status |
1..1 |
code |
Указывается значение «busy» (занят) или «free» (свободен) – в зависимости от статуса записи на приём |
|
start |
1..1 |
instant |
Дата и время начала приема |
|
end |
1..1 |
instant |
Дата и время окончания приема |
|
comment |
0..1 |
string |
Номер талона в очереди. |
Пример фрагмента Bundle по ресурсу Slot приведен в разделе 4.6.3.
Appointment
Ресурс Appointment предназначен для передачи данных о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём и номер направления).
В Таблице 33 представлено описание параметров ресурса Appointment. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 33 - Параметры ресурса Appointment
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Appointment. |
|
extension |
1..1 |
code |
Признак жителя города или села («Признак жителя города или села», OID 1.2.643.5.1.13.13.11.1042). |
|
extension.url |
1..1 |
uri |
Передаётся значение « https://portal.egisz.rosminzdrav.ru/materials/541:Is_Villager » |
|
extension.valueCodeableConcept.coding.system |
1..1 |
uri |
Передаётся значение «urn:oid:1.2.643.5.1.13.13.11.1042» |
|
extension.valueCodeableConcept.coding.code |
1..1 |
uri |
Передаётся код из справочника «Признак жителя города или села» (OID 1.2.643.5.1.13.13.11.1042):
|
|
identifier |
1..1 |
Identifier |
Идентификатор ресурса Appointment в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Appointment в МИС МО. |
|
status |
1..1 |
code |
Статус записи на приём. |
|
serviceType |
1..1 |
CodeableConcept |
Информация об услугах, на которые произведена запись (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070) |
|
coding.system |
1..* |
uri |
Указывается значение «urn:oid:1.2.643.5.1.13.13.11.1070» |
|
coding.code |
1..* |
code |
Указывается код из справочника «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070 |
|
appointmentType |
1..1 |
CodeableConcept |
Причина приёма. |
|
coding.system |
1..1 |
uri |
Указывается значение « http://terminology.hl7.org/CodeSystem/v2-0276 » |
|
coding.code |
1..1 |
code |
|
|
supportingInformation |
1..1 |
Reference(Organization) |
Ссылка на данные по участнику информационного взаимодействия, осуществившего запись на приём |
|
start |
1..1 |
dateTime |
Дата и время начала приема |
|
end |
1..1 |
dateTime |
Дата и время окончания приема |
|
slot |
1..1 |
Reference(Slot) |
Ссылка на ресурс Slot (талон) |
|
created |
1..1 |
dateTime |
Дата осуществления записи на прием |
|
basedOn |
1..1 |
Reference(ServiceRequest) |
Номер направления. |
|
participant |
2..2 |
CodeableConcept |
Информация об участниках оказания услуги (пациент и кабинет/медицинский ресурс) |
|
actor.reference |
1..1 |
Reference(Patient, Location, PractitionerRole) |
Ссылка на ресурс Patient (пациент); |
|
status |
1..1 |
code |
Статус участника. |
Пример фрагмента Bundle по ресурсу Appointment приведен в разделе 4.6.3.
Organization
Ресурс Organization предназначен для передачи данных об участнике информационного обмена, осуществившего запись на приём.
В Таблице 34 представлено описание параметров ресурса Organization. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 34 - Параметры ресурса Organization
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Organization. |
|
identifier |
1..1 |
Identifier |
Участник информационного взаимодействия, осуществивший запись |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Указывается публичный GUID |
|
type |
1..1 |
CodeableConcept |
Источник записи |
|
coding.system |
1..* |
uri |
Указывается значение «urn:oid:1.2.643.2.69.1.1.1.115» |
|
coding.code |
1..* |
code |
Указывается значение из справочника «Источники записи» |
Пример фрагмента Bundle по ресурсу Organization приведен в разделе 4.6.3.
Описание выходных данных
В ответе метода от СЗПВ передается информация об успешном или неуспешном приёме от МИС МО данных с информацией об изменении записи на приём по направлению.
В случае успешного приёма от МИС МО данных с информацией об изменении записи на приём по направлению, в ответе метода передаётся ресурс OperationOutcome в формате «All OK» (пример ответа метода для успешной операции приведен в разделе 4.6.4).
В случае неуспешного приёма от МИС МО данных с информацией об изменении записи на приём по направлению, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.6.4).
Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)
Данный метод используется для получения от целевой МО справочной информации по количеству доступных талонов для записи по направлению.
При получении запроса целевая МО самостоятельно определяет набор параметров, на которые ориентируется при формировании информации по массиву доступных талонов, вне зависимости от того, какие параметры запроса заполнены.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$getreferenceinfo.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 15 представлена схема информационного взаимодействия в рамках метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)».
<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="c6e6f7e1-22cd-4cf2-85cb-e76503ca93fe"><ac:parameter ac:name="">_Ref60243811</ac:parameter></ac:structured-macro>Рисунок 15. Схема информационного взаимодействия в рамках метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)»
Описание схемы:
- Клиент СЗПВ отправляет запрос метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)» в СЗПВ. Состав параметров запроса представлен в Таблице 35.
- СЗПВ отправляет запрос метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 35.
- Целевое ЛПУ передает ответ метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.7.2.
- СЗПВ передает ответ метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.7.2.
Описание параметров запроса
В Таблице 35 представлено описание параметров запроса метода $getreferenceinfo.
Таблица 35 – Описание параметров запроса метода $getreferenceinfo
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
organizationId |
1..1 |
string |
При обращении клиента сервиса к СЗПВ необходимо передавать идентификатор МО из справочника с OID 1.2.643.2.69.1.1.1.64. |
|
mkbCode |
0..1 |
String |
Код заболевания. Значение в соответствии с МКБ-10. OID справочника: 1.2.643.2.69.1.1.1.2 |
|
priority |
0..1 |
String |
Комментарий о приоритете и состоянии пациента. |
|
privilegeType |
0..1 |
String |
Код льготы пациента. OID справочника: 1.2.643.2.69.1.1.1.7 |
|
profileMedService |
1..1 |
String |
Идентификатор составного профиля помощи. OID справочника: 1.2.643.2.69.1.1.1.56 |
|
reason |
0..1 |
String |
Основание направления, цель направления пациента. |
|
sourceLPU |
1..1 |
String |
Идентификатор МО, направляющей пациента. OID справочника: 1.2.643.2.69.1.1.1.64 |
|
surveyOrgan |
0..1 |
String |
Идентификатор области исследования. OID справочника: 1.2.643.2.69.1.1.1.58 |
|
surveyType |
0..1 |
String |
Идентификатор вида исследования. OID справочника: 1.2.643.2.69.1.1.1.57 |
|
patient |
0..1 |
|
Данные о пациенте |
|
Patient.identifier |
0..4 |
Identifier |
Идентификатор пациента (идентификатор пациента в МИС МО, СНИЛС пациента, серия и номер полиса пациента, серия и номер документа, удостоверяющего личность пациента). |
|
Patient.identifier.system |
1..1 |
string |
Пространство имён идентификатора.
|
|
Patient.identifier.value |
1..1 |
string |
Значение для идентификатора или для документа. |
|
Patient.name |
0..1 |
HumanName |
ФИО пациента |
|
Patient.name.family |
0..1 |
string |
Фамилия. |
|
Patient.name.given |
0..2 |
string |
Имя, Отчество. Сначала указывается Имя. |
|
Patient.telecom |
0..* |
ContactPoint |
Контактные телефоны пациента |
|
Patient.telecom.system |
1..1 |
code |
Передаётся значение «phone» |
|
Patient.telecom.value |
1..1 |
string |
Номер телефона. |
|
Patient.telecom.use |
1..1 |
code |
Передаётся одно из начений:
|
|
Patient.gender |
0..1 |
code |
Код пола пациента (справочник FHIR. OID: 1.2.643.2.69.1.1.1.40) |
|
Patient.birthDate |
0..1 |
date |
Дата рождения пациента |
Описание выходных данных
В ответе метода от целевой МО передается справочная информация о доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению в формате Bundle типа collection. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы, кроме Patient, должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:
"fullUrl": "[Тип ресурса]/[id ресурса]"
например, "fullUrl": "Schedule/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание представлено в Таблице 36.
Таблица 36 – Описание ресурсов, входящих в состав Bundle
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
---|---|---|---|
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
|
Schedule |
Ссылка на PractitionerRole; |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты). |
|
PractitionerRole |
Ссылка на Organization (целевая МО); |
В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией для осуществления записи на прием) |
|
Practitioner |
|
В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС) |
|
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). |
|
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале) для оформления записи по направлению |
|
Parameters |
Ссылка на Schedule |
Ресурс предназначен для описания причины при отсутствии расписания |
Схема структуры Bundle приведена на Рисунке 16.
Рисунок 17. Структура ответа метода $getreferenceinfo
Описание ресурсов, входящих в состав Bundle
Patient
Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 37 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 37 - Параметры ресурса Patient
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
0..1 |
id |
Идентификатор ресурса Patient. |
|
identifier |
0..1 |
Identifier |
Идентификатор пациента в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора пациента в МИС МО. |
|
managingOrganization |
0..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Пример фрагмента Bundle по ресурсу Patient приведен в разделе 4.7.4.
Schedule
Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 38 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 38 - Параметры ресурса Schedule
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Schedule. |
|
identifier |
1..1 |
Identifier |
Идентификатор расписания медицинского ресурса в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора расписания медицинского ресурса в МИС МО. |
|
actor |
1..3 |
Reference |
Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location) |
|
comment |
|
|
Код причины отсутствия свободных талонов в запрашиваемом периоде. Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.222 «Причины отсутствия талонов». Должен передаваться, если отсутствуют свободные слоты за все дни из запрашиваемого диапаз талонов в запрашиваемом периоде. |
Пример фрагмента Bundle по ресурсу Schedule приведен в разделе 4.7.4.
PractitionerRole
Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 39 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 39 - Параметры ресурса PractitionerRole
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса PractitionerRole. |
|
extention |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
|
2.1 |
extention.url |
1..1 |
uri |
Передаётся значение « https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group » |
2.2 |
extention.valueCodeableConcept |
|
|
|
2.3 |
extention.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.4 |
extention.valueCodeableConcept.coding. system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан») |
2.5 |
extention.valueCodeableConcept.coding. code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». |
identifier |
1..1 |
Identifier |
Идентификатор ресурса PractitionerRole в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса PractitionerRole в МИС МО. |
|
practitioner |
1..1 |
Reference(Practitioner) |
Ссылка на медицинского работника (ресурс Practitioner) |
|
organization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
|
code |
1..1 |
CodeableConcept |
Информация о должности медицинского работника |
|
code.coding |
3..3 |
Coding |
Информация о должности медицинского работника |
|
code.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о должности медицинского работника:
|
|
code.coding.code |
1..1 |
code |
Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника. |
|
code.coding.display |
1..1 |
string |
Наименование врачебной должности из справочника врачебных должностей целевой МИС МО. |
|
specialty |
1..1 |
CodeableConcept |
Информация о специальности медицинского работника |
|
specialty.coding |
2..2 |
Coding |
Информация о специальности медицинского работника |
|
specialty.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о специальности медицинского работника:
|
|
specialty.coding.code |
1..1 |
code |
Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника. |
|
specialty.coding.display |
1..1 |
string |
Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО. |
|
specialty.text |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности). |
|
availabilityExceptions |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к данному врачу). |
Пример фрагмента Bundle по ресурсу PractitionerRole приведен в разделе 4.7.4.
Practitioner
Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 40 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 40 - Параметры ресурса Practitioner
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Practitioner. |
|
identifier |
2..2 |
Identifier |
Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС) |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора или для СНИЛСа. |
|
name |
1..1 |
HumanName |
ФИО медицинского работника |
|
name.family |
1..1 |
string |
Фамилия. |
|
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. |
Пример фрагмента Bundle по ресурсу Practitioner приведен в разделе 4.7.4.
Location
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 41 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 41 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Location. |
|
identifier |
1..1 |
Identifier |
Идентификатор ресурса Location в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Location в МИС МО |
|
address |
1..1 |
Address |
Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём |
|
address.text |
1..1 |
string |
Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой. |
|
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
|
coding.system |
1..1 |
uri |
Указывается значение « http://terminology.hl7.org/CodeSystem/location-physical-type » |
|
coding.code |
1..1 |
code |
Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО) |
|
coding.display |
1..1 |
string |
Указывается значение «Building» |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Пример фрагмента Bundle по ресурсу Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём, приведен в разделе 4.7.4.
В Таблице 42 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 42 - Параметры ресурса Location (описание кабинета МО)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Location. |
|
extention |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
|
2.1 |
extention.url |
1..1 |
uri |
Передаётся значение « https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group » |
2.2 |
extention.valueCodeableConcept |
|
|
|
2.2.1 |
extention.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1.1 |
extention.valueCodeableConcept.coding. system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан») |
identifier |
2..2 |
Identifier |
Идентификатор ресурса Location в МИС МО и OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора.
|
|
identifier.value |
1..1 |
string |
Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 |
|
name |
1..1 |
string |
Наименование кабинета. |
|
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
|
coding.system |
1..1 |
uri |
Указывается значение « http://terminology.hl7.org/CodeSystem/location-physical-type » |
|
coding.code |
1..1 |
code |
Указывается значение «ro». |
|
coding.display |
1..1 |
string |
Указывается значение «Room» |
|
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
|
partOf |
0..1 |
Reference(Location) |
Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания) |
Примеры фрагмента Bundle по ресурсу Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника) приведены в разделе 4.7.4.
Slot
Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по направлению.
В Таблице 43 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 43 - Параметры ресурса Slot
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Slot. |
|
identifier |
1..1 |
Identifier |
Идентификатор талона в МИС МО |
|
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. |
|
identifier.value |
1..1 |
string |
Значение идентификатора талона в МИС МО. |
|
schedule |
1..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
|
status |
1..1 |
code |
Указывается значение «free» |
|
start |
1..1 |
instant |
Дата и время начала приема |
|
end |
1..1 |
instant |
Дата и время окончания приема |
|
comment |
0..1 |
string |
Номер талона в очереди. |
Пример фрагмента Bundle по ресурсу Slot приведен в разделе 4.7.4.
Parameters
Ресурс Parameters предназначен для описания причины отсутствия расписания (в отдельных параметрах по требованиям КУ ФЭР стр.137 v3.1.0).
В Таблица 45 представлено описание параметров ресурса Parameters. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 45 - Параметры ресурса Parameters
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
---|---|---|---|---|
id |
1..1 |
id |
Идентификатор ресурса Parameters. |
|
parameter |
0..* |
Identifier |
Параметры МО |
|
Parameter.MO_name |
1..1 |
string |
Название МО |
|
Parameter.MO_Address |
1..1 |
string |
Адресс МО |
|
Parameter.MO_Phone |
1..1 |
string |
Номер телефона МО |
|
referenceSchedule |
0..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
Пример фрагмента Bundle по ресурсу Parameters приведен в разделе 4.7.4.
Приложение 1. Справочник ошибок
Идентификатор ошибки |
Текст ошибки |
1 |
Не был указан/указан неверно guid при вызове метода |
2 |
Отсутствует доступ или не найдена конечная точка |
3 |
Время ожидания истекло |
4 |
Получен не полный набор данных для выполнения метода |
5 |
На стороне сервиса МИС метод не поддержан |
6 |
Техническая ошибка на стороне МИС |
7 |
Техническая ошибка. Медицинская система учреждения не поддержала данную функциональность. |
8 |
Нет связи с сервисом "Управление очередями" |
9 |
Не удалось определить ЛПУ для обращения за талонами |
10 |
Учреждение с данным идентификатором отсутствует в справочнике |
11 |
Отсутствуют данные целевой МО |
12 |
Ошибка в сервисе УО |
13 |
Недействительное значение параметра |
14 |
Неверный формат входящего параметра |
15 |
Внутренняя ошибка сервиса |
16 |
МИС медицинской организации передала некорректные данные |
20 |
Пациент с заданными параметрами не найден |
21 |
Данные пациента не являются уникальными |
22 |
Несоответствие записи акта гражданского состояния |
23 |
МИС не вернула идентификатор пациента |
30 |
Запись запрещена |
31 |
Расхождения в данных прикрепления пациента |
32 |
Несоответствие сроков действия полиса ОМС |
33 |
Специальность врача не соответствует профилю пациента |
34 |
Нарушение порядка и периодичности записи |
35 |
Пациент имеет предстоящую запись к данному врачу/врачу этой специальности |
36 |
Пациент не имеет прикрепления к данному учреждению или участку |
37 |
Указан недопустимый идентификатор пациента |
38 |
Указан недопустимый идентификатор талона на запись |
39 |
Талон к врачу занят/заблокирован |
40 |
Пациент уже имеет запись на это время к другому врачу |
41 |
Отсутствует информация о врачебных участках по пациенту |
42 |
Указан некорректный идентификатор медицинского осмотра |
43 |
Указан некорректный идентификатор медицинской услуги |
44 |
Указан некорректный идентификатор медицинского ресурса |
45 |
Не найдено расписание медицинского ресурса |
46 |
Отмена записи невозможна, медицинская услуга уже оказана |
47 |
Отмена записи невозможна, медицинская услуга обязательна |
48 |
Указан некорректный идентификатор сессии |
49 |
Статус заявки не изменен. Статус заявки может быть изменен согласно правилам статусной модели |
50 |
Значение PARequestPatientContacts.Phone не может быть пустым |
51 |
Значение PARequestPatientContacts.Phone имеет неверный формат |
52 |
Значение PARequestPatientContacts.Email имеет неверный формат |
53 |
Значение PASource должно соответствовать одному из значений справочника "Источник записи" |
60 |
Указан недопустимый идентификатор врача |
61 |
Указаны недопустимые интервалы времени |
62 |
Дата осуществления записи на прием должна быть меньше или равна дате начала приема (NoticeAppointment) |
63 |
Дата начала приема должна быть больше или равна дате отправки запроса (Appointment) |
64 |
Дата и время начала приема должна быть меньше или равна дате и времени окончания приема |
65 |
Дата осуществления записи на прием должна быть меньше или равна дате отправки запроса (NoticeAppointment) |
66 |
Дата и время изменения статуса записи на прием должна быть больше или равна дате и времени осуществления записи на прием |
67 |
Дата и время изменения статуса записи на прием должна быть меньше или равна дате и времени отправки запроса |
70 |
Указан недопустимый идентификатор специальности |
71 |
В запросе запрещено одновременное заполнение параметров: идентификатора специальности и федерального идентификатора специальности |
72 |
Нет доступного врача для вызова врача на дом |
73 |
Нет доступных слотов для вызова врача на дом |
75 |
Талон с указанным номером не существует или уже отменен |
76 |
Направление не найдено по параметрам поиска |
77 |
Направление найдено, но не прошло проверку на актуальность |
80 |
Нет прикрепления к ЛПУ |
90 |
Сведения о записи не найдены |
91 |
Неизвестный источник записи |
92 |
Заявка {idPar} не найдена среди активных заявок |
94 |
Неизвестный статус записи |
99 |
Текст ответа МИС – в случае необходимости передачи определенной информации клиенту сервиса, инициирующему запрос метода |
101 |
Техническая ошибка на стороне Fer |