Сервис «По поиску информации по пострадавшему работнику»: различия между версиями

Текущая версия от 05:02, 7 ноября 2023

В данной статье описывается принцип работы сервиса по получению сведений о по пострадавшему работнику (далее – Сервис) посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.

Сервис по поиску информации по пострадавшему работнику

Адреса web сервисов:
Тестовый сервис	https://testscbws.mkb.kz/mtsznServices/GetInfoDegreeWorkerImplService?wsdl
Продуктивный сервис	https://scbws.mkb.kz/mtsznServices/GetInfoDegreeWorkerImplService?wsdl
Метод сервиса:	getInfoDegreeWorker getInfoDegreeWorkerUseToken

При вызове веб-сервиса обязательно указываются следующие параметры:

1. ID и пароль клиента (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.

2. ID пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:

Http Headers: {Authorization=[Basic c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}

SOAP Message: [Показать ответ]

1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.mtszn.scb.kz/">
2.	   <soapenv:Header>
3.	      <userId> xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx </userId>
4.	      </soapenv:Header>
5.	   <soapenv:Body>
6.	      </data:getInfoDegreeWorker>
7.	   </soapenv:Body>
8.	</soapenv:Envelope>

Метод getInfoDegreeWorker

Метод предназначен для получения выходных документов.

Состав данных запроса: [Показать ответ]

№	Наименование	Формат	Поле	Обязательность	Описание
1	ИИН	xs:string	iin	Да	ИИН пострадавшего работника
2	Номер запроса	xs:string	requestNumber	Да	Присвоенный системный номер исходящего ответа
3	Подтверждение субъекта	xs:integer	consent	Да	Согласие true – (Да) или false – (Нет)

Метод getInfoDegreeWorkerUseToken

Состав данных запроса: [Показать ответ]

№	Наименование	Формат	Поле	Обязательность	Описание
Входные параметры метода getInfoDegreeWorker
1	ИИН	xs:string	iin	Да	ИИН пострадавшего работника
2	Номер запроса	xs:string	requestNumber	Да	Присвоенный системный номер исходящего ответа
3	Подтверждение субъекта	xs:integer	consent	Да	Согласие true – (Да) или false – (Нет)
4	Токен КДП	xs:string	token	Да	Наличие согласия субъекта на предоставление информации из ГБД

Состав данных ответа метода GgetInfoDegreeWorker и GetInfoDegreeWorkerUseToken: [Показать ответ]

№	Наименование	Формат	Обязательность	Примечание
1.	iin	string	Да	ИИН пострадавшего работника
2.	responseNumber	string	Да	Присвоенный системный номер исходящего ответа
3.	dateSurvey	date	Да	Дата освидетельствования, в формате dd.mm.yyyy
4.	degree	integer	Да	Степень УПТ, %
5.	termDegree	string	Да	Срок степени УПТ
6.	dateTermDegree	string	Да	Срок зачтен с, в формате dd.mm.yyyy
7.	responseNumber	string	Да	Номер ответа
8.	gruppaInv	string	Да	Группа инвалидности
9.	appointDate	date	Да	Дата назначения
10.	endDateExpertise	date	Да	Дата окончания
11.	srokInv	string	Да	Срок инвалидности
12.	dataOkonInv	date	Да	Дата окончания инвалидности
13.	reExaminationDate	date	Да	Дата повторного осмотра
14.	numberAct	integer	Да	Номер АКТа
15.	srokZachtenS	date	Да	Срок начала
16.	prInv	string	Да	Причина инвалидности
17.	IPRNumber	integer	Да	Номер ИПРН
18.	mainDiagnosis	string	Да	Основной диагноз
19.	mseName	string	Да	Наименования МСЭ
20.	hospitalName	string	Да	Наименования мед. учреждения
21.	workPlace	string	Да	Место работы
22.	workPosition	string	Да	Должность
23.	mseZakl	string	Да	Заключение МСЭ
24.	medicalRehabilation	string	Да	Медицинская реабилитация
25.	srokUPT	date	Да	Срок УПТ
26.	numberN1	integer	Да	Номер Н1
27.	nameOrg	string	Да	Наименования организации
28.	referenceUpt	integer	Да	Справка УПТ

Пример вызова сервиса

Пример вызова метода getInfoDegreeWorker [Показать ответ]

1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.mtszn.scb.kz/">
2.	   <soapenv:Header>
3.	      <userId>Ваш пользователь</userId>
4.	      </soapenv:Header>
5.	   <soapenv:Body>
6.	      <data:getInfoDegreeWorker>
7.	         <iin>ИИН</iin>
8.	         <requestNumber>номер запроса</requestNumber>
9.	         <consent>подтверждение </consent>
10.	      </data:getInfoDegreeWorker>
11.	   </soapenv:Body>
12.	</soapenv:Envelope>

Пример вызова метода getInfoDegreeWorkerUseToken [Показать ответ]

1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.mtszn.scb.kz/">
2.	   <soapenv:Header>
3.	      <userId>Ваш пользователь</userId>
4.	   </soapenv:Header>
5.	   <soapenv:Body>
6.	      <data:getInfoDegreeWorkerUseToken>
7.	         <requestNumber>Номер запроса</requestNumber>
8.	         <iin>ИИН субъекта</iin>
9.	         <token>Токен КДП</token>
10.	         <consent>Согласие субъекта</consent>
11.	      </data:getInfoDegreeWorkerUseToken>
12.	   </soapenv:Body>
13.	</soapenv:Envelope>

Пример ответа на вызов методов getInfoDegreeWorker и getInfoDegreeWorkerUseToken

Пример ответа [Показать ответ]

 1<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
 2	     <soap:Body wsu:Id="id-D927B52BE810283BC71678167574122119429" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
 3	      <ns2:SendMessageResponse xmlns:ns2="http://bip.bee.kz/SyncChannel/v10/Types">
 4	         <response>
 5	            <responseInfo>
 6                    <messageId>Идентификатор сообщения</messageId>
 7               <responseDate>Дата ответа</responseDate>
 8               <status>
 9                  <code>КОД</code>
10                  <message>Сообщение о статусе</message>
11               </status>
12               <sessionId>Идентификатор сессии</sessionId>
13            </responseInfo>
14            <responseData>
15               <data>
16                  <data>
17                     <ResponseInfoInv>
18                        <responseNumber>Номер отчета</responseNumber>
19                        <iin>ИИН пострадавшего работника</iin>
20                        <gruppaInv>Группа инвалидности</gruppaInv>
21                        <appointDate>Дата назначения</appointDate>
22                        <endDateExpertise>Дата окончания</endDateExpertise>
23                        <srokInv>Срок инвалидности</srokInv>
24                        <dataOkonInv>Дата окончания инвалидности</dataOkonInv>
25                        <reExaminationDate>Дата повторного осмотра</reExaminationDate>
26                        <numberAct>Номер АКТа</numberAct>
27                        <srokZachtenS>Срок начала</srokZachtenS>
28                        <prInv>Причина инвалидности</prInv>
29                        <IPRNumber>Номер ИПРН </IPRNumber>
30                        <mainDiagnosis>Основной диагноз</mainDiagnosis>
31                        <mseName>Наименования МСЭ</mseName>
32                        <hospitalName>Наименования мед. учреждения</hospitalName>
33                        <workPlace>Место работы</workPlace>
34                        <workPosition>Должность</workPosition>
35                        <mseZakl>Заключение МСЭ</mseZakl>
36                        <medicalRehabilation>Медицинская реабилитация</medicalRehabilation>
37                     </ResponseInfoInv>
38                     <ResponseInfoDegreeWorker>
39                        <ResponseInfoDegreeWorkerData>
40                           <dateSurvey>Дата освидетельствования, в формате dd.mm.yyyy</dateSurvey>
41                           <degree>Степень УПТ, %</degree>
42                           <termDegree>Срок степени УПТ</termDegree>
43                           <srokUPT>Срок УПТ</srokUPT>
44                           <dateTermDegree>Срок зачтен с, в формате dd.mm.yyyy</dateTermDegree>
45                           <numberN1>Номер Н1</numberN1>
46                           <nameOrg>Наименования организации</nameOrg>
47                           <referenceUpt>Справка УПТ</referenceUpt>
48                        </ResponseInfoDegreeWorkerData>
49                        <ResponseInfoDegreeWorkerData>
50                           <dateSurvey>Дата освидетельствования, в формате dd.mm.yyyy</dateSurvey>
51                           <degree>Степень УПТ, %</degree>
52                           <termDegree>Срок степени УПТ</termDegree>
53                           <srokUPT>Срок УПТ</srokUPT>
54                           <dateTermDegree>Срок зачтен с, в формате dd.mm.yyyy</dateTermDegree>
55                           <numberN1>33</numberN1>
56                           <nameOrg>Наименования организации</nameOrg>
57                           <referenceUpt>Справка УПТ</referenceUpt>
58                        </ResponseInfoDegreeWorkerData>
59                     </ResponseInfoDegreeWorker>
60                     <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
61                        <ds:SignedInfo>
62                           <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
63                           <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34310-gost34311"/>
64                           <ds:Reference URI="">
65                              <ds:Transforms>
66                                 <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
67                                 <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/>
68                              </ds:Transforms>
69                              <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34311"/>
70                              <ds:DigestValue>Ваш DigestValue</ds:DigestValue>
71                           </ds:Reference>
72                        </ds:SignedInfo>
73                        <ds:SignatureValue>Ваш SignatureValue</ds:SignatureValue>
74                        <ds:KeyInfo>
75                           <ds:X509Data>
76                              <ds:X509Certificate>Ваш X509Certificate</ds:X509Certificate>
77                           </ds:X509Data>
78                        </ds:X509Data>
79                     </ds:KeyInfo>
80                  </ds:Signature>
81                </data>
82              </data>
83           </responseData>
84    </response>
85   </ns2:SendMessageResponse>
86      </soap:Body>
87   </soap:Envelope>

Обработка исключений

При обработке запроса методов getInfoDegreeWorker и getInfoDegreeWorkerUseToken может возвращать следующие виды ошибок: [Показать ответ]

Код ошибки	Описание ошибки
SBF-VE-8	Номер "ИИН" должен содержать 12 цифр
VAL-JSR-001	Обязательное поле "%s" отсутствует
SBF-AD-1	Пользователь %s не имеет прав для выполнения действия
FAULT-015	Сервис на стороне ГБД недоступен
VAL-R-004	Для получения отчета необходимо подтвердить согласие субъекта на запрос его данных из ГБД

Главная страница

Предыдущая страница

Сервис «По поиску информации по пострадавшему работнику»: различия между версиями

Текущая версия от 05:02, 7 ноября 2023

Содержание