Сервис о регистрации в качестве безработного: различия между версиями

Версия от 12:06, 27 декабря 2023

В данной статье описывается принцип работы сервиса, предоставляющего сведения по получению справки о регистрации безработного посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.

Сервис о регистрации в качестве безработного

Адреса web сервиса:
Тестовый сервис	https://scbws.mkb.kz/mtszn/unemployed?wsdl
Продуктивный сервис	https://testscbws.mkb.kz/mtszn/unemployed?wsdl
Метод сервиса	unemployedUseToken

При вызове веб-сервиса обязательно указываются следующие параметры:

1. ID и пароль клиента (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.

2. ID пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:

Http Headers: {Authorization=[Basic c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}

Метод unemployedUseToken

Посредством данного метода предоставляется справка о регистрации безработного

Состав данных запроса unemployedUseToken: [Показать ответ]

№	Наименование	Поле	Формат
1	Идентификационный номер пользователя	userId	xs:string
2	Индивидуальный идентификационный номер	IIN	xs:string
3	Системная дата запроса	requestSystemDate	xs:string
4	Токен КДП	token	xs:string

Состав данных ответа unemployedUseToken: [Показать ответ]

№	Наименование	Поле	Формат	Примечание
1	Идентификатор сообщения в системе получателя	messageId	xs:string
2	Дата ответа	responseDate	xs:string
3	КОД	code	xs:string
4	Сообщение о статусе	message	xs:string
5	ИИН	iin	xs:string
6	Фамилия	lastName	xs:string
7	Имя	firstName	xs:string
8	Отчество	parentName	xs:string	true/false
9	зарегистрирован как Безработный	registeredAsUnemployed	xs:string	0/1 Да нет
10	Дата ответа системы	responseSystemDate	xs:string

Пример вызова метода unemployedUseToken: [Показать ответ]

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.mtszn.scb.kz/">
   <soapenv:Header>
   	<userId>хххххх-хххххх-ххххх</userId>
   </soapenv:Header>
   <soapenv:Body>
      <data:unemployedUseToken>
         <iin>ИИН</iin>
         <requestSystemDate>2020-01-08T17:25:24.286+06:00</requestSystemDate>
    <token>Токен</token>
      </data:unemployedUseToken>
   </soapenv:Body>
</soapenv:Envelope>

Пример ответа на вызов метода unemployedUseToken: [Показать ответ]

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:unemployedUseTokenResponse xmlns:ns2="http://data.mtszn.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
         <return>
            <response>
               <responseInfo>
                  <messageId>ee338e2b-9447-43ab-ae64-bc93d37a58d0</messageId>
                  <correlationId>4ba78cd8-4236-4357-b014-74d40b0c997b</correlationId>
                  <responseDate>2023-12-14T16:50:20.032+06:00</responseDate>
                  <status>
                     <code>0</code>
                     <message>Сообщение успешно обработано</message>
                  </status>
               </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"?><unemployedStatusResponse xmlns="http://services.gcvp.kz/gcvp/schemas">  <iin>011026500207</iin>  <lastName>Фамилия</lastName>  <firstName>Имя</firstName>  <parentName>Отчество</parentName>  <registeredAsUnemployed>0</registeredAsUnemployed>  <responseSystemDate>2023-12-14T16:50:20</responseSystemDate><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>XSARlRifv6Q2UVOaAdxj5gO102Ag32Qdy22Y/hItnYE=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue>RwqKS6Anymumdvdi5rejBsMCUGCSqDDgMKAQEBATAYBgoqgw4DCgEBAQEBBgoqgw4DCgEDAQEAA0MABEB5RtmPFRxqKCylohvM902/18y6Y/T8VcSKpR/F2x5i+RJQPZSDMuxwmS0PiZBLJHwIoSAzrSOz8wlJXTo+eh9Mo4ICDjCCAgowDgYDVR0PAQH/BAQDAgbAMDMGA1UdJQQsMCoGCCsGAQUFBwMEBggqgw4DAwQBAgYJKoMOAwMEAQI6nhNLNeHk+5PM/znGpdjMA8GA1UdIwQIMAaABFtqc+kwFgYGKoMOAwMFBAwwCgYIKoMOAwMFAQEwDQYJKoMOAwoBAQECBQADQQDmHB88GylfRp7G9c5fTskty8h5TieHqLxGm2AZuK5UnlyRxrn6EPvT9fHRIvEUK9t2lMTENJ2uSVYWJ1e4Q6TS</ds:X509Certificate></ds:X509Data></ds:KeyInfo></ds:Signature></unemployedStatusResponse>]]></data>
               </responseData>
            </response>
            <gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
         </return>
      </ns2:unemployedUseTokenResponse>
   </soap:Body>
</soap:Envelope>

Пример формата бизнес-данных ответа веб-сервиса на получение детальной информации: [Показать ответ]

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<unemployedStatusResponse xmlns="http://services.gcvp.kz/gcvp/schemas">
	<iin>ИИН</iin>
	<lastName>Фамилия</lastName>
	<firstName>Имя</firstName>
	<parentName>Отчество</parentName>
	<registeredAsUnemployed>0</registeredAsUnemployed>
	<responseSystemDate>2023-12-14T16:50:20</responseSystemDate>
	<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>XSARlRifv6Q2UVOaAdxj5gO102Ag32Qdy22Y/hItnYE=</ds:DigestValue>
			</ds:Reference>
		</ds:SignedInfo>
		<ds:SignatureValue>RwqKS6AnymuHi42TXeXiodJq8GcuooKv7/R1WypJox7+rtZUzIXGAA==</ds:SignatureValue>
		<ds:KeyInfo>
			<ds:X509Data>			<ds:X509Certificate>MIIFBjCCBLCgAwIBAgIUdXR6dqnqeE0s14eT7k8z/Ocal2MwDQYJKoMOAwoBAQECBQAwUzELMAkGA1UEBhMCS1oxRDBCBgNVBAMMO9Kw0JvQotCi0KvSmiDQmtCj05jQm9CQ0J3QlNCr0KDQo9Co0Ksg0J7QoNCi0JDQm9Cr0pogKEdPU1QpMB4XDTIzMDcxMTAzNDM0MFoXDTI0MDcxMDAzNDM0MFow2FfZ29zdC5jZXIwIgYIKwYBBQUHMAGGFmh0dHA6Ly9vY3NwLnBraS5nb3Yua3owHQYDVR0OBBYEFPV0enap6nhNLNeHk+5PM/znGpdjMA8GA1UdIwQIMAaABFtqc+kwFgYGKoMOAwMFBAwwCgYIKoMOAwMFAQEwDQYJKoMOAwoBAQECBQADQQDmHB88GylfRp7G9c5fTskty8h5TieHqLxGm2AZuK5UnlyRxrn6EPvT9fHRIvEUK9t2lMTENJ2uSVYWJ1e4Q6TS</ds:X509Certificate>
			</ds:X509Data>
		</ds:KeyInfo>
	</ds:Signature>
</unemployedStatusResponse>

Обработка исключений методов UnemployedUseToken

При обработке запроса метода UnemployedUseToken может возвращать следующие виды ошибок: [Показать ответ]

Код ошибки	Описание ошибки
SBF-VE-8	Номер "ИИН/БИН" должен содержать 12 цифр
VAL-JSR-001	Обязательное поле "IIN" отсутствует
SBF-AD-1	Пользователь %s не имеет прав для выполнения действия
SBF-AD-1	Пользователь не соответствует данному кредитору
SBF-AD-1	Пользователь %s не активен
FAULT-015	Сервис на стороне ГБД недоступен
FAULT-015	Ошибка обработки сообщения на стороне ГБД
FAULT-015	Null value exception
рлапрловат	Токен не валидный

Главная страница

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

Сервис о регистрации в качестве безработного: различия между версиями

Версия от 12:06, 27 декабря 2023