Запись на прием к врачу по FHIR-архитектуре

Обновленный Сервис записи на приём к врачу (версия 3.0) предназначен для предоставления услуг записи посредством информационного взаимодействия ИС через API Интеграционной платформы.
Услуга «Запись на прием к врачу по направлению» в рамках обновленного сервиса записи на прием к врачу (версия 3.0) предоставляет возможность оформления записи на прием к врачу в электронном виде по направлениям с использованием информационного взаимодействия с подсистемой «Управление очередями на оказание медицинской помощи» (УО) и обеспечивает поддержку федеральных требований оказания данной услуги через КУ ФЭР (ЕПГУ - Госуслуги).
Участниками процесса в рамках услуги «Запись на прием к врачу по направлению» являются:

  • СЗПВ;
  • Клиент СЗПВ (инициатор оформления записи);
  • УО (источник данных о направлении);
  • МИС целевой МО (владелец расписания медицинских ресурсов для записи по направлению).

На Рисунке 1 представлена схема информационного взаимодействия в рамках сценария оформления записи по услуге «Запись на приём к врачу по направлению».

Рисунок 1. Схема информационного взаимодействия в рамках сценария оформления записи по услуге «Запись на приём к врачу по направлению»
Краткое описание протокола взаимодействия приведено в разделе 3.
Описание методов в рамках услуги «Запись на прием к врачу по направлению» приведено в разделе 4.

Описание протокола взаимодействия

Общая информация о сервисе

Информационный обмен осуществляется в соответствии со стандартом FHIR® (Fast Healthcare Interoperability Resources), разработанным организацией HL7. Используемая версия FHIR Release 4, 4.0.1. Подробное описание стандарта доступно по следующим ссылкам:

В качестве протокола взаимодействия используется REST (использование REST-протокола в FHIR® – см. https://hl7.org/fhir/http.html).

Требования к авторизации

При информационном взаимодействии с СЗПВ необходимо передавать в заголовке сообщения авторизационный токен в формате:

Authorization: N3[пробел][GUID системы]


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

 

Использование справочников

Справочники, используемые в СЗПВ, опубликованы в «Сервисе Терминологии». Описание сервиса Терминологии и правила взаимодействия с ним приведены по ссылке: http://api.netrika.ru/docs.php?article=Terminology.
Для каждого справочника в Настоящем документе указан его OID (объектный идентификатор). Перечень присвоенных корневых OID:
1.2.643.5.1.13.2.1 - Корневой OID справочников, размещённых в Федеральном реестре НСИ (http://nsi.rosminzdrav.ru/);
1.2.643.2.69.1.1.1 – Корневой OID для справочников подсистемы НСИ Регионального фрагмента.
Передача параметров, использующих значения справочников, не указанных в стандарте FHIR, осуществляется в следующей структуре:

"coding": [


{

"system": "urn:oid:[OID справочника в сервисе Терминологии]",

 

"code": "[код значения]"


}
]
При передаче параметров, использующих значения внутренних справочников FHIR, указывается только код значения (справочники стандарта FHIR также опубликованы в сервисе Терминологии).
Справочники, используемые в рамках услуги «Запись на прием к врачу по направлению»:

 

  1. Справочник «ЛПУ» Интеграционной платформы
  2. «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066)
  3. «Статус направления» (OID 1.2.643.2.69.1.1.1.50)
  4. «Тип направления» (OID 1.2.643.2.69.1.1.1.55)
  5. «Составной профиль помощи» (OID 1.2.643.2.69.1.1.1.56)
  6. «Вид исследования» (OID 1.2.643.2.69.1.1.1.57)
  7. «Область исследования» (OID 1.2.643.2.69.1.1.1.58)
  8. «Справочник МО региона» (OID 1.2.643.2.69.1.1.1.64)
  9. «Роль в направлении пациента» (OID 1.2.643.2.69.1.1.1.66)
  10. «Номенклатура должностей медицинских работников и фармацевтических работников» (OID 1.2.643.5.1.13.2.1.1.607)
  11. «Классификатор половой принадлежности» (OID 1.2.643.5.1.13.2.1.1.156)
  12. «Тип контакта» (OID 1.2.643.2.69.1.1.1.27)
  13. «Статус диагноза» (OID 1.2.643.2.69.1.1.1.26)
  14. «МКБ10 ред.СПб КЗ» (OID 1.2.643.2.69.1.1.1.2)
  15. «Тип адреса» (OID 1.2.643.2.69.1.1.1.28)
  16. «Классификатор категорий льгот» (OID 1.2.643.2.69.1.1.1.7)
  17. «Составной тип документа» (OID 1.2.643.2.69.1.1.1.59)
  18. «Реестр страховых медицинских организаций (ФОМС)» (OID 1.2.643.5.1.13.2.1.1.635)
  19. «Регион» (OID 1.2.643.2.69.1.1.1.51)
  20. «Вид медицинской помощи» (OID 1.2.643.2.69.1.1.1.52)
  21. «Форма медицинской помощи» (OID 1.2.643.2.69.1.1.1.54)
  22. «Условия медицинской помощи» (OID 1.2.643.2.69.1.1.1.53)
  23. «Источник аннулирования» (OID 1.2.643.2.69.1.1.1.49)
  24. «Причина аннулирования» (OID 1.2.643.2.69.1.1.1.60)
  25. «Справочник соответствия кодов МО Росминздрав и ФФОМС» (OID 1.2.643.2.69.1.1.1.87)
  26. Справочник «Роль пользователя»
  27. Справочник «Источники записи» (OID 1.2.643.2.69.1.1.1.115)
  28. «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102)
  29. Справочник «Статус записи на прием»
  30. Справочник типа ресурса Location http://terminology.hl7.org/CodeSystem/location-physical-type
  31. Справочник «Тип документа» (OID 1.2.643.2.69.1.1.1.6)
  32. «ФРМО. Справочник отделений и кабинетов» (OID 1.2.643.5.1.13.13.99.2.115)
  33. Справочник причин приёма https://terminology.hl7.org/1.0.0/CodeSystem-v2-0276.html
  34. Справочник ошибок Сервиса записи на прием (OID 1.2.643.2.69.1.1.1.166)

 Cервис выдачи идентификаторов процесса

Для обеспечения возможности связывания данных методов сервиса записи на прием, вызванных в рамках одного процесса, на стороне сервиса сбора и хранения информации, необходимо, чтобы клиент СЗПВ передавал в рамках вызова метода идентификатор процесса, полученный от сервиса выдачи идентификаторов процесса (далее СВИП). Под процессом в данном случае понимается сценарий, состоящий из последовательного вызова методов СЗПВ с целью получения услуги предоставляемой СЗПВ. Каждый раз, когда начинается новый процесс, должен быть получен новый идентификатор процесса. Под процессом обычно понимается некоторый use case, который обеспечивает СЗПВ.
Данный идентификатор требуется передавать в Header запроса метода сервиса записи на прием в следующем формате:
Processid: YourProcessId
Примеры use case'ов, обеспечиваемых СЗПВ (v 3.0 - FHIR):

  1. Запись по направлению. Состоит из методов: $searchslots, $setappointment.
  2. Запись на вакцинацию. Состоит из методов: $getpatientid, $searchmedicalresources, $searchslots, $setappointment.
  3. Запись по диспансерному наблюдению. Состоит из методов: $getpatientid, $getdispensaryobservationinfo, $searchmedicalresources, $searchslots, $setappointment.
  4. Запись по направлению. Состоит из методов: $searchslots, $setappointment.
  5. Отмена записи. Состоит из методов: $cancelappointment.
  6. Уведомление об изменении статуса записи. Состоит из методов: $changenotification.

Каждый идентификатор процесса имеет ограничение срока жизни. Это сделано для того, чтобы не допустить ситуации, при которой один идентификатор процесса будет использоваться неопределённо долго, а также для обеспечения утилизации идентификаторов процесса, которые уже не могут участвовать в обмене данными (в этом случае считается, что пользовательский сеанс уже завершён и сервис может не ожидать новых запросов с данным токеном). Время жизни токена обычно выбирается достаточно продолжительным (порядка 3 часов) для того, чтобы пользовательская сессия не успела завершиться до окончания срока действия токена, однако, если это произошло, то нужно либо заново получить новый токен, либо принудительно завершить пользовательский сеанс и начать use case c самого начала.
При получении запроса метода с идентификатором процесса сервис записи на прием определяет с помощью СВИП актуальность указанного идентификатора процесса. В случае, если идентификатор процесса просрочен или был передан некорректно, СЗПВ сгенерирует своё значение, которое будет передано в сервис сбора и хранения информации в качестве идентификатора процесса, цепочка при этом разорвётся. 
Описание методов СВИП:

  1. Метод получения идентификатора процесса

Адрес: /api/token
HTTP-метод: GET
Данный метод используется для получения клиентом сервиса записи на прием идентификатора процесса.
В запросе метода отсутствуют входные параметры.
Формат ответа метода:
{
"success": true,
"resultcode": 0,
"message": null,
"content": "YourProcessId"
}
, где наполнение параметра content – идентификатор процесса.

  1. Метод получения данных по идентификатору процесса (авторизационной сессии)

 

Адрес: /api/session?token=
HTTP-метод: GET
Данный метод используется для проверки актуальности и получения данных по идентификатору процесса (авторизационной сессии).
В запросе метода указывается идентификатор процесса в формате [base]/api/session?token=[YourProcessId]
Формат ответа метода:
{"content":

Unknown macro: {"token"}

}
, где
наполнение параметра token – идентификатор процесса,
наполнение параметра startDate - дата начала действия идентификатора процесса,
наполнение параметра endDate - дата истечения срока действия идентификатора процесса.

 

Описание методов сервиса

Список методов сервиса

Сервис записи на приём к врачу в части услуги «Запись на приём к врачу по направлению» содержит следующие методы: _Выбор_района_(GetDistrictList)

  1. Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots);|#_Выбор_ЛПУ_(GetLPUList)
  2. Осуществление записи на приём к врачу по направлению ($setappointment);
  3. Отмена записи на приём к врачу по направлению ($cancelappointment);
  4. Уведомление о факте записи на приём по направлению ($notify);
  5. Уведомление об изменении записи на приём по направлению ($changenotification);
  6. Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo).

