Региональный сервис «Идентификация гражданина в сфере ОМС» осуществляет взаимодействие через интеграционную подсистему обеспечения оказания государственных услуг в сфере здравоохранения (ИП ООГУЗ) и только между медицинской информационной системой и федеральным сервисом идентификации гражданина в медицинской организации.
Описание решения
Описание информационного взаимодействия
Сервис предназначен для идентификации гражданина в сфере ОМС через федеральный сервис ИП ООГУЗ.
Взаимодействие с внешними информационными системами или иными подсистемами общей информационной системы здравоохранения должно быть построено на архитектуре стандарта FHIR HL7 версии 4.0, размещенный по адресу https://www.hl7.org/fhir/index.html.
Описание авторизации
Авторизация в сервисе «Идентификация пациента» должна осуществляться по токену системы.
Токен должен быть передан в заголовке запроса в формате:
Authorization: N3[пробел][токен системы]
Токен системы выдается клиенту администратором сервиса.
Описание работы со справочной информацией
Все необходимые справочники, размещены в сервисе терминологии.
Состав справочников, используемых при взаимодействии с внешними информационными системами:
1.2.643.2.69.1.1.1.64 – Справочник медицинских организаций
1.2.643.2.69.1.1.1.6 – Справочник «Тип документа»
1.2.643.5.1.13.13.99.2.206 – ФРМО. Регионы Российской Федерации
1.2.643.5.1.13.13.99.2.183 – Реестр страховых медицинских организаций (ФОМС).
Описание ресурсов используемых при взаимодействии
Описание ресурса Bundle
Ресурс Bundle используется для передачи набора ресурсов, связанных друг с другом контекстом.
В сервисе с помощью ресурса Bundle передается ответ от федерального сервиса содержащий положительный результат проверки.
В таблице 1 представлено описание ресурса Bundle.
Таблица 1 – Описание параметров ресурса Bundle
|
№ п.п. |
Параметр |
Тип |
Кратность |
Описание |
|
1 |
resourceType |
string |
1..1 |
Тип ресурса
Принимает значение: “Bundle” |
|
2. |
identifier |
identifier |
1..1 |
Идентификатор пакета |
|
2.1 |
identifier.value |
string |
1..1 |
Федеральный идентификатор пакета |
|
3. |
type |
string |
1..1 |
Тип пакета
Принимает значение: searchset |
|
4. |
entry |
BackboneElement |
1..1 |
Набор ресурсов в пакете |
|
4.1 |
entry.resource |
BackboneElement |
1..2 |
Параметры ресурса |
Описание ресурса Parameters
Ресурс Parameters используется для отправки POST запросов на поиск информации о персоне или получении результатов.
В составе ресурса Parameters ожидаются входные параметры из внешних информационных систем на поиск соответствующей информации.
В таблице 2 представлено описание ресурса Parameters.
Таблица 2 – Описание параметров ресурса Parameters
|
№ п.п. |
Параметр |
Тип |
Кратность |
Описание |
|
1 |
resourceType |
string |
1..1 |
Тип ресурса
Принимает значение: “Parameters” |
|
2 |
parameter |
parameter |
1..1 |
Набор параметров для поиска информации |
|
3. |
name |
string |
1..1 |
Принимает значения для поиска информации по пациенту: - lpuId – код МО из справочника НСИ 1.2.643.2.69.1.1.1.64 - patientSurname – Фамилия пациента - patientName – Имя пациента - patientPatronymic – Отчество пациента - birthDate– Дата рождения - docType– Тип документа, удостоверяющего личность из справочника НСИ 1.2.643.2.69.1.1.1.6 - docNumber - Серия и номер документа, удостоверяющего личность. Формат передачи: [серия_документа]:[номер документа]
Принимает значения для получения результата поиска: - lpuId– код МО из справочника НСИ 1.2.643.2.69.1.1.1.64 - RequestMessageId – идентификатор сообщения |
|
3.1 |
valueString |
string |
1..1 |
Значение параметра, указанного в поле name |
Описание ресурса Patient
Ресурс Patient используется для передачи информации о пациенте идентифицированном в системе ОМС.
В таблице 3 представлено описание ресурса Patient.
Таблица 3 – Описание параметров ресурса Patient
|
№ п.п. |
Параметр |
Тип |
Кратность |
Описание |
|
1 |
resourceType |
string |
1..1 |
Тип ресурса
Принимает значение: “Patient” |
|
2 |
identifier |
identifier |
1..1 |
Сведения об идентификаторах пациента: - полис ОМС |
|
2.1 |
identifier.system |
string |
0..1 |
Принимает значение: urn:oid:1.2.643.2.69.1.1.1.6.228 |
|
2.2 |
identifier.value |
string |
1..1 |
Полис ОМС |
|
2.3 |
identifier.period |
period |
0..1 |
Период действия полиса ОМС |
|
2.3.1 |
identifier.period.start |
dateTime |
1..1 |
Начало действия полиса ОМС |
|
2.3.2 |
identifier.period.end |
dateTime |
0..1 |
Окончание действия полиса ОМС |
|
2.4 |
identifier.assigner |
assigner |
0..1 |
Сведения об организации, выдавшей документ |
|
2.4.1 |
identifier.assigner.reference |
reference |
0..1 |
Ссылка на сведения о страховой медицинской организации |
|
2.4.2 |
identifier.assigner.display |
string |
0..1 |
Код субъекта РФ по ОКАТО |
|
3 |
identifier.extension |
extension |
0..1 |
Для передачи описания типа документа |
|
3.1 |
identifier.extension.url |
url |
1..1 |
Всегда принимает значение http://hl7.org/fhir/StructureDefinition/rendered-value |
|
3.2 |
identifier.extension.valueString |
string |
1..1 |
Используется для передачи наименования типа полиса ОМС |
Описание ресурса Organization
Ресурс Organization предназначен для передачи информации о страховом представителе СМО.
В таблице 4 представлено описание параметров ресурса Organization.
Таблица 4 – Описание параметров ресурса Organization
|
№ п.п. |
Параметр |
Тип |
Кратность |
Описание |
|
1 |
resourceType |
string |
1..1 |
Тип ресурса
Принимает значение: “Organization” |
|
2 |
id |
string |
1..1 |
Идентификатор ресурса в системе |
|
3 |
identifier |
identifier |
1..1 |
Сведения об идентификаторах организации |
|
3.1 |
identifier.system |
string |
1..1 |
Принимает значение: urn:oid:1.2.643.5.1.13.13.99.2.183 |
|
3.2 |
identifier.value |
string |
1..1 |
Код СМО в реестре страховых МО из справочника 1.2.643.5.1.13.13.99.2.183 |
|
4 |
name |
string |
0..1 |
Наименование страховой МО |
|
5 |
telecom |
ContactPoint |
0..1 |
Сведения о телефоне «горячей линии» контакт-центра ТФОМС |
|
|
telecom.value |
dateTime |
0..1 |
Телефон «горячей линии» контакт-центра ТФОМС |
|
2.4 |
contact |
assigner |
0..1 |
Сведения о страховом представителе СМО |
|
2.4.1 |
contact.telecom |
reference |
0..1 |
Параметр для передачи контактной информации о страховом представителе |
|
2.4.2 |
contact.telecom.value |
string |
0..1 |
Контактный телефон страхового представителя СМО |
Описание метода $sendIdentityPatient
Описание входных параметров метод $sendIdentityPatient
В таблице 5 представлены параметры, передаваемые в ресурсе Parameters, при запросе методом $sendIdentityPatient.
Таблица 5 – Описание вложенных параметров ресурса Parameters
|
№ п.п. |
Параметр |
Тип |
Кратность |
Описание |
|
1 |
lpuId |
string |
1..1 |
Код МО из справочника НСИ 12.643.2.69.1.1.1.64 |
|
2 |
patientSurname |
string |
1..1 |
Фамилия пациента |
|
3 |
patientName |
string |
1..1 |
Имя пациента |
|
3 |
patientPatronymic |
string |
0..1 |
Отчество пациента |
|
4 |
birthDate |
dateTime |
1..1 |
Дата рождения |
|
5 |
docType |
string |
1..1 |
Тип документа, удостоверяющего личность из справочника НСИ 1.2.643.2.69.1.1.1.6 |
|
6 |
docNumber |
string |
1..1 |
Серия и номер документа, удостоверяющего личность. Формат передачи: [серия_документа]:[номер документа] |
Описание выходных параметров метод $sendIdentityPatient
Выходными параметрами является идентификатор сообщения для последующих запросов или соответствующая ошибка.
Описание метода $getIdentityPatient
Описание входных параметров метод $getIdentityPatient
В таблице 6 представлены параметры, передаваемые в ресурсе Parameters, при запросе методом $getIdentityPatient.
Таблица 6 – Описание вложенных параметров ресурса Parameters
|
№ п.п. |
Параметр |
Тип |
Кратность |
Описание |
|
1 |
lpuId |
string |
1..1 |
идентификатор ЛПУ из справочника НСИ 12.643.2.69.1.1.1.64 |
|
2 |
RequestMessageId |
string |
1..1 |
Идентификатор сообщения |
Описание выходных параметров метод $getIdentityPatient
В случае положительного ответа от федерального сервиса в результате будет возвращен Bundle, структура которого представлена на рис. 3.
Рис. 3 – Структура Bundle результата идентификации
Набор параметров ресурса Bundle представлен в п.2.1настоящего документа.
В таблице 7 представлено описание параметров, передаваемых в результате идентификации пациента в сфере ОМС.
Таблица 7 – Описание ресурсов Bundle результата идентификации
|
№ п.п. |
Наименование ресурса |
Описание |
|
1 |
Patient |
Ресурс пациента, содержащий данные из ответа от федерального сервиса. Передается информация о: - ФИО пациента - Полисе пациента - Регионе страхования |
|
2 |
Organization |
Ресурс для передачи информации о страховой медицинской организации из ответа от федерального сервиса. Передается информация о: - страховой медицинской организации - страховом представителе страховой медицинской организации |
Описание кодов ошибок
|
Код ошибки |
Описание |
|
1 |
Внутренняя ошибка сервиса |
|
2 |
Ошибка федерального сервиса |
|
3 |
Свойство [Наименование элемента] не заполнено |
|
4 |
Пациент не идентифицирован |
|
5 |
Отсутствуют данные по запросу |
|
6 |
По данному запросу ответ еще не получен |
|
7 |
Свойство [Наименование элемента] не должно содержать значения в будущем |
|
8 |
Дата [Наименование элемента] указана в неверном формате |
|
9 |
[Адрес параметра] [Значение параметра] не найдено в сервисе терминологии [OID справочника] |
|
10 |
Документ [Наименование элемента] указан в неверном формате |
|
11 |
Неверно указан Единый номер полиса (ЕНП) |