Версия от 10:11, 21 декабря 2023
В данной статье описывается принцип работы сервиса, по предварительной проверке соответствия выплатам по ОСНС посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.
Сервис по предварительной проверке соответствия выплатам по ОСНС
При вызове веб-сервиса обязательно указываются следующие параметры:
- 1. ID и пароль клиента (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.
- 2. ID пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:
Http Headers: {Authorization=[Basic c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}
Метод preCheckRequest
Сервис по предварительной проверке соответствия выплатам по ОСНС
Состав данных запроса preCheckRequest: [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
1
|
Идентификационный номер пользователя
|
userId
|
xs:string
|
2
|
Текущее время запроса
|
requestDate
|
xs:string
|
3
|
Идентификатор запроса
|
requestId
|
xs:string
|
4
|
ИИН физического лица
|
iin
|
xs:string
|
5
|
Токен безопасности
|
token
|
xs:string
|
|
Состав данных ответа preCheckRequest: [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
Примечание
|
1
|
Идентификатор сообщения
|
messageId
|
xs:string
|
|
2
|
Дата ответа
|
responseDate
|
xs:string
|
|
3
|
Код
|
code
|
xs:string
|
1-положительно
2-ошибка
|
4
|
Сообщение
|
message
|
xs:string
|
|
5
|
Идентификатор сообщения
|
sessionId
|
xs:string
|
|
6
|
Значение текста из справочника
|
descrition
|
xs:string
|
При отправке кода статуса-2 будет отображен текст ошибки
|
|
Пример вызова метода preCheckRequest: [Показать ответ]
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
<soapenv:Header>
<userId>хххххххх-ххххххх-ххххххх</userId>
</soapenv:Header>
<soapenv:Body>
<data:preCheckRequest>
<requestDate>2008-09-29</requestDate>
<requestId>473218470321</requestId>
<iin>110505005005</iin>
<token>string</token>
</data:preCheckRequest>
</soapenv:Body>
</soapenv:Envelope>
Пример ответа на вызов метода preCheckRequest: [Показать ответ]
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:preCheckRequestResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
<return>
<response>
<responseInfo>
<messageId>af8114a7-d49c-407f-a57f-f662dd4d74cd</messageId>
<correlationId/>
<responseDate>2023-12-20T16:52:22.205+06:00</responseDate>
<status>
<code>SCSS001</code>
<message>Message has been processed successfully</message>
</status>
<sessionId>{73fee4d2-fcae-42b8-b866-e43a892cc2da}</sessionId>
</responseInfo>
<responseData>
<data xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><![CDATA[<?xml version="1.0" encoding="UTF-8" standalone="no"?><tns:response xmlns:tns="http://mtczn.kz"> <responseDate>2023-12-20T16:52:22</responseDate> <requestId>473218470321</requestId> <responseStatus> <code>005</code> <descrition>Аналогичный запрос уже существует</descrition> </responseStatus><ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#"><ds:SignedInfo><ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/><ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34310-gost34311"/><ds:Reference URI=""><ds:Transforms><ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/></ds:Transforms><ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34311"/><ds:DigestValue>dXT0X+WCEEggHoh2xKJJXii8eV6gQN53cjvO596j1dA=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue>BvRpg+rpve/B6eIhuKtPrqAM6THHEo6rmu/10QmfIFFL3NhPtj4Fr4DbKhKpXweUPlT8NTX1wwjSqkcQYKjaiA==</ds:SignatureValue><ds:KeyInfo><ds:X509Data><ds:X509Certificate>MIIFBjCCBLCgAwIBAgIUdXR6dqnqeE0s14eT7k8z/Ocal2MwDQYJKoMOAwoBAQECBQAwUzELMAkGA1UEBhMCS1oxRDBCBgNVBAMMO9Kw0JvQotCi0KvSmiDQmtCj05jQm9CQ0J3QlNCr0KDQo9Co0Ksg0J7QoNCi0JDQm9Cr0pogKEdPU1QpMB4XDTIzMDcxMTAzNDM0MFoXDTI0MDcxMDAzNDM0MFowggGNMSIwIAYDVQQDDBnQntCh0J/QkNCd0J7QkiDQldCg0JHQntCbMRcwFQYDVQQEDA7QntCh0J/QkNCd0J7QkjEYMBYGA1UEBRMPSUlONzcwMTE2MzAwODgyMQswCQYDVQQGEwJLWjGBxDCBwQYDVQQKDIG50JPQvtGB0YPQtNCw0YDRgdGC0LLQtdC90L3QvtC1INGD0YfRgNC10LbQtNC10L3QuNC1ICLQnNC40L3QuNGB0YLQtdGA0YHRgtCy0L4g0YLRgNGD0LTQsCDQuCDRgdC+0YbQuNCw0LvRjNC90L7QuSDQt9Cw0YnQuNGC0Ysg0L3QsNGB0LXQu9C10L3QuNGPINCg0LXRgdC/0YPQsdC70LjQutC4INCa0LDQt9Cw0YXRgdGC0LDQvSIxGDAWBgNVBAsMD0JJTjE3MDM0MDAwMTMzOTEfMB0GA1UEKgwW0JTQo9CZ0KHQldCR0JDQldCS0JjQpzElMCMGCSqGSIb3DQEJARYWZS5vc3Bhbm92QGVuYmVrLmdvdi5rejBsMCUGCSqDDgMKAQEBATAYBgoqgw4DCgEBAQEBBgoqgw4DCgEDAQEAA0MABEB5RtmPFRxqKCylohvM902/18y6Y/T8VcSKpR/F2x5i+RJQPZSDMuxwmS0PiZBLJHwIoSAzrSOz8wlJXTo+eh9Mo4ICDjCCAgowDgYDVR0PAQH/BAQDAgbAMDMGA1UdJQQsMCoGCCsGAQUFBwMEBggqgw4DAwQBAgYJKoMOAwMEAQICBgkqgw4DAwQDAgEwXgYDVR0gBFcwVTBTBgcqgw4DAwIBMEgwIQYIKwYBBQUHAgEWFWh0dHA6Ly9wa2kuZ292Lmt6L2NwczAjBggrBgEFBQcCAjAXDBVodHRwOi8vcGtpLmdvdi5rei9jcHMwWAYDVR0fBFEwTzBNoEugSYYiaHR0cDovL2NybC5wa2kuZ292Lmt6L25jYV9nb3N0LmNybIYjaHR0cDovL2NybDEucGtpLmdvdi5rei9uY2FfZ29zdC5jcmwwXAYDVR0uBFUwUzBRoE+gTYYkaHR0cDovL2NybC5wa2kuZ292Lmt6L25jYV9kX2dvc3QuY3JshiVodHRwOi8vY3JsMS5wa2kuZ292Lmt6L25jYV9kX2dvc3QuY3JsMGMGCCsGAQUFBwEBBFcwVTAvBggrBgEFBQcwAoYjaHR0cDovL3BraS5nb3Yua3ovY2VydC9uY2FfZ29zdC5jZXIwIgYIKwYBBQUHMAGGFmh0dHA6Ly9vY3NwLnBraS5nb3Yua3owHQYDVR0OBBYEFPV0enap6nhNLNeHk+5PM/znGpdjMA8GA1UdIwQIMAaABFtqc+kwFgYGKoMOAwMFBAwwCgYIKoMOAwMFAQEwDQYJKoMOAwoBAQECBQADQQDmHB88GylfRp7G9c5fTskty8h5TieHqLxGm2AZuK5UnlyRxrn6EPvT9fHRIvEUK9t2lMTENJ2uSVYWJ1e4Q6TS</ds:X509Certificate></ds:X509Data></ds:KeyInfo></ds:Signature></tns:response>]]></data>
</responseData>
</response>
<gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</return>
</ns2:preCheckRequestResponse>
</soap:Body>
</soap:Envelope>
Метод preCheckResponse
Сервис по предварительной проверке соответствия выплатам по ОСНС
Состав данных запроса preCheckResponse: [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
1
|
Идентификационный номер пользователя
|
userId
|
xs:string
|
2
|
Текущее время запроса
|
requestDate
|
xs:string
|
3
|
Идентификатор запроса
|
requestId
|
xs:string
|
|
Состав данных ответа preCheckResponse : [Показать ответ]
№
|
Наименование
|
Поле
|
Формат
|
Примечание
|
1
|
Идентификатор сообщения
|
messageId
|
xs:string
|
|
2
|
Дата ответа
|
responseDate
|
xs:string
|
|
3
|
Отчество
|
code
|
xs:string
|
|
4
|
Сообщение
|
message
|
xs:string
|
|
5
|
Идентификатор сообщения
|
sessionId
|
xs:string
|
|
Развернутый состав данных
|
6
|
Дата ответа
|
responseDate
|
xs:string
|
|
7
|
Дата отчета
|
responseId
|
xs:string
|
|
8
|
Статус лица
|
personState
|
xs:string
|
00-Документ действителен
11-В связи со смертью гражданина
|
9
|
Статус лица
|
Leave_the_country
|
xs:string
|
Выезд за РК 1-Да
2-Нет
|
9
|
Гражданство лица
|
personCitizenship
|
xs:string
|
Гражданство РК, разрешение на ПМЖ в РК
|
10
|
Обязательные профессиональные пенсионные взносы
|
oppv
|
xs:string
|
1-не соответствует(меньше 84 месяца)
2-есть полных 84 месяца
|
11
|
БИН
|
bin
|
xs:string
|
БИН организации, которой перечислил ОППВ в последний раз
|
12
|
Период платежа
|
period
|
xs:string
|
Период платежа будет в ММГГГГ
|
13
|
Дата платежа
|
payDate
|
xs:string
|
|
14
|
Рабочие условия
|
workingConditions
|
xs:string
|
1-Расторжение с трудовым договором (вредные условия труда)
2-переход на легкие условия труда (заключение дополнительного договора)
|
15
|
Дата создания рабочих условий
|
workingConditionsDate
|
xs:string
|
Дата изменения условий труда/расторжения договора
|
16
|
Период платежа ОППВ
|
periodOppv
|
xs:string
|
1-Да (ОППВ уплачен после заключения договора ППА)
2-НЕТ (ОППВ не уплачен после заключения ППА)
|
|
Пример вызова метода preCheckResponse : [Показать ответ]
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
<soapenv:Header>
<userId>хххххххх-ххххххх-ххххххх</userId>
</soapenv:Header>
<soapenv:Body>
<data:preCheckResponse>
<requestDate>2008-09-29</requestDate>
<requestId>473218470321</requestId>
</data:preCheckResponse>
</soapenv:Body>
</soapenv:Envelope>
Пример ответа на вызов метода preCheckResponse : [Показать ответ]
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:preCheckResponseResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
<return>
<response>
<responseInfo>
<messageId>bcaf837d-9e19-465b-aaa7-b34ae5eca98e</messageId>
<correlationId/>
<responseDate>2023-12-20T16:51:19.065+06:00</responseDate>
<status>
<code>SCSS001</code>
<message>Message has been processed successfully</message>
</status>
<sessionId>{4fcb75db-be76-42dc-b934-76c99d00fd0c}</sessionId>
</responseInfo>
<responseData>
<data xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><![CDATA[<?xml version="1.0" encoding="UTF-8" standalone="no"?><tns:response xmlns:tns="http://mtczn.kz"> <responseDate>2023-12-20T14:11:03</responseDate> <responseId>473218470321</responseId> <person> <personState>1</personState> <personCitizenship>1</personCitizenship> <oppv>1</oppv> <bin></bin> <period>082023</period> <payDate>2023-11-06</payDate> <workingConditions>3</workingConditions> </person><ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#"><ds:SignedInfo><ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/><ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34310-gost34311"/><ds:Reference URI=""><ds:Transforms><ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/></ds:Transforms><ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gost34311"/><ds:DigestValue>KImi4rDJkXPtdR8/xlaE6ZbpU0O+GBOsgTpoIR5FuqQ=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue>594NszQacaTI6eZH8+Cs0I2Y6t86OUzvKEhOs++a6uE+plfm+MQfWRqGYAUKzigMJHuTyBgKs/KXueLkV9pVBw==</ds:SignatureValue><ds:KeyInfo><ds:X509Data><ds:X509Certificate>MIIFBjCCBLCgAwIBAgIUdXR6dqnqeE0s14eT7k8z/Ocal2MwDQYJKoMOAwoBAQECBQAwUzELMAkGA1UEBhMCS1oxRDBCBgNVBAMMO9Kw0JvQotCi0KvSmiDQmtCj05jQm9CQ0J3QlNCr0KDQo9Co0Ksg0J7QoNCi0JDQm9Cr0pogKEdPU1QpMB4XDTIzMDcxMTAzNDM0MFoXDTI0MDcxMDAzNDM0MFowggGNMSIwIAYDVQQDDBnQntCh0J/QkNCd0J7QkiDQldCg0JHQntCbMRcwFQYDVQQEDA7QntCh0J/QkNCd0J7QkjEYMBYGA1UEBRMPSUlONzcwMTE2MzAwODgyMQswCQYDVQQGEwJLWjGBxDCBwQYDVQQKDIG50JPQvtGB0YPQtNCw0YDRgdGC0LLQtdC90L3QvtC1INGD0YfRgNC10LbQtNC10L3QuNC1ICLQnNC40L3QuNGB0YLQtdGA0YHRgtCy0L4g0YLRgNGD0LTQsCDQuCDRgdC+0YbQuNCw0LvRjNC90L7QuSDQt9Cw0YnQuNGC0Ysg0L3QsNGB0LXQu9C10L3QuNGPINCg0LXRgdC/0YPQsdC70LjQutC4INCa0LDQt9Cw0YXRgdGC0LDQvSIxGDAWBgNVBAsMD0JJTjE3MDM0MDAwMTMzOTEfMB0GA1UEKgwW0JTQo9CZ0KHQldCR0JDQldCS0JjQpzElMCMGCSqGSIb3DQEJARYWZS5vc3Bhbm92QGVuYmVrLmdvdi5rejBsMCUGCSqDDgMKAQEBATAYBgoqgw4DCgEBAQEBBgoqgw4DCgEDAQEAA0MABEB5RtmPFRxqKCylohvM902/18y6Y/T8VcSKpR/F2x5i+RJQPZSDMuxwmS0PiZBLJHwIoSAzrSOz8wlJXTo+eh9Mo4ICDjCCAgowDgYDVR0PAQH/BAQDAgbAMDMGA1UdJQQsMCoGCCsGAQUFBwMEBggqgw4DAwQBAgYJKoMOAwMEAQICBgkqgw4DAwQDAgEwXgYDVR0gBFcwVTBTBgcqgw4DAwIBMEgwIQYIKwYBBQUHAgEWFWh0dHA6Ly9wa2kuZ292Lmt6L2NwczAjBggrBgEFBQcCAjAXDBVodHRwOi8vcGtpLmdvdi5rei9jcHMwWAYDVR0fBFEwTzBNoEugSYYiaHR0cDovL2NybC5wa2kuZ292Lmt6L25jYV9nb3N0LmNybIYjaHR0cDovL2NybDEucGtpLmdvdi5rei9uY2FfZ29zdC5jcmwwXAYDVR0uBFUwUzBRoE+gTYYkaHR0cDovL2NybC5wa2kuZ292Lmt6L25jYV9kX2dvc3QuY3JshiVodHRwOi8vY3JsMS5wa2kuZ292Lmt6L25jYV9kX2dvc3QuY3JsMGMGCCsGAQUFBwEBBFcwVTAvBggrBgEFBQcwAoYjaHR0cDovL3BraS5nb3Yua3ovY2VydC9uY2FfZ29zdC5jZXIwIgYIKwYBBQUHMAGGFmh0dHA6Ly9vY3NwLnBraS5nb3Yua3owHQYDVR0OBBYEFPV0enap6nhNLNeHk+5PM/znGpdjMA8GA1UdIwQIMAaABFtqc+kwFgYGKoMOAwMFBAwwCgYIKoMOAwMFAQEwDQYJKoMOAwoBAQECBQADQQDmHB88GylfRp7G9c5fTskty8h5TieHqLxGm2AZuK5UnlyRxrn6EPvT9fHRIvEUK9t2lMTENJ2uSVYWJ1e4Q6TS</ds:X509Certificate></ds:X509Data></ds:KeyInfo></ds:Signature></tns:response>]]></data>
</responseData>
</response>
<gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</return>
</ns2:preCheckResponseResponse>
</soap:Body>
</soap:Envelope>
Обработка исключений методов preCheckRequest и preCheckResponse
При обработке запроса методов preCheckRequest
и preCheckResponse может возвращать следующие виды ошибок: [Показать ответ]
Код ошибки
|
Описание ошибки
|
SBF-AD-1
|
Пользователь %s не имеет прав для выполнения действия
|
SBF-AD-1
|
Пользователь не соответствует данному кредитору
|
SBF-AD-1
|
Пользователь %s не активен
|
FAULT-015
|
Сервис на стороне ГБД недоступен
|
FAULT-015
|
Null value exception
|
SBF-VE-8
|
Номер "ИИН/БИН" должен содержать 12 цифр
|
VAL-JSR-001
|
Обязательное поле "IIN" отсутствует
|
|