Обязательность параметров, используемых в запросах, указана в соответствующих таблицах. При этом используются следующие обозначения:

  • 0..1 - параметр необязательный, максимальное количество экземпляров один;
  • 0..* – параметр необязательный, максимальное количество экземпляров не ограничено;
  • 1..1 – параметр обязательный, экземпляр один;
  • 1..2 – параметр обязательный, экземпляр один или два;
  • 1..3 – параметр обязательный, экземпляр один, два или три;
  • 1..* – параметр обязательный, максимальное количество экземпляров не ограничено;
  • 2..2 – параметр обязательный, два экземпляра.

Значения параметров методов, имеющих тип Datetime, необходимо передавать в формате UTC с указанием таймзоны. Если таймзона не указана, то в рамках сервиса считается, что передано локальное время (региональное), и сервис работает с переданным значением как с "датой, для которой не указана таймзона".

Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)

 

Данный метод используется для поиска в целевой МО доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению. В качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$searchslots.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 2 представлена схема информационного взаимодействия в рамках метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)».

<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="a1a932e1-0f36-4b29-bbb1-88c7ee1e1988"><ac:parameter ac:name="">_Ref12878762</ac:parameter></ac:structured-macro>Рисунок 2. Схема информационного взаимодействия в рамках метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)»
Описание схемы:

 

  1. Клиент СЗПВ отправляет запрос метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)» в СЗПВ. Состав параметров запроса представлен в Таблице 1.
  2. СЗПВ отправляет запрос метода SearchOne в сервис УО для получения данных о направлении.
  3. УО передает ответ метода SearchOne в СЗПВ с данными о направлении.
  4. В случае, если направление имеет статус 1, 2, 3, 4, 5 или 6 (по данным из шага 3), СЗПВ отправляет запрос метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)» в целевое ЛПУ, определенное на шаге 3. Состав параметров запроса представлен в Таблице 1.
  5. Целевое ЛПУ передает ответ метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.1.2.
  6. СЗПВ передает ответ метода «Поиск доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению ($searchslots)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.1.2.

Описание параметров запроса

В Таблице 1 представлено описание параметров запроса метода $searchslots.
Таблица 1 – Описание параметров запроса метода $searchslots

Параметры

Кратность

Тип

Описание

organizationId

0..1

string

Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы.
Наполняется при передаче запроса от СЗПВ к поставщику данных

referralId

1..1

string

Номер направления (идентификатор направления в сервисе УО)

patientSurname

0..1

string

Фамилия пациента (заполняется как в выданном направлении)

 

Описание выходных данных

В ответе метода от целевой МО передается информация о доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению в формате Bundle типа collection. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы, кроме Patient, должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:

"fullUrl": "Тип ресурса/id ресурса"


например, "fullUrl": "Schedule/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание представлено в Таблице 2.
Таблица 2  Описание ресурсов, входящих в состав Bundle

 

№ п/п

Параметр

Ссылки на другие ресурсы

Описание

 

Patient

Ссылка на Organization (целевая МО)

В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО)

 

Schedule

Ссылка на PractitionerRole;
Ссылка на Location

В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты).

В случае, если медицинский ресурс является медицинским работником, в рамках одного ресурса Schedule должна быть указана одна ссылка на ресурс PractitionerRole, а также могут быть указаны максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём, и максимум одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём. Количество ресурсов Schedule определяется количеством уникальных наборов PractitionerRole и максимум 2-х Location.

В случае, если медицинский ресурс является кабинетом, в рамках одного ресурса Schedule должна быть указана одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём, а также может быть указана максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём. В рамках ресурса Schedule не должна передаваться ссылка на ресурс PractitionerRole.
Количество ресурсов Schedule определяется количеством уникальных наборов Location с данными по описанию кабинета и Location с данными по адресу физического здания.

 

PractitionerRole

Ссылка на Organization (целевая МО);
Ссылка на Practitioner

В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией для осуществления записи на прием)

 

Practitioner

 

В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС)

 

Location

Ссылка на Organization (целевая МО)

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В рамках передачи данных о расписании медицинского работника как медицинского ресурса, в ресурсах Location может передаваться информация о месте приема медицинского работника (адрес физического здания медицинской организации, где будет осуществляться приём, и описание кабинета, где будет осуществляться приём) – двумя отдельными ресурсами Location.
В рамках передачи данных о расписании кабинета как медицинского ресурса, в ресурсе Location передается информация с описанием данного кабинета (наименование кабинета, OID кабинета в соответствии со справочником ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 и прочее), а также в отдельном ресурсе Location может передаваться информация об адресе физического здания медицинской организации, где будет осуществляться приём.

 

Slot

Ссылка на Schedule

В ресурсе указывается информация о талоне (свободном временном интервале) для оформления записи по направлению

 

Parameters

Ссылка на Schedule

Ресурс предназначен для описания причины при отсутствии расписания


Схема структуры Bundle приведена на Рисунке 3.

Рисунок 4. Структура ответа метода $searchslots
Описание ресурсов, входящих в состав Bundle

Patient

Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 3 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 3 - Параметры ресурса Patient

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Patient.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор пациента в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора пациента в МИС МО.
Максимальная длина поля: 300 символов

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)


Пример фрагмента Bundle по ресурсу Patient приведен в разделе 4.2.4.

Schedule

Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 4 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 4 - Параметры ресурса Schedule

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Schedule.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор расписания медицинского ресурса в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора расписания медицинского ресурса в МИС МО.
Передаётся в формате guid

 

actor

1..3

Reference

Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location)

 

comment

 

 

Код причины отсутствия свободных талонов в запрашиваемом периоде.
Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.222 «Причины отсутствия талонов».
Должен передаваться, если отсутствуют свободные слоты за все дни из запрашиваемого диапаз талонов в запрашиваемом периоде.
Должен передаваться, если отсутствуют свободные слоты за все дни из запрашиваемого диапазона времени (в ответе метода не передан как минимум один слот со ссылкой на данный ресурс Schedule).


Пример фрагмента Bundle по ресурсу Schedule приведен в разделе 4.2.4.

PractitionerRole

Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 5 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 5 - Параметры ресурса PractitionerRole

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса PractitionerRole.
Передаётся в формате guid

 

extention

1..1

code

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.1

extention.url

1..1

uri

Передаётся значение «

https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group

»

2.2

extention.valueCodeableConcept

0..1

CodeableConcept

 

2.2.1

extention.valueCodeableConcept.coding

1..3

Coding

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив)

2.2.1.1

extention.valueCodeableConcept.coding. system

1..1

code

Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)

2.2.1.2

extention.valueCodeableConcept.coding. code

1..1

code

Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан».
В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя

 

identifier

1..1

Identifier

Идентификатор ресурса PractitionerRole в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса PractitionerRole в МИС МО.
Максимальная длина поля: 200 символов

 

practitioner

1..1

Reference(Practitioner)

Ссылка на медицинского работника (ресурс Practitioner)

 

organization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)

 

code

1..1

CodeableConcept

Информация о должности медицинского работника

 

code.coding

3..3

Coding

Информация о должности медицинского работника

 

code.coding.system

1..1

uri

Значение OID справочника, по которому передаётся информация о должности медицинского работника:

  • «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) В рамках контейнера 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)).
 

code.coding.code

1..1

code

Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника.
Максимальная длина поля: 300 символов

 

code.coding.display

1..1

string

Наименование врачебной должности из справочника врачебных должностей целевой МИС МО.
Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5
Максимальная длина поля: 300 символов

 

specialty

1..1

CodeableConcept

Информация о специальности медицинского работника

 

specialty.coding

2..2

Coding

Информация о специальности медицинского работника

 

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) В рамках контейнера 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)).
 

specialty.coding.code

1..1

code

Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника.
Максимальная длина поля: 300 символов

 

specialty.coding.display

1..1

string

Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО.
Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5
Максимальная длина поля: 300 символов

 

specialty.text

0..1

string

Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности).
Максимальная длина поля: 300 символов

 

availabilityExceptions

0..1

string

Комментарий (указывается важная информация для осуществления записи на прием к данному врачу).
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу PractitionerRole приведен в разделе 4.2.4.

Practitioner

Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 6 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 6 - Параметры ресурса Practitioner

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Practitioner.
Передаётся в формате guid

 

identifier

2..2

Identifier

Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС)

 

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)
 

identifier.value

1..1

string

Значение для идентификатора или для СНИЛСа.
Максимальная длина поля: 300 символов

 

name

1..1

HumanName

ФИО медицинского работника

 

name.family

1..1

string

Фамилия.
Максимальная длина поля: 300 символов

 

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу Practitioner приведен в разделе 4.2.4.

Location

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 7 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 7 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Location.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор ресурса Location в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса Location в МИС МО

 

address

1..1

Address

Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём

 

address.text

1..1

string

Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой.
Максимальная длина поля: 300 символов

 

physicalType

1..1

CodeableConcept

Тип ресурса Location

 

coding.system

1..1

uri

Указывается значение «

http://terminology.hl7.org/CodeSystem/location-physical-type

»

 

coding.code

1..1

code

Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО)

 

coding.display

1..1

string

Указывается значение «Building»

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)

Пример фрагмента Bundle по ресурсу Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём, приведен в разделе 4.2.4.
В Таблице 8 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 8 - Параметры ресурса Location (описание кабинета МО)

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Location.
Передаётся в формате guid

 

extention

1..1

code

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.1

extention.url

1..1

uri

Передаётся значение «

https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group

»

2.2

extention.valueCodeableConcept

1..1

CodeableConcept

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.2.1

extention.valueCodeableConcept.coding

1..3

Coding

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив)

2.2.1.1

extention.valueCodeableConcept.coding. system

1..1

code

Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)

2.2.1.2

extention.valueCodeableConcept.coding. code

1..1

code

Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан».
В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя

 

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 заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе

 

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)
 

identifier.value

1..1

string

Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115
Максимальная длина поля: 300 символов

 

name

1..1

string

Наименование кабинета.
Например: «Кабинет №5».
Максимальная длина поля: 300 символов

 

physicalType

1..1

CodeableConcept

Тип ресурса Location

 

coding.system

1..1

uri

Указывается значение «

http://terminology.hl7.org/CodeSystem/location-physical-type

»

 

coding.code

1..1

code

Указывается значение «ro».
Обозначение того, что данный ресурс Location – кабинет (комната)

 

