Перейти к содержанию

ГИП

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

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

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

Важно

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

Authorization: Token <Токен>

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

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

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

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

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

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

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

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

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

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

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

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

[base_url]/[action]

Где:

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

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

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

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

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}