Запись на вакцинацию

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

Описание решения

Обновленный Сервис записи на приём к врачу (версия 3.0) предназначен для предоставления услуг записи посредством информационного взаимодействия ИС через API Интеграционной платформы.

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

Участниками процесса в рамках услуги «Запись на вакцинацию» являются:

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

 

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

Описание методов в рамках услуги «Запись на вакцинацию» приведено в разделе 4.

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

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

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

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

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

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

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

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

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

Справочники, используемые в СЗПВ, опубликованы в «Сервисе Терминологии». Описание сервиса Терминологии и правила взаимодействия с ним приведены по ссылке: http://api.netrika.ru/docs.php?article=Terminology.

Для каждого справочника в Настоящем документе указан его OID (объектный идентификатор). Перечень присвоенных корневых OID:

1.2.643.5.1.13.2.1 - Корневой OID справочников, размещённых в Федеральном реестре НСИ (http://nsi.rosminzdrav.ru/);

1.2.643.2.69.1.1.1 – Корневой OID для справочников подсистемы НСИ Регионального фрагмента.

Передача параметров, использующих значения справочников, не указанных в стандарте FHIR, осуществляется в следующей структуре:

 "coding": [   {       "system": "urn:oid:[OID справочника в сервисе Терминологии]",       "code": "[код значения]"   }]

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

Справочники, используемые в рамках услуги «Запись на вакцинацию»:

  1. Справочник «ЛПУ» Интеграционной платформы
  2. «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066)
  3. «Справочник МО региона» (OID 1.2.643.2.69.1.1.1.64)
  4. «Классификатор половой принадлежности» (OID 1.2.643.5.1.13.2.1.1.156)
  5. Справочник «Роль пользователя»
  6. Справочник «Источники записи» (OID 1.2.643.2.69.1.1.1.115)
  7. «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102)
  8. Справочник «Статус записи на прием»
  9. Справочник типа ресурса Location http://terminology.hl7.org/CodeSystem/location-physical-type
  10. Справочник «Тип документа» (OID 1.2.643.2.69.1.1.1.6)
  11. «ФРМО. Справочник отделений и кабинетов» (OID2.643.5.1.13.13.99.2.115)
  12. Справочник причин приёма https://terminology.hl7.org/1.0.0/CodeSystem-v2-0276.html
  13. «ФРМО. Типы врачебных участков» (OID 2.643.5.1.13.13.99.2.639)
  14. Справочник «Возрастная категория граждан» (OID2.643.2.69.1.1.1.223)
  15. Справочник «Причины отсутствия талонов» (OID 1.2.643.2.69.1.1.1.222)
  16. Справочник ошибок

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

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

Данный идентификатор требуется передавать в Header запроса метода сервиса записи на прием в следующем формате:

Processid: YourProcessId

Примеры use case'ов, обеспечиваемых СЗПВ (v 3.0 - FHIR):

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

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

При получении запроса метода с идентификатором процесса сервис записи на прием определяет с помощью СВИП актуальность указанного идентификатора процесса. В случае, если идентификатор процесса просрочен или был передан некорректно, СЗПВ сгенерирует своё значение, которое будет передано в сервис сбора и хранения информации в качестве идентификатора процесса, цепочка при этом разорвётся. 

Описание методов СВИП:

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

Адрес: /api/token

HTTP-метод: GET

Данный метод используется для получения клиентом сервиса записи на прием идентификатора процесса.

В запросе метода отсутствуют входные параметры.

Формат ответа метода:

{

  "success": true,

  "resultcode": 0,

  "message": null,

  "content": "YourProcessId"

}

, где наполнение параметра content – идентификатор процесса.

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

Адрес: /api/session?token=

HTTP-метод: GET

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

В запросе метода указывается идентификатор процесса в формате [base]/api/session?token=[YourProcessId]

Формат ответа метода:

{

  "success": true,

  "resultcode": 0,

  "message": null,

  "content": {

    "token": "YourProcessId",

    "startDate": "2019-11-11T11:16:32.2089653Z",

    "endDate": "2019-11-11T11:36:32.2089672Z"

  }

}

, где

наполнение параметра token – идентификатор процесса,

наполнение параметра startDate - дата начала действия идентификатора процесса,

наполнение параметра endDate - дата истечения срока действия идентификатора процесса.

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

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

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

Данный метод используется для поиска в целевой МО доступных медицинских ресурсов для записи на вакцинацию. В качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты.

Для вызова метода необходимо указывать URL в формате [base]/api/appointment/vaccination/fhir/$searchmedicalresources.

Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html

На Рисунке 2 представлена схема информационного взаимодействия в рамках метода «Поиск доступных медицинских ресурсов для записи на вакцинацию ($searchmedicalresources)».

Рисунок 2. Схема информационного взаимодействия в рамках метода «Поиск доступных медицинских ресурсов для записи на вакцинацию ($searchmedicalresources)»

Описание схемы:

  • Клиент СЗПВ отправляет запрос метода «Поиск доступных медицинских ресурсов для записи на вакцинацию ($searchmedicalresources)» в СЗПВ. Состав параметров запроса представлен в Таблице 1.
  • СЗПВ отправляет запрос метода «Поиск доступных медицинских ресурсов для записи на вакцинацию ($searchmedicalresources)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 1.
  • Целевое ЛПУ передает ответ метода «Поиск доступных медицинских ресурсов для записи на вакцинацию ($searchmedicalresources)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.2.2.

СЗПВ передает ответ метода «Поиск доступных медицинских ресурсов для записи на вакцинацию ($searchmedicalresources)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.2.2.

 

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

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

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

№ п/п

Параметр

Кратность

Тип

Описание

1.       

organizationId

1..1

string

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

2.       

infectionId

1..1

CodeableConcept

Массив кодов инфекций, по которым необходимо провести вакцинацию (по справочнику «Код инфекции» OID 1.2.643.2.69.1.1.1.130).

Допустима передача более одного кода инфекций в рамках infectionId для комбинаций значений:

·         «3», «5»

·         «3», «4», «5»

В остальных случаях в рамках infectionId должен передаваться только один код инфекции.

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

2.1.     

infectionId.valueCodeableConcept.coding

1..3

Coding

 

2.1.1.    

infectionId.valueCodeableConcept.coding.system

1..1

uri

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

2.1.2.   

infectionId.valueCodeableConcept.coding.code

1..1

code

Передаётся код из справочника «Код инфекций» (OID 1.2.643.2.69.1.1.1.130)

3.       

patientId

1..1

string

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

4.       

startDateTimeRange

1..1

Datetime

Дата начала периода предоставления информации о наличии/отсутствии свободных слотов

5.       

endDateTimeRange

 

1..1

Datetime

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

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

В ответе метода от целевой МО передается информация о доступных медицинских ресурсах для записи на вакцинацию в формате Bundle типа collection. FHIR-ресурс Bundle используется для передачи набора ресурсов.

Все переданные ресурсы должны быть связаны либо с ресурсом Schedule, либо с ресурсом, связанным с ресурсом Schedule. Под ресурсом, связанным с ресурсом Schedule, подразумеваются ресурсы, которые либо имеют ссылку на ресурс Schedule, либо в ресурсе Schedule имеется ссылка на передаваемый ресурс.

В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization), то данный ресурс должен присутствовать в передаваемом Bundle.

В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:

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

например, "fullUrl": "PractitionerRole/31f34a1f-2984-43cc-b2c1-33cd077370de".

Перечень ресурсов, передаваемых в рамках Bundle, и их описание представлено в Таблице 2.

Таблица 2 – Описание ресурсов, входящих в состав Bundle

№ п/п

Параметр

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

Описание

1.           

Schedule

Ссылка на PractitionerRole;

