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

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

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

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

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

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

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

Http Headers: {Authorization=[Basic jUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}

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

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>  
4.	    </soapenv:Header>  
5.	    <soapenv:Body>  
6.	        <data:getAuto/>  
7.	    </soapenv:Body>  
8.	</soapenv:Envelope>

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

Метод 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	Номер кузова ТС	xs:string	bodyNum
8	VIN код ТС	xs:string	autoVIN
9	Цвет (код из справочника)	xs:string	autoColor
10	Цвет	xs:string	autoColorName	Текстовое наименование справочника
11	Серия и номер СРТС	xs:string	SRTSSerNum
12	Категория ТС ("A","B","C","D","E","F")	xs:string	autoCategory
13	Мощность двигателя (кВт)	xs:string	motorPower1
14	Мощность двигателя (л.с.)	xs:string	motorPower2
15	Объем двигателя (куб. см)	xs:string	motorVolume
16	Разрешенная максимальная масса	xs:string	autoTonnageMax
17	Масса без нагрузки	xs:string	autoWeight
18	Код документа, подтверждающего законность приобретения ТС ("A","B","C" - "M")	xs:string	docPurchaseCode
19	Номер документа, подтверждающего законность приобретения ТС, дата его выдачи	xs:string	docPurchaseNumDate
20	Серия и номер прежнего СРТС	xs:string	SRTSSerNumOld
21	Дата распечатки СРТС	xs:date	SRTSDate
22	Количество посадочных мест	xs:string	СountPlacesBus
23	Фамилия/Наименование ЮЛ	xs:string	lastName
24	Имя	xs:string	firstName
25	Отчество	xs:string	middleName
26	Серия документа, подтверждающего личность владельца ТС	xs:string	docSer	Только для ФЛ
27	Код документа, подтверждающего личность владельца ТС ("1" - паспорт, "2" -удостоверение личности)	xs:string	docType	Только для ФЛ
28	Дата выдачи документа, подтверждающего личность владельца ТС	xs:date	docDate	Только для ФЛ
29	Номер документа, подтверждающего личность владельца ТС	xs:string	docNum	Только для ФЛ
30	Серия водительского удостоверения владельца СРТС/водителя	xs:string	drivingDocSer
31	Номер водительского удостоверения владельца СРТС/водителя	xs:string	drivingDocNum
32	Код области КАТО владельца ТС	xs:string	areaCode
33	Код района КАТО владельца ТС	xs:string	districtCode
34	Код населенного пункта КАТО владельца ТС	xs:string	cityCode
35	Улица местожительства/местонахождения владельца СРТС	xs:string	streetName
36	Номер дома, корпус местожительства/местонахождения владельца СРТС	xs:string	dom
37	Номер квартиры, комнаты местожительства/местонахождения СРТС	xs:string	apartment
38	Телефонный номер владельца СРТС	xs:string	contactPrefix
39	Код ГНЗ (3 цифры)	xs:string	autoRegNumCode
40	Тип субъекта (ФЛ/ЮЛ)	xs:string	isPersonApplicant	"1" – ЮЛ "2" – ФЛ
41	Код типа ТС (6 цифр)	xs:string	autoType
42	Код национальности	xs:string	national
43	Пол	xs:string	gender	"1" – мужской "2" – женский
44	РНН	xs:string	RNN
45	ИИН/БИН	xs:string	IIN
46	Особые отметки	xs:string	OsobOtmetki
47	Адрес владельца ТС	xs:string	ownerKato
48	Дата рождения владельца ТС	xs:date	birthDate
49	Статус карточки	xs:string	status	P – на учёте
50	Дата присвоения статуса	xs:date	statusDate
51	Дата первичной регистрации ТС	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.	      <userId>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</userId>
4.	      </soapenv:Header>
5.	   <soapenv:Body>
6.	      <data:getAuto>
7.	         <iinBin>ИИН(для ФЛ)/БИН(для ЮЛ)</iinBin>
8.	      </data:getAuto>
9.	   </soapenv:Body>
10.	</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>777YBA02</autoRegNum>
12.	                  <autoRegNumOld>945WOA02</autoRegNumOld>
13.	                  <autoModel>TOYOTA 4RUNNER</autoModel>
14.	                  <autoYear>2008</autoYear>
15.	                  <motorNum>1GR0065398</motorNum>
16.	                  <chassisNum>-</chassisNum>
17.	                  <BodyNum>JTEBU14R530017419</BodyNum>
18.	                  <autoVIN>JTEBU14R530017419</autoVIN>
19.	                  <autoColor>0G00000</autoColor>
20.	                  <autoColorName>СИНИЙ</autoColorName>
21.	                  <SrtsSerNum>AS00372174</SrtsSerNum>
22.	                  <autoCategory>B</autoCategory>
23.	                  <motorPower1>120</motorPower1>
24.	                  <motorPower2>163</motorPower2>
25.	                  <motorVolume>4000</motorVolume>
26.	                  <autoTonnageMax>2300</autoTonnageMax>
27.	                  <autoWeight>1800</autoWeight>
28.	                  <docPurchaseCode>D</docPurchaseCode>
29.	                  <docPurchaseNumDate>AS00337102</docPurchaseNumDate>
30.	                  <SRTSSerNumOld>AS00337102</SRTSSerNumOld>
31.	                  <SRTSDate>2016-09-26</SRTSDate>
32.	                  <CountPlacesBus>4</CountPlacesBus>
33.	                  <LastName>ТЕСТОВ</LastName>
34.	                  <FirstName>ТЕСТ</FirstName>
35.	                  <MiddleName>ТЕСТОВИЧ</MiddleName>
36.	                  <docSer/>
37.	                  <docType>2</docType>
38.	                  <docDate>2013-11-05</docDate>
39.	                  <docNum>035500549</docNum>
40.	                  <drivingDocSer/>
41.	                  <drivingDocNum/>
42.	                  <areaCode>7500000004</areaCode>
43.	                  <districtCode>7513100004</districtCode>
44.	                  <cityCode>7500000004</cityCode>
45.	                  <streetName>АКСАЙ-10</streetName>
46.	                  <dom>15</dom>
47.	                  <apartment>13</apartment>
48.	                  <contactPrefix>8 (708) 777-77-77</contactPrefix>
49.	                  <autoRegNumCode>120</autoRegNumCode>
50.	                  <isPersonApplicant>2</isPersonApplicant>
51.	                  <autoType>240000</autoType>
52.	                  <National>005</National>
53.	                  <gender>1</gender>
54.	                  <RNN/>
55.	                  <IIN>850508303386</IIN>
56.	                  <OsobOtmetki>Т/П AS00337102 ПФС 26/09/2016 КВТ 120 ДЖИП</OsobOtmetki>
57.	                  <ownerKato>7513100004</ownerKato>
58.	                  <birthDate>1985-05-08</birthDate>
59.	                  <status>P</status>
60.	                  <statusDate>2016-09-26</statusDate>
61.	                  <autoFirstRegDate>2011-03-25</autoFirstRegDate>
62.	               </item>
63.	            </responseData>
64.	         </return>
65.	      </ns2:getAutoResponse>
66.	   </soap:Body>
67.	</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>007AA02</autoRegNum>
12.	                  <autoRegNumOld/>
13.	                  <autoModel>CADILLAC ESCALADE</autoModel>
14.	                  <autoYear>2018</autoYear>
15.	                  <motorNum/>
16.	                  <chassisNum>-</chassisNum>
17.	                  <BodyNum>1GYS47KL5MR486281</BodyNum>
18.	                  <autoVIN>1GYS47KL5MR486281</autoVIN>
19.	                  <autoColor>0A00000</autoColor>
20.	                  <autoColorName>ЧЕРНЫЙ</autoColorName>
21.	                  <SrtsSerNum>AP00052396</SrtsSerNum>
22.	                  <autoCategory>B</autoCategory>
23.	                  <motorPower1>306</motorPower1>
24.	                  <motorPower2>416</motorPower2>
25.	                  <motorVolume>6162</motorVolume>
26.	                  <autoTonnageMax>3231</autoTonnageMax>
27.	                  <autoWeight>2731</autoWeight>
28.	                  <docPurchaseCode>D</docPurchaseCode>
29.	                  <docPurchaseNumDate>ДТ 55302/140222/0016857</docPurchaseNumDate>
30.	                  <SRTSSerNumOld/>
31.	                  <SRTSDate>2022-02-24</SRTSDate>
32.	                  <CountPlacesBus>5</CountPlacesBus>
33.	                  <LastName>ТОО "ГКБ"</LastName>
34.	                  <FirstName>122746000336</FirstName>
35.	                  <MiddleName/>
36.	                  <docSer/>
37.	                  <docType/>
38.	                  <docNum/>
39.	                  <drivingDocSer/>
40.	                  <drivingDocNum/>
41.	                  <areaCode>7500000004</areaCode>
42.	                  <districtCode>7512100004</districtCode>
43.	                  <cityCode>7500000004</cityCode>
44.	                  <streetName>Микрорайон Шапагат</streetName>
45.	                  <dom>276</dom>
46.	                  <apartment/>
47.	                  <contactPrefix>7 (777) 777-77-77</contactPrefix>
48.	                  <autoRegNumCode>120</autoRegNumCode>
49.	                  <isPersonApplicant>1</isPersonApplicant>
50.	                  <autoType>249990</autoType>
51.	                  <National/>
52.	                  <gender/>
53.	                  <RNN/>
54.	                  <IIN>122746000336</IIN>
55.	                  <OsobOtmetki>ДТ 55302/140222/0016857 КВТ 306 ДЖИП</OsobOtmetki>
56.	                  <ownerKato>7512100004</ownerKato>
57.	                  <status>P</status>
58.	                  <statusDate>2022-02-24</statusDate>
59.	                  <autoFirstRegDate>2022-02-24</autoFirstRegDate>             
60.	               </item>
61.	            </responseData>
62.	         </return>
63.	      </ns2:getAutoResponse>
64.	   </soap:Body>
65.	</soap:Envelope>

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

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

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

Метод getAutoByKeyFields

Метод getAutoByKeyFields предназначен для получения сведений о зарегистрированных/снятых с учёта ТС по ключевым параметрам.

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

№	Наименование	Формат	Поле	Обязательность	Примечание
1	Номер запроса	xs: string	requestNumber	Да
2	Государственный регистрационный номерной знак (ГРНЗ)	xs: string	AutoRegNum	Нет
3	Номер кузова ТС	xs: string	BodyNum	Нет
4	Номер Шасси ТС	xs: string	chassisNum	Нет
5	Серия и номер СРТС	xs: string	SrtsSerNum	Нет
6	VIN код ТС	xs: string	VinCode	Нет
7	Статус карточки ТС	xs: string	status	Да	P – на учёте, S – снят с учёта.

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

№	Наименование	Формат	Поле	Примечание
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	Номер кузова ТС	xs:string	bodyNum
8	VIN код ТС	xs:string	autoVIN
9	Цвет (код из справочника)	xs:string	autoColor
10	Цвет	xs:string	autoColorName	Текстовое наименование справочника
11	Серия и номер СРТС	xs:string	SRTSSerNum
12	Категория ТС ("A","B","C","D","E","F")	xs:string	autoCategory
13	Мощность двигателя (кВт)	xs:string	motorPower1
14	Мощность двигателя (л.с.)	xs:string	motorPower2
15	Объем двигателя (куб. см)	xs:string	motorVolume
16	Разрешенная максимальная масса	xs:string	autoTonnageMax
17	Масса без нагрузки	xs:string	autoWeight
18	Серия и номер прежнего СРТС	xs:string	SRTSSerNumOld
19	Дата распечатки СРТС	xs:date	SRTSDate
20	Количество посадочных мест	xs:string	СountPlacesBus
21	Фамилия/Наименование ЮЛ	xs:string	lastName/Name
22	Код ГНЗ (3 цифры)	xs:string	autoRegNumCode
23	Код типа ТС (6 цифр)	xs:string	autoType
24	Особые отметки	xs:string	OsobOtmetki
25	Адрес владельца ТС	xs:string	ownerKato
26	Статус карточки	xs:string	status	P – на учёте, S – снят с учёта.
27	Дата присвоения статуса	xs:date	statusDate
28	Дата первичной регистрации ТС	xs:date	autoFirstRegDate

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

Пример вызова метода с помощью 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>
4.	      </soapenv:Header>
5.	   <soapenv:Body>
6.	      <data:getAutoByKeyFields>
7.	         <requestNumber></requestNumber>
8.	         <AutoRegNum></AutoRegNum>
9.	         <BodyNum></BodyNum>
10.	         <chassisNum></chassisNum>
11.	         <SrtsSerNum></SrtsSerNum>
12.	         <VinCode></VinCode>
13.	         <status></status>
14.	      </data:getAutoByKeyFields>
15.	   </soapenv:Body>
16.	</soapenv:Envelope>

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

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

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2.	   <soap:Body>
3.	      <ns2:getAutoByKeyFieldsResponse 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.	               <itemKey>
10.	                  <IdNumNikad/>
11.	                  <autoRegNum>777YBA07</autoRegNum>
12.	                  <autoRegNumOld>946WOO02</autoRegNumOld>
13.	                  <autoModel>TOYOTA 4RUNNER</autoModel>
14.	                  <autoYear>2003</autoYear>
15.	                  <motorNum>1GR0065398</motorNum>
16.	                  <chassisNum>-</chassisNum>
17.	                  <BodyNum>JTEBU14R530017419</BodyNum>
18.	                  <autoVIN>JTEBU14R530017419</autoVIN>
19.	                  <autoColor>0G00000</autoColor>
20.	                  <autoColorName>СИНИЙ</autoColorName>
21.	                  <SrtsSerNum>AS00372174</SrtsSerNum>
22.	                  <autoCategory>B</autoCategory>
23.	                  <motorPower1>120</motorPower1>
24.	                  <motorPower2>163</motorPower2>
25.	                  <motorVolume>4000</motorVolume>
26.	                  <autoTonnageMax>2300</autoTonnageMax>
27.	                  <autoWeight>1800</autoWeight>
28.	                  <SRTSSerNumOld>AS00337102</SRTSSerNumOld>
29.	                  <SRTSDate>2016-09-26</SRTSDate>
30.	                  <CountPlacesBus>4</CountPlacesBus>
31.	                  <autoRegNumCode>120</autoRegNumCode>
32.	                  <autoType>240000</autoType>
33.	                  <OsobOtmetki>Т/П AS00337102 ПФС 26/09/2016 КВТ 120 ДЖИП</OsobOtmetki>
34.	                  <ownerKato>7513100004</ownerKato>
35.	                  <status>P</status>
36.	                  <statusDate>2016-09-26</statusDate>
37.	                  <autoFirstRegDate>2011-03-25</autoFirstRegDate>
38.	               </itemKey>
39.	            </responseData>
40.	         </return>
41.	      </ns2:getAutoByKeyFieldsResponse>
42.	   </soap:Body>
43.	</soap:Envelope>

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

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

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

Справочник КАТО

Скачать справочник КАТО по состоянию на 22.06.2022

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

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

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

Содержание

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

Метод getAuto

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

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

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

Метод getAutoByKeyFields

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

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

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

Справочник КАТО

Навигация

Поиск