Сервис «База мобильных граждан»

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

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

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

Описание сервиса VerifyPhoneInfoImplService

Адреса web сервисов:	Наименование элемента
Тестовый сервис	https://testscbws.mkb.kz/gbdServices/VerifyPhoneInfoImplService?wsdl
Продуктивный сервис	https://scbws.mkb.kz/gbdServices/VerifyPhoneInfoImplService?wsdl
Метод сервиса:	getVerifyPhoneInfo

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

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

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

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:getVerifyPhoneInfo/>
7.	 </soapenv:Body>
8.	</soapenv:Envelope>

Метод getVerifyPhoneInfo

Метод getVerifyPhoneInfo сервиса VerifyPhoneInfoImplService предназначен для получения верифицированных сведений о физических лицах.

---

Таблица 1. Состав данных запроса на получение информации [Показать ответ]

№	Наименование	Поле	Формат	Обяза­тельность	Примечание
1	ИИН субъекта	iin	xs:string	Да	Значение должно со­держать 12 цифр
2	Номер мобильного телефона	phone	xs:string	Да	Значение поля должно передаваться в формате: 7xxxxxxxxxx
3	Номер запроса	requestNumber	xs:string	Да	Значение поля должно быть уникаль­ным и не должно повторяться при каждом за­просе.
4	Согласие субъекта на запрос данных	consentConfirmed	xs:boolean	Да	Возможные значения: - true; - false.

Таблица 2. Состав данных ответа на запрос получения информации [Показать ответ]

№	Наименование	Поле	Формат	Обяза­тельность	Примечание
Возвращаемая информация по верификации физического лица (responseData/data)
1	Результат верификации	result	xs:boolean	Да	Возвращаемые значения: - true; -false.

Пример вызова метода getVerifyPhoneInfo

---

Пример вызова метода getVerifyPhoneInfo сервиса с помощью SOAP запроса имеет следующий вид: [Показать ответ]

1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
2.	    <soapenv:Header>
3.	    <userId>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</userId></soapenv:Header>
4.	   <soapenv:Body>
5.	      <data:getVerifyPhoneInfo>
6.	         <iin>xxxxxxxxxxxx</iin>
7.	         <phone>71111111111</phone>
8.	         <requestNumber>123</requestNumber>
9.	         <consentConfirmed>true</consentConfirmed>
10.	      </data:getVerifyPhoneInfo>
11.	   </soapenv:Body>
12.	</soapenv:Envelope>

Пример ответа на вызов метода getVerifyPhoneInfo

---

Пример ответа на вызов метода getVerifyPhoneInfo сервиса с помощью SOAP запроса имеет следующий вид: [Показать ответ]

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2.	   <soap:Body>
3.	      <ns2:getVerifyPhoneInfoResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/" xmlns:ns3="http://bip.bee.kz/SyncChannel/v10/Types">
4.	         <return>
5.	            <response>
6.	               <responseInfo>
7.	                  <messageId>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</messageId>
8.	                  <responseDate>2021-11-05T12:54:01.163Z</responseDate>
9.	                  <status>
10.	                     <code>1</code>
11.	                     <message>success</message>
12.	                  </status>
13.	               </responseInfo>
14.	               <responseData>
15.	                  <data xsi:type="ns6:verifyPhoneResponse" xmlns:ns4="http://mgov.bee.kz/mbc/v6" xmlns:ns6="http://kz.nitec.mgov/mbc/verifyphone" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
16.	                     <result>true</result>
17.	                  </data>
18.	               </responseData>
19.	            </response>
20.	         </return>
21.	      </ns2:getVerifyPhoneInfoResponse>
22.	   </soap:Body>
23.	</soap:Envelope>

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

---

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

Код/Текст ошибки/сообщения	Описание ошибки/сообщения	Примечание
SBF-VE-8	Номер "ИИН" должен содержать 12 цифр
VAL-JSR-001	Значение обязательного поля "%s" не должно быть пустым
VAL-JSR-001	Обязательное поле "%s" отсутствует
ScbSystemFault	Пользователь %s не имеет прав для вы­пол­нения действия
FAULT-015	Сервис на стороне ГБД не досту­пен
VAL-R-004	Для получения отчета необходимо подтвер­дить согласие субъекта на запрос его данных из ГБД