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

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

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

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

---

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

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

№	Наименование	Формат	Поле	Обязатель­ность	Описание
Входные параметры метода 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	Да	Наличие согласия субъекта на предоставление информации из ГБД

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

№	Наименование	Формат	Поле	Обязатель­ность
Входные параметры метода getInfoDegreeWorker
1	ИИН пострадавшего работника	xs:string	iin	Да
2	Присвоенный системный номер исходящего ответа	xs:date	responseNumber	Да
3	Дата освидетельствования, в формате dd.mm.yyyy	xs:integer	dateSurvey	Да
4	Срок степени УПТ	xs:integer	termDegree	Да

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

---

Пример вызова метода 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>17b4694a-9b6b-41d8-99d6-af28c4d22408</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.	                     <ResponseInfoDegreeWorker>
18.	                        <ResponseInfoDegreeWorkerData>
19.	                           <responseNumber>Присвоенный системный номер исходящего ответа</responseNumber>
20.	                           <iin>ИИН пострадавшего работника</iin>
21.	                           <dateSurvey>Дата освидетельствования</dateSurvey>
22.	                           <degree>Степень УПТ</degree>
23.	                           <termDegree>Срок степени УПТ</termDegree>
24.	                        </ResponseInfoDegreeWorkerData>
25.	                     </ResponseInfoDegreeWorker>
26.	                     <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
27.	                        <ds:SignedInfo>
28.	                           <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
29.	                           <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34310-gost34311"/>
30.	                           <ds:Reference URI="">
31.	                              <ds:Transforms>
32.	                                 <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
33.	                                 <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/>
34.	                              </ds:Transforms>
35.	                              <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34311"/>
36.	                              <ds:DigestValue>Ваш DigestValue</ds:DigestValue>
37.	                           </ds:Reference>
38.	                        </ds:SignedInfo>
39.	                        <ds:SignatureValue>Ваш SignatureValue</ds:SignatureValue>
40.	                        <ds:KeyInfo>
41.	                           <ds:X509Data>
42.	                              <ds:X509Certificate>Ваш X509Certificate</ds:X509Certificate>
43.	                           </ds:X509Data>
44.	                        </ds:KeyInfo>
45.	                     </ds:Signature>
46.	                  </data>
47.	               </data>
48.	            </responseData>
49.	         </response>
50.	      </ns2:SendMessageResponse>
51.	   </soap:Body>
52.	</soap:Envelope>

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

---

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

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

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

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