Технический документ для поставщиков информации Ломбард и получателей кредитных отчетов «Загрузка данных»-Ломбард

Данный документ разработан для технического описания системы «База данных кредитных историй» (далее - БДКИ) АО «Государственное кредитного бюро» (далее - ГКБ). БДКИ - это ин-формационные ресурсы кредитного бюро (программно-аппаратные средства), основанные на информационных системах и информационных процессах, соответствующих требованиям, установленным законодательством Республики Казахстан, используемые для сбора и хранения информации о кредитных историях субъектов кредитных историй, мониторинга и корректировок информации, а также для формирования кредитных историй (кредитных отчетов) и осуществления иных действий, определенных Законом о кредитных бюро.

Существует два способа загрузки данных по контрактам и субъектам:

1) Пользовательский web-интерфейс ПО БДКИ;

2) Автоматическая загрузка данных.

В данном документе описывается автоматическая загрузка данных, его методы, входные XML-файлы, примеры входных и выходных SOAP-запросов, ошибки и бизнес-логика системы. Данные для автоматической загрузки предоставляются в виде ZIP- архива, содержащего XML-файл установленного формата, либо в виде непосредственно XML-файла.

Технический документ предназначается:

1) для разработчиков, которые будут реализовать взаимодействие с системой ГКБ;

2) для поставщиков информации.

Примечание: информацию с описанием передачи данных в 1 день смотрите в разделе «6. Передача информации в 1 день».

Подключение к системе «БДКИ» через Интернет

Требования

1. Сервер или персональный компьютер с доступом в Интернет.

2. Интернет-браузер:

• Internet Explorer 10 и выше;

• Mozilla Firefox 23 и выше;

• Google Chrome 29 и выше.

3. Следующие открытые TCP порты:

• 443 – интерфейс ПО БДКИ;

• 8643 – центральный сервис аутентификации CAS.

Адреса

Веб-интерфейс (сайт):
Продуктивный сервис	https://bdki.mkb.kz/ba	модуль загрузки информации в эталонную ИС БДКИ посредством передачи пакетов в XML/ZIP форматах;
Продуктивный сервис	https://bdki.mkb.kz/chdb	модуль передачи информации в эталонную ИС БДКИ посредством ручного создания субъектов и контрактов.
Тестовый сервис	https://testbdki.mkb.kz/ba	модуль загрузки информации в тестовую ИС БДКИ посредством передачи пакетов в XML/ZIP форматах;
Тестовый сервис	https://testbdki.mkb.kz/chdb	модуль передачи информации в тестовую ИС БДКИ посредством ручного создания субъектов и контрактов.
Веб-сервис:
Продуктивный сервис	https://ws.mkb.kz/creditHistoryDataServices/BatchProcessingService?wsdl	web-сервис для автоматической загрузки пакетов в эталонную ИС БДКИ
Тестовый сервис	https://testws.mkb.kz/creditHistoryDataServices/BatchProcessingService?wsdl	web-сервис для автоматической загрузки пакетов в тестовую ИС БДКИ

Передача договоров

Для передачи кредитных договоров формируется XML-файл (подробное описание см. в разделе «3.1 Общая информация по договору»). При загрузке пакета необходимо указать тип файла со значением 1-«Кредитный договор».

Система осуществляет проверку файлов в два этапа:

1) Проверка корректности структуры файлов в соответствии с XSD-схемами;

2) Проверка бизнес-правил.

Если в файле есть и ошибочные и корректные записи, то корректные записи загружаются и сохраняются в базе, а ошибочные не попадают в систему, при этом поставщик данных получает уведомление о возникшей ошибке.

Если записи файла корректны и прошли перечисленные выше этапы проверки, то перед загрузкой информации в базу данных система проверяет, существуют ли уже субъекты и договоры, указанные в файле.

Общая информация по договору

При автоматической загрузке XML-файла, каждая запись субъекта/договора содержит признак «Вставить» (создать новый субъект/договор) либо «Обновить» (обновить данные по субъекту/договору). В одном файле может быть несколько договоров и соответственно связанных с ним субъектов.

Запись договора имеет следующую структуру: [Показать ответ]

1) Вид операции («Вставить»/«Обновить»);

2) Блок «Общая информация по договору»;

2.1) Специфические данные для договора;

3) Блок информации по обеспечениям;

4) Блок информации по субъектам (Физическое лицо);

4.1) Блок по идентификационным документам субъекта;

4.2) Блок информации по адресам субъекта;

4.3) Блок информации по контактным данным субъекта;

5) Блок информации по учетным датам.

Примечание: Все вышеуказанные блоки обязательны для заполнения.

XML пример для передачи договора: [Показать ответ]

1.	<?xml version="1.0" encoding="utf-8"?>  
2.	<Records>  
3.	    <Contract operation="2">  
4.	        <General>  
5.	            <ContractCode>Ломбард_Test_01</ContractCode>  
6.	            <AgreementNumber>Ломбард_Test_01</AgreementNumber>  
7.	            <FundingType id="2"/>  
8.	            <CreditPurpose2 id="1"/>  
9.	            <CreditObject id="03"/>  
10.	            <ContractPhase id="5"/>  
11.	            <ContractStatus id="1"/>  
12.	            <StartDate>2011-02-21</StartDate>  
13.	            <EndDate>2021-02-21</EndDate>  
14.	            <RealPaymentDate>2019-12-21</RealPaymentDate>  
15.	            <AnnualEffectiveRate>11.7</AnnualEffectiveRate>
16.	            <NominalRate>25.20</NominalRate>  
17.	            <ProlongationCount>1</ProlongationCount>  
18.	            <BranchLocation katoId="710000000"/>  
19.	            <Address katoId="750000000" typeId="5">  
20.	                <StreetName>  
21.	                    <Text language="ru-RU">пр. Достык</Text>  
22.	                </StreetName>  
23.	                <StreetNumber>136</StreetNumber>  
24.	            </Address>  
25.	            <CriminalCase>№12000 от 15.11.2019г</CriminalCase>  
26.	            <Collaterals>  
27.	                <Collateral statusId="1" typeId="5">  
28.	                    <PledgeName>  
29.	                        <Text language="en-GB">Mobile phone</Text>  
30.	                        <Text language="ru-RU">Мобильный телефон</Text>  
31.	                        <Text language="kk-KZ">Ұялы телефон</Text>  
32.	                    </PledgeName>  
33.	                    <Value currency="KZT" typeId="5">15000.00</Value>  
34.	                    <SerialNumber>45222</SerialNumber>  
35.	                    <Model>Samsung</Model>  
36.	                    <State id="1"/>  
37.	                    <Weight unitId="2">23.50</Weight>  
38.	                    <Colour>белый</Colour>  
39.	                    <Measurement>  
40.	                        <Length unitId="1">15.40</Length>  
41.	                        <Width unitId="1">12.05</Width>  
42.	                    </Measurement>  
43.	                    <ProductionDate>2018-02-15</ProductionDate>  
44.	                </Collateral>  
45.	            </Collaterals>  
46.	            <Subjects>  
47.	                <Subject roleId="1">  
48.	                    <Entity>  
49.	                        <Individual>  
50.	                            <FirstName>  
51.	                                <Text language="ru-RU">ИМЯ</Text>  
52.	                            </FirstName>  
53.	                            <Surname>  
54.	                                <Text language="ru-RU">ФАМИЛИЯ</Text>  
55.	                            </Surname>  
56.	                            <FathersName>  
57.	                                <Text language="ru-RU">ОТЧЕСТВО</Text>  
58.	                            </FathersName>  
59.	                            <Gender>F</Gender>  
60.	                            <Residency id="1"/>  
61.	                            <DateOfBirth>1989-01-01</DateOfBirth>  
62.	                            <NegativeStatus id="11"/>  
63.	                            <Citizenship id="110"/>  
64.	                            <Identifications>  
65.	                                <Identification rank="1" typeId="14">  
66.	                                    <Number>890101402472</Number>  
67.	                                    <IssueDate>2011-02-21</IssueDate>  
68.	                                </Identification>  
69.	                                <Identification rank="2" typeId="7">  
70.	                                    <Number>123456789</Number>  
71.	                                    <IssueDate>2009-02-21</IssueDate>  
72.	                                </Identification>  
73.	                            </Identifications>  
74.	                            <Addresses>  
75.	                                <Address katoId="750000000" locationId="110" typeId="1">  
76.	                                    <StreetName>  
77.	                                        <Text language="ru-RU">пр. Достык</Text>  
78.	                                    </StreetName>  
79.	                                    <StreetNumber>136</StreetNumber>  
80.	                                    <AdditionalInformation>Доп. информация</AdditionalInformation>  
81.	                                </Address>  
82.	                                <Address katoId="750000000" locationId="110" typeId="6">  
83.	                                    <StreetName>  
84.	                                        <Text language="ru-RU">пр. Достык</Text>  
85.	                                    </StreetName>  
86.	                                    <StreetNumber>136</StreetNumber>  
87.	                                    <AdditionalInformation>Доп. информация</AdditionalInformation>  
88.	                                </Address>  
89.	                            </Addresses>  
90.	                            <Communications>  
91.	                                <Communication typeId="3">87019303855</Communication>  
92.	                                <Communication typeId="2">87271234567</Communication>  
93.	                                <Communication typeId="1">87271234589</Communication>  
94.	                            </Communications>  
95.	                        </Individual>  
96.	                    </Entity>  
97.	                </Subject>  
98.	            </Subjects>  
99.	        </General>  
100.	        <Type>  
101.	            <Credit>  
102.	                <CreditLimit currency="KZT">15000.00</CreditLimit>  
103.	                <RecordsList>  
104.	                    <Record accountingDate="2019-12-27">  
105.	                        <ResidualAmount currency="KZT">0</ResidualAmount>  
106.	                        <OverdueInstalmentCount>0</OverdueInstalmentCount>  
107.	                        <OverdueAmount currency="KZT">0.00</OverdueAmount>  
108.	                        <ProlongationEndDate>2019-12-25</ProlongationEndDate>  
109.	                        <LastPaymentDate>2020-12-01</LastPaymentDate>  
110.	                    </Record>  
111.	                </RecordsList>  
112.	            </Credit>  
113.	        </Type>  
114.	    </Contract>  
115.	</Records>

Примечание: данные, предоставленные в XML примере, вымышленные, любые совпадения с реальными данными случайны.

Таблица 1. Общая информация по договору [Показать ответ]

№	Название тега	Наименование	Обязательность	Параметр	Тип	Комментарий
	<Records>	Тег, отвечающий за общие поля. В нем содержатся все контракты.	ДА	-	-	-
