Сервис «Автомобиль»

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

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

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

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

Сервис AutoDetailsImplService предназначен для получения сведений по ТС и владельцам ТС.

Адреса web сервисов:
Продуктивный сервис	https://scbws.mkb.kz/gbdServices/AutoDetailsImplService?wsdl
Метод сервиса:	getAuto

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

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

Http Headers: {Authorization=[Basic jUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}

SOAP Message: [Показать ответ]

<syntaxhighlight lang="xml" line="1">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz">  
	<soapenv:Header>  
		<userId>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</userId>
	</soapenv:Header>
	<soapenv:Body>
		<data:getAuto/>  
	</soapenv:Body>
</soapenv:Envelope>

где c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2 - есть значение HTTP Header, представляющее собой ID клиента и его пароль в формате «clientId:password» и кодировке Base64 как того требует механизм Basic Authentication.

Метод getAuto

---

Метод getAuto предназначен для получения сведений о зарегистрированных ТС и их владельцах.

Состав данных запроса на получение информации из БД Авто: [Показать ответ]

№	Наименование	Формат	Поле	Размерность	Обязательность	Примечание
1	ИИН/БИН	xs: string	iinBin	12	Да	Для получения информа­ции по физическому лицу поле за­полняется значе­нием ИИН. Для получения информа­ции по юридическому лицу поле заполняется значе­нием БИН.

Состав данных ответа на запрос получения информации из БД Авто: [Показать ответ]

№	Наименование	Формат	Поле	Примечание
1	Государственный номерной знак (ГНЗ)	xs:string	autoRegNum
2	Прежний ГНЗ	xs:string	autoRegNumOld
3	Марка, модель, модификация ТС	xs:string	autoModel
4	Год выпуска ТС	xs:string	autoYear
5	Номер двигателя ТС	xs:string	motorNum
6	Номер шасси ТС	xs:string	chassisNum
7	Номер кузова ТС (VIN ТС)	xs:string	bodyNum
8	Цвет (код из справочника)	xs:string	autoColor
9	Цвет	xs:string	autoColorName	Текстовое наиме­но­ва­ние спра­воч­ника
10	Серия и номер СРТС	xs:string	SRTSSerNum
11	Категория ТС ("A","B","C","D","E","F")	xs:string	autoCategory
12	Мощность двигателя (кВт)	xs:string	motorPower1
13	Мощность двигателя (л.с.)	xs:string	motorPower2
14	Объем двигателя (куб. см)	xs:string	motorVolume
15	Разрешенная максимальная масса	xs:string	autoTonnageMax
16	Масса без нагрузки	xs:string	autoWeight
17	Код документа, подтверждающего законность приобретения ТС ("A","B","C" - "M")	xs:string	docPurchaseCode
18	Номер документа, подтверждающего законность приобретения ТС, дата его выдачи	xs:string	docPurchaseNumDate
19	Серия и номер прежнего СРТС	xs:string	SRTSSerNumOld
20	Дата распечатки СРТС	xs:date	SRTSDate
21	Количество посадочных мест	xs:string	СountPlacesBus
22	Фамилия/Наименование ЮЛ	xs:string	lastName/Name
23	Имя/Код юридического лица	xs:string	firstName/companyCode
24	Отчество/Ведомство ЮЛ	xs:string	middleName/companyDep
25	Серия документа, подтверждающего лич­ность владельца ТС	xs:string	docSer	Только для ФЛ
26	Код документа, подтверждающего лич­ность владельца ТС ("1" - паспорт, "2" -удостоверение личности)	xs:string	docType	Только для ФЛ
27	Дата выдачи документа, подтверждаю­щего личность владельца ТС	xs:date	docDate	Только для ФЛ
28	Номер документа, подтверждающего лич­ность владельца ТС	xs:string	docNum	Только для ФЛ
29	Серия водительского удостоверения вла­дельца СРТС/водителя	xs:string	drivingDocSer
30	Номер водительского удостоверения вла­дельца СРТС/водителя	xs:string	drivingDocNum
31	Код области КАТО владельца ТС	xs:string	areaCode
32	Код района КАТО владельца ТС	xs:string	districtCode
33	Код населенного пункта КАТО владельца ТС	xs:string	cityCode
34	Улица местожительства/местонахождения владельца СРТС	xs:string	streetName
35	Номер дома, корпус местожитель­ства/местонахождения владельца СРТС	xs:string	dom
36	Номер квартиры, комнаты местожитель­ства/местонахождения СРТС	xs:string	apartment
37	Телефонный номер владельца СРТС	xs:string	contactPrefix
38	Код ГНЗ (3 цифры)	xs:string	autoRegNumCode
39	Тип субъекта (ФЛ/ЮЛ)	xs:string	isPersonApplicant	"1" – ЮЛ "2" – ФЛ
40	Код типа ТС (6 цифр)	xs:string	autoType
41	Код национальности	xs:string	national
42	Пол	xs:string	gender	"1" – мужской "2" – женский
43	РНН	xs:string	rnn
44	ИИН/БИН	xs:string	IIN
45	Особые отметки	xs:string	notes
46	Адрес владельца ТС	xs:string	ownerKato
47	Дата рождения владельца ТС	xs:date	birthDate
48	Статус карточки	xs:string	status	P – на учете
49	Дата присвоения статуса	xs:date	statusDate
50	Дата первичной регистрации ТС	xs:date	autoFirstRegDate

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

---

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

 1	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">  
 2	   <soapenv:Header>  
 3	<!--ID пользователя, от имени которого будет выполнена запрашиваемая операция-->  
 4	        <userId>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</userId>  
 5	   </soapenv:Header>  
 6	   <soapenv:Body>  
 7	      <data:getAuto>  
 8	         <!--Optional:-->  
 9	         <iinBin>ИИН(для ФЛ)/БИН(для ЮЛ)</iinBin>  
10	      </data:getAuto>  
11	   </soapenv:Body>  
12	</soapenv:Envelope>

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

1 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

2	   <soap:Body>  
3	      <ns2:getAutoResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/">  
4	         <return>  
5	            <responseInfo>  
6	               <status>Message has been processed successfully</status>  
7	            </responseInfo>  
8	            <responseData>  
9	               <item>  

10 <IdNumNikad/> 11 <autoRegNum>111JJJ05</autoRegNum> 12 <autoRegNumOld>A111HD</autoRegNumOld> 13 <autoModel>SKODA OCTAVIA A4</autoModel> 14 <autoYear>2006</autoYear> 15 <motorNum>APK949180</motorNum> 16 <chassisNum/> 17 <BodyNum>TMBDE41U468864389</BodyNum> 18 <autoColor>0J01000</autoColor> 19 <autoColorName>СЕРЫЙ МЕТАЛЛИК</autoColorName> 20 <SrtsSerNum>BA00339515</SrtsSerNum> 21 <autoCategory>B</autoCategory> 22 <motorPower1>85</motorPower1> 23 <motorPower2>115</motorPower2> 24 <motorVolume>1984</motorVolume> 25 <autoTonnageMax>1850</autoTonnageMax> 26 <autoWeight>1395</autoWeight> 27 <docPurchaseCode>D</docPurchaseCode> 28 <docPurchaseNumDate>24/12/13</docPurchaseNumDate> 29 <SRTSSerNumOld>AF00281311</SRTSSerNumOld> 30 <SRTSDate>2014-01-14</SRTSDate> 31 <CountPlacesBus>0</CountPlacesBus> 32 <LastName>ПУПКИН</LastName> 33 <FirstName>ВАСИЛИЙ</FirstName> 34 <MiddleName>ИВАНОВИЧ</MiddleName> 35 <docSer/> 36 <docType>2</docType> 37 <docDate>2007-11-09</docDate> 38 <docNum>123456789</docNum> 39 <drivingDocSer/> 40 <drivingDocNum/> 41 <areaCode>190000000</areaCode> 42 <districtCode>196800000</districtCode> 43 <cityCode>196855100</cityCode> 44 <streetName>СОЛНЕЧНАЯ</streetName> 45 <dom>4/3</dom> 46 <apartment/> 47 <contactPrefix/> 48 <autoRegNumCode>120</autoRegNumCode> 49 <isPersonApplicant>2</isPersonApplicant> 50 <autoType>240000</autoType> 51 <National>005</National> 52 <gender>1</gender> 53 <RNN/> 54 <IIN>123456789012</IIN> 55 <OsobOtmetki>ДКП 24/12/13, кВт 85 ХЭТЧБЕК</OsobOtmetki> 56 <ownerKato>196855100</ownerKato> 57 <birthDate>1982-12-30</birthDate> 58 <status>P</status> 59 <statusDate>2014-01-14</statusDate> 60 <autoFirstRegDate>2006-05-03</autoFirstRegDate> 61 </item> 62 </responseData> 63 </return> 64 </ns2:getAutoResponse> 65 </soap:Body> 66 </soap:Envelope>

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

1		<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
2	   <soap:Body>  
3	      <ns2:getAutoResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/">  
4	         <return>  
5	            <responseInfo>  
6	               <status>Message has been processed successfully</status>  
7	            </responseInfo>  
8	            <responseData>  
9	               <item>  

10 <IdNumNikad/> 11 <autoRegNum>002AA02</autoRegNum> 12 <autoRegNumOld>A001AA</autoRegNumOld> 13 <autoModel>ВАЗ 21214-187</autoModel> 14 <autoYear>2011</autoYear> 15 <motorNum/> 16 <chassisNum/> 17 <BodyNum>XTA323251B2002573</BodyNum> 18 <autoColor>0I00000</autoColor> 19 <autoColorName>БЕЛЫЙ</autoColorName> 20 <SrtsSerNum>FE71117222</SrtsSerNum> 21 <autoCategory>B</autoCategory> 22 <motorPower1>59</motorPower1> 23 <motorPower2>80</motorPower2> 24 <motorVolume>1690</motorVolume> 25 <autoTonnageMax>1610</autoTonnageMax> 26 <autoWeight>1210</autoWeight> 27 <docPurchaseCode>Q</docPurchaseCode> 28 <docPurchaseNumDate>FE60004890</docPurchaseNumDate> 29 <SRTSSerNumOld>FE60004890</SRTSSerNumOld> 30 <SRTSDate>2017-01-18</SRTSDate> 31 <CountPlacesBus/> 32 <LastName>ТОО 'ВАСИЛЁК'</LastName> 33 <FirstName/> 34 <MiddleName/> 35 <docSer/> 36 <docType>2</docType> 37 <docDate>1999-12-30</docDate> 38 <docNum/> 39 <drivingDocSer/> 40 <drivingDocNum/> 41 <areaCode>630000000</areaCode> 42 <districtCode>632000000</districtCode> 43 <cityCode>632010000</cityCode> 44 <streetName>САДОВАЯ</streetName> 45 <dom>18/1</dom> 46 <apartment/> 47 <contactPrefix/> 48 <autoRegNumCode>119</autoRegNumCode> 49 <isPersonApplicant>1</isPersonApplicant> 50 <autoType>240000</autoType> 51 <National>005</National> 52 <gender>1</gender> 53 <RNN/> 54 <IIN>123456789012</IIN> 55 <OsobOtmetki>кВт 59</OsobOtmetki> 56 <ownerKato>632010000</ownerKato> 57 <birthDate>1983-12-30</birthDate> 58 <status>P</status> 59 <statusDate>2017-01-18</statusDate> 60 <autoFirstRegDate>2011-03-04</autoFirstRegDate> 61 </item> 62 </responseData> 63 </return> 64 </ns2:getAutoResponse> 65 </soap:Body> 66 </soap:Envelope>

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

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

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