Ссылка на Location

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

 

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

 

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

Количество ресурсов Schedule определяется количеством уникальных наборов Location с данными по описанию кабинета и Location с данными по адресу физического здания.

2.           

PractitionerRole

Ссылка на Organization;

Ссылка на Practitioner

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

3.           

Practitioner

 

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

4.           

Location

Ссылка на Organization

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

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

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

5.           

Slot

Ссылка на Schedule

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

В рамках метода «Поиск доступных медицинских ресурсов для записи на вакцинацию ($searchmedicalresources)» передается первый ближайший талон по каждой доступной для записи дате по медицинскому ресурсу в запрашиваемый период.

6.           

Parameters

Ссылка на Schedule

В ресурсе указывается информация с текстовым описанием причины отсутствия свободных талонов у медицинского ресурса (передается в случае, если параметр comment в ресурсе Schedule заполнен и его значение не «3» или «7»)

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

Рисунок 3. Структура Bundle

 

Структура ответа метода $searchmedicalresources представлена на Рисунке 4.

Рисунок 4. Структура ответа метода $searchmedicalresources

Ресурс  Schedule

Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.

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

Таблица 3 - Параметры ресурса Schedule

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Schedule.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.     

identifier.value

1..1

string

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

Передаётся в формате guid

3.       

serviceCategory

1..1

CodeableConcept

Код услуги из справочника «Номенклатура медицинских услуг» (OID 1.2.643.5.1.13.13.11.1070)

3.1.     

serviceCategory.valueCodeableConcept.coding

1..1

Coding

 

3.2.     

serviceCategory.valueCodeableConcept.coding.system

1..1

uri

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

3.3.     

serviceCategory.valueCodeableConcept.coding.code

1..1

code

Передаётся код услуги из справочника «Номенклатура медицинских услуг» (OID 1.2.643.5.1.13.13.11.1070): «B04.014.004»

4.       

serviceType

1..1

CodeableConcept

Массив кодов инфекций, по которым необходимо провести вакцинацию (по справочнику «Код инфекции» OID 1.2.643.2.69.1.1.1.130).

Допустима передача более одного кода инфекций в рамках infectionId для комбинаций значений:

·         «3», «5»

·         «3», «4», «5»

В остальных случаях в рамках infectionId должен передаваться только один код инфекции.

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

4.1.     

serviceType.valueCodeableConcept.coding

1..3

Coding

 

4.1.1.    

serviceType.valueCodeableConcept.coding.system

1..1

uri

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

4.1.2.   

serviceType.valueCodeableConcept.coding.code

1..1

code

Передаётся код из справочника «Код инфекций» (OID 1.2.643.2.69.1.1.1.130)

5.       

actor

1..3

Reference

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

6.       

comment

0..1

string

Код причины отсутствия свободных талонов в запрашиваемом периоде.

Должно соответствовать коду из справочника OID 1.2.643.2.69.1.1.1.222 «Причины отсутствия талонов».

Должен отсутствовать, если в ответе метода передан как минимум один слот со ссылкой на данный ресурс Schedule.

Должен передаваться, если отсутствуют свободные слоты за все дни из запрашиваемого диапазона времени (в ответе метода не передан как минимум один слот со ссылкой на данный ресурс Schedule)

Ресурс PractitionerRole

Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.

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

Таблица 4 - Параметры ресурса PractitionerRole

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса PractitionerRole.

Передаётся в формате guid

2.       

extension

1..1

code

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

2.1.     

extension.url

1..1

uri

Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group»

2.2.     

extension.valueCodeableConcept.coding

1..3

Coding

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

2.2.1.    

extension.valueCodeableConcept.coding.system

1..1

code

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

 

2.2.2.    

extension.valueCodeableConcept.coding.code

1..1

code

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

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

3.       

identifier

1..1

Identifier

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

3.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

3.2.     

identifier.value

1..1

string

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

Максимальная длина поля: 200 символов

4.       

practitioner

1..1

Reference(Practitioner)

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

5.       

organization

1..1

Reference(Organization)

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

6.       

code

1..1

CodeableConcept

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

6.1.     

code.coding

3..3

Coding

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

6.1.1.    

code.coding.system

1..1

uri

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

·         «1.2.643.5.1.13.13.11.1102» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) - должность, по которой трудоустроен медицинский работник в данной МО

·         «1.2.643.5.1.13.13.11.1102.2» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) – код должности, расположенной в папках «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи) » -> «врачи-специалисты»

и

«Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов со средним профессиональным (медицинским) образованием (средний медицинский персонал)»

·         «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных должностей целевой МИС МО

·         «1.2.643.2.69.1.1.1.219» - для регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219)[1]

6.1.2.   

code.coding.code

1..1

code

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

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

6.1.3.   

code.coding.display

1..1

string

Наименование врачебной должности из справочника врачебных должностей целевой МИС МО.

Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5

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

7.       

specialty

1..1

CodeableConcept

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

7.1.     

specialty.coding

2..2

Coding

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

7.1.1.    

specialty.coding.system

1..1

uri

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

·         «1.2.643.5.1.13.13.11.1066» - для справочника «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066);

·         «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных специальностей целевой МИС МО

·         «1.2.643.2.69.1.1.1.220» - для регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220)[2]

7.1.2.   

specialty.coding.code

1..1

code

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

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

7.1.3.   

specialty.coding.display

1..1

string

Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО.

Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5

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

7.2.     

specialty.text

0..1

string

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

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

8.       

availabilityExceptions

0..1

string

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

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

 

[1] В рамках контейнера code.coding ресурса PractitionerRole передача значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник должностей или региональный справочник должностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) в рамках оформления записи на вакцинацию и передавать в рамках контейнера code.coding значение должности из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).

Одновременное указание значений из регионального справочника должностей и справочника должностей целевой МИС МО не допускается (в рамках контейнера code.coding ресурса PractitionerRole в дополнении к значениям по OID «1.2.643.5.1.13.13.11.1102» и «1.2.643.5.1.13.13.11.1102.2»  может передаваться либо значение из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219), либо значение из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).

[2] В рамках контейнера specialty.coding ресурса PractitionerRole передача значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник специальностей или региональный справочник специальностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) в рамках оформления записи на вакцинацию и передавать в рамках контейнера specialty.coding значение специальности из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).

Одновременное указание значений из регионального справочника специальностей и справочника специальностей целевой МИС МО не допускается (в рамках контейнера specialty.coding ресурса PractitionerRole в дополнении к значению по OID «1.2.643.5.1.13.13.11.1066» может передаваться либо значение из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220), либо значение из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).

Ресурс Practitioner

Ресурс Practitioner предназначен для передачи данных о медицинском работнике.

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

Таблица 5 - Параметры ресурса Practitioner

№ п/п

Параметр

Кратность

Тип

Описание

1.       

identifier

2..2

Identifier

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

1.1.                    

identifier.system

1..1

uri

Пространство имён идентификатора.

Указывается код:

·         OID для идентификатора в МИС/ЛИС (1.2.643.5.1.13.2.7.100.5)

·         OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223)

1.2.                    

identifier.value

1..1

string

Значение для идентификатора или для СНИЛСа.

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

2.       

name

1..1

HumanName

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

2.1.     

name.family

1..1

string

Фамилия.

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

2.2.     

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.

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

Ресурс Location

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

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

Таблица 6 - Параметры ресурса Location (адрес физического здания медицинской организации, где будет осуществляться приём)

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Location.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.                    

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.                    

identifier.value

1..1

string

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

3.       

address

1..1

Address

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

3.1.     

address.text

1..1

string

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

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

4.       

physicalType

1..1

CodeableConcept

Тип ресурса Location

4.1.     

coding.system

1..1

uri

Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type»

4.2.     

