Сервис «Передача данных о сельско-хозяйственных животных по владельцам»

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

Данный технический документ предназначается: 1) для разработчиков, которые будут осуществлять взаимодействие с информационной системой ГКБ; 2) для получателей информации.

Сервис по "Передаче данных о с/х животных по владельцам"

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

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

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

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

Http Headers: {Authorization=[Basic c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}

Состав данных запроса по методу getIszhUs:

Состав данных запроса getIszhUs: [Показать ответ]

№	Наименование	Поле	Формат	Примечание
1	Индивидуальный идентификационный номер пользователя	userId	xs:string
2	Идентификационный номер владельца ИИН/БИН	Identifier	xs:string

Состав данных ответа по методу getIszhUs:

Состав данных ответа getIszhUs: [Показать ответ]

№	Наименование	Поле	Формат	Примечание
1	Возврат	return	xs:string
2	Ответ	response	xs:string
3	Информация об ответе	responseInfo	SyncMessage InfoResponse
4	Идентификатор сообщения в системе получателя	messageId	xs:string
5	Дата ответа в системе получателя запроса	responseDate	xs:dateTime
6	Сообщение о статусе	status	StatusInfo
7	Код статуса	code	xs:string
8	Сообщение о статусе	message	xs:string
9	Идентификатор сессии	sessionId	xs:string
10	ИИН/БИН Владельца/Арендатора (по которому отправляется запрос)	EnterpriseUIN	xs:string	Уникальный идентификатор начислений
11	Животные	Animals	xs:string	Тег-родитель животного
12	ИНЖ животного	Inj	xs:string
13	ID типа животного	AnimalKindId	xs:string	1 Крупный рогатый скот 5 Лошади 6 Свиньи 7 Верблюды 8 Мелко рогатый скот 9 Козы 10 Овцы 11 Однокопытные 12 Ослы 14 Мулы 15 Пони 16 Зебра 17 Кулан 18 Маралы
14	Код типа животного	AnimalKindCode	xs:string
15	Наименование типа животного (каз)	AnimalKindNameKz	xs:string
16	Наименование типа животного (рус)	AnimalKindNameRu	xs:string
17	Дата рождения	BirthDate	xs:string
18	Порода	MastId	xs:string
19	наименование породы на казахском	MastNameKz	xs:string
20	наименование породы на русском	MastNameRu	xs:string
21	Кастрирован	Castrated	xs:string	да/нет
22	Идентификатор СЖ матери	MotherInj	xs:string
23	Кличка	Nickname	xs:string
24	Владелец	Owner	xs:string
25	Арендатор	RentOwner	xs:string	ИИН/БИН арендатора
26	Дата регистрации	RegistrationDate	xs:string
27	Идентификатор пола	GenderId	xs:string	1 Самец 2 Самка
28	Гендерный код	GenderCode	xs:string
29	гендерное имя на казахском языке	GenderNameKz	xs:string
30	гендерное имя на русском языке	GenderNameRu	xs:string
31	Половозрастная группа	AgeGroupId	xs:string
32	Код возврастной группы	AgeGroupCode	xs:string
33	Название возврастной группы на казахском языке	AgeGroupNameKz	xs:string
34	Название возврастной группы на русском языке	AgeGroupNameRu	xs:string
35	Метод идентификации	IdentId	xs:string	1Биркование 2 Таврение 3Татуировки 4 Ножные колечки 5Таврение холодным способом 6 Таврение горячим способом 7Крылометки 8Татуировки ушные 9Татуировки губные 10Чипирование
36	Код идентификации	IdentCode	xs:string
37	Наименование идентификации (каз)	IdentNameKz	xs:string
38	Наименование идентификации (рус)	IdentNameRu	xs:string
39	Племенное ли	IsBreed	xs:string	IsBreed Выбирается значение «да» или «нет
40	Кровность	BreedKindId	xs:string	1Чистопородная 2 помесь IV поколения 3 помесь III поколения 4 помесь II поколения 5 помесь I поколения 6 Не распределено по породности
41	Код племенного типа	BreedKindCode	xs:string
42	Наименование племенного типа (каз)	BreedKindNameKz	xs:string
43	Наименование племенного типа (рус)	BreedKindNameRu	xs:string
44	Класс с/х животного	ClassId	xs:string	1 Элита-рекорд 2 Элита 3 I класс 4 II класс 5 III класс 6 Внеклассное животное 7 Небонитированное животное 8 Небонитированное животное
45	Код класса	ClassCode	xs:string
46	Наименование класса (каз)	ClassNameKz	xs:string
47	Наименование класса (рус)	ClassNameRu	xs:string
48	Направление продуктивности	DirectionId	xs:string	1 верхово-упряжные 2 верховые 3 грубошерстного направления продуктивности 4 каракульские 5 молочного направления продуктивности 6 молочно-мясного направления продуктивности 7 мясного направления продуктивности 8 мясо-сального направления продуктивности 9 полугрубошерстного направления продуктивности 10 полутонкорунного направления продуктивности 11 рысистые 12 тонкорунного направления продуктивности 13 тяжелоупряжные и местные 14 яичного направления продуктивности 15 прочие 16 шерстного направления 17 пухового направления 18 сального направления 19 продуктивного направления 20 мясо-шерстного направления продуктивности 21 Мясо-шерстного длинношерстного направления 22 Мясо-шерстного короткошерстного направления 23 Смушкового направления 24 Шубного направления 25 Нет
49	Наименование направления продуктивности на казахском языке	DirectionNameKz	xs:string
50	Наименование направления продуктивности на русском языке	DirectionNameKz	xs:string
51	Импорт	Import	xs:string	да/нет
52	Идентификатор страны импортера	ImportCountryId	xs:string	Если Import=false сервис возвращает страну Казахстан
53	Идентификатор кода страны импорта	ImportCountryCode	xs:string
54	Наименование страны импорта на казахском языке	ImportCountryNameKz	xs:string
55	Наимеование страны импорта на русском языке	ImportCountryNameRu	xs:string
56	Текущий статус животного	Status	xs:string	Status Зарегистрирован -1 Снят с учета-2 Не определен 3 Передан в СПК/аренду -4
57	В залоге	IsPledged	xs:string	IsPledged Выбирается значение «да» или «нет
58	ИИН/БИН залогодержателя	pledgeeIdentifier	xs:string
59	Дата начала залога	ContractStartDate	xs:string
60	Дата окончания залога	ContractEndDate	xs:string
61	Код КАТО	TE	xs:string
62	Наименование КАТО (каз)	KatoNameKz	xs:string
63	Наименование КАТО (рус)	KatoNameRu	xs:string

Справочники ИСЖ Универсальный:

Ссылка на скачивание справочника: Справочник с/х

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

Пример вызова метода getIszhUs с помощью 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>Идентификационный номер пользователя</userId>
4.	   </soapenv:Header>
5.	   <soapenv:Body>
6.	      <data:getIszhUs>
7.	         <Identifier> Идентификационный номер владельца ИИН/БИН</Identifier>
8.	      </data:getIszhUs>
9.	   </soapenv:Body>
10.	</soapenv:Envelope>

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

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

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
2.	   <soap:Body>
3.	      <ns2:getIszhUsResponse 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>qjyU4QbM-k3rBvvt11OWcD5fKJ5jjczfTylRko0X</messageId>
8.	                  <responseDate>Дата ответа</responseDate>
9.	                  <status>
10.	                     <code>КОД</code>
11.	                     <message>Сообщение о статусе</message>
12.	                  </status>
13.	                  <sessionId>Идентификатор сессии</sessionId>
14.	               </responseInfo>
15.	               <responseData>
16.	          <data xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
17.	                     <OwnerAnimals xmlns:xsd="http://www.w3.org/2001/XMLSchema">
18.	                        <EnterpriseUIN>ИИН/БИН предприятия</EnterpriseUIN>
19.	                        <Animals>
20.	                           <Animals>
21.	                              <Inj>ИНЖ животного</Inj>
22.	                              <AnimalKindId>1</AnimalKindId>
23.	                              <AnimalKindCode>Cattle</AnimalKindCode>
24.	                              <AnimalKindNameKz>Наименование типа животного(каз)</AnimalKindNameKz>
25.	                              <AnimalKindNameRu>Наименование типа животного(рус)</AnimalKindNameRu>
26.	                              <BirthDate>Дата рождения</BirthDate>
27.	                              <MastId>Порода</MastId>
28.	                              <MastCode>Код породы</MastCode>
29.	                              <MastNameKz>наименование породы на (каз)</MastNameKz>
30.	                              <MastNameRu>наименование породы на (рус)</MastNameRu>
31.	                              <Castrated>Кастрирован да/нет</Castrated>
32.	                              <MotherInj/>
33.	                              <Nickname/>
34.	                              <Owner>ИИН/БИН арендатора</Owner>
35.	                              <RentOwner/>
36.	                              <RegistrationDate>Дата регистрации</RegistrationDate>
37.	                              <GenderId>Идентификатор пола</GenderId>
38.	                              <GenderCode>Гендерный код</GenderCode>
39.	                              <GenderNameKz>гендерное имя на казахском языке</GenderNameKz>
40.	                              <GenderNameRu>гендерное имя на русском языке</GenderNameRu>
41.	                              <AgeGroupId>Идентификатор возрастной группы</AgeGroupId>
42.	                              <AgeGroupCode>Код возврастной группы</AgeGroupCode>
43.	                              <AgeGroupNameKz>Название возврастной группы на казахском языке</AgeGroupNameKz>
44.	                              <AgeGroupNameRu>Название возврастной группы на русском языке</AgeGroupNameRu>
45.	                              <IdentId></IdentId>
46.	                              <IdentCode>BR</IdentCode>
47.	                              <IdentNameKz>Наименование идентификации(каз)</IdentNameKz>
48.	                              <IdentNameRu>Наименование идентификации(рус)</IdentNameRu>
49.	                              <IsBreed>племенное ли</IsBreed>
50.	                              <BreedKindId>0</BreedKindId>
51.	                              <BreedKindCode/>
52.	                              <BreedKindNameKz/>
53.	                              <BreedKindNameRu/>
54.	                             <ClassId>0</ClassId>
55.	                             <ClassCode/>
56.	                             <ClassNameKz/>
57.	                            <ClassNameRu/>
58.	                          <DirectionId>Направление продуктивности</DirectionId>
59.	                        <DirectionNameKz>Наименование направления продуктивности на казахском языке</DirectionNameKz>
60.	                              <DirectionNameRu>Наименоваие направления продуктивности на русском языке</DirectionNameRu>
61.	                              <Import>Импорт да/нет</Import>
62.	                              <ImportCountryId>Идентификатор страны импорта</ImportCountryId>
63.	                            <ImportCountryCode>Идентификатор кода  страны импорта  </ImportCountryCode>
64.	                           <ImportCountryNameKz>Наименование страны импорта на казахском языке</ImportCountryNameKz>
65.	                              <ImportCountryNameRu>Наимеование страны импорта на русском языке</ImportCountryNameRu>
66.	                              <Status>Текущий статус животного</Status> 
67.	                              <IsPledged>в залоге да/нет</IsPledged>
68.	                              <pledgeeIdentifier/>
69.	                              <ContractStartDate xsi:nil="true"/>
70.	                              <ContractEndDate xsi:nil="true"/>
71.	                              <TE>Код КАТО</TE>
72.	                              <KatoNameKz>Наименование КАТО(каз)</KatoNameKz>
73.	                              <KatoNameRu>Наименование КАТО(рус)</KatoNameRu>
74.	                           </Animals>
75.	                        </Animals>
76.	                     </OwnerAnimals>
77.	                  </data>
78.	               </responseData>
79.	            </response>
80.	            <gbdStatusResponse xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
81.	         </return>
82.	      </ns2:getIszhUsResponse>
83.	   </soap:Body>
84.	</soap:Envelope>

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

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

Код ошибки	Описание ошибки
VAL-JSR-001	1. Обязательное поле "%s" отсутствует 2. Значение обязательного поля "ObjectUID" не должно быть пустым
FAULT-015	Сервис на стороне ГБД недоступен
SBF-AD-1	Пользователь не соответствует данному кредитору

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

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