coding.display

1..1

string

Указывается значение «Room»

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)

 

partOf

0..1

Reference(Location)

Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания)


Примеры фрагмента Bundle по ресурсу Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника) приведены в разделе 4.2.4.

Slot

Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по направлению.
В Таблице 9 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 9 - Параметры ресурса Slot

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Slot.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор талона в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора талона в МИС МО.
Максимальная длина поля: 300 символов

 

schedule

1..1

Reference(Schedule)

Ссылка на ресурс Schedule (расписание)

 

status

1..1

code

Указывается значение «free»

 

start

1..1

instant

Дата и время начала приема

 

end

1..1

instant

Дата и время окончания приема

 

comment

0..1

string

Номер талона в очереди.
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу Slot приведен в разделе 4.2.4.

Parameters

Ресурс Parameters предназначен для описания причины отсутствия расписания (в отдельных параметрах по требованиям КУ ФЭР стр.137 v3.1.0).
В Таблица 10 представлено описание параметров ресурса Parameters. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 10 - Параметры ресурса Parameters

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Parameters.
Передаётся в формате guid

 

parameter

0..*

Identifier

Параметры МО

 

Parameter.MO_name

1..1

string

Название МО

 

Parameter.MO_Address

1..1

string

Адресс МО

 

Parameter.MO_Phone

1..1

string

Номер телефона МО
Максимальная длина поля: 300 символов

 

referenceSchedule

0..1

Reference(Schedule)

Ссылка на ресурс Schedule (расписание)


Пример фрагмента Bundle по ресурсу Parameters приведен в разделе 4.2.4.
 

 

Осуществление записи на приём к врачу по направлению ($setappointment)

 

Данный метод используется для осуществления в целевой МО записи на приём к врачу по направлению.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$setappointment.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 5 представлена схема информационного взаимодействия в рамках метода «Осуществление записи на приём к врачу по направлению ($setappointment)».

<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="dacc05b4-4a7b-497b-a5d6-86fa49839556"><ac:parameter ac:name="">_Ref43131662</ac:parameter></ac:structured-macro>Рисунок 5. Схема информационного взаимодействия в рамках метода «Осуществление записи на приём к врачу по направлению ($setappointment)»
Описание схемы:

 

  1. Клиент СЗПВ отправляет запрос метода «Осуществление записи на приём к врачу по направлению ($setappointment)» в СЗПВ. Состав параметров запроса представлен в Таблице 10.
  2. СЗПВ отправляет запрос метода SearchOne в сервис УО для получения данных о направлении.
  3. УО передает ответ метода SearchOne в СЗПВ с данными о направлении.
  4. В случае, если направление имеет статус 1, 2, 3, 4, 5 или 6 (по данным из шага 3), СЗПВ отправляет запрос метода «Осуществление записи на приём к врачу по направлению ($setappointment)» в целевое ЛПУ, определенное на шаге 3. Состав параметров запроса представлен в Таблице 10.
  5. Целевое ЛПУ передает ответ метода «Осуществление записи на приём к врачу по направлению ($setappointment)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.2.2.
  6. СЗПВ передает ответ метода «Осуществление записи на приём к врачу по направлению ($setappointment)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.2.2.

Описание параметров запроса

В Таблице 10 представлено описание параметров запроса метода $setappointment.
Таблица 11 – Описание параметров запроса метода $setappointment

Параметры

Кратность

Тип

Описание

organizationId

1..1

string

Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы

referralId

1..1

string

Номер направления (идентификатор направления в сервисе УО)

patientId

1..1

string

Идентификатор пациента из соответствующего справочника целевой МИС

slotId

1..1

string

Идентификатор талона для записи из соответствующего справочника целевой МИС

previousSlotId

0..1

string

Идентификатор талона записи на прием, по которой необходимо произвести перенос даты и времени (указывается идентификатор талона по существующей записи на прием)

 

Описание выходных данных

В ответе метода от целевой МО передается информация об успешной или неуспешной операции оформления записи на приём к врачу по направлению.
В случае успешной операции по оформлению записи на приём к врачу по направлению, в ответе метода передаётся ресурс OperationOutcome в формате «All OK» (пример ответа метода для успешной операции приведен в разделе 4.2.4).
В случае неуспешной операции по оформлению записи на приём к врачу по направлению, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.2.4).


 

 

Отмена записи на приём к врачу по направлению ($cancelappointment)

 

Данный метод используется для осуществления в целевой МО отмены записи на приём к врачу по направлению.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$cancelappointment.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 6 представлена схема информационного взаимодействия в рамках метода «Отмена записи на приём к врачу по направлению ($cancelappointment)».

<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="833b4fb2-31dd-439b-b55f-c3a414f19b53"><ac:parameter ac:name="">_Ref45036601</ac:parameter></ac:structured-macro>Рисунок 6. Схема информационного взаимодействия в рамках метода «Отмена записи на приём к врачу по направлению ($cancelappointment)»
Описание схемы:

 

  1. Клиент СЗПВ отправляет запрос метода «Отмена записи на приём к врачу по направлению ($cancelappointment)» в СЗПВ. Состав параметров запроса представлен в Таблице 11.
  2. СЗПВ отправляет запрос метода «Отмена записи на приём к врачу по направлению ($cancelappointment)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 11.
  3. Целевое ЛПУ передает ответ метода «Отмена записи на приём к врачу по направлению ($cancelappointment)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.3.2.
  4. СЗПВ передает ответ метода «Отмена записи на приём к врачу по направлению ($cancelappointment)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.3.2.

Описание параметров запроса

В Таблице 11 представлено описание параметров запроса метода $cancelappointment.
Таблица 12 – Описание параметров запроса метода $cancelappointment

Параметры

Кратность

Тип

Описание

organizationId

1..1

string

Идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы

patientId

1..1

string

Идентификатор пациента из соответствующего справочника целевой МИС

slotId

1..1

string

Идентификатор талона для записи из соответствующего справочника целевой МИС

 

Описание выходных данных

В ответе метода от целевой МО передается информация об успешной или неуспешной операции отмены записи на приём к врачу по направлению.
В случае успешной операции по отмене записи на приём к врачу по направлению, в ответе метода передаётся ресурс OperationOutcome в формате «All OK» (пример ответа метода для успешной операции приведен в разделе 4.3.4).
В случае неуспешной операции по отмене записи на приём к врачу по направлению, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.3.4).

 

 

Уведомление о факте записи на приём по направлению ($notify)

 

Данный метод предназначен для передачи в СЗПВ сведений обо всех фактах записи на приём по направлениям в рамках МО. При передаче данных о факте записи на приём по направлению необходимо передавать дату и время осуществления записи на приём.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$notify.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 7 представлена схема информационного взаимодействия в рамках метода «Уведомление о факте записи на приём по направлению ($notify)».

<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="13e4c8a2-7573-412c-ad51-b8b4110be0ee"><ac:parameter ac:name="">_Ref48057844</ac:parameter></ac:structured-macro>Рисунок 7. Схема информационного взаимодействия в рамках метода «Уведомление о факте записи на приём по направлению ($notify)»
Описание схемы:

 

  1. Целевое ЛПУ отправляет запрос метода «Уведомление о факте записи на приём по направлению ($notify)» в СЗПВ. Состав параметров запроса метода представлен в разделе 4.5.1.
  2. СЗПВ передает ответ метода «Уведомление о факте записи на приём по направлению ($notify)» в целевое ЛПУ. Состав параметров ответа метода представлен в Таблице 23.

Описание параметров запроса

В запросе метода от целевой МО передается информация о ресурсах, описывающих факт записи на приём по направлению, в формате Bundle типа transaction. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы, кроме Patient и Organization (как ресурс, описывающий участника информационного обмена, осуществившего запись на приём), должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization как ресурс, описывающий целевую МО), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:

"fullUrl": "Тип ресурсаid ресурса"


например, "fullUrl": "Schedule/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи, где медицинским ресурсом выступает медицинский работник, представлено в Таблице 12.
Таблица 12 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)

 

№ п/п

Параметр

Ссылки на другие ресурсы

Описание

 

Patient

Ссылка на Organization (целевая МО)

В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО)

 

Schedule

Ссылка на PractitionerRole;
Ссылка на Location

В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает медицинский работник).
В рамках ресурса Schedule должна быть указана одна ссылка на ресурс PractitionerRole, а также могут быть указаны максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём, и максимум одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём. Количество передаваемых ресурсов Schedule - 1..1.

 

PractitionerRole

Ссылка на Organization (целевая МО);
Ссылка на Practitioner

В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией по осуществлению записи на прием)

 

Practitioner

 

В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС)

 

Location

Ссылка на Organization (целевая МО)

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о месте приема конкретного медицинского работника).
В ресурсах Location может передаваться информация о месте приема медицинского работника (адрес физического здания медицинской организации, где будет осуществляться приём, и описание кабинета, где будет осуществляться приём) – двумя отдельными ресурсами Location.
Количество передаваемых ресурсов Location - 0..2.

 

Slot

Ссылка на Schedule

В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по направлению

 

Appointment

Ссылка на Organization (участник информационного обмена, осуществивший запись на приём);
Ссылка на Patient;
Ссылка на PractitionerRole;
Ссылка на Slot

В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём и номер направления).
Количество передаваемых ресурсов Appointment - 1..1.

 

Organization (участник информационного обмена, осуществивший запись на приём)

 

В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём


Схема структуры Bundle для факта записи, где медицинским ресурсом выступает медицинский работник, приведена на Рисунке 8.

Рисунок 8. Структура Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи, где медицинским ресурсом выступает кабинет, представлено в Таблице 13.
Таблица 13 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)

№ п/п

Параметр

Ссылки на другие ресурсы

Описание

 

Patient

Ссылка на Organization (целевая МО)

В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО)

 

Schedule

Ссылка на Location

В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает кабинет).
В рамках ресурса Schedule должна быть указана одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём, а также может быть указана максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём. В рамках ресурса Schedule не должна передаваться ссылка на ресурс PractitionerRole.
Количество передаваемых ресурсов Schedule - 1..1.

 

Location

Ссылка на Organization (целевая МО)

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги).
В ресурсе Location передается информация с описанием данного кабинета (наименование кабинета, OID кабинета в соответствии со справочником ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 и прочее), а также в отдельном ресурсе Location может передаваться информация об адресе физического здания медицинской организации, где будет осуществляться приём.
Количество передаваемых ресурсов Location - 1..2.

 

