В данной статье описывается принцип работы сервиса по получению сведений о социальном статусе физического лица (далее - Сервис) посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.
Описание сервиса PersonStatusImplService
| Наименование вышестоящего элемента
|
Наименование элемента
|
Тип
|
Размерность
|
Описание
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
При вызове веб-сервиса обязательно указываются следующие параметры:
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:getPersonSocialStatus/>
7. </soapenv:Body>
8. </soapenv:Envelope>
где c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2 - есть значение HTTP Header, представляющее собой ID клиента и его пароль в формате «clientId:password» и кодировке Base64 как того требует механизм Basic Authentication.
Метод getPersonSocialStatus
Метод getPersonSocialStatus сервиса PersonStatusImplService предназначен для получения сведений о социальном статусе физического лица.
Таблица 1. Состав данных запроса на получение информации [Показать ответ]
| №
|
Наименование
|
Поле
|
Формат
|
Обязательность
|
Примечание
|
| +
|
+
|
+
|
+
|
+
|
|
Таблица 2. Состав данных ответа на запрос получения информации [Показать ответ]
| Наименование вышестоящего элемента
|
Наименование элемента
|
Тип
|
Размерность
|
Описание
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Наименование вышестоящего элемента
|
Наименование элемента
|
Тип
|
Размерность
|
Описание
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Пример вызова метода getPersonSocialStatus
Пример вызова метода getPersonSocialStatus сервиса PersonStatusImplService с помощью SOAP запроса имеет следующий вид: [Показать ответ]
1. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.mtszn.scb.kz/">
2. <soapenv:Header>
3. <userId>USER_ID</userId>
4. </soapenv:Header>
5. <soapenv:Body>
6. <data:getPersonSocialStatus>
7. <iin>ИИН_СУБЪЕКТА</iin>
8. <requestNumber>НОМЕР_ЗАПРОСА</requestNumber>
9. <consentConfirmed>true</consentConfirmed>
10. </data:getPersonSocialStatus>
11. </soapenv:Body>
12. </soapenv:Envelope>
Пример ответа на вызов метода getPersonSocialStatus
Пример ответа на вызов метода getPersonSocialStatus сервиса PersonStatusImplService с помощью SOAP запроса имеет следующий вид: [Показать ответ]
1. <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2. <soap:Body>
3. <ns2:getPersonSocialStatusResponse xmlns:ns2="http://data.mtszn.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
4. <return>
5. <response>
6. <responseInfo>
7. <messageId>8e654fb7-09d2-4e24-a220-951f7243f706</messageId>
8. <correlationId>e314816d-2f1b-44ef-a312-cf76f759ef79</correlationId>
9. <responseDate>2021-03-25T22:47:12.653+06:00</responseDate>
10. <status>
11. <code>SCSS001</code>
12. <message>Message has been processed successfully</message>
13. </status>
14. <sessionId>{f594214b-21df-4027-ad10-fe0073a88c62}</sessionId>
15. </responseInfo>
16. <responseData>
17. <data>
18. <ResponseInfoPersonStatus>
19. <retiree>1</retiree>
20. <war>0</war>
21. <warEquated>0</warEquated>
22. <motherWManyChildren>0</motherWManyChildren>
23. <disabled>0</disabled>
24. <unemployed>0</unemployed>
25. <breadwinnerLoss>0</breadwinnerLoss>
26. <care1yr>0</care1yr>
27. <careDisabledChild>0</careDisabledChild>
28. </ResponseInfoPersonStatus>
29. </data>
30. </responseData>
31. </response>
32. </return>
33. </ns2:getPersonSocialStatusResponse>
34. </soap:Body>
35. </soap:Envelope>
Обработка исключений метода getPersonSocialStatus
При обработке запроса метод getPersonSocialStatus сервиса PersonStatusImplService может возвращать следующие виды ошибок/исключений/сообщений: [Показать ответ]
| Наименование вышестоящего элемента
|
Наименование элемента
|
Тип
|
Размерность
|
Описание
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|