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

Материал из Wiki ГКБ
Перейти к навигации Перейти к поиску
(основание BAZAZNANIY-32)
Строка 315: Строка 315:
  
 
=='''Обработка исключений'''==
 
=='''Обработка исключений'''==
−
-----
 
  
 
<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
 
<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">

Версия от 08:32, 19 мая 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

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

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


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


Источник — https://wiki.gkb.kz/?title=Сервис_«По_поиску_информации_по_пострадавшему_работнику»&oldid=6465