Slot

Ссылка на Schedule

В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по направлению

 

Appointment

Ссылка на Organization (участник информационного обмена, осуществивший запись на приём);
Ссылка на Patient;
Ссылка на Location;
Ссылка на Slot

В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём и номер направления).
Количество передаваемых ресурсов Appointment - 1..1.

 

Organization (участник информационного обмена, осуществивший запись на приём)

 

В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём


Схема структуры Bundle для факта записи, где медицинским ресурсом выступает кабинет, приведена на Рисунке 9.

Рисунок 10. Структура ответа метода $notify
Описание ресурсов, входящих в состав Bundle

Patient

Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 14 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 14 - Параметры ресурса Patient

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Patient.
Передаётся в формате guid

 

identifier

1..4

Identifier

Идентификатор пациента (идентификатор пациента в МИС МО, СНИЛС пациента, серия и номер полиса пациента, серия и номер документа, удостоверяющего личность пациента).
Идентификатор пациента в МИС МО обязателен для передачи

 

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).
 

identifier.value

1..1

string

Значение для идентификатора или для документа.
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="9898a5b8-7fc1-4c42-8f8b-88927878b5a5"><ac:plain-text-body><![CDATA[* для идентификатора в МИС указывается [идентификатор в МИС]
]]></ac:plain-text-body></ac:structured-macro>
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="e97d48b5-0c38-4adb-82fb-f72ec7547f3e"><ac:plain-text-body><![CDATA[* для ДУЛ и полисов указывается [Серия]:[Номер] или [Номер], если нет серии, номер - обязателен. В серии не должны использоваться разделители (пробелы, тире и т.д.), допускаются цифры и буквы русского и латинского алфавита. В номере не должны использоваться разделители (пробелы, тире и т.д.), допускаются только цифры.
]]></ac:plain-text-body></ac:structured-macro>
Максимальная длина поля: 300 символов

 

name

1..1

HumanName

ФИО пациента

 

name.family

1..1

string

Фамилия.
Максимальная длина поля: 300 символов

 

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.
Максимальная длина поля: 300 символов

 

telecom

0..*

ContactPoint

Контактные телефоны пациента

 

telecom.system

1..1

code

Передаётся значение «phone»

 

telecom.value

1..1

string

Номер телефона.
Максимальная длина поля: 300 символов

 

telecom.use

1..1

code

Передаётся одно из начений:

  • «home» - номер домашнего телефона;
  • «mobile» - номер мобильного телефона.
 

gender

0..1

code

Код пола пациента (справочник FHIR. OID: 1.2.643.2.69.1.1.1.40)

 

birthDate

1..1

date

Дата рождения пациента

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)


Пример фрагмента Bundle по ресурсу Patient приведен в разделе 4.5.3.

Schedule

Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 15 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 15 - Параметры ресурса Schedule

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Schedule.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор расписания медицинского ресурса в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора расписания медицинского ресурса в МИС МО.
Передаётся в формате guid

 

actor

1..3

Reference

Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location)


Пример фрагмента Bundle по ресурсу Schedule приведен в разделе 4.5.3.

PractitionerRole

Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 16 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 16 - Параметры ресурса PractitionerRole

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса PractitionerRole.
Передаётся в формате guid

 

extention

1..1

code

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.1

extention.url

1..1

uri

Передаётся значение «

https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group

»

2.2

extention.valueCodeableConcept

 

 

 

2.2.1

extention.valueCodeableConcept.coding

1..3

Coding

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив)

2.2.1.1

extention.valueCodeableConcept.coding. system

1..1

code

Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)

2.2.1.2

extention.valueCodeableConcept.coding. code

1..1

code

Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан».
В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя

 

identifier

1..1

Identifier

Идентификатор ресурса PractitionerRole в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса PractitionerRole в МИС МО.
Максимальная длина поля: 200 символов

 

practitioner

1..1

Reference(Practitioner)

Ссылка на медицинского работника (ресурс Practitioner)

 

organization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)

 

code

1..1

CodeableConcept

Информация о должности медицинского работника

 

code.coding

3..3

Coding

Информация о должности медицинского работника

 

code.coding.system

1..1

uri

Значение OID справочника, по которому передаётся информация о должности медицинского работника:

  • «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) В рамках контейнера 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)).
 

code.coding.code

1..1

code

Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника.
Максимальная длина поля: 300 символов

 

code.coding.display

1..1

string

Наименование врачебной должности из справочника врачебных должностей целевой МИС МО.
Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5
Максимальная длина поля: 300 символов

 

specialty

1..1

CodeableConcept

Информация о специальности медицинского работника

 

specialty.coding

2..2

Coding

Информация о специальности медицинского работника

 

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) В рамках контейнера 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)).
 

specialty.coding.code

1..1

code

Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника.
Максимальная длина поля: 300 символов

 

specialty.coding.display

1..1

string

Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО.
Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5
Максимальная длина поля: 300 символов

 

specialty.text

0..1

string

Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности).
Максимальная длина поля: 300 символов

 

availabilityExceptions

0..1

string

Комментарий (указывается важная информация для осуществления записи на прием к данному врачу).
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу PractitionerRole приведен в разделе 4.5.3.

Practitioner

Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 17 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 17 - Параметры ресурса Practitioner

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Practitioner.
Передаётся в формате guid

 

identifier

2..2

Identifier

Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС)

 

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)
 

identifier.value

1..1

string

Значение для идентификатора или для СНИЛСа.
Максимальная длина поля: 300 символов

 

name

1..1

HumanName

ФИО медицинского работника

 

name.family

1..1

string

Фамилия.
Максимальная длина поля: 300 символов

 

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу Practitioner приведен в разделе 4.5.3.

Location

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 18 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 18 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Location.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор ресурса Location в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса Location в МИС МО

 

address

1..1

Address

Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём

 

address.text

1..1

string

Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой.
Максимальная длина поля: 300 символов

 

physicalType

1..1

CodeableConcept

Тип ресурса Location

 

coding.system

1..1

uri

Указывается значение «

http://terminology.hl7.org/CodeSystem/location-physical-type

»

 

coding.code

1..1

code

Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО)

 

coding.display

1..1

string

Указывается значение «Building»

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)


Пример фрагмента Bundle по ресурсу Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём, приведен в разделе 4.5.3.
В Таблице 19 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 19 - Параметры ресурса Location (описание кабинета МО)

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Location.
Передаётся в формате guid

 

extention

1..1

code

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.1

extention.url

1..1

uri

Передаётся значение «

https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group

»

2.2

extention.valueCodeableConcept

1..1

CodeableConcept

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.2.1

extention.valueCodeableConcept.coding

1..3

Coding

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив)

2.2.1.1

extention.valueCodeableConcept.coding. system

1..1

code

Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)

2.2.1.2

extention.valueCodeableConcept.coding. code

1..1

code

Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан».
В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя

 

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 заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе

 

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)
 

identifier.value

1..1

string

Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115
Максимальная длина поля: 300 символов

 

name

1..1

string

Наименование кабинета.
Например: «Кабинет №5».
Максимальная длина поля: 300 символов

 

physicalType

1..1

CodeableConcept

Тип ресурса Location

 

coding.system

1..1

uri

Указывается значение «

http://terminology.hl7.org/CodeSystem/location-physical-type

»

 

coding.code

1..1

code

Указывается значение «ro».
Обозначение того, что данный ресурс Location – кабинет (комната)

 

coding.display

1..1

string

Указывается значение «Room»

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)

 

partOf

0..1

Reference(Location)

Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания)


Примеры фрагмента Bundle по ресурсу Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника) приведены в разделе 4.5.3.

Slot

Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по направлению.
В Таблице 20 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 20 - Параметры ресурса Slot

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Slot.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор талона в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора талона в МИС МО.
Максимальная длина поля: 300 символов

 

schedule

1..1

Reference(Schedule)

Ссылка на ресурс Schedule (расписание)

 

status

1..1

code

Указывается значение «busy»

 

start

1..1

instant

Дата и время начала приема

 

end

1..1

instant

Дата и время окончания приема

 

comment

0..1

string

Номер талона в очереди.
Максимальная длина поля: 300 символов

Пример фрагмента Bundle по ресурсу Slot приведен в разделе 4.5.3.

Appointment

Ресурс Appointment предназначен для передачи данных о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём и номер направления).
В Таблице 21 представлено описание параметров ресурса Appointment. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 21 - Параметры ресурса Appointment

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Appointment.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор ресурса Appointment в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса Appointment в МИС МО.
Максимальная длина поля: 300 символов

 

status

1..1

code

Статус записи на приём.
Указывается значение «booked» (Запись оформлена)

 

serviceType

1..1

CodeableConcept

Информация об услугах, на которые произведена запись (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070)

 

coding.system

1..*

uri

Указывается значение «urn:oid:1.2.643.5.1.13.13.11.1070»

 

coding.code

1..*

code

Указывается код из справочника «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070

 

supportingInformation

1..1

Reference(Organization)

Ссылка на данные по участнику информационного взаимодействия, осуществившего запись на приём

 

start

1..1

dateTime

Дата и время начала приема

 

end

1..1

dateTime

Дата и время окончания приема

 

slot

1..1

Reference(Slot)

Ссылка на ресурс Slot (талон)

 

created

1..1

dateTime

Дата осуществления записи на прием

 

basedOn

1..1

Reference(ServiceRequest)

Номер направления.
Максимальная длина поля: 300 символов

 

participant

2..2

CodeableConcept

Информация об участниках оказания услуги (пациент и кабинет/медицинский ресурс)

 

actor.reference

1..1

Reference(Patient, Location, PractitionerRole)

Ссылка на ресурс Patient (пациент);
ссылка на ресурс Location (кабинет как мед ресурс) или ссылка на ресурс PractitionerRole (мед работник как мед ресурс)

 

status

1..1

code

Статус участника. Указывается значение «accepted»


Пример фрагмента Bundle по ресурсу Appointment приведен в разделе 4.5.3.

Organization

Ресурс Organization предназначен для передачи данных об участнике информационного обмена, осуществившего запись на приём.
В Таблице 22 представлено описание параметров ресурса Organization. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 22 - Параметры ресурса Organization

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Organization.
Передаётся в формате guid

 

