Web-сервис ЕИР версии 2¶
- Содержание
- Web-сервис ЕИР версии 2
Тестовая среда¶
Справочная информация по методам https://support.arhofoms.ru:8122/swagger
Адрес тестового сервиса для разработчиков https://support.arhofoms.ru:8122/
Для авторизации в тестовом сервисе нужно послать запрос по адресу https://support.arhofoms.ru:8122/token в виде
post https://support.arhofoms.ru:8122/token Content-type:application/x-www-form-urlencoded grant_type=password&username=username&password=password&client_id=api_secret_key
Для каждой МИС по запросу будет выдан Client_id
Работа с токенами¶
Пример запроса с токеном авторизации
POST https://support.arhofoms.ru:8122/api/Hosp/ReferralByList Accept:application/json Content-type:application/json authorization:Bearer sUIZuuvSd-xBxLc_RTxXseEf5AHMfK9Cam7FDKEYya7QlB94b1nGfPBpBWZuCupysC5KfwF_BdBqnmHN2B68ccYX7Jq_B-NLF_8Avi6Sx9-RKgsCgmsvM0qWM3jyX_1Y7PQ2F7eFiciPPoZyoR0oh94wlWM_z0q3Lz84pr5kQSd7qevHNx4VQyophSxhmkUh-dhxZTD6RdAEb81f_9t_uAM3WX5Nj1n-3jcVrif_hjk4uM3uhgOIfDTCEHz0K9kWWyy7PZpmDl2MDkgY_KsxQ4NvMbSHVFf_UAAjN2FUrbMN6fIW6jObX3zVNTqoGmaw865SqnJth5gJzNN4hjhN6TJVUYG-pxM8bzEHUsMb0w9uQ73tCDIttyR4ItOT5WMPQsZut6upKjMOv0zUv6ExlWdMfqviCiH03vXAQsKSXQ5C3Y84W1sapQDEORuW30xed7RPn4c9ryGMVxcQApkniIQHDtUVuequJRMLH09yv5E9cGTMUqz1qmfuBzcjFAEe { "Exp":1, "ReferralList":"<ReferralList> <ORD_NO>60</ORD_NO><ORD_NO>61</ORD_NO><ORD_NO>62</ORD_NO></ReferralList>" }
Если указан заголовок Accept:application/json, то ответ будет в виде JSON, без заголовка в виде XML
Учетные записи для тестирования¶
UserName Password 290005 290005 290014 290014 290102 290102 290104 290104 290201 290201 290208 290208 29030 test 29031 test
Продуктивная среда (сеть ViPNet)¶
- интерфейсная часть (веб-приложение для пользователей): https://адрес_сервиса_в_випнет_мониторе:91
- веб-сервис (для автоматического взаимодействия): https://адрес_сервиса_в_випнет_мониторе:91/api
XML схемы и их применение¶
Запросы направлений из ЕИР:¶
- ReferralList.xsd - список номеров запрашиваемых направлений. Передаётся в запросе направлений по номерам. Список состоит из множества номеров запрашиваемых направлений.
- ReferralFilter.xsd - набор параметров фильтра отбора направлений. Передаётся в запросе направлений по фильтру. Такой запрос в основном предназначен для создания пользовательских приложений, таких как на сайте ТФОМС.
- ReferralPack.xsd - пакет направлений. Возвращается в ответ на различные запросы направлений: по списку; по фильтру; по таймстампу. Пакет состоит из множества записей. Каждая запись содержит данные направления.
Создание и редактирование направлений в ЕИР:¶
- CommandPack.xsd - пакет команд для создания и редактирования направлений. Пакет состоит из множества записей. Каждая запись содержит данные направления и команду. Подробнее - в разделе "Перечень команд и их описание".
- ResultPack.xsd - пакет ответов выполнения команд направлений. Возвращается в ответ на пакет команд (CommandPack.xsd). Пакет состоит из множества записей, по одной на каждую запись исходного пакета команд. Каждая запись содержит результат выполнения команды.
Список команд для создания и редактирования направлений в ЕИР:¶
В схеме CommandPack.xsd в каждой записи должно быть заполнено поле команды ("Command"). Команды предметно-ориентированные, определяют изменяемую часть направления.
Перечень команд и их описание:
Команда Описание ------- ------------- Ambul Создание (изменение) записи направления из поликлиники, заполнение или изменение амбулаторной части направления. Предназначена для применения в поликлинике. Cancel Изменение полей Отмены направления. Extr Создание (изменение) записи экстренной госпитализации в стационаре. Заполнение или изменение персональной части направления и полей фактической госпитализации. Full Создание (изменение) записи направления. Заполнение или изменение всех полей направления. Предназначена для ИС-посредников, например шины МИАЦ Hosp Изменение полей фактической госпитализации. Предназначена для стационаров. Out Изменение полей выписки (плановой и фактической) из стационара. Предназначена для изменения дат выписки (в том числе планируемой), карты и диагноза. Plan Изменение полей плановой даты госпитализации и стационара. Для изменения запланированной госпитализации без изменения остальной части направления.
Поля направления, изменяемые различными командами, перечислены в таблице "Применимость полей направления для различных команд.xlsx"
Перечень команд и их доступность ролям пользователей:
Команда Роли ------- ------------- Ambul ambul proxy Cancel smo hosp hospd proxy Extr hosp proxy Full proxy Hosp hosp hospd proxy Out hosp hospd proxy Plan smo hosp hospd proxy
Сервис определения СП и прикрепления к МО/СМП.¶
Ссылка на документацию https://support.arhofoms.ru:8122/Help/Api/POST-api-Osp
Схема Packet.xsd
Назначение.
- Определение СП и прикрепления к МО/СМП при оказании медуслуг и подготовке реестров счетов медуслуг в МО.
- Определение наличия и действия СП при приёме заявлений от ЗЛ в СМО.
- Поиск информации в региональном сегменте для выяснения сложных случаев: коллизий; расхождений в персональных данных; неидентифицированных; и т.п.
Краткое описание принципа работы.
Клиент отправляет запросы пакетами. Пакет содержит тип запроса и один или несколько сообщений запросов. Типом запроса задается, какой режим обработки будет применён к запросам и что за результат будет отправлен в ответ. Пока обрабатываются типы запросов:
- 'ident' – идентификация (поиск с выбором наиболее релевантного ЗЛ) в региональном сегменте и выдача последней страховки, независимо от её состояния «действующая»/«закрытая»; - 'prik' – идентификация в РС, определение прикрепления и СП в соответствии с регламентом, выдача информации о прикреплении и СП для использования в реестрах счетов - 'full' – идентификация в региональном сегменте (РС) и выдача всех страховок ЗЛ из РС - 'seek' – простой поиск в региональном сегменте и выдача всех приемлемых совпадений;
Запрос содержит идентификационные данные – поля запроса, включая: ФИО, ДР, место рождения, различные документы, такие как СНИЛС, полис, паспорт и т.п. Поля запроса могут быть включены в запрос как все, так и частично. Поиск всегда ведётся по совокупности полей запроса (атрибутам), при этом разные атрибуты имеют разную величину влияния совпадения – «вес». Атрибутам, имеющим высокую избирательность и защиту, как например СНИЛС, назначен больший вес, а таким как фамилия, имя и др. – меньший вес. После сопоставления из различных вариантов совпадений атрибутов определяется вес совпадения как сумма весов совпадающих атрибутов. Совпадения, имеющие вес меньше допустимого, отбрасываются как неприемлемые. Из оставшихся совпадений формируются ответы в зависимости от типа запроса. В ответ, кроме данных страховки (СП) и прикрепления, включаются также поля персональных данных, но только в том случае, когда по ним есть хотя бы частичное совпадение с полями запроса.