В данной статье описывается принцип работы сервиса по получению сведений о социальном статусе физического лица (далее - Сервис) посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных 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. Состав данных запроса на получение информации: [Показать ответ]
| №
|
Наименование
|
Поле
|
Формат
|
Обязательность
|
Примечание
|
| 1
|
ИИН субъекта
|
iin
|
xs:string
|
Да
|
Значение должно содержать 12 цифр
|
| 2
|
Номер запроса
|
requestNumber
|
xs:string
|
Да
|
Значение поля должно быть уникальным и не должно повторяться при каждом запросе
|
| 3
|
Согласие субъекта на запрос данных
|
consentConfirmed
|
xs:boolean
|
Да
|
Возможные значения:
- true;
- false.
|
| 4
|
Токен КДП
|
token
|
xs:string
|
Да
|
Наличие согласия субъекта на предоставление информации из ГБД
|
Метод getPersonSocialStatusUseToken
Метод getPersonSocialStatusUseToken сервиса PersonStatusImplService предназначен для получения сведений о социальном статусе физического лица. Данный метод вызывается с помощью ключа безопасности «Токен».
Таблица 2. Состав данных запроса на получение информации [Показать ответ]
| №
|
Наименование
|
Поле
|
Формат
|
Обязательность
|
Примечание
|
| 1
|
ИИН субъекта
|
iin
|
xs:string
|
Да
|
Значение должно содержать 12 цифр
|
| 2
|
Номер запроса
|
requestNumber
|
xs:string
|
Да
|
Значение поля должно быть уникальным и не должно повторяться при каждом запросе
|
| 3
|
Токен КДП
|
token
|
xs:string
|
Да
|
Наличие согласия субъекта на предоставление информации из ГБД
|
Таблица 3. Состав данных ответа на запрос получения информации [Показать ответ]
| №
|
Наименование
|
Поле
|
Формат
|
Обязательность
|
Примечание
|
| 1
|
Ответ на запрос
|
response
|
SyncsendMessageResponse
|
Да
|
|
| 2
|
Метаданные ответа
|
responseInfo
|
SyncsendMessageResponse
|
Да
|
|
| 3
|
Идентификатор сообщения в системе получателя
|
messageId
|
xs:string
|
Да
|
|
| 4
|
Идентификатор цепочки сообщения в системе получателя запроса
|
correlationId
|
xs:string
|
Нет
|
|
| 5
|
Дата ответа в системе получателя запроса
|
responseDate
|
xs:dateTime
|
Да
|
|
| 6
|
Объект «Информация о статусе»
|
status
|
StatusInfo
|
Да
|
|
| 6.1
|
Код статуса
|
code
|
xs:string
|
Да
|
|
| 6.2
|
Сообщение о статусе
|
message
|
xs:string
|
Да
|
|
| 7
|
Идентификатор сессии
|
sessionId
|
Guid
|
Да
|
|
| 8
|
Объект «Данные ответа»
|
responseData
|
DataInfo
|
Да
|
|
| 9
|
Объект «Данные сообщения»
|
data
|
xs:Anytype
|
Нет
|
|
| №
|
Наименование
|
Поле
|
Формат
|
Обязательность
|
Примечание
|
| Возвращаемая информация по социальному статусу ФЛ
(ResponseInfoPersonStatus)
|
| 1
|
Пенсионеры
|
retiree
|
xs:boolean
|
Да
|
0/1
|
| 2
|
Участники и инвалиды ВОВ
|
war
|
xs:boolean
|
Да
|
0/1
|
| 3
|
Лица, приравненные по льготам и гарантиям к участникам и инвалидам ВОВ
|
warEquated
|
xs:boolean
|
Да
|
0/1
|
| 4
|
Многодетные матери, награжденные подвесками «Алтын алқа», «Күміс алқа» или получившие
ранее звание «Мать-героиня», а также награжденные орденами «Материнская слава» I и II степени
|
motherWManyChildren
|
xs:boolean
|
Да
|
0/1
|
| 5
|
Лица, имеющие группу инвалидности
|
disabled
|
xs:boolean
|
Да
|
0/1
|
| 6
|
Лица, зарегистрированные в качестве безработных
|
unemployed
|
xs:boolean
|
Да
|
0/1
|
| 7
|
Лица, потерявшие кормильца
|
breadwinnerLoss
|
xs:boolean
|
Да
|
0/1
|
| 8
|
Получатели выплаты по уходу за ребенком в возрасте до 1 года
|
care1yr
|
xs:boolean
|
Да
|
0/1
|
| 9
|
Пособие воспитывающему ребенка-инвалида
|
careDisabledChild
|
xs:boolean
|
Да
|
0/1
|
Пример вызова метода 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>
Пример вызова метода getPersonSocialStatusUseToken сервиса 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></soapenv:Header>
4. <soapenv:Body>
5. <data:getPersonSocialStatusUseToken>
6. <requestNumber>номер запроса</requestNumber>
7. <iin>ИИН субъекта</iin>
8. <token>Токен КДП</token>
9. <consentConfirmed>Согласие субъекта</consentConfirmed>
10. </data:getPersonSocialStatusUseToken>
11. </soapenv:Body>
12. </soapenv:Envelope>
Пример ответа сервиса:
Пример ответа на вызов методов getPersonSocialStatus и getPersonSocialStatusUseToken сервиса 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 и getPersonSocialStatusUseToken сервиса PersonStatusImplService может возвращать следующие виды ошибок/исключений/сообщений: [Показать ответ]
| Код/Текст ошибки/сообщения
|
Описание ошибки/сообщения
|
Примечание
|
| SBF-VE-8
|
Номер "ИИН" должен содержать 12 цифр
|
|
| VAL-JSR-001
|
Обязательное поле "%s" отсутствует
|
|
| ScbSystemFault
|
Пользователь «%s» не имеет прав для выполнения действия
|
|
| FAULT-015
|
Сервис на стороне ГБД не доступен
|
|
| VAL-R-004
|
Для получения отчета необходимо подтвердить согласие субъекта на запрос его данных из ГБД
|
|