1	<Contract>	Информация о договоре	ДА	operation	Int (целое число)	Вид проводимой операции. См. справочник «Вид операции»
2	<General>	Общее поле для всех договоров	ДА	-	-	-
3	<ContractCode>	Уникальный код договора	ДА	-	String (строка)	Указывается уникальный код договора в системе поставщика информации или уникальный номер договора (ЗБ)
4	<AgreementNumber>	Номер договора	ДА	-	String (строка)	Указывается уникальный номер договора (ЗБ)
5	<FundingType>	Вид финансирования	ДА	id	Int (целое число)	См. справочник «Вид финансирования»
6	<CreditPurpose2>	Цель кредита 2	ДА	id	Int (целое число)	См. справочник «Цель кредита 2»
7	<CreditObject>	Объект кредитования	ДА	id	String (строка)	См. справочник «Объект кредитования»
8	<ContractPhase>	Фаза контракта	ДА	id	Int (целое число)	Поле "Фаза контракта" заполняется значением "5-Завершен" при полном возврате суммы микрокредита, при реализации предмета залога или переходе имущества в собственность залогодержателя. См. справочник «Фаза контракта»
9	<ContractStatus>	Статус контракта	ДА	id	Int (целое число)	См. справочник «Статус контракта»
10	<StartDate>	Дата начала срока действия контракта	ДА	-	Date (дата)	Указывается дата выдачи займа Формат: ГГГГ-ММ-ДД
11	<EndDate>	Дата окончания срока действия контракта	ДА	-	Date (дата)	Указывается дата погашения займа по ЗБ (без учета продлений срока погашения займа) Формат: ГГГГ-ММ-ДД
12	<RealPaymentDate>	Дата фактического завершения	ДА/НЕТ	-	Date (дата)	Поле заполняется при полном возврате суммы микрокредита, при реализации предмета залога или переходе имущества в собственность залогодержателя Формат: ГГГГ-ММ-ДД
13	<AnnualEffectiveRate>	Ставка вознаграждения	ДА	-	Double (десятичное число)	Указывается годовая эффективная ставка вознаграждения
14	<NominalRate>	Номинальная ставка вознаграждения	ДА	-	Double (десятичное число)	Указывается номинальная ставка вознаграждения на дату заключения договора. Поле становится обязательным для залоговых билетов, заключенных с 01-08-2021 г.
15	<ProlongationCount>	Количество пролонгаций	ДА/НЕТ	-	positiveInteger (положительное целое число)	-
16	<BranchLocation>	Местонахождение филиала	ДА	katoId	String (строка)	Заполняется только значениями КАТО из справочника «Местонахождение филиала»
17	<Address>	Фактический адрес ломбарда, в котором выдан займ	ДА	typeId	Int (целое число)	См. справочник «Тип адреса»
17	<Address>	Фактический адрес ломбарда, в котором выдан займ	ДА	katoId	String (строка)	См. справочник «Список местонахождений»
18	<StreetName>	Название улицы	ДА	-	-	-
18.1	<Text>	Текстовое поле для названия улицы	ДА	-	String (строка)	Значение поля «Название улицы» должно быть указано хотя бы на одном из трех языков. Возможные значения параметра language см. в справочнике «Поддерживаемые языки»
18.1	<Text>	Текстовое поле для названия улицы	ДА	language	String (строка)
19	<StreetNumber>	Номер дома	ДА	-	String (строка)	-
20	<CriminalCase>	Реквизиты уголовного дела	ДА/НЕТ	-	String (строка)	Указываются реквизиты уголовного дела
21	<Collaterals>	Блок информации по обеспечениям	ДА	-	-	Подробное описание см. в разделе «3.3 Записи по обеспечениям»
22	<Subjects>	Блок информации по субъектам	ДА	-	-	Подробное описание см. в разделе «3.4 Записи по субъектам физическим лицам»
23	<Type>	Блок информации по учетным датам	ДА	-	-	Подробное описание см. в разделе «3.2 Информация по учетным датам»

Информация по учетным датам

В данном разделе содержится вся специфическая информация по передаваемым учетным датам. Элемент <RecordsList> содержит учетные записи, относящиеся к договору.

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

1.	<Type>  
2.	    <Credit>  
3.	        <CreditLimit currency="KZT">15000.00</CreditLimit>  
4.	        <RecordsList>  
5.	            <Record accountingDate="2019-12-27">  
6.	                <ResidualAmount currency="KZT">15000.02</ResidualAmount>  
7.	                <OverdueInstalmentCount>0</OverdueInstalmentCount>  
8.	                <OverdueAmount currency="KZT">0.00</OverdueAmount>  
9.	                <ProlongationEndDate>2019-12-25</ProlongationEndDate>  
10.	            </Record>  
11.	        </RecordsList>  
12.	    </Credit>  
13.	</Type>

Таблица 2. Информация по передаваемой учетной дате: [Показать ответ]

№	Название тега	Наименование	Обязательность	Параметр	Тип	Комментарий
	<Type>	Начало блока по учетным датам	ДА	-	-	-
	<Credit>	Информация по учетной дате	ДА	-	-	-
1	<CreditLimit>	Сумма кредита	ДА	-	Double (десятичное число)	Значения параметра currency cм. в справочнике «Коды валют»
1	<CreditLimit>	Сумма кредита	ДА	currency	String (строка)	Значения параметра currency cм. в справочнике «Коды валют»
2	<RecordsList>	Блок информации по учетным записям	ДА	-	-	-
2.1	<Record>	Информация по учетной записи	ДА	accountingDate	Date (дата)	Формат: ГГГГ-ММ-ДД
2.1.1	<ResidualAmount>	Остаточная сумма	ДА	-	Double (десятичное число)	Значения параметра currency cм. в справочнике «Коды валют»
2.1.1	<ResidualAmount>	Остаточная сумма	ДА	currency	String (строка)	Значения параметра currency cм. в справочнике «Коды валют»
2.1.2	<OverdueInstalmentCount>	Количество дней просрочки	ДА	-	Int (целое число)	-
2.1.3	<OverdueAmount>	Сумма просроченных платежей	ДА	-	Double (десятичное число)	Значения параметра currency cм. в справочнике «Коды валют»
2.1.3	<OverdueAmount>	Сумма просроченных платежей	ДА	currency	String (строка)	Значения параметра currency cм. в справочнике «Коды валют»
3	<ProlongationEndDate>	Дата завершения пролонгации	ДА/НЕТ	-	Date (дата)	Формат: ГГГГ-ММ-ДД
4	<LastPaymentDate>	Дата последнего платежа	ДА/НЕТ		Date (дата)	Указывается дата поступления последнего платежа по договору. Поле обязательно при наличии погашения.

Записи по обеспечениям

Обеспечения по кредиту - это система гарантий возвратности кредита, используемая для погашения основного долга и процентов, причитающихся кредитору. Ценности или денежные средства, являющиеся залогом возврата должником полученных в ссуду средств и уплаты им причитающихся процентов. В данном разделе содержится вся информация о видах обеспечения.

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

1.	<Collaterals>  
2.	    <Collateral statusId="1" typeId="5">  
3.	        <PledgeName>  
4.	            <Text language="en-GB">Mobile phone</Text>  
5.	            <Text language="ru-RU">Мобильный телефон</Text>  
6.	            <Text language="kk-KZ">Ұялы телефон</Text>  
7.	        </PledgeName>  
8.	        <Value currency="KZT" typeId="1">15000.00</Value>  
9.	        <SerialNumber>45222</SerialNumber>  
10.	        <Model>Samsung</Model>  
11.	        <State id="1"/>  
12.	        <Weight unitId="2">23.50</Weight>  
13.	        <Colour>белый</Colour>  
14.	        <Measurement>  
15.	            <Length unitId="1">15.40</Length>  
16.	            <Width unitId="1">12.05</Width>  
17.	        </Measurement>  
18.	        <ProductionDate>2018-02-15</ProductionDate>  
19.	    </Collateral>  
20.	</Collaterals>

Таблица 3. Записи по обеспечениям: [Показать ответ]

№	Название тега	Наименование	Обязательность	Параметр	Тип	Комментарий
	<Collaterals>	Начало блока по обеспечениям	ДА	-	-	-
1	<Collateral>	Вид залога/заклада	ДА	typeId	Int (целое число)	См. справочник «Вид залога/заклада»
1	<Collateral>	Вид залога/заклада	ДА	statusId	Int (целое число)	См. справочник «Статус предмета залога»
2	<PledgeName>	Наименование залога/заклада	ДА	-	-	-
2.1	<Text>	Текстовое поле для наименования залога/заклада	ДА	-	String (строка)	Значение поля «Наименование залога/заклада» должно быть указано хотя бы на одном из трех языков. Возможные значения параметра language см. в справочнике «Поддерживаемые языки»
2.1	<Text>	Текстовое поле для наименования залога/заклада	ДА	language	String (строка)
3	<Value>	Вид стоимости обеспечения	ДА	-	Double (десятичное число)	Указывается стоимость по соглашению сторон (согласно залогового билета) Возможные значения параметра typeId см. в справочнике «Вид стоимости обеспечения» Возможные значения параметра currency см. в справочнике «Поддерживаемые языки»
				typeId	Int (целое число)
				currency	String (строка)
4	<SerialNumber>	Серийный номер/VIN код	ДА/НЕТ	-	String (строка)	Обязательно к заполнению для вида залога/заклада "3-Транспортные средства"
5	<Model>	Модель	ДА/НЕТ	-	String (строка)	Обязательно к заполнению для видов залога/заклада: "3-Транспортные средства", "4-Электротехническое оборудование", "5-Устройства сотовой связи".
6	<State>	Состояние	ДА	id	Int (целое число)	См. справочник «Состояние»
7	<Weight>	Вес (масса)	ДА/НЕТ	-	Double (десятичное число)	Обязательно к заполнению для вида залога/заклада: "1-Ювелирные изделия и другие изделия из драгоценных металлов и драгоценных камней". Возможные значения параметра unitId см. в справочнике «Единицы измерения массы»
7	<Weight>	Вес (масса)	ДА/НЕТ	unitId	Int (целое число)
8	<Colour>	Цвет	ДА/НЕТ	-	String (строка)	Обязательно к заполнению для вида залога/заклада: "3-Транспортные средства".
9	<Measurement>	Размер	ДА/НЕТ	-	-	-
9.1	<Length>	Длина	ДА/НЕТ	-	Double (десятичное число)	Возможные значения параметра unitId см. в справочнике «Единицы измерения длины и ширины»
9.1	<Length>	Длина	ДА/НЕТ	unitId	Int (целое число)
9.2	<Width>	Ширина	ДА/НЕТ	-	Double (десятичное число)	Возможные значения параметра unitId см. в справочнике «Единицы измерения длины и ширины»
9.2	<Width>	Ширина	ДА/НЕТ	unitId	Int (целое число)
10	<ProductionDate>	Дата изготовления	ДА/НЕТ	-	Date (дата)	Обязательно к заполнению для вида залога/заклада: "3-Транспортные средства". Формат: ГГГГ-ММ-ДД Для транспортных средств следует указывать 1-е января года выпуска. Например, для ТС с 2020 годом выпуска следует указывать значение "2020-01-01"

Записи по субъектам физическим лицам

В данном разделе содержится информация о субъекте контракта, его идентификационных данных, адресе субъекта, а также информация по контактным данным субъекта. Каждый контракт может содержать несколько субъектов, имеющих отношение к контракту.

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

