Сервис идентификации граждан в сфере ОМС
03.05.2023
Обозначения и сокращения
В настоящем документе применены следующие сокращения (обозначения):
Сокращение (обозначение) |
Значение сокращения (обозначения) |
1 |
2 |
БД |
База данных |
ЕГИСЗ |
Единая государственная информационная система в сфере здравоохранения |
ЕПГУ |
Единый портал государственных и муниципальных услуг (функций). |
ИП ООГУЗ |
Интеграционная подсистема обеспечения оказания государственных услуг в сфере здравоохранения |
МИС |
Медицинская информационная система. |
МО |
Медицинская организация – больница, поликлиника, диспансер и др. Ранее использовался термин «лечебно-профилактическое учреждение» (ЛПУ). |
НСИ |
Нормативно-справочная информация |
ОМС |
Обязательное медицинское страхование |
СНИЛС |
Страховой номер индивидуального лицевого счета застрахованного лица |
ФИО |
Фамилия имя отчество |
Описание решения
Описание информационного взаимодействия
Сервис предназначен для идентификации гражданина в сфере ОМС через федеральный сервис ИП ООГУЗ.
Информационный обмен данными с сервисом представлен на Рис. 1.
Рис. 1 – Информационное взаимодействие
Взаимодействие с внешними информационными системами или иными подсистемами общей информационной системы здравоохранения должно быть построено на архитектуре стандарта 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– Тип документа, удостоверяющего личность или полис ОМС единого образца. Формат передачи: «urn:oid:1.2.643.2.69.1.1.1.6.ХХ», где ХХ- код справочника НСИ 1.2.643.2.69.1.1.1.6. Поле «IdIdentityType» в справочнике 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 |
Принимает значение: |
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
Структура ресурса Parameters представлена на Рис. 2.
Рис. 2 – Структура ресурса Parameters при запросе методом $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 |
Тип документа, удостоверяющего личность или полис ОМС единого образца. Формат передачи: «urn:oid:1.2.643.2.69.1.1.1.6.ХХ», где ХХ- код справочника НСИ 1.2.643.2.69.1.1.1.6. Поле «IdIdentityType» в справочнике 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настоящего документа.
В Bundle передается набор ресурсов Patient и Organization, согласно спецификации п.2.3 и п. 2.4 настоящего документа (рис. 4).
Рис. 4 – Состав ресурсов Bundle результата идентификации
В таблице 7 представлено описание параметров, передаваемых в результате идентификации пациента в сфере ОМС.
Таблица 7 – Описание ресурсов Bundle результата идентификации
№ п.п. |
Наименование ресурса |
Описание |
1 |
Patient |
Ресурс пациента, содержащий данные из ответа от федерального сервиса. Передается информация о: - ФИО пациента - Полисе пациента - Регионе страхования |
2 |
Organization |
Ресурс для передачи информации о страховой медицинской организации из ответа от федерального сервиса. Передается информация о: - страховой медицинской организации - страховом представителе страховой медицинской организации |
Описание кодов ошибок
Код ошибки |
Описание |
1 |
Внутренняя ошибка сервиса |
2 |
Ошибка федерального сервиса |
3 |
Свойство [Наименование элемента] не заполнено |
4 |
Пациент не идентифицирован |
5 |
Отсутствуют данные по запросу |
6 |
По данному запросу ответ еще не получен |
7 |
Свойство [Наименование элемента] не должно содержать значения в будущем |
8 |
Дата [Наименование элемента] указана в неверном формате |
9 |
[Адрес параметра] [Значение параметра] не найдено в сервисе терминологии [OID справочника] |
10 |
Документ [Наименование элемента] указан в неверном формате |
11 |
Неверно указан Единый номер полиса (ЕНП) |
Метод $sendIdentityPatient
Запрос $sendIdentityPatient
POST http://base//api/IdentityPatient/fhir/$sendIdentityPatient Authorization: N3[пробел][GUID системы] Version: 1.0.0 Content-type: application/json
{
"resourceType": "Parameters",
"parameter": [{
"name": "lpuId",
"valueString": "9ace100c-c8b7-496e-8e44-fea75c4695a2" //Идентификатор ЛПУ. OID справочника: 1.2.643.2.69.1.1.1.64
}, {
"name": "patientSurname",
"valueString": "Петров" //Фамилия пациента
}, {
"name": "patientName",
"valueString": "Митрофан" //Имя пациента
}, {
"name": "patientPatronymic",
"valueString": "Валентинович" //Отчество пациента
}, {
"name": "birthDate",
"valueString": "1982-05-05" //Дата рождения пациента
}, {
"name": "docType",
"valueString": "urn:oid:1.2.643.2.69.1.1.1.6.14" //Тип документа, удостверяющего личность, согласно справочнику 1.2.643.2.69.1.1.1.6
}, {
"name": "docNumber",
"valueString": "1111:567890" // Серия и номер документа, удостоверяющего личность
}
]
}
Успешный ответ
{
"resourceType": "Parameters",
"parameter": [
{
"name": "RequestMessageId",
"valueString": "faaa979d-f251-4e2d-8c65-deab7eb45ebb"
}
]
}
Ответ с ошибкой
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"details": {
"coding": [
{
"code": "1",
"display": "Ошибка проверки значения в справочнике: Значение параметра lpuId 9ace100c-c8b7-496e-8e44-fea75c4695a2 не соответствует справочник"
}
]
}
}
]
}
Метод $getIdentityPatient
Запрос методом $getIdentityPatient
POST http://base//api/IdentityPatient/fhir/$getidentitypatient Authorization: N3[пробел][GUID системы] Version: 1.0.0 Content-type: application/json
{
"resourceType": "Parameters",
"parameter": [
{
"name": "lpuId",
"valueString": "e18f03f6-05f4-43db-afee-ddfcc850c17b"
},
{
"name": "RequestMessageId",
"valueString": "c42f30e1-4372-4e4d-b90e-c38cd0d6427a"
}
]
}
Успешный ответ
{
"resourceType": "Bundle",
"identifier": {
"value": "c42f30e1-4372-4e4d-b90e-c38cd0d6427a"
},
"type": "searchset",
"entry": [
{
"resource": {
"resourceType": "Patient",
"identifier": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/rendered-value",
"valueString": "Полис ОМС единого образца"
}
],
"system": "urn:oid:1.2.643.2.69.1.1.1.6.228",
"value": "4759272364966762",
"period": {
"start": "2019-02-10"
},
"assigner": {
"reference": "Organization/34007",
"display": "18000"
}
}
]
}
},
{
"resource": {
"resourceType": "Organization",
"id": "34007",
"identifier": [
{
"system": "urn:oid:1.2.643.5.1.13.13.99.2.183",
"value": "34007"
}
],
"name": "ФИЛИАЛ ООО \"РГС-МЕДИЦИНА\" В ВОЛГОГРАДСКОЙ ОБЛАСТИ",
"telecom": [
{
"value": "52108252835"
}
]
}
}
]
}
Ответ с ошибкой
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"code": "invalid",
"details": {
"coding": [
{
"code": "2",
"display": "Ошибка федерального сервиса"
}
]
},
"diagnostics": "NO_REQUEST_FOR_MESSAGE_ID"
}
]
}