coding.code

1..1

code

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

4.3.     

coding.display

1..1

string

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

5.       

managingOrganization

1..1

Reference(Organization)

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

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

Таблица 7 - Параметры ресурса Location (описание кабинета МО)

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Location.

Передаётся в формате guid

2.       

extension

1..1

code

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

Заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе

2.1.     

extension.url

1..1

uri

Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group»

2.2.     

extension.valueCodeableConcept.coding

1..3

Coding

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

2.2.1.    

extension.valueCodeableConcept.coding.system

1..1

code

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

 

2.2.2.    

extension.valueCodeableConcept.coding.code

1..1

code

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

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

3.       

identifier

2..2

Identifier

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

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

4.       

identifier.system

1..1

uri

Пространство имён идентификатора.

Указывается код:

·         OID для идентификатора в МИС МО (1.2.643.5.1.13.2.7.100.5)

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

5.       

identifier.value

1..1

string

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

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

6.       

name

1..1

string

Наименование кабинета.

Например: «Кабинет №5».

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

7.       

physicalType

1..1

CodeableConcept

Тип ресурса Location

7.1.     

coding.system

1..1

uri

Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type»

7.2.     

coding.code

1..1

code

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

Обозначение того, что данный ресурс Location – кабинет (комната)

7.3.     

coding.display

1..1

string

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

8.       

managingOrganization

1..1

Reference(Organization)

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

9.       

partOf

0..1

Reference(Location)

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

Ресурс Slot

Ресурс Slot предназначен для передачи данных о талоне (свободном временном интервале) для оформления записи на вакцинацию. В рамках метода «Поиск доступных медицинских ресурсов для записи на вакцинацию ($searchmedicalresources)» передается первый ближайший талон по каждой доступной для записи дате по медицинскому ресурсу в запрашиваемый период.

В Таблице 8 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 8 - Параметры ресурса Slot

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Slot.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.     

identifier.value

1..1

string

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

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

3.       

schedule

1..1

Reference(Schedule)

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

4.       

status

1..1

code

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

5.       

start

1..1

instant

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

6.       

end

1..1

instant

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

7.       

comment

0..1

string

Номер талона в очереди.

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

Ресурс Parameters

Ресурс Parameters предназначен для передачи информации с текстовым описанием причины отсутствия свободных талонов у медицинского ресурса (передается в случае, если параметр comment в ресурсе Schedule заполнен и его значение не «3» или «7»).

В Таблице 9 представлено описание параметров ресурса Parameters. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 9 - Параметры ресурса Parameters

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Parameters.

Передаётся в формате guid

2.       

Parameter.name

1..5

string

Для кода причины «1» и «2» должен быть передан параметр:

«Available_date» – Дата, когда появится запись к медицинскому ресурсу

Для кода причины «4» передаются следующие параметры:

«MO_Name» – Наименование структурного подразделения МО

«MO_Address» – Адрес структурного подразделения МО

«MO_Phone» — Телефон регистратуры структурного подразделения МО

Для кода причины «5» передаются следующие параметры:

«MO_Name» – Наименование структурного подразделения МО «MO_Address» – Адрес структурного подразделения МО

«Specialist_Name» – ФИО медицинского специалиста

«Specialist_Post» – Должность медицинского специалиста

«Room» – Кабинет, куда необходимо обратиться

Для кода причины «6» передаются следующие параметры:

«Visit_Info» – Информация о днях приема без предварительной записи

3.       

Parameter.valueString

1..5

string

Значение параметра

4.       

Parameter.name

1..1

string

Передаётся «referenceSchedule»

5.       

Parameter.valueReference

1..1

Reference(Schedule)

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

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

Данный метод используется для поиска в целевой МО доступных талонов по медицинскому ресурсу для записи на вакцинацию. В качестве медицинских ресурсов могут выступать как медицинские работники, так и кабинеты.

Для вызова метода необходимо указывать URL в формате [base]/api/appointment/vaccination/fhir/$searchslots.

Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html

На Рисунке 5 представлена схема информационного взаимодействия в рамках метода «Поиск доступных талонов для записи на вакцинацию ($searchslots)».

Рисунок 5. Схема информационного взаимодействия в рамках метода «Поиск доступных талонов для записи на вакцинацию ($searchslots)»

Описание схемы:

  • Клиент СЗПВ отправляет запрос метода «Поиск доступных талонов для записи на вакцинацию ($searchslots)» в СЗПВ. Состав параметров запроса представлен в Таблице 10.
  • СЗПВ отправляет запрос метода «Поиск доступных талонов для записи на вакцинацию ($searchslots)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 10.
  • Целевое ЛПУ передает ответ метода «Поиск доступных талонов для записи на вакцинацию ($searchslots)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.3.2.

СЗПВ передает ответ метода «Поиск доступных талонов для записи на вакцинацию ($searchslots)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.3.2.

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

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

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

№ п/п

Параметр

Кратность

Тип

Описание

1.       

organizationId

1..1

string

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

2.       

infectionId

1..1

CodeableConcept

Массив кодов инфекций, по которым необходимо провести вакцинацию (по справочнику «Код инфекции» OID 1.2.643.2.69.1.1.1.130).

Допустима передача более одного кода инфекций в рамках infectionId для комбинаций значений:

·         «3», «5»

·         «3», «4», «5»

В остальных случаях в рамках infectionId должен передаваться только один код инфекции.

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

2.1.     

infectionId.valueCodeableConcept.coding

1..3

Coding

 

2.1.1.    

infectionId.valueCodeableConcept.coding.system

1..1

uri

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

2.1.2.   

infectionId.valueCodeableConcept.coding.code

1..1

code

Передаётся код из справочника «Код инфекций» (OID 1.2.643.2.69.1.1.1.130)

3.       

patientId

1..1

string

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

4.       

scheduleId

1..1

string

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

5.       

startDateTimeRange

1..1

Datetime

Дата и время начала периода предоставления информации о наличии/отсутствии свободных слотов

6.       

endDateTimeRange

1..1

Datetime

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

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

В ответе метода от целевой МО передается информация о доступных талонах по медицинскому ресурсу для записи на вакцинацию в формате Bundle типа collection. FHIR-ресурс Bundle используется для передачи набора ресурсов.

В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:

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

например, "fullUrl": "PractitionerRole/31f34a1f-2984-43cc-b2c1-33cd077370de".

Перечень ресурсов, передаваемых в рамках Bundle, и их описание представлено в Таблице 11.

Таблица 11 – Описание ресурсов, входящих в состав Bundle

№ п/п

Параметр

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

Описание

1.       

Slot

Ссылка на Schedule

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

Структура ответа метода $searchslots представлена на Рисунке 6.

Рисунок 6. Структура ответа метода $searchslots

Ресурс Slot

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

В Таблице 12 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 12 - Параметры ресурса Slot

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Slot.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.     

identifier.value

1..1

string

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

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

3.       

schedule

1..1

Reference(Schedule)

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

4.       

status

1..1

code

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

5.       

start

1..1

instant

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

6.       

end

1..1

instant

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

7.       

comment

0..1

string

Номер талона в очереди.

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

 

Осуществление записи на вакцинацию ($setappointment)

Данный метод используется для осуществления в целевой МО записи на вакцинацию.

Для вызова метода необходимо указывать URL в формате [base]/api/appointment/vaccination/fhir/$setappointment.

Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html

На Рисунке 7 представлена схема информационного взаимодействия в рамках метода «Осуществление записи на вакцинацию ($setappointment)».

Рисунок 7. Схема информационного взаимодействия в рамках метода «Осуществление записи на вакцинацию ($setappointment)»

 