1.	<Subjects>  
2.	    <Subject roleId="1">  
3.	        <Entity>  
4.	            <Individual>  
5.	                <FirstName>  
6.	                    <Text language="ru-RU">ИМЯ</Text>  
7.	                </FirstName>  
8.	                <Surname>  
9.	                    <Text language="ru-RU">ФАМИЛИЯ</Text>  
10.	                </Surname>  
11.	                <FathersName>  
12.	                    <Text language="ru-RU">ОТЧЕСТВО</Text>  
13.	                </FathersName>  
14.	                <Gender>F</Gender>  
15.	                <Residency id="1"/>  
16.	                <DateOfBirth>1989-01-01</DateOfBirth>  
17.	                <NegativeStatus id="11"/>  
18.	                <Citizenship id="110"/>  
19.	                <Identifications>  
20.	                    <Identification rank="1" typeId="14">  
21.	                        <Number>890101402472</Number>  
22.	                        <IssueDate>2011-02-21</IssueDate>  
23.	                    </Identification>  
24.	                    <Identification rank="2" typeId="7">  
25.	                        <Number>123456789</Number>  
26.	                        <IssueDate>2009-02-21</IssueDate>  
27.	                    </Identification>  
28.	                </Identifications>  
29.	                <Addresses>  
30.	                    <Address katoId="750000000" locationId="110" typeId="1">  
31.	                        <StreetName>  
32.	                            <Text language="ru-RU">пр. Достык</Text>  
33.	                        </StreetName>  
34.	                        <StreetNumber>136</StreetNumber>  
35.	                        <AdditionalInformation>Дополнительная информация</AdditionalInformation>  
36.	                    </Address>  
37.	                    <Address katoId="750000000" locationId="110" typeId="6">  
38.	                        <StreetName>  
39.	                            <Text language="ru-RU">пр. Достык</Text>  
40.	                        </StreetName>  
41.	                        <StreetNumber>136</StreetNumber>  
42.	                        <AdditionalInformation>Дополнительная информация</AdditionalInformation>  
43.	                    </Address>  
44.	                </Addresses>  
45.	                <Communications>  
46.	                    <Communication typeId="3">87019303855</Communication>  
47.	                    <Communication typeId="2">87271234567</Communication>  
48.	                    <Communication typeId="1">87271234589</Communication>  
49.	                </Communications>  
50.	            </Individual>  
51.	        </Entity>  
52.	    </Subject>  
53.	</Subjects>

Таблица 4. Записи по субъектам физическим лицам: [Показать ответ]

№	Название тега	Наименование	Обязательность	Параметр	Тип	Комментарий
	<Subjects>	Начало блока по субъектам	ДА	-	-	-
1	<Subject>	Информация о субъекте	ДА	roleId	Int (целое число)	См. справочник «Роль субъекта»
2	<Entity>	Блок «Вид субъекта»	ДА	-	-	-
3	<Individual>	Физическое лицо	ДА	-	-	-
4	<FirstName>	Имя субъекта	ДА	-	-	-
4.1	<Text>	Текстовое поле для имени субъекта	ДА	-	String (строка)	Значение поля «Наименование имени субъекта» должно быть указано хотя бы на одном из трех языков. Возможные значения параметра language см. в справочнике «Поддерживаемые языки»
4.1	<Text>	Текстовое поле для имени субъекта	ДА	language	String (строка)
5	<Surname>	Фамилия субъекта	ДА	-	-	-
5.1	<Text>	Текстовое поле для фамилии субъекта	ДА	-	String (строка)	Значение поля «Наименование фамилии субъекта» должно быть указано хотя бы на одном из трех языков. Возможные значения параметра language см. в справочнике «Поддерживаемые языки»
5.1	<Text>	Текстовое поле для фамилии субъекта	ДА	language	String (строка)
6	<FathersName>	Отчество субъекта	ДА/НЕТ	-	-	-
6.1	<Text>	Текстовое поле для отчества субъекта	ДА/НЕТ	-	String (строка)	При наличии отчества у субъекта данное поле становится обязательным к заполнению. Значение поля «Наименование отчества субъекта» должно быть указано хотя бы на одном из трех языков. Возможные значения параметра language см. в справочнике «Поддерживаемые языки»
6.1	<Text>	Текстовое поле для отчества субъекта	ДА/НЕТ	language	String (строка)
7	<Gender>	Пол	ДА	-	String (строка)	См. справочник «Пол»
8	<Residency>	Признак резиденства	ДА	id	Int (целое число)	См. справочник «Признак резиденства»
9	<DateOfBirth>	Дата рождения	ДА	id	Date (дата)	Формат: ГГГГ-ММ-ДД
10	<NegativeStatus>	Статус субъекта	ДА	id	Int (целое число)	Значение "11-Клиент не имеет негативной информации" поля "Статус субъекта" указывается при отсутствии у клиента негативной информации, а также в случае возврата залогодержателю правоохранительными органами ошибочно изъятого залогового имущества по действующему договору о предоставлении микрокредита. Возможные значения параметра unitId см. в справочнике «Статус субъекта»
11	<Citizenship>	Гражданство	ДА	id	Int (целое число)	Значение параметра id заполняется кодом страны. См. справочник «Список стран»
12	<Identifications>	Начало блока по документам	ДА	-	-	-
13	<Identification>	Информация по документу	ДА	rank	Int (целое число)	См. справочник «Категория документа»
13	<Identification>	Информация по документу	ДА	typeId	Int (целое число)	См. справочник «Вид документа» 1. При передаче значения документов 6-Паспорт гражданина РК, 7-Удостоверение личности, 8-Вид на жительство иностранца в РК и 17-Удостоверение лица без гражданства обязательны к передаче ИИН и номер соответствующего документа. 2. При передаче значения документов 18-Удостоверение беженца (физ. лицо) и 19-Паспорт гражданина иностранного государства (физ. лицо) обязателен к передаче номер соответствующего документа.
14	<Number>	Номер документа	ДА	-	String (строка)	-
15	<IssueDate>	Дата выдачи документа	ДА	-	Date (дата)	Формат ГГГГ-ММ-ДД Поле "Дата выдачи документа" обязательно для заполнения и его значение не может быть меньше 01-01-1900 и больше текущей даты, за исключением вида документа "14-ИИН".
16	<Addresses>	Начало блока по адресам субъекта	ДА	-	-	-
13	<Address>	Информация по адресу	ДА	typeId	Int (целое число)	См. справочник «Тип адреса»
				locationId	Int (целое число)	Значение параметра locationId заполняется кодом страны. См. справочник «Список стран»
				katoId	String (строка)	Наименование города/населенного пункта (используется значение КАТО). См. справочник «Коды КАТО»
14	<StreetName>	Название улицы	ДА	-	-	-
14.1	<Text>	Текстовое поле для названия улицы	ДА	-	String (строка)	Значение поля «Название улицы» должно быть указано хотя бы на одном из трех языков. Возможные значения параметра language см. в справочнике «Поддерживаемые языки»
14.1	<Text>	Текстовое поле для названия улицы	ДА	language	String (строка)
15	<StreetNumber>	Номер дома	ДА	-	String (строка)	-
16	<AdditionalInformation>	Дополнительная информация по адресу	ДА/НЕТ	-	String (строка)	-
21	<Communications>	Начало блока по контактам субъекта	ДА	-	-	-
22	<Communication>	Информация по контакту	ДА	typeId	Int (целое число)	Обязательна передача вида связи "3-Мобильный" См. справочник «Вид связи»

Алгоритм расчета контрольного разряда для ИИН: [Показать ответ]

При расчете используется следующий алгоритм в два цикла:

а12=(а1*b1+а2*b2+а3*b3+а4*b4+а5*b5+а6*b6+а7*b7+а8*b8+а9*b9+a10*b10+a11*b11) mod 11,

где ai - значение i-гo разряда; bi - вес i-гo разряда.

Первый цикл

Разряд ИИН	1	2	3	4	5	6	7	8	9	10	11
Вес разряда	1	2	3	4	5	6	7	8	9	10	11

Второй цикл

Если полученное число равно 10, то расчет контрольного разряда производится с другой последовательностью весов:

Разряд ИИН	1	2	3	4	5	6	7	8	9	10	11
Вес разряда	3	4	5	6	7	8	9	10	11	1	2

Процесс загрузки данных

Данные в ИС БДКИ можно передавать 2-мя способами: [Показать ответ]

1. Посредством веб-интерфейса – пакеты в этом случае загружаются вручную через раздел «Администрирование». Более подробно этот способ описан в техническом документе «Пользовательская инструкция ИС БДКИ Часть 1 «Для Поставщиков информации».

2. Посредством веб-сервиса – пакеты в этом случае загружаются посредством вызова метода веб-сервиса по загрузке пакетов. Более подробно сервис описан в разделе «4.1 Сервис загрузки пакетов BatchProcessingWebService» данного документа.

Примечания: [Показать ответ]

- система поддерживает следующие возможные форматы файлов для загрузки - *.zip и *.xml;

- имеется возможность выбора нескольких файлов для загрузки;

- размер одного передаваемого пакета ограничен - 100 Мб (в пользовательском интерфейсе в случае превышения лимита отображается сообщение об ошибке);

- в одном XML/ZIP пакете можно передавать до 10 000 записей;

- при загрузке в ИС БДКИ данных в виде одного XML/ZIP файла, необходимо передавать от 10 000 (десяти тысяч) до 50 000 (пятидесяти тысяч) контрактов. В случае, если количество передаваемых контрактов составляет менее 10 000 (десяти тысяч) контрактов, то необходимо передавать все контракты в одном XML/ZIP файле.

Независимо от способа передачи пакета: [Показать ответ]

→Независимо от способа передачи пакета, после получения запроса от пользователя о появлении нового файла на сервере, система перемещает его с сервера и размещает в локальной папке. На этом шаге файлу присваивается ID для того, чтобы он не был утерян. Далее файл отправляется в архив, где он переименовывается (наименование содержит ID пакета в системе) и размещается в папке, наименование которой содержит дату загрузки. Параллельно система отправляет нотификацию о том, что файл принят в обработку (сообщение содержит ID пакета) и файл поступает на проверку. Проверка файла осуществляется в несколько этапов:

1. Проверка корректности структуры файла в соответствии с XSD-схемами.

→Если файл не прошел данный этап валидации, то в системе регистрируется факт не прохождения проверки с отражением причины непринятия файла в БДКИ. Одновременно, пользователю, осуществляющему загрузку информации, направляется уведомление с указанием наименования файла и описанием ошибки, из-за которой загруженный файл не прошел проверку валидации.

2. Проверка бизнес-правил.

→Если в файле с информацией, подлежащей загрузке в БДКИ, присутствуют и корректные, и ошибочные записи, то в результате обработки файла в БДКИ корректные записи, согласно бизнес-правилам, описанными в настоящем Техническом документе, загружаются и сохраняются в БДКИ. Перечень не принятых ошибочных записей также будет выявлен в БДКИ, при этом Поставщик информации получит уведомление с описанием ошибочных записей в загруженном файле.

→При загрузке файла каждая запись субъекта/контракта содержит признак «Вставить» (т.е. создать новый контракт/субъект) либо «Обновить» (обновить данные по контракту/субъекту).

→Если в файле есть и ошибочные и корректные записи, то корректные записи загружаются и сохраняются в базе, а ошибочные записи не попадают в систему, при этом Поставщик информации уведомляется о возникшей ошибке.

→Если записи файла корректны и прошли перечисленные выше этапы проверки, то перед загрузкой информации в БДКИ система проверяет существуют ли уже субъекты и контракты, указанные в файле.

Проверка наличия контрактов в системе: [Показать ответ]

Независимо от вида операции («Вставить»/«Обновить») система осуществит поиск контракта в системе. Идентификация контрактов осуществляется по следующим полям (совпадение по всем параметрам):

1) Код контракта;

2) Дата начала срока действия договора;

3) Поставщик информации.

В случае если контракт не найден, то он создается. Создание контракта осуществляется в соответствии с определенными требованиями.

Механизм обновления/добавления данных выглядит следующим образом: [Показать ответ]

1) Перезапись - сохранение всех полей; если переданы пустые поля, значит, сохраняются пустые поля;