identifier

1..1

Identifier

Участник информационного взаимодействия, осуществивший запись

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.2.69.1.2.113» (код для СЗПВ)

 

identifier.value

1..1

string

Указывается публичный GUID

 

type

1..1

CodeableConcept

Источник записи

 

coding.system

1..*

uri

Указывается значение «urn:oid:1.2.643.2.69.1.1.1.115»

 

coding.code

1..*

code

Указывается значение из справочника «Источники записи»


Пример фрагмента Bundle по ресурсу Organization приведен в разделе 4.5.3.

Описание выходных данных

В Таблице 23 представлено описание выходных данных метода $notify.
Таблица 23 – Описание выходных данных метода $notify

Параметры

Кратность

Тип

Описание

notificationId

1..1

string

Идентификатор уведомления о записи

 

 

Уведомление об изменении записи на приём по направлению ($changenotification)

Данный метод предназначен для передачи в СЗПВ изменений ранее переданных методом $notify фактов записи на приём по направлению (например, изменился статус записи на приём по направлению).
Предполагается следующий сценарий использования метода «Уведомление об изменении записи на приём по направлению ($changenotification)»:

  1. МИС МО передает сведения в СЗПВ обо всех записях на приём по направлению путем вызова метода $notify для каждой записи.
  2. СЗПВ присваивает идентификатор уведомлению и возвращает его в ответе метода $notify.
  3. МИС МО сохраняет полученный идентификатор уведомления для последующего использования.
  4. После того, как произошло изменение записи на приём по направлению, МИС МО передает обновлённые сведения о записи по уже известному идентификатору уведомления путем вызова метода $changenotification для каждой записи.

 

Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$changenotification.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 11 представлена схема информационного взаимодействия в рамках метода «Уведомление об изменении записи на приём по направлению ($changenotification)».

<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="f949367d-4f3b-4970-8c0c-6dc60a93ceb2"><ac:parameter ac:name="">_Ref48066812</ac:parameter></ac:structured-macro>Рисунок 11. Схема информационного взаимодействия в рамках метода «Уведомление об изменении записи на приём по направлению ($changenotification)»
Описание схемы:

 

  1. Целевое ЛПУ отправляет запрос метода «Уведомление об изменении записи на приём по направлению ($changenotification)» в СЗПВ. Состав параметров запроса метода представлен в разделе 4.6.1.
  2. СЗПВ передает ответ метода «Уведомление об изменении записи на приём по направлению ($changenotification)» в целевое ЛПУ. Состав параметров ответа метода представлен в разделе 4.6.2.

Описание параметров запроса

В запросе метода от целевой МО передается информация о ресурсах, описывающих факт записи на приём по направлению (включая изменённую информацию), в формате Bundle типа transaction. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы, кроме Patient и Organization (как ресурс, описывающий участника информационного обмена, осуществившего запись на приём), должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization как ресурс, описывающий целевую МО), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:

"fullUrl": "[Тип ресурса]/[id ресурса]"


например, "fullUrl": "Schedule/31f34a1f-2984-43cc-b2c1-33cd077370de".
В рамках ресурса Bundle необходимо передавать параметр id с наполнением полученного ранее идентификатора уведомления о записи посредством метода «Уведомление о факте записи на приём по направлению ($notify)» (выходной параметр «notificationId»).
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи (включая изменённую информацию), где медицинским ресурсом выступает медицинский работник, представлено в Таблице 24.
Таблица 24 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)

 

№ п/п

Параметр

Ссылки на другие ресурсы

Описание

 

Patient

Ссылка на Organization (целевая МО)

В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО)

 

Schedule

Ссылка на PractitionerRole;
Ссылка на Location

В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает медицинский работник).
В рамках ресурса Schedule должна быть указана одна ссылка на ресурс PractitionerRole, а также могут быть указаны максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём, и максимум одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём. Количество передаваемых ресурсов Schedule - 1..1.

 

PractitionerRole

Ссылка на Organization (целевая МО);
Ссылка на Practitioner

В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией по осуществлению записи на прием)

 

Practitioner

 

В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС)

 

Location

Ссылка на Organization (целевая МО)

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о месте приема конкретного медицинского работника).
В ресурсах Location может передаваться информация о месте приема медицинского работника (адрес физического здания медицинской организации, где будет осуществляться приём, и описание кабинета, где будет осуществляться приём) – двумя отдельными ресурсами Location.
Количество передаваемых ресурсов Location - 0..2.

 

Slot

Ссылка на Schedule

В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по направлению

 

Appointment

Ссылка на Organization (участник информационного обмена, осуществивший запись на приём);
Ссылка на Patient;
Ссылка на PractitionerRole;
Ссылка на Slot

В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём, дата изменения записи на приём и номер направления).
Количество передаваемых ресурсов Appointment - 1..1.

 

Organization (участник информационного обмена, осуществивший запись на приём)

 

В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём


Схема структуры Bundle для факта записи (включая изменённую информацию), где медицинским ресурсом выступает медицинский работник, приведена на Рисунке 12.

Рисунок 12. Структура Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)
Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи (включая изменённую информацию), где медицинским ресурсом выступает кабинет, представлено в Таблице 25.
Таблица 25 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)

№ п/п

Параметр

Ссылки на другие ресурсы

Описание

 

Patient

Ссылка на Organization (целевая МО)

В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО)

 

Schedule

Ссылка на Location

В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинского ресурса выступает кабинет).
В рамках ресурса Schedule должна быть указана одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём, а также может быть указана максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём. В рамках ресурса Schedule не должна передаваться ссылка на ресурс PractitionerRole.
Количество передаваемых ресурсов Schedule - 1..1.

 

Location

Ссылка на Organization (целевая МО)

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём, и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги).
В ресурсе Location передается информация с описанием данного кабинета (наименование кабинета, OID кабинета в соответствии со справочником ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 и прочее), а также в отдельном ресурсе Location может передаваться информация об адресе физического здания медицинской организации, где будет осуществляться приём.
Количество передаваемых ресурсов Location - 1..2.

 

Slot

Ссылка на Schedule

В ресурсе указывается информация о талоне (свободном временном интервале), по которому оформлена запись по направлению

 

Appointment

Ссылка на Organization (участник информационного обмена, осуществивший запись на приём);
Ссылка на Patient;
Ссылка на Location;
Ссылка на Slot

В ресурсе указывается информация о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём, дата изменения записи на приём и номер направления).
Количество передаваемых ресурсов Appointment - 1..1.

 

Organization (участник информационного обмена, осуществивший запись на приём)

 

В ресурсе указывается информация об участнике информационного обмена, осуществившего запись на приём


Схема структуры Bundle для факта записи (включая изменённую информацию), где медицинским ресурсом выступает кабинет, приведена на Рисунке 13.

Рисунок 14. Структура ответа метода $changenotification
Описание ресурсов, входящих в состав Bundle

Patient

Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 26 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 26 - Параметры ресурса Patient

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Patient.
Передаётся в формате guid

 

identifier

1..4

Identifier

Идентификатор пациента (идентификатор пациента в МИС МО, СНИЛС пациента, серия и номер полиса пациента, серия и номер документа, удостоверяющего личность пациента).
Идентификатор пациента в МИС МО обязателен для передачи

 

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).
 

identifier.value

1..1

string

Значение для идентификатора или для документа.
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a895d4e5-f13b-47e4-b230-c2422c176ffc"><ac:plain-text-body><![CDATA[* для идентификатора в МИС указывается [идентификатор в МИС]
]]></ac:plain-text-body></ac:structured-macro>
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a85e6e43-e9b8-47b5-bb9e-07eb480b52a0"><ac:plain-text-body><![CDATA[* для ДУЛ и полисов указывается [Серия]:[Номер] или [Номер], если нет серии, номер - обязателен. В серии не должны использоваться разделители (пробелы, тире и т.д.), допускаются цифры и буквы русского и латинского алфавита. В номере не должны использоваться разделители (пробелы, тире и т.д.), допускаются только цифры.
]]></ac:plain-text-body></ac:structured-macro>
Максимальная длина поля: 300 символов

 

name

1..1

HumanName

ФИО пациента

 

name.family

1..1

string

Фамилия.
Максимальная длина поля: 300 символов

 

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.
Максимальная длина поля: 300 символов

 

telecom

0..*

ContactPoint

Контактные телефоны пациента

 

telecom.system

1..1

code

Передаётся значение «phone»

 

telecom.value

1..1

string

Номер телефона.
Максимальная длина поля: 300 символов

 

telecom.use

1..1

code

Передаётся одно из начений:

  • «home» - номер домашнего телефона;
  • «mobile» - номер мобильного телефона.
 

gender

0..1

code

Код пола пациента (справочник FHIR. OID: 1.2.643.2.69.1.1.1.40)

 

birthDate

1..1

date

Дата рождения пациента

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)


Пример фрагмента Bundle по ресурсу Patient приведен в разделе 4.6.3.

Schedule

Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 27 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 27 - Параметры ресурса Schedule

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Schedule.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор расписания медицинского ресурса в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора расписания медицинского ресурса в МИС МО.
Передаётся в формате guid

 

actor

1..3

Reference

Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location)


Пример фрагмента Bundle по ресурсу Schedule приведен в разделе 4.6.3.

PractitionerRole

Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 28 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 28 - Параметры ресурса PractitionerRole

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса PractitionerRole.
Передаётся в формате guid

 

extention

1..1

code

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.1

extention.url

1..1

uri

Передаётся значение «

https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group

»

2.2

extention.valueCodeableConcept

 

 

 

2.2.1

extention.valueCodeableConcept.coding

1..3

Coding

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив)

2.2.1.1

extention.valueCodeableConcept.coding. system

1..1

code

Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)

2.2.1.2

extention.valueCodeableConcept.coding. code

1..1

code

Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан».
В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя

 

identifier

1..1

Identifier

Идентификатор ресурса PractitionerRole в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса PractitionerRole в МИС МО.
Максимальная длина поля: 200 символов

 

practitioner

1..1

Reference(Practitioner)

Ссылка на медицинского работника (ресурс Practitioner)

 

organization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)

 

code

1..1

CodeableConcept

Информация о должности медицинского работника

 

code.coding

3..3

Coding