Описание схемы:

  • Клиент СЗПВ отправляет запрос метода «Осуществление записи на вакцинацию ($setappointment)» в СЗПВ. Состав параметров запроса представлен в Таблице 13.
  • СЗПВ отправляет запрос метода «Осуществление записи на вакцинацию ($setappointment)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 13.
  • Целевое ЛПУ передает ответ метода «Осуществление записи на вакцинацию ($setappointment)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.4.2.
  • СЗПВ передает ответ метода «Осуществление записи на вакцинацию ($setappointment)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.4.2.

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

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

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

№ п/п

Параметр

Кратность

Тип

Описание

1.       

organizationId

1..1

string

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

2.       

infectionId

1..1

CodeableConcept

Массив кодов инфекций, по которым необходимо провести вакцинацию (по справочнику «Код инфекции» OID 1.2.643.2.69.1.1.1.130).

Допустима передача более одного кода инфекций в рамках infectionId для комбинаций значений:

·         «3», «5»

·         «3», «4», «5»

В остальных случаях в рамках infectionId должен передаваться только один код инфекции.

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

2.1.     

infectionId.valueCodeableConcept.coding

1..3

Coding

 

2.1.1.    

infectionId.valueCodeableConcept.coding.system

1..1

uri

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

2.1.2.   

infectionId.valueCodeableConcept.coding.code

1..1

code

Передаётся код из справочника «Код инфекций» (OID 1.2.643.2.69.1.1.1.130)

3.       

patientId

1..1

string

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

4.       

slotId

1..1

string

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

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

В ответе метода от целевой МО передается информация об успешной или неуспешной операции оформления записи на вакцинацию.

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

В случае неуспешной операции по оформлению записи на вакцинацию, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.4.4).

 

Отмена записи на вакцинацию ($cancelappointment)

Данный метод используется для осуществления в целевой МО отмены записи на вакцинацию.

Для вызова метода необходимо указывать URL в формате [base]/api/appointment/vaccination/fhir/$cancelappointment.

Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html

На Рисунке 8 представлена схема информационного взаимодействия в рамках метода «Отмена записи на вакцинацию ($cancelappointment)».

Рисунок 8. Схема информационного взаимодействия в рамках метода «Отмена записи на вакцинацию ($cancelappointment)»

 

Описание схемы:

  • Клиент СЗПВ отправляет запрос метода «Отмена записи на вакцинацию ($cancelappointment)» в СЗПВ. Состав параметров запроса представлен в Таблице 14.
  • СЗПВ отправляет запрос метода «Отмена записи на вакцинацию ($cancelappointment)» в целевое ЛПУ. Состав параметров запроса представлен в Таблице 14.
  • Целевое ЛПУ передает ответ метода «Отмена записи на вакцинацию ($cancelappointment)» в СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.5.2.

СЗПВ передает ответ метода «Отмена записи на вакцинацию ($cancelappointment)» клиенту СЗПВ. Состав выходных данных ответа метода представлен в разделе 4.5.2.

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

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

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

Параметры

Кратность

Тип

Описание

organizationId

1..1

string

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

patientId

1..1

string

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

slotId

1..1

string

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

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

В ответе метода от целевой МО передается информация об успешной или неуспешной операции отмены записи на вакцинацию.

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

В случае неуспешной операции по отмене записи на вакцинацию, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 4.5.4).

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

Данный метод предназначен для передачи в СЗПВ сведений обо всех фактах записи на вакцинацию в рамках МО. При передаче данных о факте записи на вакцинацию необходимо передавать дату и время осуществления записи на приём.

Для вызова метода необходимо указывать URL в формате [base]/api/appointment/vaccination/fhir/$notify.

Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html

На Рисунке 9 представлена схема информационного взаимодействия в рамках метода «Уведомление о факте записи на вакцинацию ($notify)».

Рисунок 9. Схема информационного взаимодействия в рамках метода «Уведомление о факте записи на вакцинацию ($notify)»

Описание схемы:

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

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

В запросе метода от целевой МО передается информация о ресурсах, описывающих факт записи на вакцинацию, в формате Bundle типа transaction. FHIR-ресурс Bundle используется для передачи набора ресурсов.

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

В случае, если в ресурсе передаётся ссылка на другой ресурс (кроме Organization как ресурс, описывающий целевую МО), то данный ресурс должен присутствовать в передаваемом Bundle.

В рамках Bundle для каждого ресурса необходимо передавать параметр fullUrl в следующем формате:

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

например, "fullUrl": "PractitionerRole/31f34a1f-2984-43cc-b2c1-33cd077370de".

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

Таблица 15 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)

№ п/п

Параметр

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

Описание

1.           

Patient

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

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

2.           

Schedule

Ссылка на PractitionerRole;

Ссылка на Location

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

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

3.           

PractitionerRole

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

Ссылка на Practitioner

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

4.           

Practitioner

 

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

5.           

Location

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

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

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

Количество передаваемых ресурсов Location  - 0..2.

6.           

Slot

Ссылка на Schedule

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

7.           

Appointment

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

Ссылка на Patient;

Ссылка на PractitionerRole;

Ссылка на Slot

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

Количество передаваемых ресурсов Appointment  - 1..1.

8.           

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

 

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

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

Рисунок 10. Структура Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)

 

Перечень ресурсов, передаваемых в рамках Bundle, и их описание, для факта записи, где медицинским ресурсом выступает кабинет, представлено в Таблице 16.

Таблица 16 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)

№ п/п

Параметр

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

Описание

1.           

Patient

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

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

2.           

Schedule

Ссылка на Location

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

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

Количество передаваемых ресурсов Schedule  - 1..1.

3.           

Location

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

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

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

Количество передаваемых ресурсов Location  - 1..2.

4.           

Slot

Ссылка на Schedule

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

5.           

Appointment

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

Ссылка на Patient;

Ссылка на Location;

Ссылка на Slot

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

Количество передаваемых ресурсов Appointment  - 1..1.

6.           

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

 

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

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

Рисунок 11. Структура Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)

 

Структура ответа метода $notify представлена на Рисунке 12.

Рисунок 12. Структура ответа метода $notify

Ресурс Patient

Ресурс Patient предназначен для передачи данных о пациенте.

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

Таблица 17 - Параметры ресурса Patient

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Patient.

Передаётся в формате guid

2.       

identifier

1..4

Identifier

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

Идентификатор пациента в МИС МО обязателен для передачи

2.1.     

identifier.system

1..1

string

Пространство имён идентификатора.

Указывается код:

·         OID для идентификатора в МИС (1.2.643.5.1.13.2.7.100.5)

·         OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223)

·         для ДУЛ и полисов OID (1.2.643.2.69.1.1.1.6.Х), где Х = код документа в справочнике 1.2.643.2.69.1.1.1.6. Для ДУЛ допустимые значения (1-18), для полисов ОМС (226-228).

2.2.     

identifier.value

1..1

string

Значение для идентификатора или для документа.

·         для идентификатора в МИС указывается [идентификатор в МИС]

·         для ДУЛ и полисов указывается [Серия]:[Номер] или [Номер], если нет серии, номер - обязателен. В серии не должны использоваться разделители (пробелы, тире и т.д.), допускаются цифры и буквы русского и латинского алфавита. В номере не должны использоваться разделители (пробелы, тире и т.д.), допускаются только цифры.

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

3.       

name

1..1

HumanName

ФИО пациента

3.1.     

name.family

1..1

string

Фамилия.

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

3.2.     

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.

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

4.       

telecom

0..*

ContactPoint

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

4.1.     

telecom.system

1..1

code

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

4.2.     

telecom.value

1..1

string

Номер телефона.

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

4.3.     

telecom.use

1..1

code

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

·         «home» - номер домашнего телефона;

·         «mobile» - номер мобильного телефона.

5.       

gender

0..1

code

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

6.       

birthDate