2) Обновление - сохранение заполненных переданных значений; если переданы пустые поля, то оставляются прежние значения.

Таблица 5. Процесс загрузки данных: [Показать ответ]

	Новая запись	Обновляемая запись
	Новая запись	Данные были заполнены	Данных ранее не было
Контракт
Общие данные	Добавляем	Обновление: • Обновляем, если значения переданы; • Оставляем то, что было, если данные не переданы (например, если была указана «Ставка вознаграждения», а при обновлении она не передана, то оставляем старое значение).	Добавляем
Учетная дата и связанная с ней информация	Добавляем	Если такая учетная дата была в системе, обновляем: • Если значения переданы, сохраняем новое значение; • Оставляем то, что было, если данные не переданы.	Если такой учетной даты не было, добавляем
Субъекты (связь контракта с субъектом)	Добавляем	Перезаписываем: Если субъект ранее был прикреплен к контракту, а в передаваемом контракте - нет, считаем, что субъект больше не связан с контрактом.	Добавляем
Обеспечение	Добавляем	Перезаписываем: Если информация по залогам не передана, считаем, что обеспечение откреплено от контракта.	Добавляем
Субъект
Общие данные	Добавляем	Обновление: • Обновляем, если значения переданы; • Оставляем то, что было, если данные не переданы (например, если был указан «Статус субъекта», а при обновлении он не передан, то оставляем старое значение).	Добавляем
Документы	Добавляем	• Если такой вид документа был, то перезаписываем все данные; • Если вид документа был и он не передается, то оставляем.	Если передается новый вид документа, то добавляем
Адреса	Добавляем	Если в автоматическом режиме приходит одна/несколько записей одного вида, в то время как в системе у субъекта уже есть одна/несколько записей адреса этого же вида, к субъекту привязываются все передаваемые адреса в качестве актуальных. Все прежние записи уходят в исторические значения. Если вид адреса был и он не передается, то оставляем.	Если передается новый вид адреса, то добавляем
Контакты	Добавляем	Если такой вид контакта был, перезаписываем. Если вид контакта был и он не передается (например, «Офисный телефон»), то оставляем.	Если передается новый вид контакта, то добавляем

Сервис загрузки пакетов BatchProcessingWebService

Сервис BatchProcessingWebService предназначен для пакетной загрузки файлов, а также для предоставления различной служебной информации о загруженных и загружаемых файлах.

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

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

2) ID пользователя, от имени которого будет выполнена запрашиваемая операция, в SOAP Header: Http Headers: {Authorization=[Basic 3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}, где c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2 - есть значение HTTP Header, представляющее собой ID клиента (организации) и его пароль в формате «clientId:password» и кодировке Base64 как того требует механизм Basic Authentication.

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

1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.chdb.scb.kz">   
2.	    <soapenv:Header>        
3.	        <userId>xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxx</userId>  
4.	    </soapenv:Header>  
5.	    <soapenv:Body>  
6.	        <data:методСервиса>  
7.	        ...  
8.	        </data:методСервиса>  
9.	    </soapenv:Body>  
10.	</soapenv:Envelope>

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

1) Вызов любого веб-сервиса идет через ESB. На этом уровне:

а) Производится базовая аутентификация - проверяется, есть ли в системе активный клиент соответствующий указанным в HTTP Authorization Header данным;

б) Определяется, действительно ли указанный в <userId> SOAP Header пользователь работает на указанного клиента и активен ли он;

в) Проверяется, имеет ли клиент доступ к запрошенному веб-сервису;

В случае, если один из вышеперечисленных пунктов не выполняется - вызывающему клиенту отсылается сообщение об ошибке, а вызов веб-сервиса не уходит дальше в модуль системы.

2) После успешной проверки на ESB вызов приходит в модуль сервисов - UM или Reporting или Data. Здесь по идентификатору из <userId> формируется пользовательский контекст, т.е. определяется, какой пользователь пытается совершить операцию и какие роли у него есть. Это позволяет установить всякого рода ограничения: например, пользователь, работающий в организации A, не сможет изменять контракты организации B (если, например, такого рода изменение указано в Batch-файле), или же он вообще не сможет изменить контракт, если роли этого не позволяют.

Метод uploadFile сервиса BatchProcessingWebService

Метод uploadFile выполняет загрузку пакетов на сервер, регистрацию принятых пакетов и постановку пакетов в очередь на обработку.

Пример входных параметров метода uploadFile: [Показать ответ]

1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.chdb.scb.kz">
2.	 <soapenv:Header>
3.	  <userId>xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxx</userId>
4.	 </soapenv:Header>
5.	 <soapenv:Body> 
6.	  <data:uploadFile> 
7.	   <!-- Содержимое XML файла, закодированное в BASE64 --> 
8.	   <file>PFJlY29yZHM...Vjb3Jkcz4=</file> 
9.	   <!-- Имя пакета (не принимается наименование на кириллице) --> 
10.	   <fileName>new_batch.xml</fileName> 
11.	   <!-- Тип пакета (1-кредитный договор) --> 
12.	   <fileType>1</fileType>
13.	   
14.	   <!-- ИЛИ --> 
15.	   <!-- Тип пакета (3-оперативная загрузка) для загрузки в 1 день -->
16.	   <fileType>3</fileType>
17.	   
18.	  </data:uploadFile>
19.	 </soapenv:Body>  
20.	</soapenv:Envelope>

Примечание: 
1. Значение <userId> смотрите в форме на предоставление доступа к ИС БДКИ.
2. При передаче информации в 1 день в теге <fileType> необходимо указывать значение 3.

Таблица 6. Входные параметры метода uploadFile: [Показать ответ]

Наименование	Тип	Описание	Примечание
file	xs:base64Binary	Содержимое пакета в кодировке BASE64
fileName	xs:string	Имя пакета	Пример: new_batch.xml Не принимаются имена на кириллице
fileType	xs:int	Тип пакета	Возможна передача следующих значений: 1 - Кредитный договор 3 - Оперативная загрузка (указывается при передаче информации в 1 день)

Пример выходных параметров метода uploadFile: [Показать ответ]

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
2.	 <SOAP-ENV:Header xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">  
3.	  <userId>xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxx</userId>  
4.	  <creditorId>xx</creditorId>  
5.	  <timestamp>1581502678429</timestamp>  
6.	 </SOAP-ENV:Header>  
7.	 <soap:Body>  
8.	  <ns2:uploadFileResponse xmlns:ns2="http://data.chdb.scb.kz">  
9.	   <batchPackageId>241010</batchPackageId>  
10.	  </ns2:uploadFileResponse>  
11.	 </soap:Body>  
12.	</soap:Envelope>

Таблица 7. Выходные параметры метода uploadFile: [Показать ответ]

Наименование	Тип	Описание	Примечание
batchPackageId	xs:int	Идентификатор пакета, зарегистрированный в ИС БДКИ

Исключительные ситуации:

Метод uploadFile может возвращать следующие виды ошибок:

1. ScbBusinessFault

2. ScbSystemFault

3. ScbValidationFault

Подробное описание видов ошибок см. в разделе «4.2 Ошибки web-сервиса»

Метод getImportInfo сервиса BatchProcessingWebService

Метод getImportInfo дает возможность посмотреть статус загрузки файла: выдает общие сведения об обновленных записях, количестве ошибок в файле и т.д.

Пример входных параметров метода getImportInfo: [Показать ответ]

1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.chdb.scb.kz">  
2.	    <soapenv:Header>        
3.	        <userId>xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxx</userId>  
4.	    </soapenv:Header>  
5.	    <soapenv:Body>  
6.	        <data:getImportInfo>            
7.	            <params>                
8.	                <!-- Параметры поддержки постраничной выборки данных -->  
9.	                <paginationSupportDto>                      
10.	                    <firstResult>0</firstResult>                      
11.	                    <maxResults>10</maxResults>  
12.	                </paginationSupportDto>                 
13.	                <!-- ID пакета, зарегистрированного в системе БДКИ -->  
14.	                <packageId>232943</packageId>  
15.	                <!-- Язык, на котором будет возвращаться информация (ru, kk, en) -->  
16.	                <language>ru</language>  
17.	            </params>  
18.	        </data:getImportInfo>  
19.	    </soapenv:Body>  
20.	</soapenv:Envelope>

Примечание: значение <userId> смотрите в форме на предоставление доступа к ИС БДКИ.

Таблица 8. Входные параметры метода getImportInfo: [Показать ответ]

Наименование	Тип	Описание	Примечание
paginationSupportDto	tns:paginationSupportDto	Параметры поддержки постраничной выборки данных.	Описание приведено в разделе «4.3 Входные параметры paginationSupportDto»
packageId	xs:long	Идентификатор пакета, зарегистрированный в ИС БДКИ
addTime	xs:dateTime	Дата добавления пакета	<addTime>2014-01-31T00:00:00.000-04:00</addTime>
language	xs:string	Язык, на котором будет возвращаться информация	<language>ru</language>

Пример выходных параметров метода getImportInfo: [Показать ответ]

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
2.	    <SOAP-ENV:Header xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">  
3.	        <userId>xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxx</userId>  
4.	        <creditorId>xx</creditorId>  
5.	        <timestamp>1581565079710</timestamp>  
6.	    </SOAP-ENV:Header>  
7.	    <soap:Body>  
8.	        <ns2:getImportInfoResponse xmlns:ns2="http://data.chdb.scb.kz">  
9.	            <filesImportInfo>  
10.	                <batchFileDtoList>  
11.	                    <fileId>240699</fileId>  
12.	                    <fileNumber>1</fileNumber>  
13.	                    <fileScheme>1</fileScheme>  
14.	                    <fileName>new_batch1.xml</fileName>  
15.	                    <batchFile>Путь к batch-файлу на сервере</batchFile>  
16.	                    <uploadedTime>2020-02-13T09:35:59.234+06:00</uploadedTime>  
17.	                    <batchUploadStatus>Файл обработан.</batchUploadStatus>  
18.	                    <numberOfContracts>1</numberOfContracts>  
19.	                    <numberOfSubjects>0</numberOfSubjects>  
20.	                    <updatedContracts>0</updatedContracts>  
21.	                    <updatedSubjects>0</updatedSubjects>  
22.	                    <newContracts>0</newContracts>  
23.	                    <newSubjects>0</newSubjects>  
24.	                    <mergedContracts>0</mergedContracts>  
25.	                    <skippedContracts>1</skippedContracts>  
26.	                    <mergedSubjects>0</mergedSubjects>  
27.	                    <numberOfErrors>0</numberOfErrors>  
28.	                    <batchPackage>  
29.	                        <packageId>241029</packageId>  
30.	                        <packageName>Пакет.zip</packageName>  
31.	                        <addTime>2020-02-13T09:35:55.583+06:00</addTime>  
32.	                        <creditor>ТОО "Василёк"</creditor>  
33.	                        <employee>Иван Иванович Иванов</employee>  
34.	                    </batchPackage>  
35.	                </batchFileDtoList>  
36.	                <batchFileDtoList>  
37.	                    <fileId>240700</fileId>  
38.	                    <fileNumber>2</fileNumber>  
39.	                    <fileScheme>1</fileScheme>  
40.	                    <fileName>new_batch2.xml</fileName>  
41.	                    <batchFile>Путь к batch-файлу на сервере</batchFile>  
42.	                    <uploadedTime>2020-02-13T09:36:04.005+06:00</uploadedTime>  
43.	                    <batchUploadStatus>Ошибка обработки.</batchUploadStatus>  
44.	                    <numberOfContracts>0</numberOfContracts>  
45.	                    <numberOfSubjects>0</numberOfSubjects>  
46.	                    <updatedContracts>0</updatedContracts>  
47.	                    <updatedSubjects>0</updatedSubjects>  
48.	                    <newContracts>0</newContracts>  
49.	                    <newSubjects>0</newSubjects>  
50.	                    <mergedContracts>0</mergedContracts>  
51.	                    <skippedContracts>0</skippedContracts>  
52.	                    <mergedSubjects>0</mergedSubjects>  
53.	                    <numberOfErrors>3</numberOfErrors>  
54.	                    <batchPackage>  
55.	                        <packageId>241029</packageId>  
56.	                        <packageName>Пакет.zip</packageName>  
57.	                        <addTime>2020-02-13T09:35:55.583+06:00</addTime>  
58.	                        <creditor>ТОО "Василёк"</creditor>  
59.	                        <employee>Иван Иванович Иванов</employee>  
60.	                    </batchPackage>  
61.	                </batchFileDtoList>  
62.	                <count>2</count>  
63.	            </filesImportInfo>  
64.	        </ns2:getImportInfoResponse>  
65.	    </soap:Body>  
66.	</soap:Envelope>

