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