1..1

date

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

7.       

managingOrganization

1..1

Reference(Organization)

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

Ресурс  Schedule

Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.

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

Таблица 18 - Параметры ресурса Schedule

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Schedule.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.     

identifier.value

1..1

string

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

Передаётся в формате guid

3.       

serviceCategory

1..1

CodeableConcept

Код услуги из справочника «Номенклатура медицинских услуг» (OID 1.2.643.5.1.13.13.11.1070)

3.1.     

serviceCategory.valueCodeableConcept.coding

1..1

Coding

 

3.2.     

serviceCategory.valueCodeableConcept.coding.system

1..1

uri

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

3.3.     

serviceCategory.valueCodeableConcept.coding.code

1..1

code

Передаётся код услуги из справочника «Номенклатура медицинских услуг» (OID 1.2.643.5.1.13.13.11.1070): «B04.014.004»

4.       

serviceType

1..1

CodeableConcept

Массив кодов инфекций, по которым необходимо провести вакцинацию (по справочнику «Код инфекции» OID 1.2.643.2.69.1.1.1.130).

Допустима передача более одного кода инфекций в рамках infectionId для комбинаций значений:

·         «3», «5»

·         «3», «4», «5»

В остальных случаях в рамках infectionId должен передаваться только один код инфекции.

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

4.1.     

serviceType.valueCodeableConcept.coding

1..3

Coding

 

4.1.1.    

serviceType.valueCodeableConcept.coding.system

1..1

uri

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

4.1.2.   

serviceType.valueCodeableConcept.coding.code

1..1

code

Передаётся код из справочника «Код инфекций» (OID 1.2.643.2.69.1.1.1.130)

5.       

actor

1..3

Reference

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

Ресурс PractitionerRole

Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.

В Таблице 19 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 19 - Параметры ресурса PractitionerRole

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса PractitionerRole.

Передаётся в формате guid

2.       

extension

1..1

code

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

2.1.     

extension.url

1..1

uri

Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group»

2.2.     

extension.valueCodeableConcept.coding

1..3

Coding

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

2.2.1.    

extension.valueCodeableConcept.coding.system

1..1

code

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

 

2.2.2.    

extension.valueCodeableConcept.coding.code

1..1

code

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

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

3.       

identifier

1..1

Identifier

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

3.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

3.2.     

identifier.value

1..1

string

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

Максимальная длина поля: 200 символов

4.       

practitioner

1..1

Reference(Practitioner)

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

5.       

organization

1..1

Reference(Organization)

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

6.       

code

1..1

CodeableConcept

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

6.1.     

code.coding

3..3

Coding

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

6.1.1.    

code.coding.system

1..1

uri

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

·         «1.2.643.5.1.13.13.11.1102» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) - должность, по которой трудоустроен медицинский работник в данной МО

·         «1.2.643.5.1.13.13.11.1102.2» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) – код должности, расположенной в папках «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи) » -> «врачи-специалисты»

и

«Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов со средним профессиональным (медицинским) образованием (средний медицинский персонал)»

·         «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных должностей целевой МИС МО

·         «1.2.643.2.69.1.1.1.219» - для регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219)[1]

6.1.2.   

code.coding.code

1..1

code

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

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

6.1.3.   

code.coding.display

1..1

string

Наименование врачебной должности из справочника врачебных должностей целевой МИС МО.

Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5

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

7.       

specialty

1..1

CodeableConcept

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

7.1.     

specialty.coding

2..2

Coding

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

7.1.1.    

specialty.coding.system

1..1

uri

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

·         «1.2.643.5.1.13.13.11.1066» - для справочника «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066);

·         «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных специальностей целевой МИС МО

·         «1.2.643.2.69.1.1.1.220» - для регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220)[2]

7.1.2.   

specialty.coding.code

1..1

code

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

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

7.1.3.   

specialty.coding.display

1..1

string

Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО.

Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5

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

7.2.     

specialty.text

0..1

string

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

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

8.       

availabilityExceptions

0..1

string

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

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

 

[1] В рамках контейнера code.coding ресурса PractitionerRole передача значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник должностей или региональный справочник должностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) в рамках оформления записи на вакцинацию и передавать в рамках контейнера code.coding значение должности из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).

Одновременное указание значений из регионального справочника должностей и справочника должностей целевой МИС МО не допускается (в рамках контейнера code.coding ресурса PractitionerRole в дополнении к значениям по OID «1.2.643.5.1.13.13.11.1102» и «1.2.643.5.1.13.13.11.1102.2»  может передаваться либо значение из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219), либо значение из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).

[2] В рамках контейнера specialty.coding ресурса PractitionerRole передача значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник специальностей или региональный справочник специальностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) в рамках оформления записи на вакцинацию и передавать в рамках контейнера specialty.coding значение специальности из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).

Одновременное указание значений из регионального справочника специальностей и справочника специальностей целевой МИС МО не допускается (в рамках контейнера specialty.coding ресурса PractitionerRole в дополнении к значению по OID «1.2.643.5.1.13.13.11.1066» может передаваться либо значение из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220), либо значение из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).

Ресурс Practitioner

Ресурс Practitioner предназначен для передачи данных о медицинском работнике.

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

Таблица 20 - Параметры ресурса Practitioner

№ п/п

Параметр

Кратность

Тип

Описание

1.       

identifier

2..2

Identifier

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

1.1.                    

identifier.system

1..1

uri

Пространство имён идентификатора.

Указывается код:

·         OID для идентификатора в МИС/ЛИС (1.2.643.5.1.13.2.7.100.5)

·         OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223)

1.2.                    

identifier.value

1..1

string

Значение для идентификатора или для СНИЛСа.

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

2.       

name

1..1

HumanName

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

2.1.     

name.family

1..1

string

Фамилия.

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

2.2.     

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.

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

Ресурс Location

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

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

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

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Location.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.                    

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.                    

identifier.value

1..1

string

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

3.       

address

1..1

Address

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

3.1.     

address.text

1..1

string

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

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

4.       

physicalType

1..1

CodeableConcept

Тип ресурса Location

4.1.     

coding.system

1..1

uri

Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type»

4.2.     

coding.code

1..1

code

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

4.3.     

coding.display

1..1

string

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

5.       

managingOrganization

1..1

Reference(Organization)

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

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

Таблица 22 - Параметры ресурса Location (описание кабинета МО)

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Location.

Передаётся в формате guid

2.       

extension

1..1

code

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

Заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе

2.1.     

extension.url

1..1

uri

Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group»

2.2.     

extension.valueCodeableConcept.coding

1..3

Coding

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

2.2.1.    

extension.valueCodeableConcept.coding.system

1..1

code

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

 

2.2.2.    

extension.valueCodeableConcept.coding.code

1..1

code

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

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

3.       

identifier

2..2

Identifier

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

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

4.       

identifier.system

1..1

uri

Пространство имён идентификатора.

Указывается код:

·         OID для идентификатора в МИС МО (1.2.643.5.1.13.2.7.100.5)

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

5.       

identifier.value

1..1

string

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

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

6.       

name

1..1

string

Наименование кабинета.

Например: «Кабинет №5».

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

7.       

physicalType

1..1

CodeableConcept

Тип ресурса Location

7.1.     

coding.system

1..1

uri

Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type»

7.2.     

coding.code

1..1

code

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

Обозначение того, что данный ресурс Location – кабинет (комната)

7.3.     

coding.display

1..1

string

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

8.       

managingOrganization

1..1

Reference(Organization)

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

9.       

partOf

0..1

Reference(Location)

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

Ресурс Slot

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

В Таблице 23 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 23 - Параметры ресурса Slot

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Slot.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.     

identifier.value

1..1

string

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

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

3.       

schedule

1..1