Таблица 9. Выходные параметры метода getImportInfo: [Показать ответ]

Наименование	Тип	Описание	Примечание
count	xs:long	Общее количество файлов в пакете
batchFileDtoList	список tns:batchFileDto	Список загруженных файлов

Таблица 10. Выходной параметр batchFile (tns:batchFileDto): [Показать ответ]

Наименование	Тип	Описание	Примечание
fileId	xs:long	Идентификатор batch-файла, зарегистрированный в БДКИ
fileNumber	xs:int	Порядковый номер файла
fileScheme	xs:string	Схема файла	1 - Кредитный договор
fileName	xs:string	Имя файла
batchFile	xs:string	Путь к batch-файлу на сервере
uploadedTime	xs:dateTime	Дата и время загрузки
batchUploadStatus	xs:string	Статус загрузки
numberOfContracts	xs:int	Количество контрактов
numberOfSubjects	xs:int	Количество субъектов
updatedContracts	xs:int	Количество обновленных контрактов
updatedSubjects	xs:int	Количество обновленных субъектов
newContracts	xs:int	Количество новых контрактов
newSubjects	xs:int	Количество новых субъектов
mergedContracts	xs:int	Количество объединенных контрактов
skippedContracts	xs:int	Количество пропущенных контрактов
mergedSubjects	xs:int	Количество объединенных субъектов
numberOfErrors	xs:int	Количество ошибок
batchPackage	tns:batchPackageDto	Блок информации о batch-пакете

Таблица 11. Выходной параметр batchPackage (tns:batchPackageDto): [Показать ответ]

Наименование	Тип	Описание
packageId	xs:long	Идентификатор batch-пакета, зарегистрированный в БДКИ
packageName	xs:string	Наименование пакета
addTime	xs:dateTime	Дата и время загрузки
creditor	xs:string	Наименование Поставщика информации
employee	xs:string	Пользователь, загрузивший пакет

Метод getImportDetailInfo сервиса BatchProcessingWebService

При успешной загрузке данных, метод getImportDetailInfo дает возможность детально посмотреть какие именно контракты/субъекты записались или обновились, а также конкретный вид ошибки, которые возникли в результате загрузки.

Пример входных параметров метода getImportDetailInfo: [Показать ответ]

1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.chdb.scb.kz">  
2.	    <soapenv:Header>  
3.	        <userId>xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxx</userId>  
4.	    </soapenv:Header>  
5.	    <soapenv:Body>  
6.	        <data:getImportDetailInfo>  
7.	            <params>  
8.	                <!-- Параметры поддержки постраничной выборки данных -->  
9.	                <paginationSupportDto>                      
10.	                    <firstResult>0</firstResult>  
11.	                    <maxResults>10</maxResults>  
12.	                </paginationSupportDto>  
13.	                <!-- Идентификатор batch-файла, зарегистрированный в БДКИ -->  
14.	                <fileId>240700</fileId>  
15.	                <!--  
16.	                Тип записи:  
17.	                0 - для получения ошибочных записей  
18.	                1 - для получения новых записей  
19.	                2 - для получения обновленных записей  
20.	                3 - для получения объединенных записей  
21.	                4 - для получения детальной информации о всех записях, кроме ошибочных  
22.	                -->  
23.	                <recordGroupStatus>0</recordGroupStatus>  
24.	                <!-- Язык, на котором будет возвращаться информация (ru, kk, en) -->  
25.	                <language>ru</language>  
26.	            </params>  
27.	        </data:getImportDetailInfo>  
28.	    </soapenv:Body>  
29.	</soapenv:Envelope>

Примечание: значение <userId> смотрите в форме на предоставление доступа к ИС БДКИ.

Таблица 11. Входные параметры метода getImportDetailInfo: [Показать ответ]

Наименование	Тип	Описание	Примечание
paginationSupportDto	tns:paginationSupportDto	Параметры поддержки постраничной выборки данных	Описание приведено в разделе «4.3 Входные параметры paginationSupportDto»
fileId	xs:long	Идентификатор batch-файла, зарегистрированный в БДКИ	Передается именно ID файла, а не ID пакета. Получить ID файла можно при вызове метода getImportInfo.
recordGroupStatus	xs:int	Тип записи	Существующие значения: 0 - для получения ошибочных записей 1 - для получения новых записей 2 - для получения обновленных записей 3 - для получения объединенных записей 4 - для получения детальной информации о всех записях, кроме ошибочных
language	xs:string	Язык, на котором будет возвращаться информация	<language>ru</language> <language>kk</language> <language>en</language>

Пример выходных параметров метода getImportDetailInfo: [Показать ответ]

1.	<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
2.	    <SOAP-ENV:Header xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">  
3.	        <userId>xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxx</userId>  
4.	        <creditorId>xx</creditorId>  
5.	        <timestamp>1581574303768</timestamp>  
6.	    </SOAP-ENV:Header>  
7.	    <soap:Body>  
8.	        <ns2:getImportDetailInfoResponse xmlns:ns2="http://data.chdb.scb.kz">  
9.	            <recordsImportInfo>  
10.	                <batchRecordDtoList>  
11.	                    <recordId>209060544</recordId>  
12.	                    <contractId>17775000</contractId>  
13.	                    <contractPhase>5</contractPhase>  
14.	                    <contractCode>Контракт01</contractCode>  
15.	                    <creditDiscriminator>1</creditDiscriminator>  
16.	                    <result>Создан новый контракт.</result>  
17.	                </batchRecordDtoList>  
18.	                <batchRecordDtoList>  
19.	                    <recordId>209060551</recordId>  
20.	                    <subjectId>859962</subjectId>  
21.	                    <subjectName>ФИО субъекта 01</subjectName>  
22.	                    <iinBin>ИИН</iinBin>  
23.	                    <contractId>17775000</contractId>  
24.	                    <contractPhase>5</contractPhase>  
25.	                    <contractCode>Контракт01</contractCode>  
26.	                    <creditDiscriminator>1</creditDiscriminator>  
27.	                    <result>Субъект обновлен.</result>  
28.	                </batchRecordDtoList>  
29.	                <batchRecordDtoList>  
30.	                    <recordId>209060552</recordId>  
31.	                    <subjectId>9081626</subjectId>  
32.	                    <subjectName>ФИО субъекта 02</subjectName>  
33.	                    <iinBin>ИИН</iinBin>  
34.	                    <contractId>17775000</contractId>  
35.	                    <contractPhase>5</contractPhase>  
36.	                    <contractCode>Контракт01</contractCode>  
37.	                    <creditDiscriminator>1</creditDiscriminator>  
38.	                    <result>Субъект обновлен.</result>  
39.	                </batchRecordDtoList>  
40.	                <count>3</count>  
41.	            </recordsImportInfo>  
42.	        </ns2:getImportDetailInfoResponse>  
43.	    </soap:Body>  
44.	</soap:Envelope>

Таблица 12. Выходные параметры метода getImportDetailInfo: [Показать ответ]

Наименование	Тип	Описание	Примечание
recordsImportInfo	count	xs:long	Общее количество результатов
Список данных:
batchRecordDtoList	recordId	xs:long	Номер записи
batchRecordDtoList	subjectId	xs:long	Идентификатор субъекта
batchRecordDtoList	subjectName	xs:string	Имя субъекта
batchRecordDtoList	rnn	xs:string	РНН субъекта
batchRecordDtoList	iinBin	xs:string	ИИН/БИН субъекта
batchRecordDtoList	contractId	xs:long	Идентификатор контракта
batchRecordDtoList	contractPhase	xs:string	Фаза контракта
batchRecordDtoList	contractCode	xs:string	Код контракта
batchRecordDtoList	creditDiscriminator	xs:string	Тип контракта
batchRecordDtoList	result	список xs:string	Список результатов
batchRecordDtoList	resultMessage	xs:string	Результат
batchRecordDtoList	resultMessagePlaceholders	список xs:string	Данные для подстановки в список результатов
batchRecordDtoList	numberOfRow	xs:int	Номер строки в файле

Исключительные ситуации:

Метод getImportDetailInfo может возвращать ошибки вида ScbBusinessFault.

Подробное описание видов ошибок см. в разделе «4.2 Ошибки web-сервиса»

Ошибки web-сервиса

Веб-сервисы ПО БДКИ могут возвращать следующие виды ошибок:

1. ScbBusinessFault - бизнес-ошибки;

2. ScbValidationFault - ошибки валидации;

3. ScbSystemFault - системные ошибки.

Бизнес-ошибки ScbBusinessFault

Предсказуемые ошибки, связанные, как правило, с бизнес-логикой работы ПО БДКИ. Например, проверки правил бизнес-логики, проверки безопасности, данные не найдены и т.д.

Таблица 13. Описание ошибок вида ScbBusinessFault: [Показать ответ]

Наименование	Тип	Описание
faultCode	xs:string	Код ошибки
faultDescription	xs:string	Описание ошибки
faultId	xs:string	Уникальный идентификатор ошибки
faultTimestamp	xs:dateTime	Ошибки даты и времени
faultType	xs:string	Тип ошибки: DATA_NOT_FOUND FILE_NOT_FOUND ACCESS_DENIED VALIDATION_ERROR INTEGRITY_CHECK CONCURRENT_MODIFICATION BATCH_ERROR REPORT_ERROR TIMEOUT_EXCEEDED

Бизнес-ошибки ScbValidationFault

Ошибки, возникающие при проверке корректности данных. Например, нарушение правил бизнес-логики, превышение размерности данных и т.д. Возвращается список, содержащий структуру, которая описана в таблице ниже.

Таблица 14. Описание ошибок вида ScbValidationFault: [Показать ответ]

Наименование	Тип	Описание	Примечание
code	xs:string	Код ошибки	VAL-C-001

Бизнес-ошибки ScbValidationFault

Непредвиденные ошибки, которые могут возникнуть при работе ПО БДКИ. Например, ошибки подключения к каким-то ресурсам, сетевые ошибки, ошибки недостаточности памяти и т.д.

Таблица 15. Описание ошибок вида ScbSystemFault: [Показать ответ]

