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

Материал из Wiki ГКБ
Перейти к навигации Перейти к поиску
Главная страница Предыдущая страница



В данной статье описывается сервис по получению данных (далее – Сервис) из базы данных «Автомобиль» автоматизированной информационной системы «Сервисный центр» Министерства внутренних дел Республики Казахстан (далее – БД Авто) посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных 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 Сервис на стороне ГБД не доступен
Нет действующих транспортных средств по данному ИИН/БИН Возникает в случае, если не найдено ни одно ТС по указан­ному ИИН/БИН
Источник — https://wiki.gkb.kz/?title=Сервис_«Автомобиль»&oldid=5983