Reference(Schedule)

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

4.       

status

1..1

code

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

5.       

start

1..1

instant

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

6.       

end

1..1

instant

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

7.       

comment

0..1

string

Номер талона в очереди.

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

Ресурс Appointment

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

В Таблице 24 представлено описание параметров ресурса Appointment. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 24 - Параметры ресурса Appointment

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Appointment.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

3.       

identifier.system

1..1

uri

Пространство имён идентификатора.

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

4.       

identifier.value

1..1

string

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

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

5.       

status

1..1

code

Статус записи на приём.

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

6.       

serviceType

1..1

CodeableConcept

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

6.1.     

coding.system

1..*

uri

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

6.2.     

coding.code

1..*

code

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

7.       

supportingInformation

1..1

Reference(Organization)

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

8.       

start

1..1

dateTime

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

9.       

end

1..1

dateTime

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

10.   

slot

1..1

Reference(Slot)

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

11.   

created

1..1

dateTime

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

12.   

participant

2..2

CodeableConcept

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

12.1. 

actor.reference

1..1

Reference(Patient, Location, PractitionerRole)

Ссылка на ресурс Patient (пациент);

ссылка на ресурс Location (кабинет как мед ресурс) или ссылка на ресурс PractitionerRole (мед работник как мед ресурс)

12.2. 

status

1..1

code

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

Ресурс Organization

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

В Таблице 25 представлено описание параметров ресурса Organization. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 25 - Параметры ресурса Organization

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Organization.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

3.       

identifier.system

1..1

uri

Пространство имён идентификатора.

Указывается код «1.2.643.2.69.1.2.113» (код для СЗПВ)

4.       

identifier.value

1..1

string

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

5.       

type

1..1

CodeableConcept

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

5.1.     

coding.system

1..*

uri

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

5.2.     

coding.code

1..*

code

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

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

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

Таблица 26 – Описание параметров запроса метода $notify

Параметры

Кратность

Тип

Описание

notificationId

1..1

string

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

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

Данный метод предназначен для передачи в СЗПВ изменений ранее переданных методом $notify фактов записи на вакцинацию (например, изменился статус записи на вакцинацию).

Предполагается следующий сценарий использования метода «Уведомление об изменении записи на вакцинацию ($changenotification)»:

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

Для вызова метода необходимо указывать URL в формате [base]/api/appointment/vaccination/fhir/$changenotification.

Подробное описание используемой в данном методе возможности Custom Operation в рамках FHIR приведено по следующей ссылке: http://fhir-ru.github.io/operations.html

На Рисунке 13 представлена схема информационного взаимодействия в рамках метода «Уведомление об изменении записи на вакцинацию ($changenotification)».

Рисунок 13. Схема информационного взаимодействия в рамках метода «Уведомление об изменении записи на вакцинацию ($changenotification)»

 

Описание схемы:

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

СЗПВ передает ответ метода «Уведомление об изменении записи на вакцинацию ($changenotification)» в целевое ЛПУ. Состав параметров ответа метода представлен в разделе 4.7.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, и их описание, для факта записи (включая изменённую информацию), где медицинским ресурсом выступает медицинский работник, представлено в Таблице 27.

Таблица 27 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)

№ п/п

Параметр

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

Описание

1.           

Patient

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

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

2.           

Schedule

Ссылка на PractitionerRole;

Ссылка на Location

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

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

3.           

PractitionerRole

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

Ссылка на Practitioner

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

4.           

Practitioner

 

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

5.           

Location

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

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

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

Количество передаваемых ресурсов Location  - 0..2.

6.           

Slot

Ссылка на Schedule

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

7.           

Appointment

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

Ссылка на Patient;

Ссылка на PractitionerRole;

Ссылка на Slot

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

Количество передаваемых ресурсов Appointment  - 1..1.

8.           

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

 

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

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

Рисунок 14. Структура Bundle (медицинским ресурсом, оказывающим услугу, является медицинский работник)

 

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

Таблица 28 – Описание ресурсов, входящих в состав Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)

№ п/п

Параметр

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

Описание

1.           

Patient

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

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

2.           

Schedule

Ссылка на Location

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

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

Количество передаваемых ресурсов Schedule  - 1..1.

3.           

Location

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

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

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

Количество передаваемых ресурсов Location  - 1..2.

4.           

Slot

Ссылка на Schedule

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

5.           

Appointment

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

Ссылка на Patient;

Ссылка на Location;

Ссылка на Slot

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

Количество передаваемых ресурсов Appointment  - 1..1.

6.           

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

 

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

В случае, если запись, которая была произведена на кабинет как медицинский ресурс, переводят в статус «fulfilled» (Посещение состоялось), дополнительно в Bundle необходимо передавать ресурсы PractitionerRole и Practitioner с описанием медицинского работника, который оказал медицинскую услугу, а также необходимо передавать ссылку на данный ресурс PractitionerRole в контейнере participant ресурса Appointment с параметром "status": "accepted".

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

Рисунок 15. Структура Bundle (медицинским ресурсом, оказывающим услугу, является кабинет)

 

Структура ответа метода $changenotification представлена на Рисунке 16.

Рисунок 16. Структура ответа метода $changenotification

Ресурс Patient

Ресурс Patient предназначен для передачи данных о пациенте.

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

Таблица 29 - Параметры ресурса Patient

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Patient.

Передаётся в формате guid

2.       

identifier

1..4

Identifier

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

Идентификатор пациента в МИС МО обязателен для передачи

2.1.     

identifier.system

1..1

string

Пространство имён идентификатора.

Указывается код:

·         OID для идентификатора в МИС (1.2.643.5.1.13.2.7.100.5)

·         OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223)

·         для ДУЛ и полисов OID (1.2.643.2.69.1.1.1.6.Х), где Х = код документа в справочнике 1.2.643.2.69.1.1.1.6. Для ДУЛ допустимые значения (1-18), для полисов ОМС (226-228).

2.2.     

identifier.value

1..1

string

Значение для идентификатора или для документа.

·         для идентификатора в МИС указывается [идентификатор в МИС]

·         для ДУЛ и полисов указывается [Серия]:[Номер] или [Номер], если нет серии, номер - обязателен. В серии не должны использоваться разделители (пробелы, тире и т.д.), допускаются цифры и буквы русского и латинского алфавита. В номере не должны использоваться разделители (пробелы, тире и т.д.), допускаются только цифры.

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

3.       

name

1..1

HumanName

ФИО пациента

3.1.     

name.family

1..1

string

Фамилия.

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

3.2.     

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.

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

4.       

telecom

0..*

ContactPoint

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

4.1.     

telecom.system

1..1

code

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

4.2.     

telecom.value

1..1

string

Номер телефона.

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

4.3.     

telecom.use

1..1

code

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

·         «home» - номер домашнего телефона;

·         «mobile» - номер мобильного телефона.

5.       

gender

0..1

code

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

6.       

birthDate

1..1

date

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

7.       

managingOrganization

1..1

Reference(Organization)

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

Ресурс  Schedule

Ресурс Schedule предназначен для передачи данных о расписании медицинского ресурса.

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

Таблица 30 - Параметры ресурса Schedule

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Schedule.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.     

identifier.value

1..1

string

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

Передаётся в формате guid

3.       

serviceCategory

1..1

CodeableConcept

Код услуги из справочника «Номенклатура медицинских услуг» (OID 1.2.643.5.1.13.13.11.1070)

3.1.     

serviceCategory.valueCodeableConcept.coding

1..1

Coding

 

3.2.     

serviceCategory.valueCodeableConcept.coding.system

1..1

uri

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

3.3.     

serviceCategory.valueCodeableConcept.coding.code

1..1

code

