Приложение 5. Описание Web-сервиса идентификации застрахованных лиц в РСЕРЗ

Приложение N 5

Описание
Web-сервиса идентификации застрахованных лиц в РСЕРЗ

Для возможности идентификации застрахованного лица, предлагается использовать подключения к Web-службе по протоколу SOAP (Версия 1.2), которая должна взаимодействовать с базой данных регионального регистра застрахованных лиц (ЕРЗ). Данный сервис могут использовать разработчики медицинских информационных систем, разработчики из страховых медицинских компаний для возможности встраивания в свои информационные системы методы идентификации в региональном сегменте регистра застрахованных лиц.

Сервис работает по принципу запрос-ответ. В запросе не осуществлять передачу персональных данных, а для идентификации осуществить передачу в запросе только хеш-значения Ф.И.О. и даты рождения, номера полиса, хеш-значения документа удостоверяющего личность и СНИЛС, а в ответ будет клиент сервиса будет получать ответ от сервиса в случае идентификации пациента: Код СМО, актуальную серию и номер полиса, тип полиса, дата начала и дату окончания полиса.

Расчет хэш значений предлагается получать с помощью одной из криптостойкой хэш-функций MD5.

Web-сервис иметь следующие методы запросов:

Имя метода: ReturnInfoPolis (Получение информации о полисе из регионального ЕРЗ)

Входящие данные:

<xs:complexType name="InfoPolisRequest"> <xs:sequence> <xs:element name="FIO_ hash" type="xs:string"/> <xs:element name="birthDate" type="xs:date"/> <xs:element name="Polis" type="xs:string"/> <xs:element name="Document_hash" type="xs:string"/> <xs:element name="SNILS" type="xs:string"/> </xs:sequence> </xs:complexType>

Где,

Наименование параметра	Назначение
FIO_HASH	Хеш значение Фамилия, Имя, Отчество
BIRTHDATE	Дата рождения
NUMBERPOLIS	Серия и номер полиса
DOCUMENT_HASH	Хеш значение серии и номера документа удостоверяющего личность
SNILS	СНИЛС
DATEON	Дата, на которую осуществляется идентификация;

Данные получаемые в качестве признака успешности выполнения запроса:

<xs:complexType name="InfoPolisResponse"> <xs:sequence> <xs:element name="SMO" type="xs:string"/> <xs:element name="TYPEPOLIS" type="xs:string"/> <xs:element name="SNPOLIS" type="xs:string"/> <xs:element name="BEGIN_DATE" type="xs:Date"/> <xs:element name="END_DATE" type="xs:Date"/> </xs:sequence> </xs:complexType>

Где:

Наименование параметра	Назначение
SMO	Код страховщика в системе ОМС в соответствии со справочником "F002"
TYPEPOLIS	Тип документа подтверждающего факт страхования по ОМС в соответствии со справочником "F008".
SNPOLIS	Серия и номер полиса
BEGIN_DATE	Дата начала действия полиса
END_DATE	Дата окончания действия полиса

В случаи если запрос выполнен не успешно (указаны пустые данные, или указанных данных недостаточно для идентификации) то функция ничего не возвращает (Nil).

WSDL описание сервиса онлайн идентификации застрахованного лица в региональном ЕРЗ:

<definitions xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://atria.cz/appointment/notification" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:ns1="http://cz.atria/patient/interchange/" xmlns:ns2="http://atria.cz/nsi/types"name="ReturnInfoInterchangeEndPointservice" targetNamespace="http://atria.cz/appointment/notification"> <types> <xs:schema xmlns="http://cz.atria/patient/interchange/" targetNamespace="http://cz.atria/patient/interchange/"> <xs:complexType name="InfoPolisRequest"> <xs:sequence> <xs:element name="FAM" type="xs:string"/> <xs:element name="IM" type="xs:string"/> <xs:element name="OT" type="xs:string"/> <xs:element name="birthDate" type="xs:date"/> <xs:element name="NumberPolis" type="xs:string"/> <xs:element name="serdoc" type="xs:string"/> <xs:element name="numdoc" type="xs:string"/> <xs:element name="SNILS" type="xs:string"/> <xs:element name="date_out" type="xs:date"/> </xs:sequence> </xs:complexType> </xs:schema> <xs:schema xmlns="http://atria.cz/nsi/types" targetNamespace="http://atria.cz/nsi/types"> <xs:complexType name="InfoPolisResponse"> <xs:sequence> <xs:element name="SMO" type="xs:string"/> <xs:element name="TYPEPOLIS" type="xs:int"/> <xs:element name="SNPOLIS" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:schema> </types> <message name="ReturnInfoPolis0Request"> <part name="request" type="ns1:InfoPolisRequest"/> </message> <message name="ReturnInfoPolis0Response"> <part name="return" type="ns2:InfoPolisResponse"/> </message> <portType name="ReturnInfoInterchangeEndPoint"> <operation name="ReturnInfoPolis"> <input message="tns:ReturnInfoPolis0Request"/> <output message="tns:ReturnInfoPolis0Response"/> </operation> </portType> <binding name="ReturnInfoInterchangeEndPointbinding" type="tns:ReturnInfoInterchangeEndPoint"> <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/> <operation name="ReturnInfoPolis"> <soap:operation soapAction=" style="rpc"/> <input> <soap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:service-ReturnInfoInterchangeEndPoint"/> </input> <output> <soap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:service-ReturnInfoInterchangeEndPoint"/> </output> </operation> </binding> <service name="ReturnInfoInterchangeEndPointservice"> <port name="ReturnInfoInterchangeEndPointPort" binding="tns:ReturnInfoInterchangeEndPointbinding"> <soap:address location="http://127.0.0.1:9999/soap/ReturnInfoInterchangeEndPoint"/> </port> </service> </definitions>

Применяемые стандарты при использовании SOAP:

1. Международный стандарт:

ISO 32000-1:2008 "Document management - Portable document format - Part 1: PDF 1.7", Stage: 90.93 (2013-04-29).

2. Стандартизованные спецификации:

Стандарт W3C "Web Services Description Language (WSDL) v1.1";

Стандарт W3C "Extensible Markup Language (XML)" (http://www.w3.org/TR/2004/REC-xml11-20040204/);

Стандарт W3C "XSL Extensible Stylesheet Language Transformation (XSLT) v1.0";

Стандарт W3C "XML Schema Definition (XSD) v1.0. XML Schema Part 1: Structures";

Стандарт W3C "XML Schema Definition (XSD) v1.0. XML Schema Part 2: Datatypes";

Безопасность сервисов

Для доступа к веб-сервису идентификации используется тот же логин и пароль что и к сервису web-доступа ЕРЗ.

Для получения логина и пароля к web-сервису РСЕРЗ требуется обратиться в ТФОМС КЧР.

Сервис предоставляется по адресу: http://78.111.242.97:9999/wsdl/ReturnInfoInterchangeEndPoint