Наименование	Тип	Описание
faultCode	xs:string	Код ошибки
faultDescription	xs:string	Описание ошибки
faultId	xs:string	Уникальный идентификатор ошибки
faultTimestamp	xs:dateTime	Ошибки даты и времени
faultType	xs:string	Тип ошибки: DATABASE_ERROR HTTP_CONNECTION_PROBLEM LDAP_CONNECTION_PROBLEM JMS_CONNECTION_PROBLEM FILE_IO_ERROR PROGRAMMATIC_ERROR UNEXPECTED_INTERNAL_ERROR ESB_ERROR REPORT_ERROR

Входные параметры paginationSupportDto

Таблица 16. Параметры для получения сущности из БД (baseGetParams): [Показать ответ]

Наименование	Тип	Описание	Возможные значения	Пример
reportNumber	tns:paginationSupportDto	Параметры поддержки постраничной выборки данных		<paginationSupportDto> <firstResult>1<firstResult> <maxResults>10<maxResults> </paginationSupportDto>
id	xs:long	Идентификатор контракта в БД	Числа в пределах от 1 до Long.MAX_VALUE	<id>1234</id>

Таблица 17. Параметры поддержки постраничной выборки данных (paginationSupportDto): [Показать ответ]

Наименование	Тип	Описание	Возможные значения	Пример
firstResult	xs:int	Позиция первого значения	Числа в пределах от 1 до Integer.MAX_VALUE	<firstResult>1<firstResult>
maxResults	xs:int	Размер выборки данных (страницы)	Числа в пределах от 1 до Integer.MAX_VALUE	<maxResults>10<maxResults>

Таблица 18. Параметр поддержки поиска по частичному совпадению (PaginationOrderPartialCoincidenceParam): [Показать ответ]

Наименование	Тип	Описание
partialCoincidenceEnabled	xs:boolean	Разрешать ли возможность поиска по частичному совпадению
ascending	xs:boolean	Сортировка по возрастанию
paginationSupportDto	tns:paginationSupportDto	Параметры поддержки постраничной выборки данных

Правила бизнес-логики

В системе ГКБ существует два состояния для контрактов и субъектов: предварительный и активный. При автоматической загрузке контракта/субъекта присваивается состояние «Активный». При создании контракта/субъекта автоматически состояние присваивается равным «Предварительный», как только внесены все необходимые данные, состояние становится «Активный».

Примечание: в случае, если при внесении всех данных по субъекту/контракту состояние не меняется с «Предварительного» на «Активный», необходимо в интерфейсе зайти в раздел редактирования субъекта/контракта и не меняя данные произвести пересохранение.

Только «Активные» контракты/субъекты участвуют в формировании отчетов. Обратный переход контракта/субъекта из состояния «Активный» в «Предварительный» не допускается. В нижеприведенной таблице описаны бизнес-правила для активных контрактов/субъектов, загружаемых в систему при помощи автоматической загрузки. Бизнес-правила для пользовательского интерфейса описаны в «Пользовательской инструкции ИС БДКИ Часть 1 «Для Поставщиков информации».

Детальное описание правил бизнес-логики приведено в документе «Приложение №1 к Договору о предоставлении информации в кредитное бюро «Структура базы данных кредитного бюро».

Таблица 19. Правила бизнес-логики по контрактам и субъектам: [Показать ответ]

Передача информации в 1 день

Контракты физических лиц, которые будут передаваться в 1 день, должны загружаться в систему в отдельной схеме. При загрузке таких контрактов необходимо указать тип файла со значением 3-«Оперативная загрузка» (смотрите подраздел 4.1.1 Метод uploadFile сервиса BatchProcessingService раздела «4.1 Процесс загрузки пакетов BatchProcessingService»). Данный тип файла предназначен исключительно для отправки вновь выданных контрактов согласно внесенным изменениям в Закон «О кредитных бюро и формировании кредитных историй в РК», которые вступят в силу 01 октября 2022г.

Обязательность полей для данного типа файла отличается от типа 1 - «Кредитный договор».

Для удобства Поставщиков информации, контракты с полным набором полей, аналогичным типу файла 1, также будут приниматься системой по типу 3. При этом в БДКИ будут записываться только поля, обязательные для типа 3. Остальные поля не записываются в БДКИ (присваивается значение NULL), несмотря на их наличие в XML файле.

Дальнейшее обновление контрактов (на 10 день) производится Поставщиками информации в прежнем режиме по типу файла 1.

Контракты, отправленные по типу 3, имеют наивысший приоритет при загрузке.

Общая информация по договору

XML пример для передачи договора в 1 день: [Показать ответ]

1.	<?xml version="1.0" encoding="utf-8"?>  
2.	<Records>  
3.	 <Contract operation="2">  
4.	  <General>  
5.	   <ContractCode>Ломбард_OneDay_Test_01</ContractCode>  
6.	   <AgreementNumber>Ломбард_OneDay_Test_01</AgreementNumber>  
7.	   <FundingType id="2"/>
8.	   <ContractPhase id="4"/>  
9.	   <ContractStatus id="4"/>  
10.	   <StartDate>2021-02-21</StartDate>  
11.	   <EndDate>2021-03-21</EndDate>  
12.	   <AnnualEffectiveRate>11.7</AnnualEffectiveRate>
13.	   <NominalRate>25.20</NominalRate>
14.	   <Subjects>  
15.	    <Subject roleId="1">  
16.	     <Entity>  
17.	      <Individual>  
18.	       <FirstName>  
19.	        <Text language="ru-RU">ИМЯ</Text>  
20.	       </FirstName>  
21.	       <Surname>  
22.	        <Text language="ru-RU">ФАМИЛИЯ</Text>  
23.	       </Surname>       
24.	       <FathersName>  
25.	        <Text language="ru-RU">ОТЧЕСТВО</Text>  
26.	       </FathersName>       
27.	       <Residency id="1"/>
28.	       <DateOfBirth>1989-01-01</DateOfBirth>  
29.	       <Identifications>  
30.	        <Identification rank="1" typeId="14">  
31.	         <Number>890101402472</Number>  
32.	        </Identification>  
33.	        <Identification rank="2" typeId="7">  
34.	         <Number>123456789</Number>  
35.	        </Identification>  
36.	       </Identifications>  
37.	       <Addresses>  
38.	        <Address katoId="750000000" locationId="110" typeId="1">  
39.	         <StreetName>  
40.	          <Text language="ru-RU">пр. Достык</Text>  
41.	         </StreetName>  
42.	        </Address>  
43.	        <Address katoId="750000000" locationId="110" typeId="6">  
44.	         <StreetName>  
45.	          <Text language="ru-RU">пр. Достык</Text>  
46.	         </StreetName>  
47.	        </Address>  
48.	       </Addresses>  
49.	      </Individual>  
50.	     </Entity>  
51.	    </Subject>  
52.	   </Subjects>  
53.	  </General>  
54.	  <Type>  
55.	   <Credit>  
56.	    <CreditLimit currency="KZT">15000.00</CreditLimit>  
57.	    <RecordsList>  
58.	     <Record accountingDate="2019-12-27">  
59.	      <ResidualAmount currency="KZT">0</ResidualAmount>
60.	     </Record>  
61.	    </RecordsList>  
62.	   </Credit>  
63.	  </Type>  
64.	 </Contract>  
65.	</Records>

Примечание: данные, предоставленные в XML примере, вымышленные, любые совпадения с реальными данными случайны.

Таблица 20. Общая информация по договору: [Показать ответ]

№	Название тега	Наименование	Обязательность	Параметр	Тип	Комментарий
	<Records>	Тег, отвечающий за общие поля. В нем содержатся все контракты.	ДА	-	-	-
1	<Contract>	Информация о договоре	ДА	operation	Int (целое число)	Вид проводимой операции. См. справочник «Вид проводимой операции»
2	<General>	Общее поле для всех договоров	ДА	-	-	-
3	<ContractCode>	Уникальный код договора	ДА	-	String (строка)	Указывается уникальный код договора в системе поставщика информации или уникальный номер договора (ЗБ)
4	<AgreementNumber>	Номер договора	ДА	-	String (строка)	Указывается уникальный номер договора (ЗБ)
5	<FundingType>	Вид финансирования	ДА	id	Int (целое число)	См. справочник «Вид финансирования»
6	<CreditPurpose2>	Цель кредита 2	НЕТ	id	Int (целое число)	Если передано, то сохраняем См. справочник «Цель кредита 2»
7	<CreditObject>	Объект кредитования	НЕТ	id	String (строка)	Если передано, то сохраняем См. справочник «Объект кредитования»
8	<ContractPhase>	Фаза контракта	ДА	id	Int (целое число)	См. справочник «Фаза контракта»
9	<ContractStatus>	Статус контракта	ДА	id	Int (целое число)	См. справочник «Статус контракта» Указывается только значение 4 для контрактов, передаваемых в 1 день
10	<StartDate>	Дата начала срока действия контракта	ДА	-	Date (дата)	Указывается дата выдачи займа Формат: ГГГГ-ММ-ДД
11	<EndDate>	Дата окончания срока действия контракта	ДА	-	Date (дата)	Указывается дата погашения займа по ЗБ (без учета продлений срока погашения займа) Формат: ГГГГ-ММ-ДД
13	<AnnualEffectiveRate>	Ставка вознаграждения	ДА	-	Double (десятичное число)	Указывается годовая эффективная ставка вознаграждения
14	<NominalRate>	Номинальная ставка вознаграждения	НЕТ	-	Double (десятичное число)	Если передано, то сохраняем Указывается номинальная ставка вознаграждения на дату заключения договора
17	<Address>	Фактический адрес ломбарда, в котором выдан займ	НЕТ	typeId	Int (целое число)	См. справочник «Тип адреса»
17	<Address>	Фактический адрес ломбарда, в котором выдан займ	НЕТ	katoId	String (строка)	Если передано, то сохраняем См. справочник «Список местонахождений»
18	<StreetName>	Название улицы	НЕТ	-	-	Если передано, то сохраняем
18.1	<Text>	Текстовое поле для названия улицы	НЕТ	-	String (строка)	Если передано, то сохраняем Значение поля «Название улицы» должно быть указано хотя бы на одном из трех языков. Возможные значения параметра language см. в справочнике «Поддерживаемые языки»
18.1	<Text>	Текстовое поле для названия улицы	НЕТ	language	String (строка)
21	<Collaterals>	Блок информации по обеспечениям	НЕТ	-	-	Если передано, то сохраняем Подробное описание см. в разделе «6.3 Записи по обеспечениям»
22	<Subjects>	Блок информации по субъектам	ДА	-	-	Подробное описание см. в разделе «6.4 Записи по субъектам физическим лицам»
23	<Type>	Блок информации по учетным датам	ДА	-	-	Подробное описание см. в разделе «6.2 Информация по учетным датам»

Информация по учетным датам

В данном разделе содержится вся специфическая информация по передаваемым учетным датам. Элемент <RecordsList> содержит учетные записи, относящиеся к договору.

XML пример блока: [Показать ответ]

1.	<Type>  
2.	 <Credit>  
3.	  <CreditLimit currency="KZT">15000.00</CreditLimit>  
4.	  <RecordsList>  
5.	   <Record accountingDate="2019-12-27">  
6.	    <ResidualAmount currency="KZT">0</ResidualAmount>
7.	   </Record>  
8.	  </RecordsList>  
9.	 </Credit>  
10.	</Type>