Передаётся код услуги из справочника «Номенклатура медицинских услуг» (OID 1.2.643.5.1.13.13.11.1070): «B04.014.004»

4.       

serviceType

1..1

CodeableConcept

Массив кодов инфекций, по которым необходимо провести вакцинацию (по справочнику «Код инфекции» OID 1.2.643.2.69.1.1.1.130).

Допустима передача более одного кода инфекций в рамках infectionId для комбинаций значений:

·         «3», «5»

·         «3», «4», «5»

В остальных случаях в рамках infectionId должен передаваться только один код инфекции

4.1.     

serviceType.valueCodeableConcept.coding

1..3

Coding

 

4.1.1.    

serviceType.valueCodeableConcept.coding.system

1..1

uri

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

4.1.2.   

serviceType.valueCodeableConcept.coding.code

1..1

code

Передаётся код из справочника «Код инфекций» (OID 1.2.643.2.69.1.1.1.130)

5.       

actor

1..3

Reference

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

Ресурс PractitionerRole

Ресурс PractitionerRole предназначен для передачи данных о медицинском работнике в привязке к МО.

В Таблице 31 представлено описание параметров ресурса PractitionerRole. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 31 - Параметры ресурса PractitionerRole

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса PractitionerRole.

Передаётся в формате guid

2.       

extension

1..1

code

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

2.1.     

extension.url

1..1

uri

Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group»

2.2.     

extension.valueCodeableConcept.coding

1..3

Coding

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

2.2.1.    

extension.valueCodeableConcept.coding.system

1..1

code

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

 

2.2.2.    

extension.valueCodeableConcept.coding.code

1..1

code

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

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

3.       

identifier

1..1

Identifier

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

3.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

3.2.     

identifier.value

1..1

string

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

Максимальная длина поля: 200 символов

4.       

practitioner

1..1

Reference(Practitioner)

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

5.       

organization

1..1

Reference(Organization)

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

6.       

code

1..1

CodeableConcept

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

6.1.     

code.coding

3..3

Coding

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

6.1.1.    

code.coding.system

1..1

uri

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

·         «1.2.643.5.1.13.13.11.1102» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) - должность, по которой трудоустроен медицинский работник в данной МО

·         «1.2.643.5.1.13.13.11.1102.2» - для справочника «ФРМР. Должности медицинского персонала» (OID 1.2.643.5.1.13.13.11.1102) – код должности, расположенной в папках «Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов с высшим профессиональным (медицинским) образованием (врачи) » -> «врачи-специалисты»

и

«Должности работников медицинских организаций» -> «Должности медицинских работников» -> «Должности специалистов со средним профессиональным (медицинским) образованием (средний медицинский персонал)»

·         «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных должностей целевой МИС МО

·         «1.2.643.2.69.1.1.1.219» - для регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219)[1]

6.1.2.   

code.coding.code

1..1

code

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

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

6.1.3.   

code.coding.display

1..1

string

Наименование врачебной должности из справочника врачебных должностей целевой МИС МО.

Передаётся только при code.coding.system = 1.2.643.5.1.13.2.7.100.5

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

7.       

specialty

1..1

CodeableConcept

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

7.1.     

specialty.coding

2..2

Coding

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

7.1.1.    

specialty.coding.system

1..1

uri

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

·         «1.2.643.5.1.13.13.11.1066» - для справочника «Номенклатура специальностей медработников с высшим и средним образованием» (OID 1.2.643.5.1.13.13.11.1066);

·         «1.2.643.5.1.13.2.7.100.5» - для справочника врачебных специальностей целевой МИС МО

·         «1.2.643.2.69.1.1.1.220» - для регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220)[2]

7.1.2.   

specialty.coding.code

1..1

code

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

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

7.1.3.   

specialty.coding.display

1..1

string

Наименование врачебной специальности из справочника врачебных специальностей целевой МИС МО.

Передаётся только при specialty.coding.system = 1.2.643.5.1.13.2.7.100.5

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

7.2.     

specialty.text

0..1

string

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

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

8.       

availabilityExceptions

0..1

string

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

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

 

[1] В рамках контейнера code.coding ресурса PractitionerRole передача значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник должностей или региональный справочник должностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219) в рамках оформления записи на вакцинацию и передавать в рамках контейнера code.coding значение должности из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).

Одновременное указание значений из регионального справочника должностей и справочника должностей целевой МИС МО не допускается (в рамках контейнера code.coding ресурса PractitionerRole в дополнении к значениям по OID «1.2.643.5.1.13.13.11.1102» и «1.2.643.5.1.13.13.11.1102.2»  может передаваться либо значение из регионального справочника «Должности медицинского персонала» (OID 1.2.643.2.69.1.1.1.219), либо значение из справочника врачебных должностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).

[2] В рамках контейнера specialty.coding ресурса PractitionerRole передача значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) осуществляется только в случае, если принято такое решение на уровне региона. Если в регионе отсутствует региональный справочник специальностей или региональный справочник специальностей не используется в рамках данного сервиса, просим игнорировать возможность передачи значения из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220) в рамках оформления записи на вакцинацию и передавать в рамках контейнера specialty.coding значение специальности из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5).

Одновременное указание значений из регионального справочника специальностей и справочника специальностей целевой МИС МО не допускается (в рамках контейнера specialty.coding ресурса PractitionerRole в дополнении к значению по OID «1.2.643.5.1.13.13.11.1066» может передаваться либо значение из регионального справочника «Специальности медицинского персонала» (OID 1.2.643.2.69.1.1.1.220), либо значение из справочника врачебных специальностей целевой МИС МО (OID 1.2.643.5.1.13.2.7.100.5)).

Ресурс Practitioner

Ресурс Practitioner предназначен для передачи данных о медицинском работнике.

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

Таблица 32 - Параметры ресурса Practitioner

№ п/п

Параметр

Кратность

Тип

Описание

1.       

identifier

2..2

Identifier

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

1.1.                    

identifier.system

1..1

uri

Пространство имён идентификатора.

Указывается код:

·         OID для идентификатора в МИС/ЛИС (1.2.643.5.1.13.2.7.100.5)

·         OID ПФР для СНИЛСа (1.2.643.2.69.1.1.1.6.223)

1.2.                    

identifier.value

1..1

string

Значение для идентификатора или для СНИЛСа.

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

2.       

name

1..1

HumanName

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

2.1.     

name.family

1..1

string

Фамилия.

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

2.2.     

name.given

1..2

string

Имя, Отчество. Сначала указывается Имя.

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

Ресурс Location

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

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

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

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Location.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.                    

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.                    

identifier.value

1..1

string

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

3.       

address

1..1

Address

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

3.1.     

address.text

1..1

string

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

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

4.       

physicalType

1..1

CodeableConcept

Тип ресурса Location

4.1.     

coding.system

1..1

uri

Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type»

4.2.     

coding.code

1..1

code

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

4.3.     

coding.display

1..1

string

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

5.       

managingOrganization

1..1

Reference(Organization)

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

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

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Location.

Передаётся в формате guid

2.       

extension

1..1

code

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

Заполняется только в рамках передачи данных о кабинете МО как о самостоятельном медицинском ресурсе

2.1.     

extension.url

1..1

uri

Передаётся значение «https://portal.egisz.rosminzdrav.ru/materials/541:Age_Group»

2.2.     

extension.valueCodeableConcept.coding

1..3

Coding

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

2.2.1.    

extension.valueCodeableConcept.coding.system

1..1

code

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

 

2.2.2.    

extension.valueCodeableConcept.coding.code

1..1

code

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

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

3.       

identifier

2..2

Identifier

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

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

4.       

identifier.system

1..1

uri

Пространство имён идентификатора.

Указывается код:

·         OID для идентификатора в МИС МО (1.2.643.5.1.13.2.7.100.5)

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