Информация о должности медицинского работника

 

code.coding.system

1..1

uri

Значение OID справочника, по которому передаётся информация о должности медицинского работника:

  • «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) В рамках контейнера 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)).
 

code.coding.code

1..1

code

Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника.
Максимальная длина поля: 300 символов

 

code.coding.display

1..1

string

Наименование врачебной должности из справочника врачебных должностей целевой МИС МО.
Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5
Максимальная длина поля: 300 символов

 

specialty

1..1

CodeableConcept

Информация о специальности медицинского работника

 

specialty.coding

2..2

Coding

Информация о специальности медицинского работника

 

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) В рамках контейнера 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)).
 

specialty.coding.code

1..1

code

Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника.
Максимальная длина поля: 300 символов

 

specialty.coding.display

1..1

string

Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО.
Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5
Максимальная длина поля: 300 символов

 

specialty.text

0..1

string

Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности).
Максимальная длина поля: 300 символов

 

availabilityExceptions

0..1

string

Комментарий (указывается важная информация для осуществления записи на прием к данному врачу).
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу PractitionerRole приведен в разделе 4.6.3.

Practitioner

Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 29 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 29 - Параметры ресурса Practitioner

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Practitioner.
Передаётся в формате guid

 

identifier

2..2

Identifier

Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС)

 

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)
 

identifier.value

1..1

string

Значение для идентификатора или для СНИЛСа.
Максимальная длина поля: 300 символов

 

name

1..1

HumanName

ФИО медицинского работника

 

name.family

1..1

string

Фамилия.
Максимальная длина поля: 300 символов

 

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу Practitioner приведен в разделе 4.6.3.

Location

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 30 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 30 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Location.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор ресурса Location в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса Location в МИС МО

 

address

1..1

Address

Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём

 

address.text

1..1

string

Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой.
Максимальная длина поля: 300 символов

 

physicalType

1..1

CodeableConcept

Тип ресурса Location

 

coding.system

1..1

uri

Указывается значение «

http://terminology.hl7.org/CodeSystem/location-physical-type

»

 

coding.code

1..1

code

Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО)

 

coding.display

1..1

string

Указывается значение «Building»

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)


Пример фрагмента Bundle по ресурсу Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём, приведен в разделе 4.6.3.
В Таблице 31 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 31 - Параметры ресурса Location (описание кабинета МО)

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Location.
Передаётся в формате guid

 

extention

1..1

code

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.1

extention.url

1..1

uri

Передаётся значение «

https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group

»

2.2

extention.valueCodeableConcept

1..1

CodeableConcept

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.2.1

extention.valueCodeableConcept.coding

1..3

Coding

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив)

2.2.1.1

extention.valueCodeableConcept.coding. system

1..1

code

Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)

2.2.1.2

extention.valueCodeableConcept.coding. code

1..1

code

Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан».
В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя

 

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 заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе

 

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)
 

identifier.value

1..1

string

Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115
Максимальная длина поля: 300 символов

 

name

1..1

string

Наименование кабинета.
Например: «Кабинет №5».
Максимальная длина поля: 300 символов

 

physicalType

1..1

CodeableConcept

Тип ресурса Location

 

coding.system

1..1

uri

Указывается значение «

http://terminology.hl7.org/CodeSystem/location-physical-type

»

 

coding.code

1..1

code

Указывается значение «ro».
Обозначение того, что данный ресурс Location – кабинет (комната)

 

coding.display

1..1

string

Указывается значение «Room»

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)

 

partOf

0..1

Reference(Location)

Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания)


Примеры фрагмента Bundle по ресурсу Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника) приведены в разделе 4.6.3.

Slot

Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по направлению.
В Таблице 32 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 32 - Параметры ресурса Slot

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Slot.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор талона в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора талона в МИС МО.
Максимальная длина поля: 300 символов

 

schedule

1..1

Reference(Schedule)

Ссылка на ресурс Schedule (расписание)

 

status

1..1

code

Указывается значение «busy» (занят) или «free» (свободен) – в зависимости от статуса записи на приём

 

start

1..1

instant

Дата и время начала приема

 

end

1..1

instant

Дата и время окончания приема

 

comment

0..1

string

Номер талона в очереди.
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу Slot приведен в разделе 4.6.3.

Appointment

Ресурс Appointment предназначен для передачи данных о записи на приём (статус записи на приём, данные об услугах, на которые произведена запись, дата осуществления записи на приём и номер направления).
В Таблице 33 представлено описание параметров ресурса Appointment. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 33 - Параметры ресурса Appointment

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Appointment.
Передаётся в формате guid

 

extension

1..1

code

Признак жителя города или села («Признак жителя города или села», OID 1.2.643.5.1.13.13.11.1042).
Указывается только при переводе записи в статус «fulfilled»

 

extension.url

1..1

uri

Передаётся значение «

https://portal.egisz.rosminzdrav.ru/materials/541:Is_Villager

»

 

extension.valueCodeableConcept.coding.system

1..1

uri

Передаётся значение «urn:oid:1.2.643.5.1.13.13.11.1042»

 

extension.valueCodeableConcept.coding.code

1..1

uri

Передаётся код из справочника «Признак жителя города или села» (OID 1.2.643.5.1.13.13.11.1042):

  • 1 - Город;
  • 2 – Село.
 

identifier

1..1

Identifier

Идентификатор ресурса Appointment в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса Appointment в МИС МО.
Максимальная длина поля: 300 символов

 

status

1..1

code

Статус записи на приём.
Указывается значение «booked» (Запись оформлена)

 

serviceType

1..1

CodeableConcept

Информация об услугах, на которые произведена запись (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070)

 

coding.system

1..*

uri

Указывается значение «urn:oid:1.2.643.5.1.13.13.11.1070»

 

coding.code

1..*

code

Указывается код из справочника «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070

 

appointmentType

1..1

CodeableConcept

Причина приёма.
Указывается только при переводе записи в статус «fulfilled»

 

coding.system

1..1

uri

Указывается значение «

http://terminology.hl7.org/CodeSystem/v2-0276

»

 

coding.code

1..1

code

  • ROUTINE - Заболевание
  • CHECKUP - Профилактический прием
 

supportingInformation

1..1

Reference(Organization)

Ссылка на данные по участнику информационного взаимодействия, осуществившего запись на приём

 

start

1..1

dateTime

Дата и время начала приема

 

end

1..1

dateTime

Дата и время окончания приема

 

slot

1..1

Reference(Slot)

Ссылка на ресурс Slot (талон)

 

created

1..1

dateTime

Дата осуществления записи на прием

 

basedOn

1..1

Reference(ServiceRequest)

Номер направления.
Максимальная длина поля: 300 символов

 

participant

2..2

CodeableConcept

Информация об участниках оказания услуги (пациент и кабинет/медицинский ресурс)

 

actor.reference

1..1

Reference(Patient, Location, PractitionerRole)

Ссылка на ресурс Patient (пациент);
ссылка на ресурс Location (кабинет как мед ресурс) или ссылка на ресурс PractitionerRole (мед работник как мед ресурс)

 

status

1..1

code

Статус участника.
Указывается значение «accepted» в случае, если пациент/МО не отменял запись
Указывается значение «declined» в случае, если пациент/МО отменил запись (значение declined необходимо указывать только для одного участника оказания услуги – кто отменил запись)


Пример фрагмента Bundle по ресурсу Appointment приведен в разделе 4.6.3.

Organization

Ресурс Organization предназначен для передачи данных об участнике информационного обмена, осуществившего запись на приём.
В Таблице 34 представлено описание параметров ресурса Organization. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 34 - Параметры ресурса Organization

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Organization.
Передаётся в формате guid

 

identifier

1..1

Identifier

Участник информационного взаимодействия, осуществивший запись

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.2.69.1.2.113» (код для СЗПВ)

 

identifier.value

1..1

string

Указывается публичный GUID

 

type

1..1

CodeableConcept

Источник записи

 

coding.system

1..*

uri

Указывается значение «urn:oid:1.2.643.2.69.1.1.1.115»

 

coding.code

1..*

code

Указывается значение из справочника «Источники записи»


Пример фрагмента Bundle по ресурсу Organization приведен в разделе 4.6.3.

Описание выходных данных

В ответе метода от СЗПВ передается информация об успешном или неуспешном приёме от МИС МО данных с информацией об изменении записи на приём по направлению.
В случае успешного приёма от МИС МО данных с информацией об изменении записи на приём по направлению, в ответе метода передаётся ресурс OperationOutcome в формате «All OK» (пример ответа метода для успешной операции приведен в разделе 4.6.4).
В случае неуспешного приёма от МИС МО данных с информацией об изменении записи на приём по направлению, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.6.4).

 

Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)

 

Данный метод используется для получения от целевой МО справочной информации по количеству доступных талонов для записи по направлению.
При получении запроса целевая МО самостоятельно определяет набор параметров, на которые ориентируется при формировании информации по массиву доступных талонов, вне зависимости от того, какие параметры запроса заполнены.
Для вызова метода необходимо указывать URL в формате [base]/api/appointment/referral/fhir/$getreferenceinfo.
Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: https://hl7.org/fhir/operations.html(ссылка с описанием используемой возможности Custom Operation в рамках FHIR носит только информативный характер и используется с целью ознакомления).
На Рисунке 15 представлена схема информационного взаимодействия в рамках метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)».

<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="c6e6f7e1-22cd-4cf2-85cb-e76503ca93fe"><ac:parameter ac:name="">_Ref60243811</ac:parameter></ac:structured-macro>Рисунок 15. Схема информационного взаимодействия в рамках метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)»
Описание схемы:

 

  1. Клиент СЗПВ отправляет запрос метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)» в СЗПВ. Состав параметров запроса представлен в Таблице 35.
  2. СЗПВ отправляет запрос метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 35.
  3. Целевое ЛПУ передает ответ метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.7.2.
  4. СЗПВ передает ответ метода «Получение справочной информации по количеству доступных талонов для записи пациента по направлению ($getreferenceinfo)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.7.2.

Описание параметров запроса

В Таблице 35 представлено описание параметров запроса метода $getreferenceinfo.
Таблица 35 – Описание параметров запроса метода $getreferenceinfo

№ п/п

Параметр

Кратность

Тип

Описание

 

organizationId

1..1

string

