В документе описывается принцип работы сервиса по предоставления сведений о регистрации сельскохозяйственной техники посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.
Сервис предоставления информации регистрации сельскохозяйственной техники
При вызове веб-сервиса обязательно указываются следующие параметры:
1. ID и пароль клиента (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.
2. ID пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:
Метод AgentByGRST – Запрос агента по ИИН/БИН и ГРНЗ
Состав данных запроса по методу AgentByGRST
Состав данных запроса по методу AgentByGRST: [Показать ответ]
| №
|
Наименование
|
Поле |
Формат |
Обязательность
|
| 1
|
Индивидуальный идентификационный номер пользователя
|
userId
|
xs:string
|
Да
|
| 2
|
ИИН/БИН
|
iinBin
|
xs:string
|
Да
|
| 3
|
Государственный Регистрационный Номерной Знак (далее ГРНЗ)
|
GovernmentNumber
|
xs:string
|
Да
|
|
Состав данных ответа по методу AgentByGRST
Состав данных ответа по методу AgentByGRST: [Показать ответ]
| №
|
Наименование
|
Поле |
Формат
|
| 1
|
Идентификатор
|
Id
|
xs:string
|
| 2
|
Тип идентификатора
|
TypeId
|
xs:string
|
| 3
|
Тип субъекта
|
TypeName
|
xs:string
|
| 4
|
ИИН/БИН
|
IBIN
|
xs:string
|
| 5
|
Имя
|
FirstName
|
xs:string
|
| 6
|
Фамилия
|
LastName
|
xs:string
|
| 7
|
Отчество
|
Patronymic
|
xs:string
|
| 8
|
КАТО код местонахождения
|
Location
|
xs:string
|
| 9
|
Сведение собственника транспортов
|
Proprietor
|
xs:string
|
| 10
|
Сведение владельца транспортов
|
Owner
|
xs:string
|
| 11
|
Идентификатор сообщении
|
messageId
|
xs:string
|
| 12
|
Дата и время
|
responseDate
|
xs:string
|
| 13
|
Номер двигателя
|
EngineNumber
|
xs:string
|
| 14
|
ГРНЗ
|
GovernmentNumber
|
xs:string
|
| 15
|
Год выпуска
|
GraduationYear
|
xs:string
|
| 16
|
Транспортное средство арестовано
|
InArrest
|
xs:string
|
| 17
|
Транспортное средство арестовано
|
InPledge
|
xs:string
|
| 18
|
Дата регистрации транспортного средства
|
RegistrationDate
|
xs:string
|
| 19
|
Номер Тех.паспорта
|
TechPassportNumber
|
xs:string
|
| 20
|
Серия технического паспорта
|
TechPassportSeries
|
xs:string
|
| 21
|
VIN код транспортного средства
|
VIN
|
xs:string
|
| 22
|
Аррест
|
Arrest
|
xs:string
|
| 23
|
Инспекция
|
Inspection
|
xs:string
|
| 24
|
Владелец
|
Proprietor
|
xs:string
|
| 25
|
Название агрегата
|
Unit
|
xs:string
|
| 26
|
Причина инспекции
|
Cause
|
xs:string
|
| 27
|
Исправность
|
Healthy
|
xs:string
|
|
Пример вызова метода AgentByGRST с помощью SOAP
Пример вызова метода AgentByGRST с помощью SOAP запроса имеет следующий вид: [Показать ответ]
1. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
2. <soapenv:Header>
3. <data:userId>Ваш пользователь</data:userId></soapenv:Header>
4. </soapenv:Header>
5. <soapenv:Body>
6. <data:AgentByGRST>
7. <iinBin>ИИН/БИН</iinBin>
8. <GovernmentNumber>ГРНЗ</GovernmentNumber>
9. </data:AgentByGRST>
10. </soapenv:Body>
11. </soapenv:Envelope>
Пример ответа на вызов по методу AgentByGRST с помощью SOAP
Пример ответа на вызов по методу AgentByGRST с помощью SOAP запроса имеет следующий вид: [Показать ответ]
1<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2 <soap:Body>
3 <ns2:AgentByGRSTResponse 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>Идентификатор сообщении</messageId>
8 <responseDate>Дата и время</responseDate>
9 <status>
10 <code>Код</code>
11 <message>Успешно выполнен</message>
12 </status>
13 <sessionId>Сессия</sessionId>
14 </responseInfo>
15 <responseData>
16 <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="yes"?>
17<AgentByGRSTResponse xmlns="http://grst.kz/uni"/>
18<AgentData>
19 <Id>Идентификатор</Id>
20 <TypeId>Тип идентификатора</TypeId>
21 <TypeName>Физическое лицо</TypeName>
22 <IBIN>ИИН/БИН</IBIN>
23 <FirstName>Имя</FirstName>
24 <LastName>Фамилия</LastName>
25 <Patronymic>Отчество</Patronymic>
26 <Location>Расположение</Location>
27 <Proprietor/>
28 <Owner/>
29</AgentData>
30<TransportData>
31 <Id>Идентификатор</Id>
32 <EngineNumber>Номер двигателя</EngineNumber>
33 <GovernmentNumber>ГРНЗ</GovernmentNumber>
34 <GraduationYear>Год выпуска</GraduationYear>
35 <InArrest>Транспортное средство арестовано</InArrest>
36 <InPledge>false</InPledge>
37 <RegistrationDate>Дата регистрации транспортного средства</RegistrationDate>
38 <TechPassportNumber>Номер Тех.паспорта</TechPassportNumber>
39 <TechPassportSeries>Серия технического паспорта</TechPassportSeries>
40 <VIN>VIN код транспортного средства</VIN>
41 <Arrest/>
42 <Inspection/>
43 <Pledge/>
44 <Proprietor/>
45 <Owner/>
46</TransportData>
47<InspectionData>
48 <Id>Идентификатор</Id>
49 <Date>Дата инспекции транспортного средства</Date>
50 <Unit>Название агрегата</Unit>
51 <Cause>Причина инспекции</Cause>
52 <Healthy>Исправность</Healthy>
53</InspectionData>]]></data>
54 </responseData>
55 </response>
56 <gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
57 </return>
58 </ns2:AgentByGRSTResponse>
59 </soap:Body>
60</soap:Envelope>
Обработка исключений методов AgentByGRST
При обработке запроса AgentByGRST может возвращать следующие виды ошибок: [Показать ответ]
| Код ошибки
|
Описание ошибки
|
| VAL-JSR-001
|
1. Обязательное поле "%s" отсутствует
2. Значение обязательного поля "%*" не должно быть пустым
|
| FAULT-015
|
Сервис на стороне ГБД недоступен
|
|