5.       

identifier.value

1..1

string

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

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

6.       

name

1..1

string

Наименование кабинета.

Например: «Кабинет №5».

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

7.       

physicalType

1..1

CodeableConcept

Тип ресурса Location

7.1.     

coding.system

1..1

uri

Указывается значение «http://terminology.hl7.org/CodeSystem/location-physical-type»

7.2.     

coding.code

1..1

code

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

Обозначение того, что данный ресурс Location – кабинет (комната)

7.3.     

coding.display

1..1

string

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

8.       

managingOrganization

1..1

Reference(Organization)

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

9.       

partOf

0..1

Reference(Location)

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

Таблица 34 - Параметры ресурса Location (описание кабинета МО)

Ресурс Slot

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

В Таблице 35 представлено описание параметров ресурса Slot. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 35 - Параметры ресурса Slot

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Slot.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

2.1.     

identifier.system

1..1

uri

Пространство имён идентификатора.

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

2.2.     

identifier.value

1..1

string

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

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

3.       

schedule

1..1

Reference(Schedule)

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

4.       

status

1..1

code

Указывается значение «free» (свободен) при статусе записи cancelled (Запись отменена). При всех остальных значениях статуса записи указывается «busy»

5.       

start

1..1

instant

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

6.       

end

1..1

instant

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

7.       

comment

0..1

string

Номер талона в очереди.

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

Ресурс Appointment

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

В Таблице 36 представлено описание параметров ресурса Appointment. Параметры, которые не используются в информационном обмене, в таблице не указаны.

Таблица 36 - Параметры ресурса Appointment

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Appointment.

Передаётся в формате guid

2.       

extension

1..1

code

Признак жителя города или села («Признак жителя города или села», OID 1.2.643.5.1.13.13.11.1042).

Указывается только при переводе записи в статус «fulfilled»

2.1.     

extension.url

1..1

uri

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

2.2.     

extension.valueCodeableConcept.coding.system

1..1

uri

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

2.3.     

extension.valueCodeableConcept.coding.code

1..1

uri

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

·         1 - Город;

·         2 – Село.

3.       

identifier

1..1

Identifier

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

4.       

identifier.system

1..1

uri

Пространство имён идентификатора.

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

5.       

identifier.value

1..1

string

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

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

6.       

status

1..1

code

Статус записи на приём.

·         booked - Запись оформлена

·         fulfilled - Посещение состоялось

·         noshow - Пациент не явился

·         cancelled - Запись отменена

7.       

serviceType

1..1

CodeableConcept

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

7.1.     

coding.system

1..*

uri

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

7.2.     

coding.code

1..*

code

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

8.       

appointmentType

1..1

CodeableConcept

Причина приёма.

Указывается только при переводе записи в статус «fulfilled»

8.1.     

coding.system

1..1

uri

Указывается значение «http://terminology.hl7.org/CodeSystem/v2-0276»

8.2.     

coding.code

1..1

code

·         ROUTINE - Заболевание

·         CHECKUP - Профилактический прием

9.       

supportingInformation

1..1

Reference(Organization)

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

10.   

start

1..1

dateTime

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

11.   

end

1..1

dateTime

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

12.   

slot

1..1

Reference(Slot)

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

13.   

created

1..1

dateTime

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

14.   

participant

2..2

CodeableConcept

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

14.1. 

actor.reference

1..1

Reference(Patient, Location, PractitionerRole)

Ссылка на ресурс Patient (пациент);

ссылка на ресурс Location (кабинет как мед ресурс) или ссылка на ресурс PractitionerRole (мед работник как мед ресурс)

14.2. 

status

1..1

code

Статус участника.

Указывается значение «accepted» в случае, если пациент/МО не отменял запись

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

Ресурс Organization

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

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

Таблица 37 - Параметры ресурса Organization

№ п/п

Параметр

Кратность

Тип

Описание

1.       

id

1..1

id

Идентификатор ресурса Organization.

Передаётся в формате guid

2.       

identifier

1..1

Identifier

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

3.       

identifier.system

1..1

uri

Пространство имён идентификатора.

Указывается код «1.2.643.2.69.1.2.113» (код для СЗПВ)

4.       

identifier.value

1..1

string

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

5.       

type

1..1

CodeableConcept

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

5.1.     

coding.system

1..*

uri

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

5.2.     

coding.code

1..*

code

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

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

В ответе метода от СЗПВ передается информация об успешном или неуспешном приёме от МИС МО данных с информацией об изменении записи на вакцинацию.

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

В случае неуспешного приёма от МИС МО данных с информацией об изменении записи на вакцинацию, в ответе метода передаётся ресурс OperationOutcome с указанием кода и текста ошибки (пример ответа метода для неуспешной операции приведен в разделе 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

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

25

Извините, запись невозможна. Пациент уже записан к врачу <ФИО врача> в кабинет <название кабинета> на услугу <название услуги> в этот день: <дата записи в формате дд.мм.гггг чч:мм>. Полную информацию об этой записи Вы можете посмотреть в Личном кабинете ЕПГУ

30

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

31

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

32

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

33

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

34

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

35

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

36

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

37

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

38

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

39

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

40

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

41

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

42

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

43

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

44

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

45

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

46

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

47

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

48

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

49

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

50

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

51

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

52

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

53

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

54

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

60

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

61

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

62

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

63

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

64

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

65

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

66

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

67

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

70

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

71

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

72

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

73

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

74

Пациент имеет активную заявку на вызов врача на дом

75

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

76

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

77

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

78

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

80

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

90

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

91

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

92

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

93

Код введён неверно

94

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

95

ЛПУ не подключена к системе ЖОЗ

99

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

151

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

МИС должна передать следующий текст:

«Name:N3:Room:N3:Service_Id:N3:VisitStart:

N3:EventDateTime:N3:AppointmentSource:N3:Member»,

 

где

 

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

Room = Наименование кабинета, где производится врачебный прием;

Service_Id = Код услуги (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070);

VisitStart = Дата и время приема;

EventDateTime = Дата совершения записи;

AppointmentSource = Источник записи (код из Приложения 7);

Member = Участник информационного взаимодействия, осуществивший запись (формат GUID, передавать при значении AppointmentSource = «Прочее»)

152

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

МИС должна передать следующий текст:

«Name:N3:FedIdPosition:N3:Room:N3:Service_Id:

N3:VisitStart:N3:EventDateTime:N3:AppointmentSource:

N3:Member»,

 

где

 

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

FedIdPosition = Идентификатор врачебной должности в федеральном справочнике должностей

(ФРМР. Должности медицинского персонала (OID 1.2.643.5.1.13.13.11.1102; 2 папки))

Room = Наименование кабинета, где производится врачебный прием;

Service_Id = Код услуги (по справочнику «Номенклатура медицинских услуг» 1.2.643.5.1.13.13.11.1070);

VisitStart = Дата и время приема;

EventDateTime = Дата совершения записи;

AppointmentSource = Источник записи (код из Приложения 7);

Member = Участник информационного взаимодействия, осуществивший запись (формат GUID, передавать при значении AppointmentSource = «Прочее»)

153

Пациент не подходит по возрастному критерию

МИС должна передать следующий текст:

«MinAge:N3:MaxAge»,

 

где

 

MinAge = Минимальный возраст пациента;

MaxAge = Максимальный возраст пациента (если верхняя граница не ограничена - не передается)

169

Пациенту недоступна вакцинация (медицинский отвод/не подошёл срок вакцинации).

МИС должна передать следующий текст:

«StartDate»,

 

где

 

StartDate = Примерная/возможная дата вакцинации.

200

Запись на второй этап вакцинации недоступна. С момента проведения первого этапа вакцинации прошло менее 21 дня