ГИП

Подсистема «Главны индекс пациента»: Сервис обогащения

Основное назначение подсистемы «Сервис обогащения ЕГИСЗ» — обеспечение информационного взаимодействия с целью:

• Получения СНИЛС (страхового номера индивидуального лицевого счета) пациента по его персональным данным;
• Получения ЕНП (единого номера полиса ОМС) пациента по его персональным данным;

Важно

Все входящие запросы от ЛПУ должны быть с авторизацией по токену в заголовке запроса.

Authorization: Token <Токен>

Swagger доступен по адресу: https://egisz-test.medflex.ru/swagger/

Получение результатов

Процесс получения результатов обогащения данных может быть организован двумя способами:

• Периодическая проверка через GET-запросы
• Автоматическая доставка через Callback

МИС может использовать любой из предложенных способов получения результата, в том числе и оба сразу.

1. Периодическая проверка через GET-запросы (Polling)

• После отправки POST-запроса сервис возвращает идентификатор запроса в uuid формате.
• Клиент (МИС) самостоятельно периодически отправляет GET-запросы по этому URL для получения результата.
• Статус выполнения может быть:
• «В процессе» — запрос ещё обрабатывается;
• «Выполнено» — результат готов;
• «Ошибка» — произошёл сбой.

2. Автоматическая доставка через Callback

В отличие от описанного выше polling-подхода, МедФлекс может самостоятельно прислать результаты в МИС через callback-запросы. Это более эффективный метод, так как МИС не нужно постоянно опрашивать сервис.

Формирование ссылок для callback методов

Адрес, по которому будут доставляться результаты выполнения запросов и другие вызовы callback методов, заполняется на стороне МедФлекс техническими специалистами.

Для указания или изменения этого адреса, обратитесь в техническую поддержку.

Важно. На стороне МИС адрес должен соответствовать единому шаблону:

POST: [base_url]/[action]

Где:

• base_url - основной адрес, например http://example.com/egisz/mpi
• action - callback метод, например error, united_policy_number, snils.

Callback запросы от МедФлекс будут приходить с Token или Basic авторизацией в заголовке. Выбор этого метода остается за МИС, на свое усмотрение.

Тело callback запроса полностью соответствует результатам получаемым через get запросы.

Список возможных ошибок

При обработке запросов на обогащение данных могут выявиться ошибки на разных стадиях: на стадии принятия и конвертации запроса, на стадии передачи запроса системе-поставщику, на стадии получения ответа и его обработки для передачи Клиенту сервиса. Разного рода ошибки должны быть транслированы Клиенту сервиса. Перечень обрабатываемых ошибок представлен в таблице:

HTTP код	Код ошибки	Пример описания
404	GW-001	Запрос с идентификатором "" не найден
500	GW-002	Внутренняя ошибка сервиса
400	GW-005	Сведения не найдены
500	GW-006	Внешняя ошибка сервиса

Требования к заполнению серии и номера документа, удостоверяющего личность.

Требования к заполнению серии и номера документа для сервиса «Получение СНИЛС по персональным данным» и «Получение ЕНП по персональным данным» представлены в таблице:

Код в ФРНСИ	Series	Number
1	d{4}	d{6}
6	\[IVXLCDM\]{1,10}\[\\-\]\[А-Я\]{2}	d{6}
7	\[А-Я\]{2}	d{7}
9	\[А-Я\]{2}	d{7}
11	d{2}	d{7}
20	\[IVXLCDM\]{1,10}\[\\-\]\[А-Я\]{2}	d{6}
42	d{2}	d{7}