При обращении клиента сервиса к СЗПВ необходимо передавать идентификатор МО из справочника с OID 1.2.643.2.69.1.1.1.64.
При передаче запроса от СЗПВ к поставщику данных (владельцу талонов) значение заменяется на идентификатор ЛПУ из справочника «ЛПУ» Интеграционной платформы

 

mkbCode

0..1

String

Код заболевания. Значение в соответствии с МКБ-10. OID справочника: 1.2.643.2.69.1.1.1.2

 

priority

0..1

String

Комментарий о приоритете и состоянии пациента.
Максимальная длина поля: 300 символов

 

privilegeType

0..1

String

Код льготы пациента. OID справочника: 1.2.643.2.69.1.1.1.7

 

profileMedService

1..1

String

Идентификатор составного профиля помощи. OID справочника: 1.2.643.2.69.1.1.1.56

 

reason

0..1

String

Основание направления, цель направления пациента.
Максимальная длина поля: 300 символов

 

sourceLPU

1..1

String

Идентификатор МО, направляющей пациента. OID справочника: 1.2.643.2.69.1.1.1.64

 

surveyOrgan

0..1

String

Идентификатор области исследования. OID справочника: 1.2.643.2.69.1.1.1.58

 

surveyType

0..1

String

Идентификатор вида исследования. OID справочника: 1.2.643.2.69.1.1.1.57

 

patient

0..1

 

Данные о пациенте

 

Patient.identifier

0..4

Identifier

Идентификатор пациента (идентификатор пациента в МИС МО, СНИЛС пациента, серия и номер полиса пациента, серия и номер документа, удостоверяющего личность пациента).
Идентификатор пациента в МИС МО обязателен для передачи

 

Patient.identifier.system

1..1

string

Пространство имён идентификатора.
Указывается код:

  • 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).
 

Patient.identifier.value

1..1

string

Значение для идентификатора или для документа.
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="b17a453a-5154-4982-8df1-40dc4870d973"><ac:plain-text-body><![CDATA[* для идентификатора в МИС указывается [идентификатор в МИС]
]]></ac:plain-text-body></ac:structured-macro>
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="f7e7020c-6630-4b61-8181-812b20dfaeb2"><ac:plain-text-body><![CDATA[* для ДУЛ и полисов указывается [Серия]:[Номер] или [Номер], если нет серии, номер - обязателен. В серии не должны использоваться разделители (пробелы, тире и т.д.), допускаются цифры и буквы русского и латинского алфавита. В номере не должны использоваться разделители (пробелы, тире и т.д.), допускаются только цифры.
]]></ac:plain-text-body></ac:structured-macro>
Максимальная длина поля: 300 символов

 

Patient.name

0..1

HumanName

ФИО пациента

 

Patient.name.family

0..1

string

Фамилия.
Максимальная длина поля: 300 символов

 

Patient.name.given

0..2

string

Имя, Отчество. Сначала указывается Имя.
Максимальная длина поля: 300 символов

 

Patient.telecom

0..*

ContactPoint

Контактные телефоны пациента

 

Patient.telecom.system

1..1

code

Передаётся значение «phone»

 

Patient.telecom.value

1..1

string

Номер телефона.
Максимальная длина поля: 300 символов

 

Patient.telecom.use

1..1

code

Передаётся одно из начений:

  • «home» - номер домашнего телефона;
  • «mobile» - номер мобильного телефона.
 

Patient.gender

0..1

code

Код пола пациента (справочник FHIR. OID: 1.2.643.2.69.1.1.1.40)

 

Patient.birthDate

0..1

date

Дата рождения пациента

 

Описание выходных данных

В ответе метода от целевой МО передается справочная информация о доступных медицинских ресурсов и талонов для записи на приём к врачу по направлению в формате Bundle типа collection. FHIR-ресурс Bundle используется для передачи набора ресурсов.
Все переданные ресурсы, кроме Patient, должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.
В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization), то данный ресурс должен присутствовать в передаваемом Bundle.
В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:

"fullUrl": "[Тип ресурса]/[id ресурса]"


например, "fullUrl": "Schedule/31f34a1f-2984-43cc-b2c1-33cd077370de".
Перечень ресурсов, передаваемых в рамках Bundle, и их описание представлено в Таблице 36.
Таблица 36 – Описание ресурсов, входящих в состав Bundle

 

№ п/п

Параметр

Ссылки на другие ресурсы

Описание

 

Patient

Ссылка на Organization (целевая МО)

В ресурсе указывается информация о пациенте (идентификатор пациента с МИС МО)

 

Schedule

Ссылка на PractitionerRole;
Ссылка на Location

В ресурсе указывается информация о расписании медицинского ресурса (в качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты).

В случае, если медицинский ресурс является медицинским работником, в рамках одного ресурса Schedule должна быть указана одна ссылка на ресурс PractitionerRole, а также могут быть указаны максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём, и максимум одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём. Количество ресурсов Schedule определяется количеством уникальных наборов PractitionerRole и максимум 2-х Location.

В случае, если медицинский ресурс является кабинетом, в рамках одного ресурса Schedule должна быть указана одна ссылка на ресурс Location с данными по описанию кабинета, где будет осуществляться приём, а также может быть указана максимум одна ссылка на ресурс Location с данными по адресу физического здания медицинской организации, где будет осуществляться приём. В рамках ресурса Schedule не должна передаваться ссылка на ресурс PractitionerRole.
Количество ресурсов Schedule определяется количеством уникальных наборов Location с данными по описанию кабинета и Location с данными по адресу физического здания.

 

PractitionerRole

Ссылка на Organization (целевая МО);
Ссылка на Practitioner

В ресурсе указывается информация о медицинском работнике в привязке к МО (данные о должности, специальности, комментарии с важной информацией для осуществления записи на прием)

 

Practitioner

 

В ресурсе указывается информация о медицинском работнике (ФИО, идентификатор в МИС МО и СНИЛС)

 

Location

Ссылка на Organization (целевая МО)

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и для передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В рамках передачи данных о расписании медицинского работника как медицинского ресурса, в ресурсах Location может передаваться информация о месте приема медицинского работника (адрес физического здания медицинской организации, где будет осуществляться приём, и описание кабинета, где будет осуществляться приём) – двумя отдельными ресурсами Location.
В рамках передачи данных о расписании кабинета как медицинского ресурса, в ресурсе Location передается информация с описанием данного кабинета (наименование кабинета, OID кабинета в соответствии со справочником ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 и прочее), а также в отдельном ресурсе Location может передаваться информация об адресе физического здания медицинской организации, где будет осуществляться приём.

 

Slot

Ссылка на Schedule

В ресурсе указывается информация о талоне (свободном временном интервале) для оформления записи по направлению

 

Parameters

Ссылка на Schedule

Ресурс предназначен для описания причины при отсутствии расписания


Схема структуры Bundle приведена на Рисунке 16.

Рисунок 17. Структура ответа метода $getreferenceinfo
Описание ресурсов, входящих в состав Bundle

Patient

Ресурс Patient предназначен для передачи данных о пациенте.
В Таблице 37 представлено описание параметров ресурса Patient. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 37 - Параметры ресурса Patient

№ п/п

Параметр

Кратность

Тип

Описание

 

id

0..1

id

Идентификатор ресурса Patient.
Передаётся в формате guid

 

identifier

0..1

Identifier

Идентификатор пациента в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора пациента в МИС МО.
Максимальная длина поля: 300 символов

 

managingOrganization

0..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)


Пример фрагмента Bundle по ресурсу Patient приведен в разделе 4.7.4.

Schedule

Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.
В Таблице 38 представлено описание параметров ресурса Schedule. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 38 - Параметры ресурса Schedule

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Schedule.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор расписания медицинского ресурса в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора расписания медицинского ресурса в МИС МО.
Передаётся в формате guid

 

actor

1..3

Reference

Ссылки на ресурсы, которые являются частью данного расписания (PractitionerRole, Location)

 

comment

 

 

Код причины отсутствия свободных талонов в запрашиваемом периоде. Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.222 «Причины отсутствия талонов». Должен передаваться, если отсутствуют свободные слоты за все дни из запрашиваемого диапаз талонов в запрашиваемом периоде.
Должен передаваться, если отсутствуют свободные слоты за все дни из запрашиваемого диапазона времени (в ответе метода не передан как минимум один слот со ссылкой на данный ресурс Schedule)


Пример фрагмента Bundle по ресурсу Schedule приведен в разделе 4.7.4.

PractitionerRole

Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.
В Таблице 39 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 39 - Параметры ресурса PractitionerRole

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса PractitionerRole.
Передаётся в формате guid

 

extention

1..1

code

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.1

extention.url

1..1

uri

Передаётся значение «

https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group

»

2.2

extention.valueCodeableConcept

 

 

 

2.3

extention.valueCodeableConcept.coding

1..3

Coding

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив)

2.4

extention.valueCodeableConcept.coding. system

1..1

code

Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)

2.5

extention.valueCodeableConcept.coding. code

1..1

code

Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.223 «Возрастные категории граждан».
В случае, если передаётся значение «4» - другие категории в массиве передавать нельзя

 

identifier

1..1

Identifier

Идентификатор ресурса PractitionerRole в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса PractitionerRole в МИС МО.
Максимальная длина поля: 200 символов

 

practitioner

1..1

Reference(Practitioner)

Ссылка на медицинского работника (ресурс Practitioner)

 

organization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)

 

code

1..1

CodeableConcept

Информация о должности медицинского работника

 

code.coding

3..3

Coding

Информация о должности медицинского работника

 

code.coding.system

1..1

uri

Значение OID справочника, по которому передаётся информация о должности медицинского работника:

  • «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) В рамках контейнера 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)).
 

code.coding.code

1..1

code

Идентификатор должности из справочника, по которому передаётся информация о должности медицинского работника.
Максимальная длина поля: 300 символов

 

code.coding.display

1..1

string

Наименование врачебной должности из справочника врачебных должностей целевой МИС МО.
Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5
Максимальная длина поля: 300 символов

 

specialty

1..1

CodeableConcept

Информация о специальности медицинского работника

 

specialty.coding

2..2

Coding

Информация о специальности медицинского работника

 

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) В рамках контейнера 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)).
 

specialty.coding.code

1..1

code

Идентификатор специальности из справочника, по которому передаётся информация о специальности медицинского работника.
Максимальная длина поля: 300 символов

 

