Сервис позволяет организовать предоставление электронной услуги «Запись по диспансерному наблюдению» на уровне региона посредством интеграции всех медицинских систем в единое информационное пространство.
Описание решения
Обновленный Сервис записи на приём к врачу (версия 3.0) предназначен для предоставления услуг записи посредством информационного взаимодействия ИС через API Интеграционной платформы.
Услуга «Запись по диспансерному наблюдению» в рамках обновленного сервиса записи на прием к врачу (версия 3.0) предоставляет возможность оформления записи по диспансерному наблюдению (запись на прием к врачу, осуществляющему диспансерное наблюдение пациента) в электронном виде и обеспечивает поддержку федеральных требований оказания данной услуги через КУ ФЭР (ЕПГУ - Госуслуги).
Участниками процесса в рамках услуги «Запись по диспансерному наблюдению» являются:
- СЗПВ;
- Клиент СЗПВ (инициатор оформления записи);
- МИС целевой МО (владелец расписания медицинских ресурсов для записи по диспансерному наблюдению).
Описание протокола взаимодействия
Общая информация о сервисе
Информационный обмен осуществляется в соответствии со стандартом FHIR® (Fast Healthcare Interoperability Resources), разработанным организацией HL7. Используемая версия FHIR Release 4, 4.0.1. Подробное описание стандарта доступно по следующим ссылкам:
В качестве протокола взаимодействия используется REST (использование REST-протокола в FHIR® – см. http://fhir-ru.github.io/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.64)
- «Классификатор половой принадлежности» (OID 1.2.643.5.1.13.2.1.1.156)
- Справочник «Роль пользователя»
- Справочник «Источники записи» (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)
- «ФРМО. Справочник отделений и кабинетов» (OID2.643.5.1.13.13.99.2.115)
- Справочник причин приёма https://terminology.hl7.org/1.0.0/CodeSystem-v2-0276.html
- «ФРМО. Типы врачебных участков» (OID 2.643.5.1.13.13.99.2.639)
- Справочник «Возрастная категория граждан» (OID2.643.2.69.1.1.1.223)
- Справочник «Причины отсутствия талонов» (OID 1.2.643.2.69.1.1.1.222)
- Справочник ошибок
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]
Формат ответа метода:
{
"success": true,
"resultcode": 0,
"message": null,
"content": {
"token": "YourProcessId",
"startDate": "2019-11-11T11:16:32.2089653Z",
"endDate": "2019-11-11T11:36:32.2089672Z"
}
}
, где
наполнение параметра token – идентификатор процесса,
наполнение параметра startDate - дата начала действия идентификатора процесса,
наполнение параметра endDate - дата истечения срока действия идентификатора процесса.
Описание методов сервиса
Список методов сервиса
Сервис записи на приём к врачу в части услуги «Запись по диспансерному наблюдению» содержит следующие методы:
- Поиск данных о диспансерном учете ($getdispensaryobservationinfo);
- Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources);
- Поиск доступных талонов для записи по диспансерному наблюдению ($searchslots);
- Осуществление записи по диспансерному наблюдению ($setappointment);
- Отмена записи по диспансерному наблюдению ($cancelappointment);
- Уведомление о факте записи по диспансерному наблюдению ($notify);
- Уведомление об изменении записи по диспансерному наблюдению ($changenotification).
Метод «Поиск идентификатора пациента в МИС МО ($getpatientid)», используемый в рамках услуги «Запись по диспансерному наблюдению», относится к базовым методам сервиса и его описание приведено в отдельном документе.
Обязательность параметров, используемых в запросах, указана в соответствующих таблицах. При этом используются следующие обозначения:
- .1 - параметр необязательный, максимальное количество экземпляров один;
- .* – параметр необязательный, максимальное количество экземпляров не ограничено;
- .1 – параметр обязательный, экземпляр один;
- .2 – параметр обязательный, экземпляр один или два;
- .3 – параметр обязательный, экземпляр один, два или три;
- .* – параметр обязательный, максимальное количество экземпляров не ограничено;
- .2 – параметр обязательный, два экземпляра.
Значения параметров методов, имеющих тип Datetime, необходимо передавать в формате UTC с указанием таймзоны. Если таймзона не указана, то в рамках сервиса считается, что передано локальное время (региональное), и сервис работает с переданным значением как с "датой, для которой не указана таймзона".
Поиск данных о диспансерном учете ($getdispensaryobservationinfo)
Данный метод используется для поиска в целевой МО данных о диспансерном учете по пациенту.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/dispensaryobservation/fhir/$getdispensaryobservationinfo.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html
На Рисунке 2 представлена схема информационного взаимодействия в рамках метода «Поиск данных о диспансерном учете ($getdispensaryobservationinfo)».
Рисунок 2. Схема информационного взаимодействия в рамках метода «Поиск данных о диспансерном учете ($getdispensaryobservationinfo)»
Описание схемы:
- Клиент СЗПВ отправляет запрос метода «Поиск данных о диспансерном учете ($getdispensaryobservationinfo)» в СЗПВ. Состав параметров запроса представлен в Таблице 1.
- СЗПВ отправляет запрос метода «Поиск данных о диспансерном учете ($getdispensaryobservationinfo)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 1.
- Целевое ЛПУ передает ответ метода «Поиск данных о диспансерном учете ($getdispensaryobservationinfo)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.2.4.
СЗПВ передает ответ метода «Поиск данных о диспансерном учете ($getdispensaryobservationinfo)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.2.4
Описание параметров запроса
В Таблице 1 представлено описание параметров запроса метода $getdispensaryobservationinfo.
Таблица 1 – Описание параметров запроса метода $getdispensaryobservationinfo
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
organizationId |
1..1 |
string |
Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы |
2. |
patientId |
1..1 |
string |
Идентификатор пациента из соответствующего справочника целевой МИС |
Описание выходных данных
В ответе метода от целевой МО передается информация о диспансерном учете пациента в формате Bundle типа collection. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы должны быть связаны либо с ресурсом Parameters, либо с ресурсом, связанным с ресурсом Parameters. Под ресурсом, связанным с ресурсом Parameters, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Parameters, либо в ресурсе Parameters имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:
"fullUrl": "[Тип ресурса]/[id ресурса]"
например, "fullUrl": "PractitionerRole/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание представлено в Таблице 2.
Таблица 2 – Описание ресурсов, входящих в состав Bundle
№ п/п |
Ресурс |
Ссылки на другие ресурсы |
Описание |
1. |
Parameters |
Ссылка на PractitionerRole |
В ресурсе указывается информация о диспансерном учете пациента (дата постановки на диспансерный учет, идентификатор карты диспансерного учета и т.д.). В рамках одного ресурса Parameters должна быть указана одна ссылка на ресурс PractitionerRole. Количество ресурсов Parameters определяется количеством видов диспансерного учета (профилей помощи) для пациента в данной МО. |
2. |
PractitionerRole |
Ссылка на Organization; Ссылка на Practitioner |
В ресурсе указывается информация о медицинском работнике в привязке к МО, который осуществляет диспансерное наблюдение пациента (данные о должности, специальности, комментарии с важной информацией для осуществления записи на прием) |
3. |
Practitioner |
|
В ресурсе указывается информация о медицинском работнике, который осуществляет диспансерное наблюдение пациента (ФИО, идентификатор в МИС МО и СНИЛС) |
Схема структуры Bundle приведена на Рисунке 3.
Рисунок 3. Структура Bundle
Структура ответа метода $getdispensaryobservationinfo представлена на Рисунке 4.
Рисунок 4. Структура ответа метода $getdispensaryobservationinfo
Ресурс Parameters
Ресурс Parameters предназначен для передачи данных о диспансерном учете пациента (дата постановки на диспансерный учет, идентификатор карты диспансерного учета и т.д.). Количество ресурсов Parameters определяется количеством видов диспансерного учета (профилей помощи) для пациента в данной МО.
В Таблице 3 представлено описание параметров ресурса Parameters. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 3 - Параметры ресурса Parameters
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Parameters. Передаётся в формате guid |
2. |
attachmentDate |
1..1 |
dateTime |
Дата постановки на диспансерный учет |
3. |
cardId |
1..1 |
string |
Идентификатор карты диспансерного учета |
4. |
medicalAreaId |
0..1 |
string |
Идентификатор врачебного участка. Обязателен для передачи при наличии участка (если передается как минимум один параметр по участку, данный параметр обязателен для заполнения) |
5. |
medicalAreaNumber |
0..1 |
string |
Номер врачебного участка. Обязателен для передачи при наличии участка (если передается как минимум один параметр по участку, данный параметр обязателен для заполнения) |
6. |
medicalAreaType |
0..1 |
string |
Код типа врачебного участка согласно справочнику «ФРМО. Типы врачебных участков» (OID 1.2.643.5.1.13.13.99.2.639). Обязателен для передачи при наличии участка (если передается как минимум один параметр по участку, данный параметр обязателен для заполнения) |
7. |
medicalAreaRoomNumber |
0..1 |
string |
Номер кабинета, в котором ведется прием пациентов врачебного участка. Возможен для передачи при наличии участка (если передаются параметры по участку, данный параметр возможен для заполнения) |
8. |
profilePostId |
1..1 |
string |
Идентификатор врачебной должности в соответсвии со справочником «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102). Допустимо использование значений для взрослого населения: врач-терапевт (Post_Id =109); врачи-специалисты; врач по медицинской профилактике (Post_Id = 71); фельдшер (Post_Id = 195). Допустимо использование значений для несовершеннолетних: врач-педиатр (Post_Id =58); врачи-специалисты; фельдшер (Post_Id = 195) |
9. |
referencePractitionRole |
1..1 |
Reference(PractitionRole) |
Ссылка на медицинского работника в привязке к МО (ресурс PractitionRole) |
PractitionerRole
Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 4 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 4 - Параметры ресурса PractitionerRole
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса PractitionerRole. Передаётся в формате guid |
2. |
extension |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
2.1. |
extension.url |
1..1 |
uri |
Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group» |
2.2. |
extension.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1. |
extension.valueCodeableConcept.coding.system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)
|
2.2.2. |
extension.valueCodeableConcept.coding.code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя |
3. |
identifier |
1..1 |
Identifier |
Идентификатор ресурса PractitionerRole в МИС МО |
3.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
3.2. |
identifier.value |
1..1 |
string |
Значение идентификатора ресурса PractitionerRole в МИС МО. Максимальная длина поля: 200 символов |
4. |
practitioner |
1..1 |
Reference(Practitioner) |
Ссылка на медицинского работника (ресурс Practitioner) |
5. |
organization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
6. |
code |
1..1 |
CodeableConcept |
Информация о должности медицинского работника |
6.1. |
code.coding |
3..3 |
Coding |
Информация о должности медицинского работника |
6.1.1. |
code.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о должности медицинского работника: · «1.2.643.5.1.13.13.11.1102» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) - должность, по которой трудоустроен медицинский работник в данной МО · «1.2.643.5.1.13.13.11.1102.2» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) – код должности, расположенной в папках «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи) » -> «врачи-специалисты» и «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов со средним профессиональным (медицинским) образованием (средний медицинский персонал)» · «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных должностей целевой МИС МО · «1.2.643.2.69.1.1.1.219» - для регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219)[1] |
6.1.2. |
code.coding.code |
1..1 |
code |
Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника. Максимальная длина поля: 300 символов |
6.1.3. |
code.coding.display |
1..1 |
string |
Наименование врачебной должности из справочника врачебных должностей целевой МИС МО. Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5 Максимальная длина поля: 300 символов |
7. |
specialty |
1..1 |
CodeableConcept |
Информация о специальности медицинского работника |
7.1. |
specialty.coding |
2..2 |
Coding |
Информация о специальности медицинского работника |
7.1.1. |
specialty.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о специальности медицинского работника: · «1.2.643.5.1.13.13.11.1066» - для справочника «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066); · «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных специальностей целевой МИС МО · «1.2.643.2.69.1.1.1.220» - для регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220)[2] |
7.1.2. |
specialty.coding.code |
1..1 |
code |
Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника. Максимальная длина поля: 300 символов |
7.1.3. |
specialty.coding.display |
1..1 |
string |
Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО. Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5 Максимальная длина поля: 300 символов |
7.2. |
specialty.text |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности). Максимальная длина поля: 300 символов |
8. |
availabilityExceptions |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к данному врачу). Максимальная длина поля: 300 символов |
[1] В рамках контейнера code.coding ресурса PractitionerRole передача значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник должностей или региональный справочник должностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) в рамках оформления записи по диспансерному наблюдению и передавать в рамках контейнера code.coding значение должности из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).
Одновременное указание значений из регионального справочника должностей и справочника должностей целевой МИС МО не допускается (в рамках контейнера code.coding ресурса PractitionerRole в дополнении к значениям по OID «1.2.643.5.1.13.13.11.1102» и «1.2.643.5.1.13.13.11.1102.2» может передаваться либо значение из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219), либо значение из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).
[2] В рамках контейнера specialty.coding ресурса PractitionerRole передача значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник специальностей или региональный справочник специальностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) в рамках оформления записи по диспансерному наблюдению и передавать в рамках контейнера specialty.coding значение специальности из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).
Одновременное указание значений из регионального справочника специальностей и справочника специальностей целевой МИС МО не допускается (в рамках контейнера specialty.coding ресурса PractitionerRole в дополнении к значению по OID «1.2.643.5.1.13.13.11.1066» может передаваться либо значение из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220), либо значение из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).
Practitioner
Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 5 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 5 - Параметры ресурса Practitioner
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Practitioner. Передаётся в формате guid |
2. |
identifier |
2..2 |
Identifier |
Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС) |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код: · OID для идентификатора в МИС/ЛИС (1.2.643.5.1.13.2.7.100.5) · OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223) |
2.2. |
identifier.value |
1..1 |
string |
Значение для идентификатора или для СНИЛСа. Максимальная длина поля: 300 символов |
3. |
name |
1..1 |
HumanName |
ФИО медицинского работника |
3.1. |
name.family |
1..1 |
string |
Фамилия. Максимальная длина поля: 300 символов |
3.2. |
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. Максимальная длина поля: 300 символов |
Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources)
Данный метод используется для поиска в целевой МО доступных медицинских ресурсов для записи по диспансерному наблюдению. В качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/dispensaryobservation/fhir/$searchmedicalresources.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html
На Рисунке 5 представлена схема информационного взаимодействия в рамках метода «Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources)».
Рисунок 5. Схема информационного взаимодействия в рамках метода «Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources)»
Описание схемы:
- Клиент СЗПВ отправляет запрос метода «Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources)» в СЗПВ. Состав параметров запроса представлен в Таблице 6.
- СЗПВ отправляет запрос метода «Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 6.
- Целевое ЛПУ передает ответ метода «Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.3.2.
- СЗПВ передает ответ метода «Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.3.2.
Описание параметров запроса
В Таблице 6 представлено описание параметров запроса метода $searchmedicalresources.
Таблица 6 – Описание параметров запроса метода $searchmedicalresources
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
organizationId |
1..1 |
string |
Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы |
2. |
cardId |
1..1 |
string |
Идентификатор карты диспансерного учета |
3. |
patientId |
1..1 |
string |
Идентификатор пациента из соответствующего справочника целевой МИС |
4. |
postId |
1..1 |
string |
Идентификатор врачебной должности в справочнике «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) |
5. |
startDateTimeRange |
1..1 |
Datetime |
Дата начала периода предоставления информации о наличии/отсутствии свободных слотов |
6. |
endDateTimeRange
|
1..1 |
Datetime |
Дата окончания периода предоставления информации о наличии/отсутствии свободных слотов |
Описание выходных данных
В ответе метода от целевой МО передается информация о доступных медицинских ресурсах для записи по диспансерному наблюдению в формате Bundle типа collection. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:
"fullUrl": "[Тип ресурса]/[id ресурса]"
например, "fullUrl": "PractitionerRole/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание представлено в Таблице 7.
Таблица 7 – Описание ресурсов, входящих в состав Bundle
№ п/п |
Ресурс |
Ссылки на другие ресурсы |
Описание |
1. |
Schedule |
Ссылка на PractitionerRole; Ссылка на Location |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты).
В случае, если медицинский ресурс является медицинским работником, в рамках одного ресурса Schedule должна быть указана одна ссылка на ресурс PractitionerRole, а также могут быть указаны максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём, и максимум одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём. Количество ресурсов Schedule определяется количеством уникальных наборов PractitionerRole и максимум 2-х Location.
В случае, если медицинский ресурс является кабинетом, в рамках одного ресурса Schedule должна быть указана одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём, а также может быть указана максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём. В рамках ресурса Schedule не должна передаваться ссылка на ресурс PractitionerRole. Количество ресурсов Schedule определяется количеством уникальных наборов Location с данными по описанию кабинета и Location с данными по адресу физического здания. |
2. |
PractitionerRole |
Ссылка на Organization; Ссылка на Practitioner |
В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией для осуществления записи на прием) |
3. |
Practitioner |
|
В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС) |
4. |
Location |
Ссылка на Organization |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). В рамках передачи данных о расписании медицинского работника как медицинского ресурса, в ресурсах Location может передаваться информация о месте приема медицинского работника (адрес физического здания медицинской организации, где будет осуществляться приём, и описание кабинета, где будет осуществляться приём) – двумя отдельными ресурсами Location. В рамках передачи данных о расписании кабинета как медицинского ресурса, в ресурсе Location передается информация с описанием данного кабинета (наименование кабинета, OID кабинета в соответствии со справочником ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 и прочее), а также в отдельном ресурсе Location может передаваться информация об адресе физического здания медицинской организации, где будет осуществляться приём. |
5. |
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале) для оформления записи по диспансерному наблюдению. В рамках метода «Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources)» передается первый ближайший талон по каждой доступной для записи дате по медицинскому ресурсу в запрашиваемый период. |
6. |
Parameters |
Ссылка на Schedule |
В ресурсе указывается информация с текстовым описанием причины отсутствия свободных талонов у медицинского ресурса (передается в случае, если параметр comment в ресурсе Schedule заполнен и его значение не «3» или «7») |
Схема структуры Bundle приведена на Рисунке 6.
Рисунок 6. Структура Bundle
Структура ответа метода $searchmedicalresources представлена на Рисунке 7.
Рисунок 7. Структура ответа метода $searchmedicalresources
Schedule
Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 8 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 8 - Параметры ресурса Schedule
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Schedule. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор расписания медицинского ресурса в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора расписания медицинского ресурса в МИС МО. Передаётся в формате guid |
3. |
actor |
1..3 |
Reference |
Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location) |
4. |
comment |
0..1 |
string |
Код причины отсутствия свободных талонов в запрашиваемом периоде. Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.222 «Причины отсутствия талонов». Должен отсутствовать, если в ответе метода передан как минимум один слот со ссылкой на данный ресурс Schedule. Должен передаваться, если отсутствуют свободные слоты за все дни из запрашиваемого диапазона времени (в ответе метода не передан как минимум один слот со ссылкой на данный ресурс Schedule) |
PractitionerRole
Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 9 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 9 - Параметры ресурса PractitionerRole
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса PractitionerRole. Передаётся в формате guid |
2. |
extension |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
2.1. |
extension.url |
1..1 |
uri |
Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group» |
2.2. |
extension.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1. |
extension.valueCodeableConcept.coding.system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)
|
2.2.2. |
extension.valueCodeableConcept.coding.code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя |
3. |
identifier |
1..1 |
Identifier |
Идентификатор ресурса PractitionerRole в МИС МО |
3.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
3.2. |
identifier.value |
1..1 |
string |
Значение идентификатора ресурса PractitionerRole в МИС МО. Максимальная длина поля: 200 символов |
4. |
practitioner |
1..1 |
Reference(Practitioner) |
Ссылка на медицинского работника (ресурс Practitioner) |
5. |
organization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
6. |
code |
1..1 |
CodeableConcept |
Информация о должности медицинского работника |
6.1. |
code.coding |
3..3 |
Coding |
Информация о должности медицинского работника |
6.1.1. |
code.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о должности медицинского работника: · «1.2.643.5.1.13.13.11.1102» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) - должность, по которой трудоустроен медицинский работник в данной МО · «1.2.643.5.1.13.13.11.1102.2» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) – код должности, расположенной в папках «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи) » -> «врачи-специалисты» и «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов со средним профессиональным (медицинским) образованием (средний медицинский персонал)» · «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных должностей целевой МИС МО · «1.2.643.2.69.1.1.1.219» - для регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219)[1] |
6.1.2. |
code.coding.code |
1..1 |
code |
Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника. Максимальная длина поля: 300 символов |
6.1.3. |
code.coding.display |
1..1 |
string |
Наименование врачебной должности из справочника врачебных должностей целевой МИС МО. Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5 Максимальная длина поля: 300 символов |
7. |
specialty |
1..1 |
CodeableConcept |
Информация о специальности медицинского работника |
7.1. |
specialty.coding |
2..2 |
Coding |
Информация о специальности медицинского работника |
7.1.1. |
specialty.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о специальности медицинского работника: · «1.2.643.5.1.13.13.11.1066» - для справочника «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066); · «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных специальностей целевой МИС МО · «1.2.643.2.69.1.1.1.220» - для регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220)[2] |
7.1.2. |
specialty.coding.code |
1..1 |
code |
Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника. Максимальная длина поля: 300 символов |
7.1.3. |
specialty.coding.display |
1..1 |
string |
Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО. Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5 Максимальная длина поля: 300 символов |
7.2. |
specialty.text |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности). Максимальная длина поля: 300 символов |
8. |
availabilityExceptions |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к данному врачу). Максимальная длина поля: 300 символов |
[1] В рамках контейнера code.coding ресурса PractitionerRole передача значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник должностей или региональный справочник должностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) в рамках оформления записи по диспансерному наблюдению и передавать в рамках контейнера code.coding значение должности из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).
Одновременное указание значений из регионального справочника должностей и справочника должностей целевой МИС МО не допускается (в рамках контейнера code.coding ресурса PractitionerRole в дополнении к значениям по OID «1.2.643.5.1.13.13.11.1102» и «1.2.643.5.1.13.13.11.1102.2» может передаваться либо значение из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219), либо значение из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).
[2] В рамках контейнера specialty.coding ресурса PractitionerRole передача значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник специальностей или региональный справочник специальностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) в рамках оформления записи по диспансерному наблюдению и передавать в рамках контейнера specialty.coding значение специальности из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).
Одновременное указание значений из регионального справочника специальностей и справочника специальностей целевой МИС МО не допускается (в рамках контейнера specialty.coding ресурса PractitionerRole в дополнении к значению по OID «1.2.643.5.1.13.13.11.1066» может передаваться либо значение из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220), либо значение из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).
Practitioner
Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 10 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 10 - Параметры ресурса Practitioner
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
identifier |
2..2 |
Identifier |
Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС) |
1.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код: · OID для идентификатора в МИС/ЛИС (1.2.643.5.1.13.2.7.100.5) · OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223) |
1.2. |
identifier.value |
1..1 |
string |
Значение для идентификатора или для СНИЛСа. Максимальная длина поля: 300 символов |
2. |
name |
1..1 |
HumanName |
ФИО медицинского работника |
2.1. |
name.family |
1..1 |
string |
Фамилия. Максимальная длина поля: 300 символов |
2.2. |
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. Максимальная длина поля: 300 символов |
Location
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 11 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 11 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Location. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор ресурса Location в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Location в МИС МО |
3. |
address |
1..1 |
Address |
Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём |
3.1. |
address.text |
1..1 |
string |
Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой. Максимальная длина поля: 300 символов |
4. |
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
4.1. |
coding.system |
1..1 |
uri |
Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type» |
4.2. |
coding.code |
1..1 |
code |
Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО) |
4.3. |
coding.display |
1..1 |
string |
Указывается значение «Building» |
5. |
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
В Таблице 12 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 12 - Параметры ресурса Location (описание кабинета МО)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Location. Передаётся в формате guid |
2. |
extension |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу/ Заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе |
2.1. |
extension.url |
1..1 |
uri |
Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group» |
2.2. |
extension.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1. |
extension.valueCodeableConcept.coding.system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)
|
2.2.2. |
extension.valueCodeableConcept.coding.code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя |
3. |
identifier |
2..2 |
Identifier |
Идентификатор ресурса Location в МИС МО и OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе |
4. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код: · OID для идентификатора в МИС МО (1.2.643.5.1.13.2.7.100.5) · OID для передачи информации о кабинете из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» (1.2.643.5.1.13.13.99.2.115) |
5. |
identifier.value |
1..1 |
string |
Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 Максимальная длина поля: 300 символов |
6. |
name |
1..1 |
string |
Наименование кабинета. Например: «Кабинет №5». Максимальная длина поля: 300 символов |
7. |
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
7.1. |
coding.system |
1..1 |
uri |
Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type» |
7.2. |
coding.code |
1..1 |
code |
Указывается значение «ro». Обозначение того, что данный ресурс Location – кабинет (комната) |
7.3. |
coding.display |
1..1 |
string |
Указывается значение «Room» |
8. |
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
9. |
partOf |
0..1 |
Reference(Location) |
Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания) |
Slot
Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по диспансерному наблюдению. В рамках метода «Поиск доступных медицинских ресурсов для записи по диспансерному наблюдению ($searchmedicalresources)» передается первый ближайший талон по каждой доступной для записи дате по медицинскому ресурсу в запрашиваемый период.
В Таблице 13 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 13 - Параметры ресурса Slot
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Slot. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор талона в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора талона в МИС МО. Максимальная длина поля: 300 символов |
3. |
schedule |
1..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
4. |
status |
1..1 |
code |
Указывается значение «free» |
5. |
start |
1..1 |
instant |
Дата и время начала приема |
6. |
end |
1..1 |
instant |
Дата и время окончания приема |
7. |
comment |
0..1 |
string |
Номер талона в очереди. Максимальная длина поля: 300 символов |
Parameters
Ресурс Parameters предназначен для передачи информации с текстовым описанием причины отсутствия свободных талонов у медицинского ресурса (передается в случае, если параметр comment в ресурсе Schedule заполнен и его значение не «3» или «7»).
В Таблице 14 представлено описание параметров ресурса Parameters. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 14 - Параметры ресурса Parameters
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Parameters. Передаётся в формате guid |
2. |
1..5 |
string |
Для кода причины «1» и «2» должен быть передан параметр: «Available_date» – Дата, когда появится запись к медицинскому ресурсу Для кода причины «4» передаются следующие параметры: «MO_Name» – Наименование структурного подразделения МО «MO_Address» – Адрес структурного подразделения МО «MO_Phone» — Телефон регистратуры структурного подразделения МО Для кода причины «5» передаются следующие параметры: «MO_Name» – Наименование структурного подразделения МО «MO_Address» – Адрес структурного подразделения МО «Specialist_Name» – ФИО медицинского специалиста «Specialist_Post» – Должность медицинского специалиста «Room» – Кабинет, куда необходимо обратиться Для кода причины «6» передаются следующие параметры: «Visit_Info» – Информация о днях приема без предварительной записи |
|
3. |
Parameter.valueString |
1..5 |
string |
Значение параметра |
4. |
1..1 |
string |
Передаётся «referenceSchedule» |
|
5. |
Parameter.valueReference |
1..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
Поиск доступных талонов для записи по диспансерному наблюдению ($searchslots)
Данный метод используется для поиска в целевой МО доступных талонов по медицинскому ресурсу для записи по диспансерному наблюдению. В качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/dispensaryobservation/fhir/$searchslots.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html
На Рисунке 8 представлена схема информационного взаимодействия в рамках метода «Поиск доступных талонов для записи по диспансерному наблюдению ($searchslots)».
Рисунок 8. Схема информационного взаимодействия в рамках метода «Поиск доступных талонов для записи по диспансерному наблюдению ($searchslots)»
Описание схемы:
- Клиент СЗПВ отправляет запрос метода «Поиск доступных талонов для записи по диспансерному наблюдению ($searchslots)» в СЗПВ. Состав параметров запроса представлен в Таблице 15.
- СЗПВ отправляет запрос метода «Поиск доступных талонов для записи по диспансерному наблюдению ($searchslots)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 15.
- Целевое ЛПУ передает ответ метода «Поиск доступных талонов для записи по диспансерному наблюдению ($searchslots)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.4.2.
СЗПВ передает ответ метода «Поиск доступных талонов для записи по диспансерному наблюдению ($searchslots)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.4.2.
Описание параметров запроса
В Таблице 15 представлено описание параметров запроса метода $searchslots.
Таблица 15 – Описание параметров запроса метода $searchslots
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
organizationId |
1..1 |
string |
Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы |
2. |
patientId |
1..1 |
string |
Идентификатор пациента из соответствующего справочника целевой МИС |
3. |
scheduleId |
1..1 |
string |
Идентификатор расписания медицинского ресурса |
4. |
cardId |
1..1 |
string |
Идентификатор карты диспансерного учета |
5. |
startDateTimeRange |
1..1 |
Datetime |
Дата и время начала периода предоставления информации о наличии/отсутствии свободных слотов |
6. |
endDateTimeRange |
1..1 |
Datetime |
Дата и время окончания периода предоставления информации о наличии/отсутствии свободных слотов |
Описание выходных данных
В ответе метода от целевой МО передается информация о доступных талонах по медицинскому ресурсу для записи по диспансерному наблюдению в формате Bundle типа collection. FHIR-ресурс Bundle используется для передачи набора ресурсов.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:
"fullUrl": "[Тип ресурса]/[id ресурса]"
например, "fullUrl": "PractitionerRole/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание представлено в Таблице 16.
Таблица 16 – Описание ресурсов, входящих в состав Bundle
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
1. |
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале) для оформления записи по диспансерному наблюдению |
Структура ответа метода $searchslots представлена на Рисунке 9.
Рисунок 9. Структура ответа метода $searchslots
Ресурс Slot
Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по диспансерному наблюдению.
В Таблице 17 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 17 - Параметры ресурса Slot
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Slot. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор талона в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора талона в МИС МО. Максимальная длина поля: 300 символов |
3. |
schedule |
1..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
4. |
status |
1..1 |
code |
Указывается значение «free» |
5. |
start |
1..1 |
instant |
Дата и время начала приема |
6. |
end |
1..1 |
instant |
Дата и время окончания приема |
7. |
comment |
0..1 |
string |
Номер талона в очереди. Максимальная длина поля: 300 символов |
Осуществление записи по диспансерному наблюдению ($setappointment)
Данный метод используется для осуществления в целевой МО записи по диспансерному наблюдению.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/dispensaryobservation/fhir/$setappointment.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html
На Рисунке 10 представлена схема информационного взаимодействия в рамках метода «Осуществление записи по диспансерному наблюдению ($setappointment)».
Рисунок 10. Схема информационного взаимодействия в рамках метода «Осуществление записи по диспансерному наблюдению ($setappointment)»
Описание схемы:
- Клиент СЗПВ отправляет запрос метода «Осуществление записи по диспансерному наблюдению ($setappointment)» в СЗПВ. Состав параметров запроса представлен в Таблице 18.
- СЗПВ отправляет запрос метода «Осуществление записи по диспансерному наблюдению ($setappointment)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 18.
- Целевое ЛПУ передает ответ метода «Осуществление записи по диспансерному наблюдению ($setappointment)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.5.2.
СЗПВ передает ответ метода «Осуществление записи по диспансерному наблюдению ($setappointment)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.5.2.
Описание параметров запроса
В Таблице 18 представлено описание параметров запроса метода $setappointment.
Таблица 18 – Описание параметров запроса метода $setappointment
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
organizationId |
1..1 |
string |
Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы |
2. |
patientId |
1..1 |
string |
Идентификатор пациента из соответствующего справочника целевой МИС |
3. |
cardId |
1..1 |
string |
Идентификатор карты диспансерного учета |
4. |
slotId |
1..1 |
string |
Идентификатор талона для записи из соответствующего справочника целевой МИС |
Описание выходных данных
В ответе метода от целевой МО передается информация об успешной или неуспешной операции оформления записи по диспансерному наблюдению.
В случае успешной операции по оформлению записи по диспансерному наблюдению, в ответе метода передаётся ресурс OperationOutcome в формате «All OK» (пример ответа метода для успешной операции приведен в разделе 4.5.4).
В случае неуспешной операции по оформлению записи по диспансерному наблюдению, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.5.4).
Отмена записи по диспансерному наблюдению ($cancelappointment)
Данный метод используется для осуществления в целевой МО отмены записи по диспансерному наблюдению.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/dispensaryobservation/fhir/$cancelappointment.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html
На Рисунке 11 представлена схема информационного взаимодействия в рамках метода «Отмена записи по диспансерному наблюдению ($cancelappointment)».
Рисунок 11. Схема информационного взаимодействия в рамках метода «Отмена записи по диспансерному наблюдению ($cancelappointment)»
Описание схемы:
- Клиент СЗПВ отправляет запрос метода «Отмена записи по диспансерному наблюдению ($cancelappointment)» в СЗПВ. Состав параметров запроса представлен в Таблице 19.
- СЗПВ отправляет запрос метода «Отмена записи по диспансерному наблюдению ($cancelappointment)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 19.
- Целевое ЛПУ передает ответ метода «Отмена записи по диспансерному наблюдению ($cancelappointment)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.6.2.
- СЗПВ передает ответ метода «Отмена записи по диспансерному наблюдению ($cancelappointment)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.6.2.
Описание параметров запроса
В Таблице 19 представлено описание параметров запроса метода $cancelappointment.
Таблица 19 – Описание параметров запроса метода $cancelappointment
Параметры |
Кратность |
Тип |
Описание |
organizationId |
1..1 |
string |
Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы |
patientId |
1..1 |
string |
Идентификатор пациента из соответствующего справочника целевой МИС |
slotId |
1..1 |
string |
Идентификатор талона для записи из соответствующего справочника целевой МИС |
Описание выходных данных
В ответе метода от целевой МО передается информация об успешной или неуспешной операции отмены записи по диспансерному наблюдению.
В случае успешной операции по отмене записи по диспансерному наблюдению, в ответе метода передаётся ресурс OperationOutcome в формате «All OK» (пример ответа метода для успешной операции приведен в разделе 4.6.4).
В случае неуспешной операции по отмене записи по диспансерному наблюдению, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.6.4).
Уведомление о факте записи по диспансерному наблюдению ($notify)
Данный метод предназначен для передачи в СЗПВ сведений обо всех фактах записи по диспансерному наблюдению в рамках МО. При передаче данных о факте записи по диспансерному наблюдению необходимо передавать дату и время осуществления записи на приём.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/dispensaryobservation/fhir/$notify.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html
На Рисунке 12 представлена схема информационного взаимодействия в рамках метода «Уведомление о факте записи по диспансерному наблюдению ($notify)».
Рисунок 12. Схема информационного взаимодействия в рамках метода «Уведомление о факте записи по диспансерному наблюдению ($notify)»
Описание схемы:
- Целевое ЛПУ отправляет запрос метода «Уведомление о факте записи по диспансерному наблюдению ($notify)» в СЗПВ. Состав параметров запроса метода представлен в разделе 4.7.1.
СЗПВ передает ответ метода «Уведомление о факте записи по диспансерному наблюдению ($notify)» в целевое ЛПУ. Состав параметров ответа метода представлен в Таблице 31.
Описание параметров запроса
В запросе метода от целевой МО передается информация о ресурсах, описывающих факт записи по диспансерному наблюдению, в формате Bundle типа transaction. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы, кроме Patient и Organization (как ресурс, описывающий участника информационного обмена, осуществившего запись на приём), должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization как ресурс, описывающий целевую МО), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:
"fullUrl": "[Тип ресурса]/[id ресурса]"
например, "fullUrl": "PractitionerRole/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи, где медицинским ресурсом выступает медицинский работник, представлено в Таблице 20.
Таблица 20 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
1. |
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
2. |
Schedule |
Ссылка на PractitionerRole; Ссылка на Location |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает медицинский работник). В рамках ресурса Schedule должна быть указана одна ссылка на ресурс PractitionerRole, а также могут быть указаны максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём, и максимум одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём. Количество передаваемых ресурсов Schedule - 1..1. |
3. |
PractitionerRole |
Ссылка на Organization (целевая МО); Ссылка на Practitioner |
В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией по осуществлению записи на прием) |
4. |
Practitioner |
|
В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС) |
5. |
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о месте приема конкретного медицинского работника). В ресурсах Location может передаваться информация о месте приема медицинского работника (адрес физического здания медицинской организации, где будет осуществляться приём, и описание кабинета, где будет осуществляться приём) – двумя отдельными ресурсами Location. Количество передаваемых ресурсов Location - 0..2. |
6. |
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по диспансерному наблюдению |
7. |
Appointment |
Ссылка на Organization (участник информационного обмена, осуществивший запись на приём); Ссылка на Patient; Ссылка на PractitionerRole; Ссылка на Slot |
В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём). Количество передаваемых ресурсов Appointment - 1..1. |
8. |
Organization (участник информационного обмена, осуществивший запись на приём) |
|
В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём |
Схема структуры Bundle для факта записи, где медицинским ресурсом выступает медицинский работник, приведена на Рисунке 13.
Рисунок 13. Структура Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи, где медицинским ресурсом выступает кабинет, представлено в Таблице 21.
Таблица 21 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
1. |
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
2. |
Schedule |
Ссылка на Location |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает кабинет). В рамках ресурса Schedule должна быть указана одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём, а также может быть указана максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём. В рамках ресурса Schedule не должна передаваться ссылка на ресурс PractitionerRole. Количество передаваемых ресурсов Schedule - 1..1. |
3. |
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги). В ресурсе Location передается информация с описанием данного кабинета (наименование кабинета, OID кабинета в соответствии со справочником ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 и прочее), а также в отдельном ресурсе Location может передаваться информация об адресе физического здания медицинской организации, где будет осуществляться приём. Количество передаваемых ресурсов Location - 1..2. |
4. |
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по диспансерному наблюдению |
5. |
Appointment |
Ссылка на Organization (участник информационного обмена, осуществивший запись на приём); Ссылка на Patient; Ссылка на Location; Ссылка на Slot |
В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём). Количество передаваемых ресурсов Appointment - 1..1. |
6. |
Organization (участник информационного обмена, осуществивший запись на приём) |
|
В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём |
Схема структуры Bundle для факта записи, где медицинским ресурсом выступает кабинет, приведена на Рисунке 14.
Рисунок 14. Структура Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)
Структура ответа метода $notify представлена на Рисунке 15.
Рисунок 15. Структура ответа метода $notify
Ресурс Patient
Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 22 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 22 - Параметры ресурса Patient
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Patient. Передаётся в формате guid |
2. |
identifier |
1..4 |
Identifier |
Идентификатор пациента (идентификатор пациента в МИС МО, СНИЛС пациента, серия и номер полиса пациента, серия и номер документа, удостоверяющего личность пациента). Идентификатор пациента в МИС МО обязателен для передачи |
2.1. |
identifier.system |
1..1 |
string |
Пространство имён идентификатора. Указывается код: · OID для идентификатора в МИС (1.2.643.5.1.13.2.7.100.5) · OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223) · для ДУЛ и полисов OID (1.2.643.2.69.1.1.1.6.Х), где Х = код документа в справочнике 1.2.643.2.69.1.1.1.6. Для ДУЛ допустимые значения (1-18), для полисов ОМС (226-228). |
2.2. |
identifier.value |
1..1 |
string |
Значение для идентификатора или для документа. · для идентификатора в МИС указывается [идентификатор в МИС] · для ДУЛ и полисов указывается [Серия]:[Номер] или [Номер], если нет серии, номер - обязателен. В серии не должны использоваться разделители (пробелы, тире и т.д.), допускаются цифры и буквы русского и латинского алфавита. В номере не должны использоваться разделители (пробелы, тире и т.д.), допускаются только цифры. Максимальная длина поля: 300 символов |
3. |
name |
1..1 |
HumanName |
ФИО пациента |
3.1. |
name.family |
1..1 |
string |
Фамилия. Максимальная длина поля: 300 символов |
3.2. |
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. Максимальная длина поля: 300 символов |
4. |
telecom |
0..* |
ContactPoint |
Контактные телефоны пациента |
4.1. |
telecom.system |
1..1 |
code |
Передаётся значение «phone» |
4.2. |
telecom.value |
1..1 |
string |
Номер телефона. Максимальная длина поля: 300 символов |
4.3. |
telecom.use |
1..1 |
code |
Передаётся одно из начений: · «home» - номер домашнего телефона; · «mobile» - номер мобильного телефона. |
5. |
gender |
0..1 |
code |
Код пола пациента (справочник FHIR. OID: 1.2.643.2.69.1.1.1.40) |
6. |
birthDate |
1..1 |
date |
Дата рождения пациента |
7. |
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Ресурс Schedule
Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 23 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 23 - Параметры ресурса Schedule
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Schedule. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор расписания медицинского ресурса в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора расписания медицинского ресурса в МИС МО. Передаётся в формате guid |
3. |
actor |
1..3 |
Reference |
Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location) |
Ресурс PractitionerRole
Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 24 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 24 - Параметры ресурса PractitionerRole
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса PractitionerRole. Передаётся в формате guid |
2. |
extension |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
2.1. |
extension.url |
1..1 |
uri |
Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group» |
2.2. |
extension.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1. |
extension.valueCodeableConcept.coding.system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)
|
2.2.2. |
extension.valueCodeableConcept.coding.code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя |
3. |
identifier |
1..1 |
Identifier |
Идентификатор ресурса PractitionerRole в МИС МО |
3.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
3.2. |
identifier.value |
1..1 |
string |
Значение идентификатора ресурса PractitionerRole в МИС МО. Максимальная длина поля: 200 символов |
4. |
practitioner |
1..1 |
Reference(Practitioner) |
Ссылка на медицинского работника (ресурс Practitioner) |
5. |
organization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
6. |
code |
1..1 |
CodeableConcept |
Информация о должности медицинского работника |
6.1. |
code.coding |
3..3 |
Coding |
Информация о должности медицинского работника |
6.1.1. |
code.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о должности медицинского работника: · «1.2.643.5.1.13.13.11.1102» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) - должность, по которой трудоустроен медицинский работник в данной МО · «1.2.643.5.1.13.13.11.1102.2» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) – код должности, расположенной в папках «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи) » -> «врачи-специалисты» и «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов со средним профессиональным (медицинским) образованием (средний медицинский персонал)» · «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных должностей целевой МИС МО · «1.2.643.2.69.1.1.1.219» - для регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219)[1] |
6.1.2. |
code.coding.code |
1..1 |
code |
Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника. Максимальная длина поля: 300 символов |
6.1.3. |
code.coding.display |
1..1 |
string |
Наименование врачебной должности из справочника врачебных должностей целевой МИС МО. Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5 Максимальная длина поля: 300 символов |
7. |
specialty |
1..1 |
CodeableConcept |
Информация о специальности медицинского работника |
7.1. |
specialty.coding |
2..2 |
Coding |
Информация о специальности медицинского работника |
7.1.1. |
specialty.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о специальности медицинского работника: · «1.2.643.5.1.13.13.11.1066» - для справочника «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066); · «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных специальностей целевой МИС МО · «1.2.643.2.69.1.1.1.220» - для регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220)[2] |
7.1.2. |
specialty.coding.code |
1..1 |
code |
Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника. Максимальная длина поля: 300 символов |
7.1.3. |
specialty.coding.display |
1..1 |
string |
Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО. Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5 Максимальная длина поля: 300 символов |
7.2. |
specialty.text |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности). Максимальная длина поля: 300 символов |
8. |
availabilityExceptions |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к данному врачу). Максимальная длина поля: 300 символов |
[1] В рамках контейнера code.coding ресурса PractitionerRole передача значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник должностей или региональный справочник должностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) в рамках оформления записи по диспансерному наблюдению и передавать в рамках контейнера code.coding значение должности из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).
Одновременное указание значений из регионального справочника должностей и справочника должностей целевой МИС МО не допускается (в рамках контейнера code.coding ресурса PractitionerRole в дополнении к значениям по OID «1.2.643.5.1.13.13.11.1102» и «1.2.643.5.1.13.13.11.1102.2» может передаваться либо значение из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219), либо значение из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).
[2] В рамках контейнера specialty.coding ресурса PractitionerRole передача значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник специальностей или региональный справочник специальностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) в рамках оформления записи по диспансерному наблюдению и передавать в рамках контейнера specialty.coding значение специальности из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).
Одновременное указание значений из регионального справочника специальностей и справочника специальностей целевой МИС МО не допускается (в рамках контейнера specialty.coding ресурса PractitionerRole в дополнении к значению по OID «1.2.643.5.1.13.13.11.1066» может передаваться либо значение из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220), либо значение из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).
Ресурс Practitioner
Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 25 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 25 - Параметры ресурса Practitioner
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
identifier |
2..2 |
Identifier |
Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС) |
1.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код: · OID для идентификатора в МИС/ЛИС (1.2.643.5.1.13.2.7.100.5) · OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223) |
1.2. |
identifier.value |
1..1 |
string |
Значение для идентификатора или для СНИЛСа. Максимальная длина поля: 300 символов |
2. |
name |
1..1 |
HumanName |
ФИО медицинского работника |
2.1. |
name.family |
1..1 |
string |
Фамилия. Максимальная длина поля: 300 символов |
2.2. |
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. Максимальная длина поля: 300 символов |
Ресурс Location
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 26 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 26 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Location. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор ресурса Location в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Location в МИС МО |
3. |
address |
1..1 |
Address |
Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём |
3.1. |
address.text |
1..1 |
string |
Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой. Максимальная длина поля: 300 символов |
4. |
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
4.1. |
coding.system |
1..1 |
uri |
Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type» |
4.2. |
coding.code |
1..1 |
code |
Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО) |
4.3. |
coding.display |
1..1 |
string |
Указывается значение «Building» |
5. |
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
В Таблице 27 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 27 - Параметры ресурса Location (описание кабинета МО)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Location. Передаётся в формате guid |
2. |
extension |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу/ Заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе |
2.1. |
extension.url |
1..1 |
uri |
Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group» |
2.2. |
extension.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1. |
extension.valueCodeableConcept.coding.system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)
|
2.2.2. |
extension.valueCodeableConcept.coding.code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя |
3. |
identifier |
2..2 |
Identifier |
Идентификатор ресурса Location в МИС МО и OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе |
4. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код: · OID для идентификатора в МИС МО (1.2.643.5.1.13.2.7.100.5) · OID для передачи информации о кабинете из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» (1.2.643.5.1.13.13.99.2.115) |
5. |
identifier.value |
1..1 |
string |
Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 Максимальная длина поля: 300 символов |
6. |
name |
1..1 |
string |
Наименование кабинета. Например: «Кабинет №5». Максимальная длина поля: 300 символов |
7. |
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
7.1. |
coding.system |
1..1 |
uri |
Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type» |
7.2. |
coding.code |
1..1 |
code |
Указывается значение «ro». Обозначение того, что данный ресурс Location – кабинет (комната) |
7.3. |
coding.display |
1..1 |
string |
Указывается значение «Room» |
8. |
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
9. |
partOf |
0..1 |
Reference(Location) |
Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания) |
Ресурс Slot
Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по диспансерному наблюдению.
В Таблице 28 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 28 - Параметры ресурса Slot
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Slot. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор талона в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора талона в МИС МО. Максимальная длина поля: 300 символов |
3. |
schedule |
1..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
4. |
status |
1..1 |
code |
Указывается значение «free» |
5. |
start |
1..1 |
instant |
Дата и время начала приема |
6. |
end |
1..1 |
instant |
Дата и время окончания приема |
7. |
comment |
0..1 |
string |
Номер талона в очереди. Максимальная длина поля: 300 символов |
Ресурс Appointment
Ресурс Appointment предназначен для передачи данных о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём).
В Таблице 29 представлено описание параметров ресурса Appointment. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 29 - Параметры ресурса Appointment
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Appointment. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор ресурса Appointment в МИС МО |
3. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
4. |
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Appointment в МИС МО. Максимальная длина поля: 300 символов |
5. |
status |
1..1 |
code |
Статус записи на приём. Указывается значение «booked» (Запись оформлена) |
6. |
serviceType |
1..1 |
CodeableConcept |
Информация об услугах, на которые произведена запись (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070) |
6.1. |
coding.system |
1..* |
uri |
Указывается значение «urn:oid:1.2.643.5.1.13.13.11.1070» |
6.2. |
coding.code |
1..* |
code |
Указывается код из справочника «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070 |
7. |
supportingInformation |
2..2 |
Reference(Organization и CarePlan) |
Ссылка на данные по участнику информационного взаимодействия, осуществившего запись на приём (Organization) Идентификатор карты диспансерного учёта (CarePlan) |
8. |
start |
1..1 |
dateTime |
Дата и время начала приема |
9. |
end |
1..1 |
dateTime |
Дата и время окончания приема |
10. |
slot |
1..1 |
Reference(Slot) |
Ссылка на ресурс Slot (талон) |
11. |
created |
1..1 |
dateTime |
Дата осуществления записи на прием |
12. |
participant |
2..2 |
CodeableConcept |
Информация об участниках оказания услуги (пациент и кабинет/медицинский ресурс) |
12.1. |
actor.reference |
1..1 |
Reference(Patient, Location, PractitionerRole) |
Ссылка на ресурс Patient (пациент); ссылка на ресурс Location (кабинет как мед ресурс) или ссылка на ресурс PractitionerRole (мед работник как мед ресурс) |
12.2. |
status |
1..1 |
code |
Статус участника. Указывается значение «accepted» |
Ресурс Organization
Ресурс Organization предназначен для передачи данных об участнике информационного обмена, осуществившего запись на приём.
В Таблице 30 представлено описание параметров ресурса Organization. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 30 - Параметры ресурса Organization
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Organization. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Участник информационного взаимодействия, осуществивший запись |
3. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.2.69.1.2.113» (код для СЗПВ) |
4. |
identifier.value |
1..1 |
string |
Указывается публичный GUID |
5. |
type |
1..1 |
CodeableConcept |
Источник записи |
5.1. |
coding.system |
1..* |
uri |
Указывается значение «urn:oid:1.2.643.2.69.1.1.1.115» |
5.2. |
coding.code |
1..* |
code |
Указывается значение из справочника «Источники записи» |
Описание выходных данных
В Таблице 31 представлено описание выходных данных метода $notify.
Таблица 31 – Описание параметров запроса метода $notify
Параметры |
Кратность |
Тип |
Описание |
notificationId |
1..1 |
string |
Идентификатор уведомления о записи |
Уведомление об изменении записи по диспансерному наблюдению ($changenotification)
Данный метод предназначен для передачи в СЗПВ изменений ранее переданных методом $notify фактов записи по диспансерному наблюдению (например, изменился статус записи по диспансерному наблюдению).
Предполагается следующий сценарий использования метода «Уведомление об изменении записи по диспансерному наблюдению ($changenotification)»:
- МИС МО передает сведения в СЗПВ обо всех записях по диспансерному наблюдению путем вызова метода $notify для каждой записи.
- СЗПВ присваивает идентификатор уведомлению и возвращает его в ответе метода $notify.
- МИС МО сохраняет полученный идентификатор уведомления для последующего использования.
- После того, как произошло изменение записи по диспансерному наблюдению, МИС МО передает обновлённые сведения о записи по уже известному идентификатору уведомления путем вызова метода $changenotification для каждой записи.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/dispensaryobservation/fhir/$changenotification.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html
На Рисунке 16 представлена схема информационного взаимодействия в рамках метода «Уведомление об изменении записи по диспансерному наблюдению ($changenotification)».
Рисунок 16. Схема информационного взаимодействия в рамках метода «Уведомление об изменении записи по диспансерному наблюдению ($changenotification)»
Описание схемы:
- Целевое ЛПУ отправляет запрос метода «Уведомление об изменении записи по диспансерному наблюдению ($changenotification)» в СЗПВ. Состав параметров запроса метода представлен в разделе 4.8.1.
- СЗПВ передает ответ метода «Уведомление об изменении записи по диспансерному наблюдению ($changenotification)» в целевое ЛПУ. Состав параметров ответа метода представлен в разделе 4.8.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, и их описание, для факта записи (включая изменённую информацию), где медицинским ресурсом выступает медицинский работник, представлено в Таблице 32.
Таблица 32 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
1. |
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
2. |
Schedule |
Ссылка на PractitionerRole; Ссылка на Location |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает медицинский работник). В рамках ресурса Schedule должна быть указана одна ссылка на ресурс PractitionerRole, а также могут быть указаны максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём, и максимум одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём. Количество передаваемых ресурсов Schedule - 1..1. |
3. |
PractitionerRole |
Ссылка на Organization (целевая МО); Ссылка на Practitioner |
В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией по осуществлению записи на прием) |
4. |
Practitioner |
|
В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС) |
5. |
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о месте приема конкретного медицинского работника). В ресурсах Location может передаваться информация о месте приема медицинского работника (адрес физического здания медицинской организации, где будет осуществляться приём, и описание кабинета, где будет осуществляться приём) – двумя отдельными ресурсами Location. Количество передаваемых ресурсов Location - 0..2. |
6. |
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по диспансерному наблюдению |
7. |
Appointment |
Ссылка на Organization (участник информационного обмена, осуществивший запись на приём); Ссылка на Patient; Ссылка на PractitionerRole; Ссылка на Slot |
В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём, дата изменения записи на приём). Количество передаваемых ресурсов Appointment - 1..1. |
8. |
Organization (участник информационного обмена, осуществивший запись на приём) |
|
В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём |
Схема структуры Bundle для факта записи (включая изменённую информацию), где медицинским ресурсом выступает медицинский работник, приведена на Рисунке 17.
Рисунок 17. Структура Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи (включая изменённую информацию), где медицинским ресурсом выступает кабинет, представлено в Таблице 33.
Таблица 33 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)
№ п/п |
Параметр |
Ссылки на другие ресурсы |
Описание |
1. |
Patient |
Ссылка на Organization (целевая МО) |
В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО) |
2. |
Schedule |
Ссылка на Location |
В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает кабинет). В рамках ресурса Schedule должна быть указана одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём, а также может быть указана максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём. В рамках ресурса Schedule не должна передаваться ссылка на ресурс PractitionerRole. Количество передаваемых ресурсов Schedule - 1..1. |
3. |
Location |
Ссылка на Organization (целевая МО) |
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги). В ресурсе Location передается информация с описанием данного кабинета (наименование кабинета, OID кабинета в соответствии со справочником ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 и прочее), а также в отдельном ресурсе Location может передаваться информация об адресе физического здания медицинской организации, где будет осуществляться приём. Количество передаваемых ресурсов Location - 1..2. |
4. |
Slot |
Ссылка на Schedule |
В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по диспансерному наблюдению |
5. |
Appointment |
Ссылка на Organization (участник информационного обмена, осуществивший запись на приём); Ссылка на Patient; Ссылка на Location; Ссылка на Slot |
В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём, дата изменения записи на приём). Количество передаваемых ресурсов Appointment - 1..1. |
6. |
Organization (участник информационного обмена, осуществивший запись на приём) |
|
В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём |
В случае, если запись, которая была произведена на кабинет как медицинский ресурс, переводят в статус «fulfilled» (Посещение состоялось), дополнительно в Bundle необходимо передавать ресурсы PractitionerRole и Practitioner с описанием медицинского работника, который оказал медицинскую услугу, а также необходимо передавать ссылку на данный ресурс PractitionerRole в контейнере participant ресурса Appointment с параметром "status": "accepted".
Схема структуры Bundle для факта записи (включая изменённую информацию), где медицинским ресурсом выступает кабинет, приведена на Рисунке 18.
Рисунок 18. Структура Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)
Структура ответа метода $changenotification представлена на Рисунке 19.
Рисунок 19. Структура ответа метода $changenotification
Ресурс Patient
Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 34 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 34 - Параметры ресурса Patient
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Patient. Передаётся в формате guid |
2. |
identifier |
1..4 |
Identifier |
Идентификатор пациента (идентификатор пациента в МИС МО, СНИЛС пациента, серия и номер полиса пациента, серия и номер документа, удостоверяющего личность пациента). Идентификатор пациента в МИС МО обязателен для передачи |
2.1. |
identifier.system |
1..1 |
string |
Пространство имён идентификатора. Указывается код: · OID для идентификатора в МИС (1.2.643.5.1.13.2.7.100.5) · OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223) · для ДУЛ и полисов OID (1.2.643.2.69.1.1.1.6.Х), где Х = код документа в справочнике 1.2.643.2.69.1.1.1.6. Для ДУЛ допустимые значения (1-18), для полисов ОМС (226-228). |
2.2. |
identifier.value |
1..1 |
string |
Значение для идентификатора или для документа. · для идентификатора в МИС указывается [идентификатор в МИС] · для ДУЛ и полисов указывается [Серия]:[Номер] или [Номер], если нет серии, номер - обязателен. В серии не должны использоваться разделители (пробелы, тире и т.д.), допускаются цифры и буквы русского и латинского алфавита. В номере не должны использоваться разделители (пробелы, тире и т.д.), допускаются только цифры. Максимальная длина поля: 300 символов |
3. |
name |
1..1 |
HumanName |
ФИО пациента |
3.1. |
name.family |
1..1 |
string |
Фамилия. Максимальная длина поля: 300 символов |
3.2. |
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. Максимальная длина поля: 300 символов |
4. |
telecom |
0..* |
ContactPoint |
Контактные телефоны пациента |
4.1. |
telecom.system |
1..1 |
code |
Передаётся значение «phone» |
4.2. |
telecom.value |
1..1 |
string |
Номер телефона. Максимальная длина поля: 300 символов |
4.3. |
telecom.use |
1..1 |
code |
Передаётся одно из начений: · «home» - номер домашнего телефона; · «mobile» - номер мобильного телефона. |
5. |
gender |
0..1 |
code |
Код пола пациента (справочник FHIR. OID: 1.2.643.2.69.1.1.1.40) |
6. |
birthDate |
1..1 |
date |
Дата рождения пациента |
7. |
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
Ресурс Schedule
Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 35 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 35 - Параметры ресурса Schedule
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Schedule. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор расписания медицинского ресурса в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора расписания медицинского ресурса в МИС МО. Передаётся в формате guid |
3. |
actor |
1..3 |
Reference |
Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location) |
Ресурс PractitionerRole
Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 36 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 36 - Параметры ресурса PractitionerRole
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса PractitionerRole. Передаётся в формате guid |
2. |
extension |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу |
2.1. |
extension.url |
1..1 |
uri |
Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group» |
2.2. |
extension.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1. |
extension.valueCodeableConcept.coding.system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)
|
2.2.2. |
extension.valueCodeableConcept.coding.code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя |
3. |
identifier |
1..1 |
Identifier |
Идентификатор ресурса PractitionerRole в МИС МО |
3.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
3.2. |
identifier.value |
1..1 |
string |
Значение идентификатора ресурса PractitionerRole в МИС МО. Максимальная длина поля: 200 символов |
4. |
practitioner |
1..1 |
Reference(Practitioner) |
Ссылка на медицинского работника (ресурс Practitioner) |
5. |
organization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
6. |
code |
1..1 |
CodeableConcept |
Информация о должности медицинского работника |
6.1. |
code.coding |
3..3 |
Coding |
Информация о должности медицинского работника |
6.1.1. |
code.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о должности медицинского работника: · «1.2.643.5.1.13.13.11.1102» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) - должность, по которой трудоустроен медицинский работник в данной МО · «1.2.643.5.1.13.13.11.1102.2» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) – код должности, расположенной в папках «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи) » -> «врачи-специалисты» и «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов со средним профессиональным (медицинским) образованием (средний медицинский персонал)» · «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных должностей целевой МИС МО · «1.2.643.2.69.1.1.1.219» - для регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219)[1] |
6.1.2. |
code.coding.code |
1..1 |
code |
Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника. Максимальная длина поля: 300 символов |
6.1.3. |
code.coding.display |
1..1 |
string |
Наименование врачебной должности из справочника врачебных должностей целевой МИС МО. Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5 Максимальная длина поля: 300 символов |
7. |
specialty |
1..1 |
CodeableConcept |
Информация о специальности медицинского работника |
7.1. |
specialty.coding |
2..2 |
Coding |
Информация о специальности медицинского работника |
7.1.1. |
specialty.coding.system |
1..1 |
uri |
Значение OID справочника, по которому передаётся информация о специальности медицинского работника: · «1.2.643.5.1.13.13.11.1066» - для справочника «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066); · «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных специальностей целевой МИС МО · «1.2.643.2.69.1.1.1.220» - для регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220)[2] |
7.1.2. |
specialty.coding.code |
1..1 |
code |
Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника. Максимальная длина поля: 300 символов |
7.1.3. |
specialty.coding.display |
1..1 |
string |
Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО. Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5 Максимальная длина поля: 300 символов |
7.2. |
specialty.text |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности). Максимальная длина поля: 300 символов |
8. |
availabilityExceptions |
0..1 |
string |
Комментарий (указывается важная информация для осуществления записи на прием к данному врачу). Максимальная длина поля: 300 символов |
[1] В рамках контейнера code.coding ресурса PractitionerRole передача значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник должностей или региональный справочник должностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) в рамках оформления записи по диспансерному наблюдению и передавать в рамках контейнера code.coding значение должности из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).
Одновременное указание значений из регионального справочника должностей и справочника должностей целевой МИС МО не допускается (в рамках контейнера code.coding ресурса PractitionerRole в дополнении к значениям по OID «1.2.643.5.1.13.13.11.1102» и «1.2.643.5.1.13.13.11.1102.2» может передаваться либо значение из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219), либо значение из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).
[2] В рамках контейнера specialty.coding ресурса PractitionerRole передача значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник специальностей или региональный справочник специальностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) в рамках оформления записи по диспансерному наблюдению и передавать в рамках контейнера specialty.coding значение специальности из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).
Одновременное указание значений из регионального справочника специальностей и справочника специальностей целевой МИС МО не допускается (в рамках контейнера specialty.coding ресурса PractitionerRole в дополнении к значению по OID «1.2.643.5.1.13.13.11.1066» может передаваться либо значение из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220), либо значение из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).
Ресурс Practitioner
Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 37 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 37 - Параметры ресурса Practitioner
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
identifier |
2..2 |
Identifier |
Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС) |
1.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код: · OID для идентификатора в МИС/ЛИС (1.2.643.5.1.13.2.7.100.5) · OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223) |
1.2. |
identifier.value |
1..1 |
string |
Значение для идентификатора или для СНИЛСа. Максимальная длина поля: 300 символов |
2. |
name |
1..1 |
HumanName |
ФИО медицинского работника |
2.1. |
name.family |
1..1 |
string |
Фамилия. Максимальная длина поля: 300 символов |
2.2. |
name.given |
1..2 |
string |
Имя, Отчество. Сначала указывается Имя. Максимальная длина поля: 300 символов |
Ресурс Location
Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 38 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 38 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Location. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор ресурса Location в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Location в МИС МО |
3. |
address |
1..1 |
Address |
Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём |
3.1. |
address.text |
1..1 |
string |
Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой. Максимальная длина поля: 300 символов |
4. |
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
4.1. |
coding.system |
1..1 |
uri |
Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type» |
4.2. |
coding.code |
1..1 |
code |
Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО) |
4.3. |
coding.display |
1..1 |
string |
Указывается значение «Building» |
5. |
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
В Таблице 39 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 39 - Параметры ресурса Location (описание кабинета МО)
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Location. Передаётся в формате guid |
2. |
extension |
1..1 |
code |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу/ Заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе |
2.1. |
extension.url |
1..1 |
uri |
Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group» |
2.2. |
extension.valueCodeableConcept.coding |
1..3 |
Coding |
Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив) |
2.2.1. |
extension.valueCodeableConcept.coding.system |
1..1 |
code |
Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)
|
2.2.2. |
extension.valueCodeableConcept.coding.code |
1..1 |
code |
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан». В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя |
3. |
identifier |
2..2 |
Identifier |
Идентификатор ресурса Location в МИС МО и OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе |
4. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код: · OID для идентификатора в МИС МО (1.2.643.5.1.13.2.7.100.5) · OID для передачи информации о кабинете из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» (1.2.643.5.1.13.13.99.2.115) |
5. |
identifier.value |
1..1 |
string |
Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 Максимальная длина поля: 300 символов |
6. |
name |
1..1 |
string |
Наименование кабинета. Например: «Кабинет №5». Максимальная длина поля: 300 символов |
7. |
physicalType |
1..1 |
CodeableConcept |
Тип ресурса Location |
7.1. |
coding.system |
1..1 |
uri |
Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type» |
7.2. |
coding.code |
1..1 |
code |
Указывается значение «ro». Обозначение того, что данный ресурс Location – кабинет (комната) |
7.3. |
coding.display |
1..1 |
string |
Указывается значение «Room» |
8. |
managingOrganization |
1..1 |
Reference(Organization) |
Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы) |
9. |
partOf |
0..1 |
Reference(Location) |
Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания) |
Ресурс Slot
Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по диспансерному наблюдению.
В Таблице 40 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 40 - Параметры ресурса Slot
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Slot. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Идентификатор талона в МИС МО |
2.1. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
2.2. |
identifier.value |
1..1 |
string |
Значение идентификатора талона в МИС МО. Максимальная длина поля: 300 символов |
3. |
schedule |
1..1 |
Reference(Schedule) |
Ссылка на ресурс Schedule (расписание) |
4. |
status |
1..1 |
code |
Указывается значение «free» (свободен) при статусе записи cancelled (Запись отменена). При всех остальных значениях статуса записи указывается «busy» |
5. |
start |
1..1 |
instant |
Дата и время начала приема |
6. |
end |
1..1 |
instant |
Дата и время окончания приема |
7. |
comment |
0..1 |
string |
Номер талона в очереди. Максимальная длина поля: 300 символов |
Ресурс Appointment
Ресурс Appointment предназначен для передачи данных о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём).
В Таблице 40 представлено описание параметров ресурса Appointment. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 40 - Параметры ресурса Appointment
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Appointment. Передаётся в формате guid |
2. |
extension |
1..1 |
code |
Признак жителя города или села («Признак жителя города или села», OID 1.2.643.5.1.13.13.11.1042). Указывается только при переводе записи в статус «fulfilled» |
2.1. |
extension.url |
1..1 |
uri |
Передаётся значение «urn:oid:1.2.643.2.69.1.100.1» |
2.2. |
extension.valueCodeableConcept.coding.system |
1..1 |
uri |
Передаётся значение «urn:oid:1.2.643.5.1.13.13.11.1042» |
2.3. |
extension.valueCodeableConcept.coding.code |
1..1 |
uri |
Передаётся код из справочника «Признак жителя города или села» (OID 1.2.643.5.1.13.13.11.1042): · 1 - Город; · 2 – Село. |
3. |
identifier |
1..1 |
Identifier |
Идентификатор ресурса Appointment в МИС МО |
4. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС) |
5. |
identifier.value |
1..1 |
string |
Значение идентификатора ресурса Appointment в МИС МО. Максимальная длина поля: 300 символов |
6. |
status |
1..1 |
code |
Статус записи на приём. · booked - Запись оформлена · fulfilled - Посещение состоялось · noshow - Пациент не явился cancelled - Запись отменена |
7. |
serviceType |
1..1 |
CodeableConcept |
Информация об услугах, на которые произведена запись (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070) |
7.1. |
coding.system |
1..* |
uri |
Указывается значение «urn:oid:1.2.643.5.1.13.13.11.1070» |
7.2. |
coding.code |
1..* |
code |
Указывается код из справочника «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070 |
8. |
appointmentType |
1..1 |
CodeableConcept |
Причина приёма. Указывается только при переводе записи в статус «fulfilled» |
8.1. |
coding.system |
1..1 |
uri |
Указывается значение «http://terminology.hl7.org/CodeSystem/v2-0276» |
8.2. |
coding.code |
1..1 |
code |
· ROUTINE - Заболевание · CHECKUP - Профилактический прием |
9. |
supportingInformation |
2..2 |
Reference(Organization и CarePlan) |
Ссылка на данные по участнику информационного взаимодействия, осуществившего запись на приём (Organization) Идентификатор карты диспансерного учёта (CarePlan) |
10. |
start |
1..1 |
dateTime |
Дата и время начала приема |
11. |
end |
1..1 |
dateTime |
Дата и время окончания приема |
12. |
slot |
1..1 |
Reference(Slot) |
Ссылка на ресурс Slot (талон) |
13. |
created |
1..1 |
dateTime |
Дата осуществления записи на прием |
14. |
participant |
2..2 |
CodeableConcept |
Информация об участниках оказания услуги (пациент и кабинет/медицинский ресурс) |
14.1. |
actor.reference |
1..1 |
Reference(Patient, Location, PractitionerRole) |
Ссылка на ресурс Patient (пациент); ссылка на ресурс Location (кабинет как мед ресурс) или ссылка на ресурс PractitionerRole (мед работник как мед ресурс) |
14.2. |
status |
1..1 |
code |
Статус участника. Указывается значение «accepted» в случае, если пациент/МО не отменял запись Указывается значение «declined» в случае, если пациент/МО отменил запись (значение declined необходимо указывать только для одного участника оказания услуги – кто отменил запись) |
Ресурс Organization
Ресурс Organization предназначен для передачи данных об участнике информационного обмена, осуществившего запись на приём.
В Таблице 42 представлено описание параметров ресурса Organization. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 42 - Параметры ресурса Organization
№ п/п |
Параметр |
Кратность |
Тип |
Описание |
1. |
id |
1..1 |
id |
Идентификатор ресурса Organization. Передаётся в формате guid |
2. |
identifier |
1..1 |
Identifier |
Участник информационного взаимодействия, осуществивший запись |
3. |
identifier.system |
1..1 |
uri |
Пространство имён идентификатора. Указывается код «1.2.643.2.69.1.2.113» (код для СЗПВ) |
4. |
identifier.value |
1..1 |
string |
Указывается публичный GUID |
5. |
type |
1..1 |
CodeableConcept |
Источник записи |
5.1. |
coding.system |
1..* |
uri |
Указывается значение «urn:oid:1.2.643.2.69.1.1.1.115» |
5.2. |
coding.code |
1..* |
code |
Указывается значение из справочника «Источники записи» |
Описание выходных данных
В ответе метода от СЗПВ передается информация об успешном или неуспешном приёме от МИС МО данных с информацией об изменении записи по диспансерному наблюдению.
В случае успешного приёма от МИС МО данных с информацией об изменении записи по диспансерному наблюдению, в ответе метода передаётся ресурс OperationOutcome в формате «All OK» (пример ответа метода для успешной операции приведен в разделе 4.8.4).
В случае неуспешного приёма от МИС МО данных с информацией об изменении записи по диспансерному наблюдению, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.8.4).
Приложение 1. Справочник ошибок
Идентификатор ошибки |
Текст ошибки |
1 |
Не был указан/указан неверно guid при вызове метода |
2 |
Отсутствует доступ или не найдена конечная точка |
3 |
Время ожидания истекло |
4 |
Получен не полный набор данных для выполнения метода |
5 |
На стороне сервиса МИС метод не поддержан |
6 |
Техническая ошибка на стороне МИС |
7 |
Техническая ошибка. Медицинская система учреждения не поддержала данную функциональность. |
8 |
Нет связи с сервисом "Управление очередями" |
9 |
Не удалось определить ЛПУ для обращения за талонами |
10 |
Учреждение с данным идентификатором отсутствует в справочнике |
11 |
Отсутствуют данные целевой МО |
12 |
Ошибка в сервисе УО |
13 |
Недействительное значение параметра |
14 |
Неверный формат входящего параметра |
15 |
Внутренняя ошибка сервиса |
16 |
МИС медицинской организации передала некорректные данные |
20 |
Пациент с заданными параметрами не найден |
21 |
Данные пациента не являются уникальными |
22 |
Несоответствие записи акта гражданского состояния |
23 |
МИС не вернула идентификатор пациента |
25 |
Извините, запись невозможна. Пациент уже записан к врачу <ФИО врача> в кабинет <название кабинета> на услугу <название услуги> в этот день: <дата записи в формате дд.мм.гггг чч:мм>. Полную информацию об этой записи Вы можете посмотреть в Личном кабинете ЕПГУ |
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 должно соответствовать одному из значений справочника "Источник записи" |
54 |
Значение DeactivationReason должно соответствовать одному из значений справочника |
60 |
Указан недопустимый идентификатор врача |
61 |
Указаны недопустимые интервалы времени |
62 |
Дата осуществления записи на прием должна быть меньше или равна дате начала приема (NoticeAppointment) |
63 |
Дата начала приема должна быть больше или равна дате отправки запроса (Appointment) |
64 |
Дата и время начала приема должна быть меньше или равна дате и времени окончания приема |
65 |
Дата осуществления записи на прием должна быть меньше или равна дате отправки запроса (NoticeAppointment) |
66 |
Дата и время изменения статуса записи на прием должна быть больше или равна дате и времени осуществления записи на прием |
67 |
Дата и время изменения статуса записи на прием должна быть меньше или равна дате и времени отправки запроса |
70 |
Указан недопустимый идентификатор специальности |
71 |
В запросе запрещено одновременное заполнение параметров: идентификатора специальности и федерального идентификатора специальности |
72 |
Нет доступного врача для вызова врача на дом |
73 |
Нет доступных слотов для вызова врача на дом |
74 |
Пациент имеет активную заявку на вызов врача на дом |
75 |
Талон с указанным номером не существует или уже отменен |
76 |
Направление не найдено по параметрам поиска |
77 |
Направление найдено, но не прошло проверку на актуальность |
78 |
В запросе запрещено одновременное заполнение параметров: идентификатора врачебной должности и федерального идентификатора врачебной должности |
80 |
Нет прикрепления к ЛПУ |
90 |
Сведения о записи не найдены |
91 |
Неизвестный источник записи |
92 |
Заявка {idPar} не найдена среди активных заявок |
93 |
Код введён неверно |
94 |
Неизвестный статус записи |
95 |
ЛПУ не подключена к системе ЖОЗ |
99 |
Текст ответа МИС – в случае необходимости передачи определенной информации клиенту сервиса, инициирующему запрос метода |
151 |
Пациент уже имеет предстоящую запись к данному врачу МИС должна передать следующий текст: «Name:N3:Room:N3:Service_Id:N3:VisitStart: N3:EventDateTime:N3:AppointmentSource:N3:Member»,
где
Name = ФИО медицинского работника; Room = Наименование кабинета, где производится врачебный прием; Service_Id = Код услуги (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070); VisitStart = Дата и время приема; EventDateTime = Дата совершения записи; AppointmentSource = Источник записи (код из Приложения 7); Member = Участник информационного взаимодействия, осуществивший запись (формат GUID, передавать при значении AppointmentSource = «Прочее») |
152 |
Пациент уже записан на это время к другому врачу МИС должна передать следующий текст: «Name:N3:FedIdPosition:N3:Room:N3:Service_Id: N3:VisitStart:N3:EventDateTime:N3:AppointmentSource: N3:Member»,
где
Name = ФИО медицинского работника; FedIdPosition = Идентификатор врачебной должности в федеральном справочнике должностей (ФРМР. Должности медицинского персонала (OID 1.2.643.5.1.13.13.11.1102; 2 папки)) Room = Наименование кабинета, где производится врачебный прием; Service_Id = Код услуги (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070); VisitStart = Дата и время приема; EventDateTime = Дата совершения записи; AppointmentSource = Источник записи (код из Приложения 7); Member = Участник информационного взаимодействия, осуществивший запись (формат GUID, передавать при значении AppointmentSource = «Прочее») |
153 |
Пациент не подходит по возрастному критерию МИС должна передать следующий текст: «MinAge:N3:MaxAge»,
где
MinAge = Минимальный возраст пациента; MaxAge = Максимальный возраст пациента (если верхняя граница не ограничена - не передается) |
200 |
Запись на второй этап вакцинации недоступна. С момента проведения первого этапа вакцинации прошло менее 21 дня |