Таблица 21. Информация по передаваемой учетной дате: [Показать ответ]

№	Название тега	Наименование	Обязательность	Параметр	Тип	Комментарий
	<Type>	Начало блока по учетным датам	ДА	-	-	-
	<Credit>	Информация по учетной дате	ДА	-	-	-
1	<CreditLimit>	Сумма кредита	ДА	-	Double (десятичное число)	Значения параметра currency cм. в справочнике «Коды валют»
1	<CreditLimit>	Сумма кредита	ДА	currency	String (строка)	Значения параметра currency cм. в справочнике «Коды валют»
2	<RecordsList>	Блок информации по учетным записям	ДА	-	-	-
2.1	<Record>	Информация по учетной записи	ДА	accountingDate	Date (дата)	Формат: ГГГГ-ММ-ДД
2.1.1	<ResidualAmount>	Остаточная сумма	ДА	-	Double (десятичное число)	Значения параметра currency cм. в справочнике «Коды валют»
2.1.1	<ResidualAmount>	Остаточная сумма	ДА	currency	String (строка)	Значения параметра currency cм. в справочнике «Коды валют»

Записи по обеспечениям

В данном разделе содержится информация о видах обеспечения.

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

1.	<Collaterals>  
2.	 <Collateral statusId="1" typeId="5"/>
3.	</Collaterals>

Таблица 22. Записи по обеспечениям: [Показать ответ]

№	Название тега	Наименование	Обязательность	Параметр	Тип	Комментарий
	<Collaterals>	Начало блока по обеспечениям	НЕТ	-	-	Если передано, то сохраняем
1	<Collateral>	Вид залога/заклада	НЕТ	typeId	Int (целое число)	Если передано, то сохраняем См. справочник «Вид залога/заклада»
1	<Collateral>	Вид залога/заклада	НЕТ	statusId	Int (целое число)	Если передано, то сохраняем См. справочник «Статус предмета залога»

Записи по субъектам физическим лицам

В данном разделе содержится информация о субъекте контракта, его идентификационных данных, адресе субъекта, а также информация по контактным данным субъекта. Каждый контракт может содержать несколько субъектов, имеющих отношение к контракту.

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

1.	<Subjects>  
2.	 <Subject roleId="1">  
3.	  <Entity>  
4.	   <Individual>  
5.	    <FirstName>  
6.	     <Text language="ru-RU">ИМЯ</Text>  
7.	    </FirstName>  
8.	    <Surname>  
9.	     <Text language="ru-RU">ФАМИЛИЯ</Text>  
10.	    </Surname>       
11.	    <FathersName>  
12.	     <Text language="ru-RU">ОТЧЕСТВО</Text>  
13.	    </FathersName>       
14.	    <Residency id="1"/>
15.	    <DateOfBirth>1989-01-01</DateOfBirth>  
16.	    <Identifications>  
17.	     <Identification rank="1" typeId="14">  
18.	      <Number>890101402472</Number>  
19.	     </Identification>  
20.	     <Identification rank="2" typeId="7">  
21.	      <Number>123456789</Number>  
22.	     </Identification>  
23.	    </Identifications>  
24.	    <Addresses>  
25.	     <Address katoId="750000000" locationId="110" typeId="1">  
26.	      <StreetName>  
27.	       <Text language="ru-RU">пр. Достык</Text>  
28.	      </StreetName>  
29.	     </Address>  
30.	     <Address katoId="750000000" locationId="110" typeId="6">  
31.	      <StreetName>  
32.	       <Text language="ru-RU">пр. Достык</Text>  
33.	      </StreetName>  
34.	     </Address>  
35.	    </Addresses>  
36.	   </Individual>  
37.	  </Entity>  
38.	 </Subject>  
39.	</Subjects>

Таблица 23. Записи по субъектам физическим лицам: [Показать ответ]

№	Название тега	Наименование	Обязательность	Параметр	Тип	Комментарий
	<Subjects>	Начало блока по субъектам	ДА	-	-	-
1	<Subject>	Информация о субъекте	ДА	roleId	Int (целое число)	См. справочник «Роль субъекта»
2	<Entity>	Блок «Вид субъекта»	ДА	-	-	-
3	<Individual>	Физическое лицо	ДА	-	-	-
4	<FirstName>	Имя субъекта	ДА	-	-	-
4.1	<Text>	Текстовое поле для имени субъекта	ДА	-	String (строка)
4.1	<Text>	Текстовое поле для имени субъекта	ДА	language	String (строка)
5	<Surname>	Фамилия субъекта	ДА	-	-	-
5.1	<Text>	Текстовое поле для фамилии субъекта	ДА	-	String (строка)
5.1	<Text>	Текстовое поле для фамилии субъекта	ДА	language	String (строка)
6	<FathersName>	Отчество субъекта	ДА/НЕТ	-	-	-
6.1	<Text>	Текстовое поле для отчества субъекта	ДА/НЕТ	-	String (строка)
6.1	<Text>	Текстовое поле для отчества субъекта	ДА/НЕТ	language	String (строка)
7	<Residency>	Признак резиденства	ДА	id	Int (целое число)	См. справочник «Признак резиденства»
8	<DateOfBirth>	Дата рождения	ДА	id	Date (дата)	Формат: ГГГГ-ММ-ДД
9	<Identifications>	Начало блока по документам	ДА	-	-	-
10	<Identification>	Информация по документу	ДА	rank	Int (целое число)	См. справочник «Категория документа»
10	<Identification>	Информация по документу	ДА	typeId	Int (целое число)	См. справочник «Вид документа»
11	<Number>	Номер документа	ДА	-	String (строка)	-
12	<IssueDate>	Дата выдачи документа	НЕТ	-	Date (дата)	Если передано, то сохраняем Формат ГГГГ-ММ-ДД
13	<Addresses>	Начало блока по адресам субъекта	ДА	-	-	-
14	<Address>	Информация по адресу	ДА	typeId	Int (целое число)	См. справочник «Тип адреса»
				locationId	Int (целое число)	Значение параметра locationId заполняется кодом страны. См. справочник «Список стран»
				katoId	String (строка)	Наименование города/населенного пункта (используется значение КАТО). См. справочник «Коды КАТО»
15	<StreetName>	Название улицы	ДА	-	-	-
15.1	<Text>	Текстовое поле для названия улицы	ДА	-	String (строка)	Значение поля «Название улицы» должно быть указано хотя бы на одном из трех языков. Возможные значения параметра language см. в справочнике «Поддерживаемые языки»

Справочники

Следующие списки представляют собой базовые начальные данные, доступные в системе, но которые могут быть изменены либо дополнены.

Вид проводимой операции

id	Наименование
1	Вставить
2	Обновить

Вид финансирования <FundingType>

id	Наименование
2	Займ

Цель кредита 2 <CreditPurpose2>

id	Наименование
1	Потребительские цели

Объект кредитования <CreditObject>

id	Наименование
03	Потребительские товары и услуги (кроме автотранспорта)
04	Автомобильный транспорт

Фаза контракта <ContractPhase>

id	Наименование
4	Действующий
5	Завершен

Статус контракта <ContractStatus>

id	Наименование
1	Стандартный
2	Просроченный
5	Ссудная/дебиторская задолженность списана на убытки в связи с признанием должника банкротом по закону о БФЛ
При передаче контрактов в 1 день:
4	Новый займ

Местонахождение филиала <BranchLocation>

id	Наименование
110000000	Акмолинская область
150000000	Актюбинская область
190000000	Алматинская область
230000000	Атырауская область
630000000	Восточно-Казахстанская область
310000000	Жамбылская область
270000000	Западно-Казахстанская область
350000000	Карагандинская область
390000000	Костанайская область
430000000	Кызылординская область
470000000	Мангистауская область
550000000	Павлодарская область
590000000	Северо-Казахстанская область
610000000	Туркестанская область
750000000	г.Алматы
710000000	г.Нур-Султан
790000000	г.Шымкент

Тип адреса (AddressType)

id	Наименование
1	Место прописки
6	Постоянное место жительства

Поддерживаемые языки (language)

id	Наименование
kk-KZ	Казахский - Казахстан
ru-RU	Русский - Россия
en-GB	Английский - Великобритания

Вид залога/заклада (CollateralType)

id	Наименование
1	Ювелирные изделия и другие изделия из драгоценных металлов и драгоценных камней
2	Бижутерия, монеты, недрагоценные металлы и изделия из них
3	Транспортные средства
4	Электротехническое оборудование
5	Устройства сотовой связи
6	Произведения искусства, предметы коллекционирования и антиквариат
7	Иные вещи

Статус предмета залога (CollateralStatus)

id	Наименование
1	Обеспечение по займу
2	Подлежит реализации во внесудебном порядке
3	Реализован во внесудебном порядке
4	Выкуплено заемщиком
5	Изъят правоохранительными органами

Вид стоимости обеспечения <Value>

id	Наименование
1	Рыночная стоимость
2	Страховая стоимость
3	Внутренняя оценка
4	Стоимость по соглашению сторон

Роль субъекта (SubjectRole)

id	Наименование
1	Заемщик

Состояние <State>

id	Наименование
1	Новое
2	Б/У

Единицы измерения массы <Weight>

id	Наименование
1	Миллиграмм (мг)
2	Грамм (г)
3	Килограмм (кг)

Единицы измерения длины <Length> и ширины <Width>

id	Наименование
1	Миллиметр (мм)
2	Сантиметр (см)
3	Метр (м)

Пол <Gender>

id	Наименование
M	Мужской
F	Женский

Признак резиденства <Residency>

id	Наименование
1	Резидент
2	Нерезидент

Статус субъекта <NegativeStatus>

id	Наименование
11	Клиент не имеет негативной информации
21	Залоговое имущество клиента изъято правоохранительными органами

Вид документа (IdentificationType)

id	Наименование
6	Паспорт гражданина РК
7	Удостоверение личности
8	Вид на жительство иностранца в РК
14	ИИН
17	Удостоверение лица без гражданства (физ. лицо)
18	Удостоверение беженца (физ. лицо)
19	Паспорт гражданина иностранного государства (физ. лицо)

Категория документа (IdentificationRank)

id	Наименование
1	Первичная оценка (только для ИИН)
2	Вторичная оценка (для остальных документов)
3	Третья оценка

Коды валют

id	Наименование
EUR	Евро
KZT	Казахстанский тенге
RUR	Российский рубль
USD	Доллар США

Вид связи (CommunicationType)

id	Наименование
1	Домашний
2	Офисный
3	Мобильный

Коды ошибок сервиса BatchProcessingWebService