specialty.coding.display

1..1

string

Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО.
Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5
Максимальная длина поля: 300 символов

 

specialty.text

0..1

string

Комментарий (указывается важная информация для осуществления записи на прием к врачам данной специальности).
Максимальная длина поля: 300 символов

 

availabilityExceptions

0..1

string

Комментарий (указывается важная информация для осуществления записи на прием к данному врачу).
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу PractitionerRole приведен в разделе 4.7.4.

Practitioner

Ресурс Practitioner предназначен для передачи данных о медицинском работнике.
В Таблице 40 представлено описание параметров ресурса Practitioner. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 40 - Параметры ресурса Practitioner

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Practitioner.
Передаётся в формате guid

 

identifier

2..2

Identifier

Идентификатор медицинского работника (идентификатор в МИС МО, СНИЛС)

 

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)
 

identifier.value

1..1

string

Значение для идентификатора или для СНИЛСа.
Максимальная длина поля: 300 символов

 

name

1..1

HumanName

ФИО медицинского работника

 

name.family

1..1

string

Фамилия.
Максимальная длина поля: 300 символов

 

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.
Максимальная длина поля: 300 символов



Пример фрагмента Bundle по ресурсу Practitioner приведен в разделе 4.7.4.

Location

Ресурс Location предназначен для передачи данных об адресе физического здания медицинской организации, где будет осуществляться приём и передачи данных о кабинете МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника).
В Таблице 41 представлено описание параметров ресурса Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 41 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Location.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор ресурса Location в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора ресурса Location в МИС МО

 

address

1..1

Address

Информация об адресе физического здания медицинской организации, где будет осуществляться врачебный приём

 

address.text

1..1

string

Адрес физического здания медицинской организации, где будет осуществляться врачебный приём. Указывается строкой.
Максимальная длина поля: 300 символов

 

physicalType

1..1

CodeableConcept

Тип ресурса Location

 

coding.system

1..1

uri

Указывается значение «

http://terminology.hl7.org/CodeSystem/location-physical-type

»

 

coding.code

1..1

code

Указывается значение «bu» (обозначение того, что данный ресурс Location - физическое здание МО)

 

coding.display

1..1

string

Указывается значение «Building»

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)



Пример фрагмента Bundle по ресурсу Location для передачи данных об адрес физического здания медицинской организации, где будет осуществляться врачебный приём, приведен в разделе 4.7.4.
В Таблице 42 представлено описание параметров ресурса Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника). Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 42 - Параметры ресурса Location (описание кабинета МО)

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Location.
Передаётся в формате guid

 

extention

1..1

code

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу

2.1

extention.url

1..1

uri

Передаётся значение «

https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group

»

2.2

extention.valueCodeableConcept

 

 

 

2.2.1

extention.valueCodeableConcept.coding

1..3

Coding

Возрастная категория граждан, запись на прием которым доступна в МО к данному медицинскому ресурсу (массив)

2.2.1.1

extention.valueCodeableConcept.coding. system

1..1

code

Передается значение «urn:oid:1.2.643.2.69.1.1.1.223» (OID справочника «Возрастные категории граждан»)

 

identifier

2..2

Identifier

Идентификатор ресурса Location в МИС МО и OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115
OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115 заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе

 

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)
 

identifier.value

1..1

string

Значение для идентификатора ресурса Location в МИС МО или для OID кабинета из справочника ФНСИ «ФРМО. Справочник отделений и кабинетов» 1.2.643.5.1.13.13.99.2.115
Максимальная длина поля: 300 символов

 

name

1..1

string

Наименование кабинета.
Например: «Кабинет №5».
Максимальная длина поля: 300 символов

 

physicalType

1..1

CodeableConcept

Тип ресурса Location

 

coding.system

1..1

uri

Указывается значение «

http://terminology.hl7.org/CodeSystem/location-physical-type

»

 

coding.code

1..1

code

Указывается значение «ro».
Обозначение того, что данный ресурс Location – кабинет (комната)

 

coding.display

1..1

string

Указывается значение «Room»

 

managingOrganization

1..1

Reference(Organization)

Ссылка на МО (идентификатор МО из справочника «ЛПУ» Интеграционной платформы)

 

partOf

0..1

Reference(Location)

Ссылка на ресурс Location, частью которого является данный ресурс (в нашем случае - кабинет является частью физического здания)


Примеры фрагмента Bundle по ресурсу Location для передачи данных с описанием кабинета МО (как о самостоятельном медицинском ресурсе, талон в расписании которого необходимо занять для получения медицинской услуги, или как о месте приема конкретного медицинского работника) приведены в разделе 4.7.4.

Slot

Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи по направлению.
В Таблице 43 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 43 - Параметры ресурса Slot

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Slot.
Передаётся в формате guid

 

identifier

1..1

Identifier

Идентификатор талона в МИС МО

 

identifier.system

1..1

uri

Пространство имён идентификатора.
Указывается код «1.2.643.5.1.13.2.7.100.5» (код для идентификатора в МИС)

 

identifier.value

1..1

string

Значение идентификатора талона в МИС МО.
Максимальная длина поля: 300 символов

 

schedule

1..1

Reference(Schedule)

Ссылка на ресурс Schedule (расписание)

 

status

1..1

code

Указывается значение «free»

 

start

1..1

instant

Дата и время начала приема

 

end

1..1

instant

Дата и время окончания приема

 

comment

0..1

string

Номер талона в очереди.
Максимальная длина поля: 300 символов


Пример фрагмента Bundle по ресурсу Slot приведен в разделе 4.7.4.

Parameters

Ресурс Parameters предназначен для описания причины отсутствия расписания (в отдельных параметрах по требованиям КУ ФЭР стр.137 v3.1.0).
В Таблица 45 представлено описание параметров ресурса Parameters. Параметры, которые не используются в информационном обмене, в таблице не указаны.
Таблица 45 - Параметры ресурса Parameters

№ п/п

Параметр

Кратность

Тип

Описание

 

id

1..1

id

Идентификатор ресурса Parameters.
Передаётся в формате guid

 

parameter

0..*

Identifier

Параметры МО

 

Parameter.MO_name

1..1

string

Название МО

 

Parameter.MO_Address

1..1

string

Адресс МО

 

Parameter.MO_Phone

1..1

string

Номер телефона МО

 

referenceSchedule

0..1

Reference(Schedule)

Ссылка на ресурс Schedule (расписание)


Пример фрагмента Bundle по ресурсу Parameters приведен в разделе 4.7.4.
 

Приложение 1. Справочник ошибок

 

Идентификатор ошибки

Текст ошибки

1

Не был указан/указан неверно guid при вызове метода

2

Отсутствует доступ или не найдена конечная точка

3

Время ожидания истекло

4

Получен не полный набор данных для выполнения метода

5

На стороне сервиса МИС метод не поддержан

6

Техническая ошибка на стороне МИС

7

Техническая ошибка. Медицинская система учреждения не поддержала данную функциональность.

8

Нет связи с сервисом "Управление очередями"

9

Не удалось определить ЛПУ для обращения за талонами

10

Учреждение с данным идентификатором отсутствует в справочнике

11

Отсутствуют данные целевой МО

12

Ошибка в сервисе УО

13

Недействительное значение параметра

14

Неверный формат входящего параметра

15

Внутренняя ошибка сервиса

16

МИС медицинской организации передала некорректные данные

20

Пациент с заданными параметрами не найден

21

Данные пациента не являются уникальными

22

Несоответствие записи акта гражданского состояния

23

МИС не вернула идентификатор пациента

30

Запись запрещена

31

Расхождения в данных прикрепления пациента

32

Несоответствие сроков действия полиса ОМС

33

Специальность врача не соответствует профилю пациента

34

Нарушение порядка и периодичности записи

35

Пациент имеет предстоящую запись к данному врачу/врачу этой специальности

36

Пациент не имеет прикрепления к данному учреждению или участку

37

Указан недопустимый идентификатор пациента

38

Указан недопустимый идентификатор талона на запись

39

Талон к врачу занят/заблокирован

40

Пациент уже имеет запись на это время к другому врачу

41

Отсутствует информация о врачебных участках по пациенту

42

Указан некорректный идентификатор медицинского осмотра

43

Указан некорректный идентификатор медицинской услуги

44

Указан некорректный идентификатор медицинского ресурса

45

Не найдено расписание медицинского ресурса

46

Отмена записи невозможна, медицинская услуга уже оказана

47

Отмена записи невозможна, медицинская услуга обязательна

48

Указан некорректный идентификатор сессии

49

Статус заявки не изменен. Статус заявки может быть изменен согласно правилам статусной модели

50

Значение PARequestPatientContacts.Phone не может быть пустым

51

Значение PARequestPatientContacts.Phone имеет неверный формат

52

Значение PARequestPatientContacts.Email имеет неверный формат

53

Значение PASource должно соответствовать одному из значений справочника "Источник записи"

60

Указан недопустимый идентификатор врача

61

Указаны недопустимые интервалы времени

62

Дата осуществления записи на прием должна быть меньше или равна дате начала приема (NoticeAppointment)

63

Дата начала приема должна быть больше или равна дате отправки запроса (Appointment)

64

Дата и время начала приема должна быть меньше или равна дате и времени окончания приема

65

Дата осуществления записи на прием должна быть меньше или равна дате отправки запроса (NoticeAppointment)

66

Дата и время изменения статуса записи на прием должна быть больше или равна дате и времени осуществления записи на прием

67

Дата и время изменения статуса записи на прием должна быть меньше или равна дате и времени отправки запроса

70

Указан недопустимый идентификатор специальности

71

В запросе запрещено одновременное заполнение параметров: идентификатора специальности и федерального идентификатора специальности

72

Нет доступного врача для вызова врача на дом

73

Нет доступных слотов для вызова врача на дом

75

Талон с указанным номером не существует или уже отменен

76

Направление не найдено по параметрам поиска

77

Направление найдено, но не прошло проверку на актуальность

80

Нет прикрепления к ЛПУ

90

Сведения о записи не найдены

91

Неизвестный источник записи

92

Заявка {idPar} не найдена среди активных заявок

94

Неизвестный статус записи

99

Текст ответа МИС – в случае необходимости передачи определенной информации клиенту сервиса, инициирующему запрос метода

101

Техническая ошибка на стороне Fer