Веб-сервис проверки страховой принадлежности
Веб-сервис проверки страховой принадлежности предоставляет возможность определения актуального статуса застрахованного лица в региональном сегменте (РС), а также возможностью его идентификации в Федеральном едином регистре застрахованных лиц (ФЕРЗЛ). Данный сервис реализован на основе протоколов SOAP и REST API, что обеспечивает удобную интеграцию с различными информационными системами.
Доступ к веб-сервису
Доступ к веб-сервису осуществляется через защищенную сеть ViPNet. Для его настройки Вы можете обратиться в наш отдел безопасности по телефону: 8 (863) 290-46-10. Специалисты отдела помогут настроить туннелирование IP-адресов внутри сети ViPNet и предоставить виртуальный IP-адрес для доступа к веб-сервису.
Также вы можете самостоятельно получить виртуальный IP-адрес в настройках ViPNet-клиента:
- Откройте свойства координатора ТФОМС РО.
- Перейдите в раздел "Туннелируемые адреса".
- Выберите туннелируемый ViPNet-адрес для IP 192.168.0.101.
Методы взаимодействия
Веб-сервис предоставляет метод get_policy_by_fio, доступный через SOAP и REST API.
Веб-сервис обрабатывает запросы метода get_policy_by_fio через соответствующие эндпоинты. Для работы с сервисом необходимо передавать корректные параметры: в формате XML при использовании SOAP или в формате JSON при использовании REST API. Для вызова метода get_policy_by_fio необходимо отправить запрос на соответствующий эндпоинт веб-сервиса.
SOAP-эндпоинт:http://виртуальный-ip-адрес:8084/soap/psp-server
WSDL-файл, описывающий доступные методы, параметры и типы данных:http://виртуальный-ip-адрес:8084/soap/psp.wsdl
REST API-эндпоинт:http://виртуальный-ip-адрес:8084/psp/post?_format=xmlилиhttp://виртуальный-ip-адрес:8084/psp/post?_format=json
Возвращаемый ответ, по-умолчанию, приходит в формате XML. Если необходимо вернуть данные в формате JSON, то необходимо это явно указать в параметре "_format=json".
Метод get_policy_by_fio принимает следующие параметры:
| Наименование | Описание |
|---|---|
| token* | JSON Web Token (JWT) предоставленный ТФОМС Ростовской области Письмо с токеном передается через программу «Деловая почта» по защищенным каналам в сети ViPNet Начинает действовать с 01.02.2025г. |
| kodorg* | Код организации в кодировке ТФОМС (например, 4010101) |
| f_name | Фамилия |
| i_name | Имя |
| o_name | Отчество (в случае отсутствия передаем пустую строку) |
| birth_date | Дата рождения (дд.мм.гггг) |
| enp | Единый номер полиса (16 цифр) |
| snils | Снилс |
| viddk | Тип документа (справочник F011 - классификатор типов документов, удостоверяющих личность) |
| serdk | Серия документа |
| nomdk | Номер документа |
| vpol | Вид полиса ОМС (Справочник типов полисов согласно МПИ ФЕРЗЛ) |
| spol | Серия полиса ОМС |
| npol | Номер полиса ОМС |
Параметры, отмеченные знаком * - обязательны к заполнению.
В случае успешной идентификации застрахованного, возвращаются следующие параметры:
| Наименование | Описание |
|---|---|
| code | Код ответа: 10 - застрахованный найден в РС или ФЕРЗЛ; 20 - застрахованный не найден в РС, сделан запрос в ФЕРЗЛ (ожидание ответа от ФЕРЗЛ); 30 - информация о застрахованном не найдена; 40 - в процессе обработки запроса произошла ошибка; 50 - слишком часто проходят запросы на идентификацию ЗЛ. |
| vid_polis | Вид полиса (справочник F008 - классификатор типов документов, подтверждающих факт страхования по ОМС) |
| ser_polis | Серия полиса |
| nom_polis | Номер полиса |
| datav | Дата выдачи полиса |
| smocod | Код СМО (справочник F002 - единый реестр СМО, осуществляющих деятельность в сфере обязательного медицинского страхования) |
| ogrn | ОГРН |
| okato | Территория страхования (ОКАТО) |
| code_mo | Федеральный код МО прикрепления (если поле не заполнено - застрахованный не прикреплен к МО) |
| kodlpu | Код МО прикрепления в кодировке ТФОМС (если поле не заполнено - застрахованный не прикреплен к МО) |
| datap | Дата прикрепления к МО (если поле не заполнено - застрахованный не прикреплен к МО) |
| enp | Единый номер полиса (16 цифр) |
| id | ID застрахованного (в случае получения ответа из регионального сегмента) |
| err | сообщение в случае ошибки |
© 1993-2025 Территориальный фонд обязательного медицинского страхования Ростовской области