id	Наименование
BATCH-1	Файл "%s" не найден.
BATCH-2	Данный тип файла не поддерживается.
BATCH-3	Данный тип FTP соединения не поддерживается.
BATCH-4	Указанный файл "%s" является директорией.
BATCH-5	Ошибка при копировании файла.
BATCH-6	Ошибка при удалении файла.
BATCH-7	Размер файла не должен превышать %s МБ
BATCH-8	Импортируемый формат файла не поддерживается.
BATCH-9	Путь к файлу "%s" или имя файла "%s" содержит некорректные символы.
FAULT-001	Ошибка обращения к базе данных.
FAULT-002	Ошибка HTTP-подключения.
FAULT-003	Ошибка подключения к LDAP.
FAULT-004	Ошибка подключения.
FAULT-005	Ошибка ввода-вывода.
FAULT-006	Программная ошибка.
FAULT-007	Внутренняя системная ошибка.
FAULT-008	ОШИБКА: Данные не найдены.
FAULT-009	ОШИБКА: Файл не найден.
FAULT-010	ОШИБКА: Доступ запрещен.
FAULT-011	ОШИБКА: Объект был изменен в параллельной транзакции.
FAULT-012	Ошибка валидации.
FAULT-013	Ошибка при проверке целостности данных.
FAULT-014	Ошибка на уровне ESB.
FAULT-022	Ошибка при автоматической загрузке данных.
FAULT-023	Ошибка при получении отчета.
FAULT-024	Не удалось сформировать кредитный отчет.
FAULT-025	Превышено время ожидания
SBF-AD-1	Пользователь %s не имеет прав для выполнения действия: "%s".
SBF-AD-2	Пользователь %s не имеет прав для отправки нотификаций, для данных получателей.
SBF-AD-3	Пользователь %s не имеет прав для просмотра информации по файлу №%s.
SBF-AD-4	Пользователь %s не имеет прав для изменения статуса пользователя %s.
SBF-AD-5	Перед созданием пользователя активируйте клиента.
SBF-CM-1	Объект был модифицирован в другой транзакции методом:"%s"
SBF-CM-2	Организация была модифицирована в другой транзакции.
SBF-CM-3	Физическое лицо было модифицировано в другой транзакции.
SBF-DNF-1	Запрошенные данные не найдены, во время выполнения метода: "%s"
SBF-DNF-2	Пользователь %s не найден.
SBF-DNF-3	Пользователь с идентификатором %s не найден.
SBF-DNF-4	Кредитор с идентификатором %s не найден.
SBF-DNF-5	Контракт с идентификатором %s не найден.
SBF-DNF-6	Язык с кодом "%s" не найден.
SBF-DNF-7	Субъект не найден.
SBF-IC-1	Ошибка в процессе генерации отчета. Более одного субъекта найдено по данному запросу.
SBF-IC-2	Ошибка в процессе генерации отчета. Более одного контракта найдено по данному запросу.
SBF-IC-3	Обнаружен дубликат объекта при сохранении методом: %s.
SBF-IC-4	При сохранении обнаружен дубликат субъекта "%s".
SBF-IC-5	При сохранении обнаружен дубликат контракта "%s".
SBF-SC-1	Не пройдена проверка действительности сертификационного пути.
SBF-SC-9	Не пройдена проверка штампа времени.
VAL-C-CO	Контракт: задан некорректный объект кредитования.
VAL-C-CP	Контракт: задана некорректная фаза договора.
VAL-C-CPT	Контракт: задано некорректное значение поля "Цель кредита 2".
VAL-C-CS	Контракт: задан некорректный статус договора.
VAL-C-CT	Контракт: задан некорректный вид финансирования
VAL-C-CUR	Контракт: задан некорректный тип валюты
VAL-S-DS	Субъект: задан некорректный статус субъекта.
VAL-S-DT	Субъект: задана некорректная роль.
VAL-S-P-C	Субъект: задан некорректный код гражданства
VAL-S-RT	Субъект: задан некорректный тип резидентства.
VAL-C-019	Запрещается переводить контракт из статуса "Активный" в "Предварительный".
VAL-C-099	В поле «%s» значение не передано либо не соответствует справочнику
VAL-C-103	В поле "%s": для справочника «Location» возможна передача только кода Страны. Использование кодов для Города, Области не допускается.
VAL-D-001	Поле "%s" обязательно для заполнения при загрузке день в день.
VAL-DC-001	Поле "Статус контракта" может принимать только значение "4-Новый займ".
VAL-DC-002	Контракт существует в системе и не может быть загружен заново со статусом "Новый займ".
VAL-S-283	В поле «%s»: при «Location» со значением «Казахстан» - передача «КАТО» обязательно. При «Location» со значением не «Казахстан» - передача «КАТО» не корректно.
VAL-PWSH-C-004	Значение поля "Дата завершения срока действия контракта" должно быть больше значения поля "Дата начала действия контракта".
VAL-PWSH-C-006	В поле "Фаза контракта" установлено значение "Завершен". В этом случае поле "Дата фактического завершения" обязательно для заполнения и его значение не может быть меньше или равным 01-01-1900, а также больше текущей даты.
VAL-PWSH-C-008	При «Фазе контракта» со значением «4-Действующий» значение поля «Остаточная сумма» должно быть больше либо равно 0 (нулю). Если значение поля «Остаточная сумма» больше 0 (нуля), то значение поля «Сумма просроченных платежей» может быть больше либо равно 0 (нулю). Если значение поля «Остаточная сумма» равно 0 (нулю), то значение поля "Сумма просроченных платежей" должно быть больше 0 (нуля).
VAL-PWSH-C-010	Если значение поля "Количество дней просрочки" больше 0 (нуля), то значение поля "Сумма просроченных платежей" должно быть больше 0 (нуля).
VAL-PWSH-C-011	Значение поля «Сумма просроченных платежей» не может быть меньше 0 (нуля).
VAL-PWSH-C-012-1	Контракт не может быть сохранен, если не заполнены следующие данные: "Код контракта", "Дата начала срока действия договора", "Дата окончания срока действия договора", "Сумма кредита" (с указанием валюты).
VAL-PWSH-C-013	Если значение поля "Сумма просроченных платежей" равно 0 (нулю), то значение поля "Количество дней просрочки" должно быть равно 0 (нулю).
VAL-PWSH-C-014	Значение поля "Дата завершения срока действия договора" не может принимать значение меньше или равно 01-01-1900.
VAL-PWSH-C-017	Необходимо корректно заполнить значение поля "Валюта" для следующих полей: "Сумма договора", "Остаточная сумма", "Сумма просроченных платежей", "Стоимость залога/заклада".
VAL-PWSH-C-061	Поле "Цель кредита 2" обязательно для заполнения.
VAL-PWSH-C-062	Поле "Объект кредитования" обязательно для заполнения.
VAL-PWSH-C-070	Значение поля "Дата начала срока действия договора" не может быть <= 01-01-1900 и больше текущей даты.
VAL-PWSH-C-134	Поле "Серийный номер/VIN-код" обязательно к заполнению ~~только~~ для вида залога/заклада "3-Транспортные средства".
VAL-PWSH-C-135	Значение поля «Наименование залога/заклада» должно быть указано хотя бы на одном из трех языков
VAL-PWSH-C-136	Поле "Модель" обязательно к заполнению для видов залога/заклада: "3-Транспортные средства", "4-Электротехническое оборудование", "5-Устройства сотовой связи".
VAL-PWSH-C-137	Поле "Вес" обязательно к заполнению для вида залога/заклада: "1-Ювелирные изделия и другие изделия из драгоценных металлов и драгоценных камней".
VAL-PWSH-C-138	Поле "Цвет" обязательно к заполнению для видов залога/заклада: "3-Транспортные средства".
VAL-PWSH-C-139	Поле "Дата изготовления" обязательно к заполнению для видов залога/заклада: "3-Транспортные средства".
VAL-PWSH-C-146-1	В поле "Фаза контракта" установлено значение "Действующий". В этом случае поле "Фактическая дата завершения" должно быть пустым.
VAL-PWSH-C-149	Значение поля "Учетная дата" не может быть больше текущей даты и меньше или равно 01-01-1900.
VAL-PWSH-C-152	Значение поля «Сумма кредита» должно быть больше 0 (нуля).
VAL-PWSH-C-203	У субъекта не должно быть более одного актуального идентификационного документа одного вида
VAL-PWSH-C-213	При передаче значения поля "Сумма просроченных платежей" больше 0 (нуля) поле "Количество дней просрочки" обязательно для заполнения и его значение должно быть больше 0 (нуля.)
VAL-PWSH-C-300	Одна учетная дата может встречаться только один раз.
VAL-PWSH-C-470	Если в поле "Фаза контракта" указано "5-Завершен", то значения полей "Остаточная сумма", "Сумма просроченных платежей" и "Количество дней просрочки" должны быть равны 0 (нулю).
VAL-PWSH-C-479	Значение поля "Количество дней просрочки" не может быть меньше 0 (нуля).
VAL-PWSH-C-480	Значение поля "Остаточная сумма" не может быть меньше 0 (нуля).
VAL-PWSH-PS-004	Поле "Признак резиденства" обязательно для передачи
VAL-PWSH-PS-007	Поля "Постоянное место жительства" и "Место прописки" обязательны к передаче
VAL-PWSH-S-001	Поле "Роль субъекта" может принимать только значение "1-Заемщик"
VAL-PWSH-S-002	Поле "Дата выдачи документа" обязательно для заполнения и его значение не может быть меньше 01-01-1900 и больше текущей даты, за исключением вида документа "14-ИИН".
VAL-PWSH-S-003	У субъекта для всех связанных контрактов необходимо заполнить значение поля "Роль"
VAL-PWSH-S-004	Поле "Номер документа" для документов вида "ИИН" не может принимать следующие значения: '000000000000', '111111111111', '222222222222', '333333333333', '444444444444', '555555555555', '666666666666', '777777777777', '888888888888', '999999999999', '123456789012'
VAL-PWSH-S-005	Тип контакта "Мобильный телефон" обязателен для передачи по субъекту
VAL-PWSH-S-006	Некорректно заполнен адрес: поле "Улица" должно быть указано хотя бы на одном из трех языков.
VAL-PWSH-S-011	По субъекту передан идентификационный документ некорректного типа
VAL-PWSH-S-012	По субъекту передан адрес некорректного типа.
VAL-PWSH-S-203	1. Обязательна передача значения ИИН и номера документа для следующих документов: 6-Паспорт гражданина РК, 7-Удостоверение личности, 8-Вид на жительство иностранца в РК, 17-Удостоверение лица без гражданства (физ. лицо). 2. Обязательна передача только номера документа для следующих документов: 18-Удостоверение беженца (физ. лицо), 19-Паспорт гражданина иностранного государства (физ. лицо).
VAL-PWSH-S-206	Значение поля "Номер документа" для прикрепленного документа вида "ИИН" должно содержать 12 цифр
VAL-PWSH-S-207	Поля "Имя" и "Фамилия" должны быть заполнены хотя бы на одном языке.
VAL-PWSH-S-270	Поле "Пол" обязательно для передачи.
VAL-PWSH-S-279	Значение поля "Дата рождения" обязательно к заполнению и не может быть меньше 01-01-1900 или больше текущей даты.

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

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

Технический документ для поставщиков информации Ломбард и получателей кредитных отчетов «Загрузка данных»-Ломбард

Содержание

Подключение к системе «БДКИ» через Интернет

Требования

Адреса

Передача договоров

Общая информация по договору

Информация по учетным датам

Записи по обеспечениям

Записи по субъектам физическим лицам

Процесс загрузки данных

Сервис загрузки пакетов BatchProcessingWebService

Метод uploadFile сервиса BatchProcessingWebService

Метод getImportInfo сервиса BatchProcessingWebService

Метод getImportDetailInfo сервиса BatchProcessingWebService

Ошибки web-сервиса

Бизнес-ошибки ScbBusinessFault

Бизнес-ошибки ScbValidationFault

Бизнес-ошибки ScbValidationFault

Входные параметры paginationSupportDto

Правила бизнес-логики

Передача информации в 1 день

Общая информация по договору

Информация по учетным датам

Записи по обеспечениям

Записи по субъектам физическим лицам

Справочники

Навигация

Поиск