Вы находитесь на странице: 1из 123

Спецификация B2B-интерфейса

V. 2.35 от 25.09.2019
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Оглавление
1. Введение ............................................................................................................................................... 4
1.1 Перекрестные ссылки ......................................................................................................................................................... 4
1.2 Цель документа ...................................................................................................................................................................... 4
1.3 Контроль изменений........................................................................................................................................................... 4
2. Поддерживаемые форматы.................................................................................................................. 4
2.1 Типы полей ............................................................................................................................................................................... 4
2.2 Обязательность и кодировка значений полей...................................................................................................... 5
3. Поддерживаемые протоколы транспортного уровня........................................................................... 5
3.1 Протокол HTTPS ..................................................................................................................................................................... 5
4. Формат XML ........................................................................................................................................... 6
4.1 Объект structure ..................................................................................................................................................................... 6
4.2 Объект collection .................................................................................................................................................................... 6
4.3 Объект attribute ...................................................................................................................................................................... 6
4.4 Объект pair ................................................................................................................................................................................ 6
4.5 Объект null ................................................................................................................................................................................ 6
4.6 Пример XML- структуры .................................................................................................................................................... 6
5. Запрос в Бюро (входной XML - поток) ................................................................................................... 7
5.1 Входной XML-поток и протокол передачи HTTPs ............................................................................................... 7
5.2 Заголовок запроса - Header.Session .......................................................................................................................... 11
5.3 Финансовая информация EnquiryRequest ............................................................................................................ 12
5.4 Информация о решении по кредитному заявлению - EnquiryRequest.Decision............................... 16
5.5 Информация о Заемщике EnquiryRequest.Consumer....................................................................................... 18
5.5.1 Поля согласия субъекта ......................................................................................................................................... 25
5.5.2 Допустимые Типы основного удостоверения и типы дополнительного удостоверения
(Primary ID Type and Secondary ID Type)................................................................................................................... 27
5.6 Работодатель EnquiryRequest.Consumer.[].Employer or Enquiry Employer .......................................... 29
5.7 Адрес субъекта EnquiryRequest.Consumer.[].Address.[] or Enquiry Address ........................................ 31
6. Ответ Бюро (выходной XML- поток) .................................................................................................... 32
6.1 Верхний уровень XML ответа....................................................................................................................................... 39
6.2 Ошибки проверки корректности ValidationErrors.[]....................................................................................... 39
6.3 Резюме Consumer.[].Summary ...................................................................................................................................... 39
6.4 Предупреждения Consumer.[].Warnings.[]............................................................................................................. 45
6.5 Записи CAIS (фактически имеющиеся кредиты) Consumer.[].CAIS.[]..................................................... 45
6.6 Финансовая информация счета CAIS (фактически имеющийся кредит) ............................................ 47
6.6.1 Тип обеспечения счета CAIS. ................................................................................................................................ 50
6.6.2 Формат Процентной ставки................................................................................................................................. 50
6.6.3 Запрос кредитной истории юридичесого лица. ........................................................................................ 50

www.bki-okb.ru 1
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.6.4 Запрос кредитной истории поручителя........................................................................................................ 50


6.7 История платежей счета CAIS Consumer.[].CAIS.[].MonthlyHistory.[] ...................................................... 51
6.8 Информация о владельце счета CAIS Consumer.[].CAIS.[].Consumer.[0] ................................................ 51
6.9 Информация о работодателе владельца счета CAIS Consumer.[].CAIS.[].Consumer.[0].Employer
.............................................................................................................................................................................................................. 53
6.10 Информация об адресе владельца счета CAIS Consumer.[].CAIS.[].Consumer.[0].Address.[] ..... 54
6.11 Информация о судебных решениях Consumer.[].CAIS.[]. Consumer.[].Legal.[] ................................. 54
6.12 Информация о договорах поручительства Consumer.[].CAIS.[]. Consumer.[].Warranty.[].......... 55
6.13 История по договору поручительства Consumer.[].CAIS.[]. Consumer.[].Warranty.[].History.[]
.............................................................................................................................................................................................................. 58
6.14 Информация о договорах залога Consumer.[].CAIS.[].Lien.[] ..................................................................... 59
6.15 Информация о льготном периоде (ипотечные каникулы) Consumer.[].CAIS.[].
MortgageHoliday.[] ...................................................................................................................................................................... 61
6.16 Информация о переуступке прав Consumer.[].CAIS.[]. Assignee.[] .......................................................... 61
6.17 Банковская гарантия Consumer.[].CAIS.[].Guarantee.[] ........................................................................... 62
6.18 Банковская гарантия Consumer.[].GUAR[]. ......................................................................................................... 62
6.19 Информация о субъекте Банковской гарантии в бюро Consumer.[].GUAR.[].Consumer.[0] ..... 63
6.20 Информация об адресе субъекта Банковской гарантии в бюро
Consumer.[].GUAR.[].Consumer.[].Address.[] .................................................................................................................. 65
6.21 История паспортов и имен Consumer.[].NameIDHistory.[] .................................................................... 66
6.22 Запрос в бюро CAPS Consumer.[].CAPS.[] ........................................................................................................ 67
6.23 Финансовая информация запроса в бюро.......................................................................................................... 69
6.24 Информация о решениях по заявлениям Consumer.[].CAPS.[].Decision .............................................. 70
6.25 Информация о субъекте запроса в бюро Consumer.[].CAPS.[].Consumer.[0]..................................... 71
6.26 Информация о работодателе субъекта запроса в бюро
Consumer.[].CAPS.[].Consumer.[0].Employer .................................................................................................................. 74
6.27 Информация об адресе субъекта запроса в бюро Consumer.[].CAPS.[].Consumer.[0].Address.[]
.............................................................................................................................................................................................................. 75
6.28 Информация о предыдущем результате проверки субъекта запроса в бюро
Consumer.[].CAPS.[]. Consumer.[0].Verification ............................................................................................................. 76
6.29 Информация о результате проверки субъекта запроса в бюро Consumer.[].PVS ......................... 76
6.30 Информация из базы данных СПАРК о юридических лицах Consumer.[]. ExtDB1[] .................... 77
6.31 Информация из базы данных СПАРК о индивидуальных предпринимателях Consumer.[].
ExtDB2[] ........................................................................................................................................................................................... 78
6.32 Информация Скоринг Бюро Consumer.[0].BureauScore[]...................................................................... 78
6.33 Информация о подписчике Subsection .[0].SubscriberDetails .............................................................. 82
6.34 Информация о банкротстве Consumer.[].BankruptcyProcedure[]........................................................... 83
6.33.1 Consumer.[]. BankruptcyProcedure[] ......................................................................................................... 83
6.34.2 Consumer.[].BankruptcyProcedure[].BankruptcyComissioner ............................................................. 84
6.34.3 Consumer.[].BankruptcyProcedure[].BankruptcyConsumer .................................................................. 85

www.bki-okb.ru 2
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.34.4 Consumer.[].BankruptcyProcedure[].BankruptcyRecord[] ............................................................... 86


7. Типы запросов ..................................................................................................................................... 86
7.1 Стандартный запрос (Standard Credit Enquiry) .................................................................................................. 86
7.1.1 XML Input ........................................................................................................................................................................ 86
7.1.2 XML Output ..................................................................................................................................................................... 87
7.2 Запрос Расширенного кредитного отчета (Extended Credit Enquiry) .................................................... 93
7.2.1 XML – запрос.................................................................................................................................................................. 93
7.2.2 XML ответ ....................................................................................................................................................................... 93
7.2.3 Структура XML Расширенного кредитного отчета приведена ниже ............................................ 93
7.3 Запрос на передачу заявления на получение кредита (Application Load Enquiry) ......................... 95
7.3.1 XML – запрос.................................................................................................................................................................. 95
7.3.2 XML – ответ .................................................................................................................................................................... 96
7.4 Запрос на обновление Решения по заявлению на получение кредита (CAPS Decision Update)
.............................................................................................................................................................................................................. 96
7.4.1 XML-запрос .................................................................................................................................................................... 96
7.4.2 XML-ответ .....................................................................................................................................................................103
7.5 Запрос наличия кредитной истории (Existence Check Enquiry) ..............................................................103
7.5.1 XML – запрос................................................................................................................................................................103
7.5.2 XML ответ .....................................................................................................................................................................103
7.6 Запрос информационной части (Info Part Enquiry) .......................................................................................104
7.6.1 XML – запрос................................................................................................................................................................104
7.6.2 XML – ответ ..................................................................................................................................................................104
7.7 Запрос Отдельного Скоринга бюро (Score Credit Enquiry) ........................................................................113
7.7.1 XML-запрос ..................................................................................................................................................................113
7.7.2 XML-ответ .....................................................................................................................................................................113
8. Ошибки .............................................................................................................................................. 114
8.1 Ошибки обработки ..........................................................................................................................................................114
8.2 Ошибки проверки корректности.............................................................................................................................114
8.3 Ошибки кодирования ....................................................................................................................................................116
8.4 Ошибки по блоку «Решение по кредитному заявлению» ..........................................................................116
8.5 Описание предупреждений ........................................................................................................................................117
9. Собственные данные ......................................................................................................................... 118
10. «Маскируемая часть» - поля и правила отображения .................................................................... 119
11. Проверки ......................................................................................................................................... 120
Приложение 1. Схемы запросов и формирования информационной части ........................................ 121

www.bki-okb.ru 3
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

1. Введение
Подписчики (Пользователи) Бюро могут получать Кредитные отчеты, содержащие кредитные истории
субъектов, используя WEB-интерфейс или B2B-интерфейс (CPU-интерфейс, XML-интерфейс).

B2B-Интерфейс дает возможность пользователям направлять свои запросы из своей информационной


системы в систему кредитного Бюро, минуя операцию ручного ввода.

Информационная система Подписчика формирует XML запрос, содержащий заявку о предоставлении


кредита и сведения о потенциальном заявителе. Информационная система Бюро отвечает XML ответом,
содержащим информацию об этом заявителе, которая была выбрана из базы данных Бюро.

Информационная система Подписчика сохраняет эти данные и проводит их анализ/интерпретацию с


целью оценки кредитоспособности потенциального заемщика.

1.1 Перекрестные ссылки


Документ «Значения кодов полей»
Документ «Описание данных CAIS»
Документ «Регламент технического подключения к бюро»

1.2 Цель документа


Цель данного документа – определить поддерживаемые форматы данных поискового запроса и ответа;
определить процесс валидации, через который проходит запрос; и определить поддерживаемые
протоколы, посредством которых происходит отправка запросов и ответов бюро.

1.3 Контроль изменений


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

2. Поддерживаемые форматы
B2B-Интерфейс поддерживает формат XML, который используется для передачи данных. Данный
формат позволяет использовать любые символы Unicode, при условии представления их с помощью
последовательности XML escape (&#n; где n – это десятичное Unicode значение данного символа).
Входные и выходные потоки данных в XML имеют определенную структуру и описываются с помощью
ограниченного набора различных объектов и атрибутов. Преимущества XML состоят в том, что данные в
этом формате легко читаются, так как каждый блок данных носит определенное наименование; нет
необходимости в том, чтобы отправлять каждый блок данных отдельно; если блок опционален, то его
просто можно опустить. Текстовые данные при отправке сохраняют исходный размер, нет
необходимости дополнять их до определенной длины. Существует множество стандартных средств для
чтения и работы с XML. К недостаткам XML можно отнести то, что наименование каждого атрибута
также является частью данных, и по этой причине потоки XML-данных могут быть довольно длинными.
2.1 Типы полей
Поля ввода и вывода имеют следующие основные типы: TEXT (текст), NUMERIC (числовой), CODE (код),
DATE (дата) и TIMESTAMP (временная метка).
• Значения поля TEXT могут содержать любой допустимый символ (длина указана в таблице с
описанием полей).
• Значения поля NUMERIC могут содержать цифры (0-9) (длина указана в таблице с описанием
полей).

www.bki-okb.ru 4
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

• Значения поля CODE должны обязательно содержать допустимый код в соответствии с


документом «Значения кодов полей».
• Значения поля DATE должны обязательно содержать 8 разрядов (0-9) и отражать допустимую
дату по Григорианскому календарю в формате YYYYMMDD. Даты до 1900 года являются
недопустимыми.
• Значения поля TIMESTAMP должны обязательно содержать 14 разрядов (0-9) и указывать
допустимую дату по Григорианскому календарю и время в формате YYYYMMDDHHMMSS.
Временные метки до 1900 года не допустимы.
Десятичные дробные значения (Decimal) должны содержать цифры от 0 до 9 и точку в качестве
разделителя целой и дробной частей. Использование этого типа предполагает, что в случае
необходимости значение будет дополнено нулями до требуемой длины.
Данное значение подразумевает использование M цифр для обозначения целой части, и N цифр – для
дробной. Разделитель обязателен и не может быть опущен или заменен на другой символ кроме точки
(.).
Допускается использование только положительных чисел, знак (+) в этом случае не ставится.
Пример Decimal (M.N):
Decimal 4.3:
123,456 (или 123.456) => 0123.456
123 => 0123.000 (целое число дополнено нулями в дробной его части, чтобы удовлетворить
требованиям этого типа данных)
56,01 => 0056.010
Decimal 6.2:
123456,7 => 123456.70
123 => 000123.00
56,01 => 000056.01
2.2 Обязательность и кодировка значений полей
Обязательность полей указана в столбце «M».

М (mandatory) Обязательное поле - поле должно присутствовать и содержать допустимое значение.


C (conditional) Условно обязательное поле - в зависимости от присутствия и содержания других полей
поле должно присутствовать и содержать допустимое значение.
Если графа не заполнена, данное поле необязательно для заполнения.

Допустимые значения кодируемых полей перечислены в документе «Значения кодов полей».

3. Поддерживаемые протоколы транспортного уровня


B2B-интерфейс поддерживает протокол передачи – HTTPS.
3.1 Протокол HTTPS
Для организации запроса используется протокол HTTPS и технология Web-сервера (IIS). Такой запрос
пересылается на сервер точно так же, как и любой HTML-документ. Ответом является файл
определенного формата (XML), содержащий только данные, а не HTML-файл, который содержит данные
и команды отображения.

Транспортный протокол HTTPS имеет следующие преимущества.


• Технология Web-серверов является дешевой (встроена в Windows).
• Не требуется настройка брандмауэров, поскольку большинство брандмауэров поддерживают
протокол HTTPS.
• Защита от перехвата и искажения информации легко обеспечивается с помощью протокола
HTTPS.

www.bki-okb.ru 5
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

4. Формат XML
Формат XML может быть составлен с использованием как коротких, так и длинных имен. В
возвращаемом XML используются только короткие имена объектов и атрибутов. Использование
коротких имен значительно сокращает размер XML-потоков, которые необходимо посылать в
Кредитное Бюро и принимать из него. Формат XML основан на использовании следующих типов и
атрибутов объектов.
4.1 Объект structure
Объект structure (структура) использует имя объекта “struct” или “s”. Этот объект содержит лишь
внутренние объекты. Каждый из внутренних объектов структуры должен обязательно иметь
уникальный атрибут “name” или “n”.
4.2 Объект collection
Объект collection ( коллекция) использует имя объекта “coll” или “c”. Объект- коллекция содержит лишь
вложенные объекты (обычно того же имени объекта). Эти вложенные объекты не имеют атрибута
“name” или “n”.
4.3 Объект attribute
Объект attribute (атрибут) использует имя объекта “attr” или “a”. Объект-атрибут содержит значение и
не содержит вложенных объектов. По умолчанию этим значением является текстовое значение с
нулевым значением атрибута, идентифицирующим нулевое текстовое значение. Тип объекта-атрибута
может быть далее определен с помощью атрибута “type” или “t”, который может принимать значения
“text” или “t”, “number” или “n”, или “date” или “d”. Объекты-атрибуты могут также иметь значение
“unknown” (неизвестное) или “no” (отсутствует). Для обозначения этого используется атрибут “status”
(состояние) или “s”, который может принимать значения “no_value” (значение отсутствует) или “0”, или
“value_unknown” (значение неизвестно) или “?”. Атрибуты состояния и типа (status и type) объекта-
атрибута не возвращаются в выходном XML-потоке.
4.4 Объект pair
Объект pair (пара) использует имя объекта “pair” или “p”. Объект-пара содержит строго два
неименованных вложенных объекта.
4.5 Объект null
Объект null (нуль) использует имя объекта “null” или “n”. Объект-нуль не имеет ни значения, ни
порожденных объектов.
4.6 Пример XML- структуры

Пример иллюстрирует XML - сообщение, используемые в B2B-интерфейсе Бюро.

<s>
<s n=”EnquiryRequest”> (запрос)
<a n=”reason” (основание) >02</a>
<a n=”financeType” (тип финансирования) >23</a>
<a n=”currency” (валюта) >EUR</a>
<a n=”creditLimit” (кредитный лимит) >2000</a>
<a n=”paymentFrequency” (частота платежей) >03</a>
<a n=”applicationChannel”(канал подачи заявления)>01</a>
<a n=”cbrFinanceType”(Тип финансирования по классификации ЦБ РФ)>03</a>
<c n=”Consumer”> (клиент)
<s>
<a n=”applicantType” (тип заявителя) >01</a>

www.bki-okb.ru 6
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<a n=”name1” (имя) >John</a>


<a n=”surname” (фамилия) >Smith</a>
<a n=”sex” (пол)>1</a>
<a n=”dateOfBirth” (дата рождения) >19650520</a>
<a n=”nationality” (национальность) >GB</a>
<a n=”primaryIDType” (тип основного удостоверения) >01</a>
<a n=”primaryID” (основное удостоверение личности) >4</a>
<a n=”secondaryIDType” (тип дополнительного удостоверения) >98</a>
<a n=”primaryIncome” (основной доход) >1400</a>
<a n=”primaryIncomeFreq” (частота получения основного дохода) >3</a>
<c n=”Address” (адрес) >
<s>
<a n=”addressFlag” (флаг адреса) >0</a>
<a n=”addressType” (тип адреса) >1</a>
</s>
<s>
<a n=”addressFlag” (флаг адреса) >1</a>
<a n=”addressType” (тип адреса) >1</a>
</s>
</c>
</s>
</c>
</s>
</s>

Примеры запроса и ответа на диске:


CD For_client_\DATA\Примеры XML запросов и ответов

5. Запрос в Бюро (входной XML - поток)


5.1 Входной XML-поток и протокол передачи HTTPs
При использовании протокола HTTPs отдельные поля формы (HTTP Form) используются для представления
различных частей общей XML-структуры запроса.

Field Name Имя поля Путь Формат Описание


Subscriber подписчик subscriberID Numeric Содержит код подписчика (SIN): 501

Group группа groupID Text Группа подписчика: GROUP


User пользователь userID Text Имя пользователя: Ivanov
Password пароль password Text Пароль для пользователя выше: 123
Function функция functionNbr Text Номер функции для данного запроса: 50
Это поле содержит полный набор данных
входящих в XML запрос (Информация и
Request запрос EnquiryRequest XML заемщике, адреса, работодатель и т.д.)
который зависит от номера функции
заданной в поле «функция»
Входной поток запроса, направляемого в Бюро, состоит из частей указанных в таблице.

www.bki-okb.ru 7
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Наименование Количество Описание


Header.Session 1 Идентификация запрашивающего пользователя
EnquiryRequest 1 Финансовая информация
EnquiryRequest.Decision 1 Информация о решениях по заявлениям
Информация о заявителе. Заявитель может быть
EnquiryRequest.Consumer 1 владельцем, совладельцем, принципалом и
поручителем
Сведения о работодателе заявителя
EnquiryRequest.Consumer.[].Employer 1
(необязательные)
Адрес заявителя: может быть действующим или
предыдущим. Тип адреса: а) фактический, адрес
не более
EnquiryRequest.Consumer.[].Address.[] регистрации, почтовый адрес (для физического
3
лица) б) рабочий, почтовый (для юридического
лица)

В запрос должен обязательно быть включен только один Субъект. Первый адрес должен быть текущим
фактическим адресом. Второй адрес может адресом регистрации. Блок сведения о работодателе не
обязателен для всех типов запросов.
Информация о
Финансовая Заемщик Работодатель Адрес
решении по
Заголовок информация EnquiryRequest. EnquiryRequest. EnquiryRequest.
кредитному
Header.Session EnquiryRequest Consumer Consumer.[]. Consumer.[].
заявлению
Employer Address.[]
Decision

1...n 1...n

обязательно

необязательно

Параметры протокола HTTP


Запрос выполняется методом HTTP POST на один из двух следующих URL:
https://ch-test.bki-okb.com/cpuEnquiry.asp
https://ch-test.bki-okb.com/cpuDecision.asp (используется только для двух функций CPU CAPS
Decision Update и CPU Application Load)

со следующими параметрами:

POST /cpuEnquiry.asp HTTP/1.1


Host: ch-test.bki-okb.com
Content-Type: application/x-www-form-urlencoded; Charset=windows-1251
Content-Length: 123456
Connection: Close

Кроме этого, необходимо задать параметры действительного клиентского сертификата


(см. «Регламент технического подключения к Бюро»). При использовании прокси-сервера необходимо
задать его параметры.

Кодирование XML-строки

С XML-запросом перед отправкой в бюро необходимо предварительно выполнить следующие


действия:

www.bki-okb.ru 8
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

1. Преобразовать в XML-строку, исключив символы Space #20, Tab #19, символы переноса сроки и
возврат каретки #13 и #10.
2. Полученную XML-строку посимвольно закодировать по правилам указанным в таблице,
используя в качестве входного Набора символов Юникод UTF8

Кода символа Представление Описание


[48..57] или [65..90])или Как есть Alphanumeric
[97..122]
Любой другой с кодом < %hh Hex escape - %hh
256
Код >= 256 %26%23nnnn%3B HTML escape &#nnnn; (with a Hex escape)
Код – десятичное представление UTF8

Пример XML-строки

Исходный запрос:

<?xml version="1.0" encoding="windows-1251"?>


<s n="EnquiryRequest">
<a n="accountClass">1</a>
<a n="accountClass">1</a>
<a n="reason">02</a>
<a n="financeType">02</a>
<a n="currency">RUB</a>
<a n="amountOfFinance">2000</a>
<a n="instalmentAmount">100</a>
<a n="paymentFrequency">03</a>
<c n="Consumer">
<s>
<a n="applicantType">01</a>
<a n="name1">Имя1</a>
...

Результат = поля Header (красным, не кодируется) &


поле Request=закодированная строка

(выделенные синим тэги препроцессора, можно исключить):

Subscriber=12345&Group=xxx&User=xxx&Password=xxxxxxxx&Function=50&Request=%3C%3Fxml%20version
%3D%221%2E0%22%20encoding%3D%22windows%2D1251%22%3F%3E%3Cs%20n%3D%22EnquiryRequest%2
2%3E%0A%20%20%3Ca%20n%3D%22accountClass%22%3E1%3C%2Fa%3E%0A%3Ca%20n%3D%22reason%22%
3E02%3C%2Fa%3E%0A%3Ca%20n%3D%22financeType%22%3E02%3C%2Fa%3E%0A%3Ca%20n%3D%22currenc
y%22%3ERUB%3C%2Fa%3E%0A . . .

Пример Escape-кодировки кириллицы

Строка: <a n="line2">Строителей</a>

Кодируется как:

www.bki-okb.ru 9
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

%3Ca%20n%3D%22line2%22%3E%26%231057%3B%26%231090%3B%26%231088%3B%26%231086%3B%26%2
31080%3B%26%231090%3B%26%231077%3B%26%231083%3B%26%231077%3B%26%231081%3B%3C%2Fa%3
E%0A%

Для русских букв применяется HTML escape: &#nnnn;

Первая буква
«С» = %26%231057%3B, где

%26%23 – это символы «&#» в UTF8


1057 – это десятичное представление U+0421 – заглавная буква «С» в UTF8
%3B – это символ «;» в UTF8

Аналогично буква «т»:


UTF8: 1090 – десятичное представление U+0442 и т.д.

Посмотреть и проверить коды можно, воспользовавшись служебной программой «Таблица символов»


Windows, Набор символов - Юникод.

www.bki-okb.ru 10
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

5.2 Заголовок запроса - Header.Session


Заголовок запроса предназначен для идентификации запрашивающего пользователя.
Дли
Name Имя поля XML-имя Тип M Описание
на
Subscriber Code Номер subscriberID Numeric 5 M Номер, идентифицирующий отдельного подписчика. Номер резервируется
подписчика Оператором Бюро. Должен быть в диапазоне 1-32764.
Group ID Идентификатор groupID Text 12 M Номер, который идентифицирует индивидуальную группу пользователей или
группы отдел в пределах подписчика. Номер резервируется Оператором Бюро.
User ID Идентификатор userID Text 12 M Номер, который идентифицирует отдельного пользователя внутри группы в
пользователя пределах подписчика. Задается Оператором Бюро
Password Пароль Password Text 12 М
Function номер функции functionNbr Numeric 2 M Поле Function Number должно иметь одно из следующих значений:
Number • CPU Extended Enquiry 40
• CPU CAPS Decision Update 41
• CPU Application Load 42
• CPU Existence Check Enquiry 51
• CPU Credit Enquiry 50
• CPU Consumer Enquiry (old) 52
• CPU Business Enquiry (old) 53
• CPU Retro Credit Enquiry 56
• CPU Retro Business Enquiry 57
• CPU Score Credit Enquiry 58
• CPU IDV Enquiry 59
• CPU Info Part Enquiry 67
• CPU Standard Credit Enquiry 70
• CPU Consumer Enquiry (new) 72
• CPU Extended Business Enquiry 73

“CPU Credit Enquiry” (Function number = 50) это запрос кредитной истории в старом формате, сохранен временно для поддержки предоставления отчета в
старом формате (подробное описание структуры отчете смотри документ «Спецификация B2B-интерфейса»).

www.bki-okb.ru 11
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

“CPU Consumer Enquiry (old)” (Function Number = 52) – это запрос субъекта кредитной истории в старом формате, сохранен временно для поддержки
предоставления отчета в старом формате. При выполнении запроса с 52 функцией в кредитном отчете не будут возвращаться новые записи (Банковские
Гарантии, Договоры Залога, Договоры Поручительства, SubscriberDetails - данные об Источнике, и т. д.).
“CPU Consumer Enquiry (new)” (Function Number = 72) – это запрос субъекта кредитной истории в новом формате. При выполнении запроса с 72 функцией в
кредитном отчете будут возвращаться новые записи (Банковские Гарантии, Договоры Залога, Договоры Поручительства, SubscriberDetails - данные об Источнике,
и т. д.).
“CPU Business Enquiry (old)” (Function Number = 53) – этот запрос по юрлицу будет использоваться для совместимости со старым форматом Бюро, при его
выполнении не будут возвращены записи нового формата (банковская гарантия, поручительство, залог и т.д.).
“CPU Extended Business Enquiry” (Function Number = 73) – этот запрос по юрлицу в новом формате, при его выполнении будут возвращены записи нового
формата (банковская гарантия, поручительство, залог и т.д.)

5.3 Финансовая информация EnquiryRequest

Дли
Name Имя поля XML-имя Тип M Описание
на
Account Class Класс счета accountClass Account 1 M
Class
Reason for Enquiry Основание для reason Reason for 2 M При использовании причины «заявление на получение кредита» (01) будет
запроса Enquiry сформирована информация о заявлении в информационной части КИ
субъекта. Причина «проверка клиента» (02) используется, если запрос
выполняется по клиенту для проверки существующего портфеля и
действующего кредита.
При проверке клиента с целью формирования новых предложений
следует выбирать причину «маркетинговое исследование» (05).
Для запроса CPU Application Load (42) следует выбирать причину запроса
«передача заявления без запроса» (08). Для других типов запроса эту
причину использовать нельзя.
Причина запроса «Запрос клиента» (06) используется только для запроса
Субъекта кредитной истории (52), для других типов запросов она не
используется.
При запросе информационной части (67) для отражения конкретной цели
запроса можно использовать все причины запроса (включая «заявление на
получение кредита» (01)) кроме причин: «Запрос клиента» (06) и

www.bki-okb.ru 12
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

«передача заявления без запроса» (08), предназначенных для запроса


Субъекта кредитной истории и передачи заявления.
Purpose of Finance цель purposeOfFinance Purpose of 2 Если поле Reason for Enquiry содержит значение «Запрос клиента» (06), то
финансирован Finance поле Purpose of Finance исключается.
ия
Application номер заявки applicationNumber Text 30 С Если значением поля Reason for Enquiry является Credit Application (01 или
Number 08), то заполнение поля Application Number является обязательным. Если
значением поля Reason for Enquiry не является Credit Application (01 или
08), то поле Application Number не используется.
Application Date дата подачи applicationDate Date 8 С Если значением поля Reason for Enquiry является Credit Application (01 или
заявки 08), то заполнение поля Application Date является обязательным. Если
значением поля Reason for Enquiry не является Credit Application (01 или
08), то поле Application Date не используется.
Значение поля Application Date не должно быть в будущем или раньше
20150301.
Finance Type тип financeType Finance 2 M Код, идентифицирующий тип кредитного счета.
финансирован Type
ия
Currency валюта currency Currency 3 M Если поле Reason for Enquiry содержит значение «Запрос клиента» (06), то
Code поле Currency Code исключается.
Credit Limit лимит creditLimit Number 15 С Смотрите Finance Fields (Поля, относящиеся к финансам)
кредитования
Amount of Finance размер amountOfFinance Number 15 С Смотрите Finance Fields (Поля, относящиеся к финансам)
кредитования Если вводится значение поля Amount of Finance (сумма средств) оно
(сумма должно быть не менее Суммы Взноса (Instalment Amount), Суммы
средств) Первоначального Взноса (Initial Deposit Amount) или Суммы
Окончательного Платежа (Final Payment Amount)
Initial Deposit начальный initialDepositAmou Number 15 С Смотрите Finance Fields (Поля, относящиеся к финансам)
депозит nt
Final Payment окончательный finalPaymentAmou Number 15 С Смотрите Finance Fields (Поля, относящиеся к финансам)
платеж nt
Installment Amount размер instalmentAmount Number 15 С Смотрите Finance Fields (Поля, относящиеся к финансам)
периодическог

www.bki-okb.ru 13
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

о платежа
(сумма взноса)
Payment Frequency Частота paymentFrequency Payment 2 С Смотрите Finance Fields (Поля, относящиеся к финансам)
платежей Frequency Значение поля Payment Frequency не может быть Variable (переменная
величина) (98) или Unknown (неизвестная величина) (99)
Duration of срок действия duration Number 3 С Смотрите Finance Fields (Поля, относящиеся к финансам)
Agreement соглашения
durationUnits единица durationUnits Duration 2 С Единица измерения срока договора, день, неделя, месяц или год
измерения Type Значением поля Duration Units не может быть Unknown (неизвестная
срока договора величина) (9).
Type of Security вид typeOfSecurity Type of 2 С Если значением поля Finance Type является Secured Loan (01), то
обеспечения Security заполнение поля Type of Security является обязательным. Если значением
кредита поля Finance Type не является Secured Loan, то поле Type of Security не
используется.
Public Comments комментарии comments Text 150
Application Способ подачи applicationChannel Application 2 C Способ подачи заявления. Обязательно для следующих видов запросов
Channel заявления Channel (CPU Extended Enquiry, CPU Application Load, CPU Score Credit Enquiry, CPU
Standard Credit Enquiry) если Reason for Enquiry = (01 или 08)
Для вида запроса в старом формате (CPU Credit Enquiry / 50) с целью
обеспечения обратной совместимости, поле не является обязательным и
может отсутствовать в запросе.
Для всех других Function Number - необязательно.
CBR Finance Type Тип cbrFinanceType CBR 3 C Тип финансирования, в соответствии с классификацией ЦБ РФ.
финансирован Finance Обязательно для следующих видов запросов (CPU Extended Enquiry, CPU
ия Type Application Load, CPU Score Credit Enquiry, CPU Standard Credit Enquiry) если
Reason for Enquiry = (01 или 08)
Для вида запроса в старом формате (CPU Credit Enquiry / 50) с целью
обеспечения обратной совместимости, поле не является обязательным и
может отсутствовать в запросе.
Для всех других Function Number - необязательно.

Финансовые поля (Finance Fields)


В зависимости от значений полей Finance Type (тип финансирования) и Reason for Enquiry (основание для запроса), поля Finance являются обязательными или
необязательными или не используются, что отражено в приведенной ниже таблице:

www.bki-okb.ru 14
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Amount of Duration of Instalment Payment


Finance Type Credit Limit Initial Deposit Final Payment
Finance Agreement Amount Frequency
Размер Первоначальн Окончательны Срок Размер Частота
Тип финансирования Лимит кред-я
финанс. ый взнос й платеж соглашения платежа платежей
01 Обеспеченная ссуда Y N y y y Y Y
02 Необеспеченная ссуда
03 Ипотечный кредит
04 Продажа в рассрочку
05 Автокредит
11 Государственное кредитование y N y y y y y
12 Синдицированный кредит
21 Возобновляемый кредит / N Y N N N N y
Кредитная линия
22 Карта продавца
23 Кредитная карта
24 Платежная карта
25 Дебетовая карта N Y N N N N N
26 Карта с овердрафтом
27 Счет с овердрафтом
41 Лизинг Y N Y Y y Y Y
42 Мобильный счет N Y Y N N N y
43 Договор аренды Y N Y N Y Y Y
44 Текущий счет/ МБК N N N N N N N
45 Почтовый перевод Y N y N y Y Y
46 Услуги он-лайн N Y N N N N y
47 Счет телекоммун-х услуг N y N N N N y
49 Страховой полис N N N N y Y Y
50 Факторинг Y N y N y Y Y
51 Алименты Y N N N N Y y
60 Банковская гарантия y y y y y y y
N = поле не должно содержать информацию, Y = Обязательное, если основанием для запроса является заявка на получение кредита (01); в остальных случаях это
поле необязательное, y = Необязательное

www.bki-okb.ru 15
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

5.4 Информация о решении по кредитному заявлению - EnquiryRequest.Decision


Информация о решениях по кредитному заявлению может быть передана только с помощью этого блока.
Данный блок является опциональным для запросов:
• Запрос на передачу заявления на получение кредита (CPU Application Load /42) с причиной запроса (Reason for Enquiry) = 08
• Запрос Расширенного кредитного отчета (CPU Extended Enquiry/40) с причиной запроса (Reason for Enquiry) = 01
• Запрос Стандартного кредитного отчета (CPU Standard Credit Enqury / TBD) с причиной запроса (Reason for Enquiry) = 01
Данный блок является обязательным для запросов:
• Запрос на обновление Решения по заявлению на получение кредита (CPU CAPS Decision Update/41)
Данный блок является запрещенным для всех запросов с причиной запроса (Reason for Enquiry) = 11

www.bki-okb.ru 16
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Дли
Name Имя поля XML-имя Тип M Примечания
на
Присутствует и является обязательным только в
Previous Stream
Предыдущий Stream ID streamID Numeric 20 С запросе на обновление решения по заявлению - CPU
ID
Decision Update, Function Number = 41
Type of Decision typeOfDecision Decision type 2 Тип решения. Поле должно быть заполнено
значением 01 (Заявление одобрено) если в поле
Тип решения М
«причина принятия решения» выбрано значение
01(Заявление одобрено).
Date of Decision Дата принятия решения dateOfDecision Date 8 М Дата принятия решения. Не должна быть в будущем
Decision End Дата окончания срока decisionEndDate Date 8 Дата окончания срока действия решения. Поле
Date действия решения обязательно для заполнения, если Тип решения «01 -
Approved», в остальных случаях поле условно
М обязательное
Decision End date >= Date of Decision
Может быть в будущем по отношению к Дате
принятия решения не более чем на 12 месяцев.
Decision Reason Причина принятия decisionReason Decision 2 Причина, по которой по кредитному заявлению было
решения Reason принято данное решение. Поле обязательно для
М заполнения. Поле должно быть заполнено значением
01 (Заявление одобрено) если в поле «тип решения»
выбрано значение 01(Заявление одобрено).
Decision Сумма решения decisionAmount Numeric 15 Сумма, указанная в кредитном заявлении, по
М
Amount которому было принято данное решение
Currency Валюта кредита, currency Currency Code 3 Валюта кредита, указанная в кредитном заявлении,
М
по которому было принято данное решение
Comments Комментарии comments Text 256 Комментарии

www.bki-okb.ru 17
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

5.5 Информация о Заемщике EnquiryRequest.Consumer.

Дли
Name Имя поля XML-имя Тип M Примечания
на
Applicant Type тип заявителя applicantType Applicant Type 2 M Поле обязательно для заполнения для всех причин
запроса кроме (06) – «Запрос клиента», и должно
всегда иметь значение (01) – основной заявитель.
Sex код пола sex Sex Code 1 M Если значением поля Function Number является
(53) Business Enquiry (запрос о юридическом лице),
а значением поля Applicant Type (тип заявителя) –
Owner (01), то значением поля Sex (пол) должна
быть Company (компания) (3)
Если поле Function Number имеет значение (50)
Credit Enquiry (запрос о физическом лице), а поле
Applicant Type (тип заявителя) – значение Owner
(01), то значением поля Sex (пол) не должна
являться Company (компания) (3)
Nationality гражданство nationality Country 2 M
Title обращение title Title 2 С Если значением поля Sex (пол) является Company
(компания) (3), то Title (обращение) не
используется.
First Name Имя name1 Text 100 С Если значением поля Sex не является Company
(компания) (3), то заполнение поля First Name
(имя) обязательно.
Если значением поля Sex (пол) является Company
(компания) (3), то First Name (имя) не используется.
Patronymic Отчество name2 Text 100 С Если значением поля Sex не является Company (3) и
значением поля Nationality является Russian
(русский) (RU), то заполнение поля Patronymic
(отчество) обязательно.
Если значением поля Sex (пол) является Company
(компания) (3), то Patronymic (отчество) не
используется.

www.bki-okb.ru 18
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Дли
Name Имя поля XML-имя Тип M Примечания
на
Surname Фамилия/ Название surname Text 150 M Если значением поля Sex (пол) является Company
компании (компания) (3), то в поле Surname (фамилия)
вводится название компании
Date of Birth дата рождения dateOfBirth Date 8 С Вводимое значение поля Date of Birth (дата
рождения) не должно относиться к будущему
периоду времени. Если значением поля Sex (пол)
не является Company (3), то значение поля Date of
Birth должно соответствовать минимальному
возрасту потенциального Заявителя - 16 лет
Place of Birth место рождения placeOfBirth Text 100 С Обязательно для заполнения, если в поле Account
Class указано значение 1 (физическое лицо)
Maiden Name девичья фамилия aliasName Text 40 С Обязательно для заполнения, если в поле Sex
указано значение 2 (женский). Если значением
поля Sex (пол) является Company (3),то в поле
Maiden Name вводится название материнской
компании
Consent флаг согласия клиента consentFlag Consumer 1 M Флаг, указывающий, подписал ли данный клиент
Consent соглашение, позволяющее кредитной организации
Indicator запрашивать информацию о кредитной истории в
Бюро.
Date Consent дата получения dateConsentGiven Date 8 M Значение поля Date Consent Given не может
Given согласия клиента относиться к будущему периоду времени
Date Consent дата окончания dateConsentExpiry Date 8 С Дата, в которую согласие перестает действовать.
Expires действия согласия Свойства обязательности и применимые проверки
в разрезе типов запросов описаны в п. 5.5.1.
Consent Purpose цель получения consentPurpose Consent 2 С Свойства обязательности и применимые проверки
согласия Purpose в разрезе типов запросов описаны в п. 5.5.1.
Consent Purpose описание цели consentPurposeDetails Text 100 С Свойства обязательности и применимые проверки
Details получения согласия в разрезе типов запросов описаны в п. 5.5.1.

www.bki-okb.ru 19
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Дли
Name Имя поля XML-имя Тип M Примечания
на
Consent индикатор consentResponsibilityFl Consent 1 С Свойства обязательности и применимые
Responsibility осведомленности об ag Responsibility проверки в разрезе типов запросов описаны в п.
Awareness ответственности за Awareness 5.5.1.
Indicator совершение Indicator
правонарушений
Consent User наименование consentUserDetails Text 100 С Свойства обязательности и применимые
Details пользователя, которому проверки в разрезе типов запросов описаны в п.
было дано согласие 5.5.1.
субъекта
Primary ID Type тип основного primaryIDType Identity Type 2 M Смотрите Допустимые Типы основного
удостоверяющего удостоверения и типы дополнительного
документа удостоверения (Primary ID Type and Secondary ID
Type)
Primary ID номер основного primaryID Text 20 M
удостоверяющего
документа
Primary ID Expiry дата истечения срока primaryIDExpiry Date 8 Значение поля Primary ID Expiry Date не может
Date действия относиться к прошлому периоду времени
удостоверяющего
документа
Primary ID Issue дата выдачи основного primaryIDIssueDate Date 8 M Значение поля Primary ID Issue Date не может
Date удостоверяющего относиться к будущему периоду времени
документа
Primary ID Issue место выдачи primaryIDIssuePlace Text 30 M
Place основного
удостоверяющего
документа
Primary ID орган, выдавший primaryIDAuthority Text 100 M
Authority основной
удостоверяющий
документ

www.bki-okb.ru 20
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Дли
Name Имя поля XML-имя Тип M Примечания
на
Secondary ID Type тип второстепенного secondaryIDType Identity Type 2 С Смотрите Допустимые Типы основного
удостоверяющего удостоверения и типы дополнительного
документа удостоверения (Primary ID Type and Secondary ID
Type) Это поле указывает тип второго
удостоверяющего документа, используемого в
дополнение к основному.
Должен содержать допустимое значение кода,
определенное документом "Значения Кодов".
Если в поле Account Class указано – Юридическое
лицо – то заполнение ИНН – обязательно.
Secondary ID номер второстепенного secondaryID Text 20 С Обязательно для заполнения, если заполнено поле
удостоверяющего Secondary ID Type.
документа
Secondary ID дата истечения срока secondaryIDExpiry Date 8 Значение поля Secondary ID Expiry Date не может
Expiry Date действия относиться к прошлому периоду времени
второстепенного
удостоверяющего
документа
Secondary ID дата выдачи secondaryIDIssueDate Date 8 Значение поля Secondary ID Issue Date не может
Issue Date второстепенного относиться к будущему периоду времени
удостоверяющего
документа
Secondary ID место выдачи secondaryIDIssuePlace Text 30
Issue Place второстепенного
удостоверяющего
документа
Secondary ID орган, выдавший secondaryIDAuthority Text 100
Authority второстепенный
удостоверяющий
документ
Driving licence Водительское drivinglicenceNbr Text 10 Проверки, выполняются в соответствии с
удостоверение Приложением С «Описания данных CAIS»

www.bki-okb.ru 21
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Дли
Name Имя поля XML-имя Тип M Примечания
на
Medical Insurance Номер медицинского medicalNbr Text 25
Number страхования
Pension Number Номер свидетельства pensionNbr Text 20 Только для физических лиц граждан РФ.
государственного
пенсионного
страхования.
Private Номер свидетельства о privateEntrepreneurID Text 20 Только для физических лиц граждан РФ.
Entrepreneur ID регистрации в качестве
Индивидуального
предпринимателя.
Issue date Дата выдачи IssuedateEntrepreneur Date 8 Только для физических лиц граждан РФ.
Entrepreneur свидетельства о
регистрации в качестве
Индивидуального
предпринимателя
EGRN ЕГРН индивидуального EGRNEntrepreneur Text 20 С Только для физических лиц граждан РФ.
Entrepreneur предпринимателя
Previous ID Номер предыдущего previousPassportNbr Text 20 С Поле Previous ID не используется, если значением
документа поля Primary ID Type (тип основного
удостоверения) не является Russian Passport
(российский паспорт) (01). Может содержать номер
старого паспорта или ЕГРН реорганизованного
юридического лица.
Income доход primaryIncome Numeric 15 С Поле обязательно для заполнения, если в поле
Account Class указано значение 1 (Физическое
лицо/индивидуальные предприниматель)
Income Frequency Частота получения primaryIncomeFreq Income 1 С Значением поля Income Frequency (частота
дохода Frequency получения дохода) не может быть Other (другая
величина) (8) или Unknown (неизвестная величина)
(9)

www.bki-okb.ru 22
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Дли
Name Имя поля XML-имя Тип M Примечания
на
Net Gross чистый/общий доход primaryIncomeFlag Income Net 1
Gross Indicator
Other Income другие виды дохода otherIncome Numeric 15
Residential Status статус проживания residentialStatus Residential 1
Status
Occupation работа occupation Occupation / 2
Activity Code
Occupation Status состояние занятости occupationStatus Occupation 2
Status
Marital Status семейное положение maritalStatus Marital Status 2
No. of количество иждивенцев numberDependants Number 3
Dependants
Education образование education Education 1
Mobile Telephone номер мобильного mobileTelNbr Text 16
телефона
Mobile Phone Регистрация mobileRegistration Mobile Phone 1
Registration мобильного телефона Registration
Subject code Subject code subjectCode Text 20
Visa Credit Card имеющаяся платежная visaCCHeld Credit Cards 1
карта Visa Held
MasterCard имеющаяся платежная mastercardCCHeld Credit Cards 1
карта Master Held
Diners Credit Card имеющаяся платежная dinersCCHeld Credit Cards 1
карта Diners Held
American Express имеющаяся платежная amExpressCCHeld Credit Cards 1
карта American Express Held
JCB Credit Card имеющаяся кредитная jcbCCHeld Credit Cards 1
карта JCB Held
Debit Card имеющаяся дебетовая debitCCHeld Credit Cards 1
карта Held
Cheque имеющаяся чековая chqGteeCCHeld Credit Cards 1
Guarantee карта Held

www.bki-okb.ru 23
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Дли
Name Имя поля XML-имя Тип M Примечания
на
Retail Credit Card имеющаяся кредитная retailCCHeld Credit Cards 1
карта Retail Held
Other Credit Card другие имеющиеся otherCCHeld Credit Cards 1
кредитные карты Held
Check Other1 Check Other1 checkOther1 Text 1 В данное время внешние проверки в стадии
Check Other2 Check Other2 checkOther2 Text 1 реализации.
Check Other3 Check Other3 checkOther3 Text 1
Check Other4 Check Other4 checkOther4 Text 1
Check Other5 Check Other5 checkOther5 Text 1
Check Other6 Check Other6 checkOther6 Text 1
Check Other7 Check Other7 checkOther7 Text 1
Check Other8 Check Other8 checkOther8 Text 1
Check Other9 Check Other9 checkOther9 Text 1
Check Other10 Check Other10 checkOther10 Text 1
Check Other11 Check Other11 checkOther11 Text 1
Check Other12 Check Other12 checkOther12 Text 1
Check Other13 Check Other13 checkOther13 Text 1
Check Other14 Check Other14 checkOther14 Text 1
Check Other15 Check Other15 checkOther15 Text 1
Check Other16 Check Other16 checkOther16 Text 1
Check Other17 Check Other17 checkOther17 Text 1
Check Other18 Check Other18 checkOther18 Text 1
Check Other19 Check Other19 checkOther19 Text 1
Check Other20 Check Other20 checkOther20 Text 1

www.bki-okb.ru 24
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

5.5.1 Поля согласия субъекта


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

Функция запроса Тип подписчика Причина запроса Обязател Правила


ьность
Credit Enquiry (FN 50) Любой тип подписчика Любая причина запроса Да consentFlag = «0»/согласие дано
Standard Credit Enquiry (FN 70)
Extended Enquiry (FN 40) consentResponsibilityFlag = «0» / подписчик
осведомлен об ответственности за совершение
Consumer Enquiry (old) (FN 52)
правонарушений
Consumer Enquiry (new) (FN 72)
Business Enquiry (old) (CPU FN 53)
Дата запроса >= Дата получения согласия
Business Enquiry (new) (FN 73)
Score Credit Enquiry (FN 58)
Дата запроса =< Дата окончания действия
согласия

Informational Part Enquiry (FN 67) Любой тип подписчика 02 – Проверка клиента Да consentFlag = «0»/согласие дано
03 – Взыскание
задолженности
consentResponsibilityFlag = «0» / подписчик
04 – Страхование осведомлен об ответственности за совершение
правонарушений
05 – Маркетинговое
исследование
07 – Запрос Дата запроса >= Дата получения согласия
информационной части
98-Другое
Дата запроса =< Дата окончания действия
согласия

www.bki-okb.ru 25
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Тип подписчика <> 01 – 01 – Заявление на Да consentFlag = «0»/ согласие дано


Банк, 12 – МФО, 13 – КПК, получение кредита
14 – Телеком
11 – Запрос с целью
consentResponsibilityFlag = «0» / подписчик
выдачи кредита
осведомлен об ответственности за совершение
правонарушений

Дата запроса >= Дата получения согласия

Дата запроса =< Дата окончания действия


согласия
Тип подписчика = 01 – 01 – Заявление на Нет Не проверяется
Банк, 12 – МФО, 13 – КПК, получение кредита
14 – Телеком
11 – Запрос с целью
выдачи кредита

ВАЖНО: «Дата запроса», указанная в столбце Правила в таблице, это календарная дата направления запроса в Бюро (текущая дата).

Поле «Описание цели получения согласия» обязательно к заполнению в случае, если поле «Цель получения согласия» = 99/Другая

Пользователь может получить кредитный отчет только в случае выполнения всех правил полей согласия.
В случае невыполнения правил пользователю вернется ошибка проверки корректности – «Согласие субъекта отсутствует или заполнено некорректным значением,
но оно является обязательным для данного вида запроса». (п. 8.2 Ошибки проверки корректности).

Поле «Дата получения согласия» не может быть в будущем (п. 8.2 Ошибки проверки корректности).

Поля согласия субъекта, присутствовавшие в формате Бюро ранее – consentFlag и dateConsentGiven – будут отражаться в xml-отчете Бюро без каких-либо
изменений. Все добавившиеся поля согласия: dateConsentExpiry, consentPurpose, consentPurposeDetails, consentResponsibilityFlag и consentUserDetails не будут
возвращаться в xml-отчете Бюро.

www.bki-okb.ru 26
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

5.5.2 Допустимые Типы основного удостоверения и типы дополнительного удостоверения (Primary ID Type and Secondary ID Type)

Тип основного удостоверения личности Primary ID Type должен соответствовать следующим правилам:

А). Для физических лиц.


I. Для граждан РФ типом основного удостоверения личности может быть:
• паспорт гражданина РФ,
• загранпаспорт гражданина РФ
• свидетельство о рождении.
• военный билет солдата,
• удостоверение личности офицера,
• паспорт моряка,
• временное удостоверение по форме № 2-П,
• дипломатический паспорт
• паспорт гражданина СССР
• Иные документы, выдаваемые уполномоченными органами
II. Для иностранных граждан, гражданство которых установлено, но не является российским.
• Международный паспорт.
• Паспорт, выданный иностранным государством и признаваемый в Российской Федерации.
• Вид на жительство.
• Удостоверение беженца.
• Свидетельство о регистрации ходатайства о признании иммигранта беженцем
III. Для лиц без гражданства.
• Международный паспорт.
• Вид на жительство.
• Разрешение на временное проживание лица без гражданства
• Удостоверение беженца
• Свидетельство о регистрации ходатайства о признании иммигранта беженцем
• Неизвестно

B). Если в поле Код пола (Sex Code) указано – Организация (Company) то в поле Primary ID Type доложено быть указан:
I. Для резидентов РФ:
• ЕГРН (06)
• ОКПО (10)

www.bki-okb.ru 27
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

II. Для нерезидентов РФ:


• ЕГРН (06)
• КПП (23)
• ИНН Юридического лица – нерезидента (24)

Тип дополнительного удостоверения Secondary ID Type не должен быть таким же, что и тип основного удостоверения Primary ID Type
Тип дополнительного (второго) удостоверения личности Secondary ID Type должен соответствовать следующим правилам:

А). Для физических лиц.


I. Для граждан РФ:
• паспорт гражданина РФ,
• загранпаспорт гражданина РФ
• свидетельство о рождении (для лиц, не достигших 14 лет).
• военный билет солдата,
• удостоверение личности офицера,
• паспорт моряка,
• временное удостоверение по форме № 2-П,
• дипломатический паспорт
• паспорт гражданина СССР
• ИНН
• Водительское удостоверение
• Другое
II. Для иностранных граждан, гражданство которых установлено, но не является российским.
• ИНН
• Водительское удостоверение.
• Вид на жительство
• Другое.
III. Для лиц без гражданства.
• ИНН.
• Водительское удостоверение.
• Вид на жительство
• Другое

www.bki-okb.ru 28
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

B). Если в поле Код пола (Sex Code) указано – Организация (Company)
Если в поле Код пола (Sex Code) указано – Организация (Company) – то заполнение поля обязательно.
I. Для резидентов РФ:
• ИНН (09)
II. Для не резидентов РФ:
• ИНН (09)
• КИО (22)
• Регистрационный номер юридического лица - нерезидента (25)

Основное и дополнительное удостоверения личности не должны совпадать.

5.6 Работодатель EnquiryRequest.Consumer.[].Employer or Enquiry Employer


Этот блок является опциональным при использовании любой причины запроса и любой функции и может быть опущен. Он может передаваться только для
Физических лиц (код пола замщика не равен «Компания» Sex code <> “Company”). Данный блок запрещен при выполнении любых запросов по юридическим
лицам.
Name Имя поля XML-имя Тип Длина M Примечание
Employer имя employerName Text 150 M
Name работодателя
EGRN/ ЕГРН или ОКПО idNumber Text 20 ЕГРН или ОКПО когда ЕГРН не известен
OKPO Проверяется в соответствие с Приложением C Описание данных
CAIS
Current / нынешний/ currentPreviousIndicator Employer 1 M
Previous предыдущий Current /
работодатель Previous
Indicator
Start Date дата начала startDate Date 8 Если значением поля Employer Current / Previous Indicator
работы (индикатор нынешнего/ предыдущего работодателя) является
End Date дата окончания endDate Date 8 С Current (нынешний работодатель) (0), то поле End Date (дата
работы окончания) блокируется. Вводимые значения полей Start Date и
End Date не могут относиться к будущему времени, а дата
окончания не может предшествовать дате начала.

www.bki-okb.ru 29
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Years with количество лет timeWithEmployer Numeric 3


Employer работы на
работодателя
Flat Number Номер flatNbr Text 6 С Поля flat number, house number, building number, block building
квартиры / должны быть заполненя таким образом чтобы однозначно
Номер офиса указать точный адрес. Заполнение обязательно
House Номер дома houseNbr Text 6
Number
Building Строение buildingNbr Text 6
Number /корпус
Block/Building Номер блока line1 Text 20
Prospect/Lane Название line2 Text 50 M
проспекта /
улицы /
переулка
Town/City Населенный line3 Text 50 M
пункт /
Поселок /
Город
District/Count округ/район/ш line4 Text 100 С
y/State тат
Republic/Regi республика/рег regionCode Region / 2 С Если значением поля Country (страна) является Russian
on ион/область Republic Federation (Российская Федерация) (RU), то заполнение поля
Republic/Region обязательно.
Если значением поля Country (страна) является не Russian
Federation, то поле Republic/Region не заполняется
Post Code почтовый код postcode Text 10 Если значением поля Country (страна) является Russian Federation
(RU), то значение поля Post Code должно состоять из 6 цифр.
Country страна country Country 2 M
Work номер workTelNbr Text 16
Telephone рабочего
Number телефона

www.bki-okb.ru 30
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Work Mobile номер workMobileTelNbr Text 16


Telephone мобильного
Number рабочего
телефона

5.7 Адрес субъекта EnquiryRequest.Consumer.[].Address.[] or Enquiry Address


Дли
Name Имя поля XML-имя Тип M Описание
на
Address Type тип адреса addressType Address 1 M Значения полей Address Type и Current/Previous должны быть уникальными
Type для каждого адреса одного и того же потенциального Заявителя. Первым
значением для данного поля должно быть Residential (1). У Заявителя может
быть только 1 нынешний адрес.
Current/Previ нынешний/пре addressFlag Address 1 M Первым значением поля Address (адрес) потенциального Заявителя должно
ous жний адрес Current быть Current (нынешний адрес)(0).
Previous
Indicator
Flat Number Номер flatNbr Text 6
квартиры /
Номер офиса
House Номер дома houseNbr Text 6
Number
Building Строение buildingNbr Text 6
Number /корпус
Block/Building Номер блока line1 Text 20 M
Prospect/Lane Название line2 Text 50 M
проспекта /
улицы /
переулка
Town/City Населенный line3 Text 50 M
пункт /
Поселок /
Город

www.bki-okb.ru 31
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

District/Count округ/район/ш line4 Text 100 С


y/State тат
Republic/Regi республика/рег regionCode Region / 2 С Если значением поля Country (страна) является Russian Federation
on ион/область Republic (Российская Федерация) (RU), то заполнение поля Republic/Region
Code обязательно.
Если значением поля Country (страна) является не Russian Federation,
то поле Republic/Region не заполняется
Post Code Индекс postcode Text 10 Если значением поля Country (страна) является Russian Federation
(Российская Федерация) (RU), то значение поля Post Code должно состоять
из 6 цифр.
Country Страна country Country 2
Start Date дата начала startDate Date 8 С Если значением поля Current / Previous indicator (индикатор нынешнего/
End Date Дата окончания endDate Date 8 предыдущего адреса) является Current (нынешний адрес) (0), то поле End
Date (дата окончания) не заполняется. Вводимые значения полей Start and
End dates не могут относиться к будущему времени, а дата окончания не
может предшествовать дате начала.
Years at Количество лет timeAtAddress Number 3
Address проживания по
адресу
Telephone номер homeTelNbr Text 16
домашнего
телефона

6. Ответ Бюро (выходной XML- поток)


Выходной XML-поток является объектом-структурой. Эта структура содержит коллекцию структур “Consumer”, коллекция стуктур “ValidationErrors” и атрибут
значения временной метки «responseDate» и уникальный код запроса «StreamID».
Если запрос выполнен успешно, объект- коллекция Consumer будет содержать структуры для найденного клиента, данные которого были введены в запросе.

Ответ, возвращаемый интерфейсом, представляет собой XML-строку, подписанную ЭЦП с использованием действующего сертификата «Оператора бюро для ЭЦП»
методом «attached» в кодировке BASE64. (PKCS#7 Signed). Для передачи строковых полей используется Escape-кодировка аналогичная применяемой в запросе
(см. раздел 5.1).

Ниже приводится общая структура выходного XML-сообщения.

www.bki-okb.ru 32
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<s>
<c n=”Consumer” (client) >
<s>
<c n=”BankruptcyProcedure” (Bankruptcy details)>
<s>
<!-- Bankruptcy information omitted here -->

<s n=”BankruptcyConsumer”>
<!-- Consumer information omitted here -->
</s>
<c n=”BankruptcyRecord”>
<s>
<!—Bankruptcy Record information omitted here -->
</s>
<s>
<!—Second Bankruptcy Record information omitted here -->
</s>
</c>
<s n=”BankruptcyCommissioner”>
<!—Bankruptcy Commissioner details information omitted here -->
</s>
</s>
<s>
<!-- Second Bankruptcy information omitted here -->
</s>
</c>
<c n=”BureauScore” (bureau score)>
<s>
<!-- Score information omitted here -->
</s>
</c>

<c n=”CAIS” (CAIS information)>


<s>
<!-- CAIS account information omitted here -->

<s n=”MortgageHoliday (mortgage holiday details)


<!-- MortgageHoliday information omitted here -->

<s n=”Assignee” (assignee details)>


<!-- Assignee information omitted here -->

<s n=”SubscriberDetails” (subscriber details details)>


<!-- Subscriber details information omitted here -->
</s>
</s>
<c n=”Consumer” >
<s>
<!-- Account holder - information omitted here -->
<c n=”Address” (address details)>
<s>

www.bki-okb.ru

33
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<!-- Address information omitted here -->


</s>
<s>
<!-- Second address information omitted here -->
</s>
</c >
<s n=”Employer” {employer details}>
<!-- Employer information omitted here -->
</s>
<c n=”Legal” (court decisions)>
<!-- Legal information omitted here -->
</c>
<s n=”Warranty” (warranty details)>
<!-- Warranty information omitted here -->

<c n=”WarrantyHistory” (warranty history details)>


<s>
<!-- Warranty historical information omitted here -->
</s>
</c>
</s>
</s>
</c>
<c n=”Guarantee” (bank gurantee details)>
<s>
<!-- Guarantee information tied to account is omitted here -->
</s>
</c>
<c n=”Lien” (lien details)>
<s>
<!-- Lien information omitted here -->
</s>
</c>
<c n=”MonthlyHistory” (account history details)>
<!-- CAIS historical information omitted here -->
</c>
<s n=”SubscriberDetails” (subscriber details details)>
<!-- Subscriber details information omitted here -->
</s>
</s>
<s>
<!-- Second CAIS account information omitted here -->
</s>
</c>
<c n=”CAPS” (caps details)>
<s>
<!-- Financial information omitted here -->

<c n=”Consumer” (client)>


<s>
<!-- Applicant information omitted here -->

www.bki-okb.ru

34
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<c n=”Address” (addres details)>


<s>
<!-- Address information omitted here -->
</s>
<s>
<!-- Second address omitted here -->
</s>
</c>
<s n=”Employer” (employer details)>
<!-- Employer fields will be blanked -->
</s>
<s n="Verification">
<a n=”status”>
<!-- Status information omitted here -->
</a>
</s>
</s>
</c>
<s n=”SubscriberDetails”> (subscriber details details)>
<!-- Subscriber details information omitted here -->
</s>
</s>
<s>
<!-- Second Bureau Enquiry information omitted here -->
</s>
</c>
<c n=”ExtDB1” (SPARK DB1)>
<!-- External Database 1 - SPARK information omitted here -->
</c>
<c n=”ExtDB2” (SPARK DB2 Entrepreneurs)>
<!-- External Database 2 - SPARK Entrepreneurs information omitted here -->
</c>

<c n=”Guarantee” (Bank guarantee details /not tied to account/)>


<s>
<c n=”Consumer” (client)>
<s>
<!-- Client information omitted here -->
<!-- partly, some fields are masked * -->
<c n=”Address” (address details, partly, some fields are masked *)>
<s>
<!-- Address information omitted here -->
</s>
<s>
<!-- Second address omitted here -->
</s>
</c>
<c n=”Guarantee” (bank guarantee details)>
<s>
<!-- Bank guarantee information omitted here -->

www.bki-okb.ru

35
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

</s>
<s>
<!-- Second bank guarantee omitted here -->
</s>
</c>
</s>
</c>
<s n=”SubscriberDetails”> (subscriber details details)>
<!-- Subscriber details information omitted here -->
</s>
</s>
</c>
<c n=”NameIDHistory” (name and passport history changes)>
<s>
<!-- Name and passport history changes information omitted here -->
</s>
</c>
<s n=”PVS”>
<!-- Person Verification Service response information omitted here -->
</s>
<s n=”Summary” (summary details)>
<!-- Summary Information omitted here -->
</s>
<c n=”Warnings” (report warnings) >
<!-- Warnings information omitted here -->
</c>

</s>
</c>»»

<c n=”ValidationErrors” (validations error details)>


<!-- ValidationErrors information omitted here -->
</c>
<a n=”errorCode”>0</a>
<a n=”responseDate”>20141224101436</a>
<a n=”streamID” (Referance ID) >12345</a>
</s>

www.bki-okb.ru

36
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

На следующем рисунке приведена блок-схема структуры XML ответа, возвращаемого Бюро.

www.bki-okb.ru

37
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

www.bki-okb.ru

38
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.1 Верхний уровень XML ответа


На верхнем уровне выходного XML-потока возвращаются следующие данные.
Name XML-имя Тип Длина Описание
Response Date responseDate Timestamp 14 Временная метка этого запроса
Error Code errorCode Numeric 9 Код ошибки данного запроса
Session ID streamID Numeric 20 Сгенерированный ссылочный номер этого запроса

6.2 Ошибки проверки корректности ValidationErrors.[]


Если предоставленные данные запроса являются правильными, то коллекция ValidationErrors является пустой. Коллекция ValidationErrors содержит структуры,
имеющие следующие атрибуты.
Name XML-имя Тип Длина Описание
Error Code number Numeric 9 Номер обнаруженной ошибки проверки корректности. Описание, относящееся к этому номеру,
можно найти в разделе Ошибки проверки корректности.
Field Name field Text 24 Имя поля, в котором была обнаружена ошибка.
path path Text Путь к полю, в котором была обнаружена ошибка.
value value Text Значение, которое вызвало эту ошибку.
extra1 extra1 Text Дополнительная информация об этой ошибке.
extra2 extra2 Text Другая дополнительная информация об этой ошибке.

6.3 Резюме Consumer.[].Summary


Структура Summary (Резюме) содержит сводную информацию клиенте. Благодаря фильтру запросов, предусмотренном в Бюро, в запросе возвращаются сведения
только по самым последним записям Бюро. Максимальное количество записей в запросе, возвращаемом Бюро, является параметром Бюро, и по умолчанию
равно 20.
Конвертация валюты осуществляется по курсу ЦБ на 1 число текущего месяца.
Name XML-имя Тип Дли Описание
на
CAISDistribution1 CAISDistribution1 Numeric 3 Количество подписчиков передавших 1 запись CAIS (фактически имеющихся кредитов)

www.bki-okb.ru
39
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Дли Описание


на
CAISDistribution2 CAISDistribution2 Numeric 3 Количество подписчиков передавших 2 записи CAIS (фактически имеющихся кредитов)

CAISDistribution3 CAISDistribution3 Numeric 3 Количество подписчиков передавших 3 записи CAIS (фактически имеющихся кредитов)

CAISDistribution4 CAISDistribution4 Numeric 3 Количество подписчиков передавших 4 записи CAIS (фактически имеющихся кредитов)

CAISDistribution5 CAISDistribution5 Numeric 3 Количество подписчиков передавших 5 записей CAIS (фактически имеющихся
кредитов)
CAISDistribution5Plus CAISDistribution5Plus Numeric 3 Количество подписчиков передавших более 5 записей CAIS (фактически имеющихся
кредитов)
CAISRecordsGuarantor CAISRecordsGuarantor Numeric 3 Количество записей CAIS в Бюро (фактически имеющихся кредитов) в которых субъект
является принципалом
CAISRecordsGuarantor CAISRecordsGuarantor Numeric 3 Количество доступных подписчику записей CAIS (фактически имеющихся кредитов) в
Recip Recip которых субъект является принципалом
CAIS Records Co- CAISRecordsJoint Numeric 3 Количество записей CAIS в Бюро (фактически имеющихся кредитов) в которых субъект
Owner является созаемщиком
CAIS Records Co- CAISRecordsJointRecip Numeric 3 Количество доступных подписчику записей CAIS (фактически имеющихся кредитов) в
Owner Before которых субъект является созаемщиком
Reciprocity
Bureau Enquiries CAISRecordsOwner Numeric 3 Количество доступных подписчику записей CAIS (фактически имеющихся кредитов) в
Owner которых субъект является основным заемщиком
CAIS Records Owner CAISRecordsOwnerRec Numeric 3 Количество доступных подписчику записей CAIS (фактически имеющихся кредитов) в
Before Reciprocity ip которых субъект является основным заемщиком
CAIS Records Referee CAISRecordsReferee Numeric 3 Количество записей CAIS в Бюро (фактически имеющихся кредитов) в которых субъект
является конкурсным управляющим
CAIS Records Referee CAISRecordsRefereeRe Numeric 3 Количество доступных подписчику записей CAIS (фактически имеющихся кредитов) в
Before Reciprocity cip которых субъект является конкурсным управляющим
Bureau Enquiry CAPSDistribution1 Numeric 3 Количество подписчиков сделавших 1 запрос в бюро (CAPS)
Distribution 1

www.bki-okb.ru
40
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Дли Описание


на
Bureau Enquiry CAPSDistribution2 Numeric 3 Количество подписчиков сделавших 2 запроса в бюро (CAPS)
Distribution 2
Bureau Enquiry CAPSDistribution3 Numeric 3 Количество подписчиков сделавших 3 запроса в бюро (CAPS)
Distribution 3
Bureau Enquiry CAPSDistribution4 Numeric 3 Количество подписчиков сделавших 4 запроса в бюро (CAPS)
Distribution 4
Bureau Enquiry CAPSDistribution5 Numeric 3 Количество подписчиков сделавших 5 запросов в бюро (CAPS)
Distribution 5
Bureau Enquiry CAPSDistribution5Plus Numeric 3 Количество подписчиков сделавших более 5 запросов в бюро (CAPS)
Distribution 5 Plus
Bureau Enquiries Last CAPSLast12MonthsGu Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
12 Months Guarantor arantor является принципалом за последние 12 месяцев
Bureau Enquiries Last CAPSLast12MonthsJoi Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
12 Months Co-Owner nt является созаемщиком за последние 12 месяцев
Bureau Enquiries Last CAPSLast12MonthsOw Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
12 Months Owner ner является основным заемщиком за последние 12 месяцев
Bureau Enquiries Last CAPSLast12MonthsRef Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
12 Months Referee eree является конкурсным управляющим за последние 12 месяцев
Bureau Enquiries Last CAPSLast3MonthsGua Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
3 Months Guarantor rantor является принципалом за последние три месяца
Bureau Enquiries Last CAPSLast3MonthsJoint Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
3 Months Co-Owner является созаемщиком за последние три месяца
Bureau Enquiries Last CAPSLast3MonthsOwn Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
3 Months Owner er является основным заемщиком за последние три месяца
Bureau Enquiries Last CAPSLast3MonthsRefe Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
3 Months Referee ree является конкурсным управляющим за последние три месяца
Bureau Enquiries Last CAPSLast6MonthsGua Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
6 Months Guarantor rantor является принципалом за последние шесть месяцев

www.bki-okb.ru
41
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Дли Описание


на
Bureau Enquiries Last CAPSLast6MonthsJoint Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
6 Months Co-Owner является созаемщиком за последние шесть месяцев
Bureau Enquiries Last CAPSLast6MonthsOwn Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
6 Months Owner er является основным заемщиком за последние шесть месяцев
Bureau Enquiries Last CAPSLast6MonthsRefe Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
6 Months Referee ree является конкурсным управляющим за последние шесть месяцев
Bureau Enquiries CAPSRecordsGuaranto Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
Guarantor r является принципалом
Bureau Enquiries CAPSRecordsGuaranto Numeric 3 Количество записей CAPS в Бюро (запросов в бюро) в которых субъект является
Guarantor Before rBeforeFilter принципалом
Filter
Bureau Enquiries Co- CAPSRecordsJoint Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
Owner является созаемщиком
Bureau Enquiries Co- CAPSRecordsJointBefo Numeric 3 Количество записей CAPS в Бюро (запросов в бюро) в которых субъект является
Owner Before Filter reFilter созаемщиком
Bureau Enquiries CAPSRecordsOwner Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
Owner является основным заемщиком
Bureau Enquiries CAPSRecordsOwnerBe Numeric 3 Количество записей CAPS в Бюро (запросов в бюро) в которых субъект является
Owner Before Filter foreFilter основным заемщиком
Bureau Enquiries CAPSRecordsReferee Numeric 3 Количество доступных подписчику записей CAPS (запросов в бюро) в которых субъект
Referee является конкурсным управляющим
Bureau Enquiries CAPSRecordsRefereeB Numeric 3 Количество записей CAPS в Бюро (запросов в бюро) в которых субъект является
Referee Before Filter eforeFilter конкурсным управляющим
CheckOther1 CheckOther1 Text 1
checkOther10 checkOther10 Text 1
CheckOther11 CheckOther11 Text 1
checkOther12 checkOther12 Text 1
checkOther13 checkOther13 Text 1
checkOther14 checkOther14 Text 1

www.bki-okb.ru
42
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Дли Описание


на
checkOther15 checkOther15 Text 1
checkOther16 checkOther16 Text 1
checkOther17 checkOther17 Text 1
checkOther18 checkOther18 Text 1
checkOther19 checkOther19 Text 1
checkOther2 checkOther2 Text 1
checkOther20 checkOther20 Text 1
checkOther3 checkOther3 Text 1
checkOther4 checkOther4 Text 1
checkOther5 checkOther5 Text 1
checkOther6 checkOther6 Text 1
checkOther7 checkOther7 Text 1
checkOther8 checkOther8 Text 1
checkOther9 checkOther9 Text 1
Consumer Enquiry ConsumerEnquiryCou Numeric 3 Количество запросов субъекта своей кредитной истории за последние 12 месяцев. Тег
Count Last 12 Month ntLast12Month доступен только при запросе субъекта.
Potential Monthly PotentialMonthlyInsta Numeric 15 Потенциальный размер ежемесячного взноса – ежемесячный платеж субъекта сумма
Instalments Non- lmentsAllButOwner по всем обязательствам плюс ежемесячный платеж субъекта, указанный вами в
Owner запросе, кроме счетов в которых субъект является основным заемщиком. Сумма в
рублях.
Potential Monthly PotentialMonthlyInsta Numeric 15 Потенциальный размер ежемесячного взноса - ежемесячный платеж субъекта сумма
Instalments Owner lmentsOwner по всем обязательствам плюс ежемесячный платеж субъекта, указанный вами в
запросе.
Potential Outstanding PotentialOutstandingB Numeric 15 Потенциальный непогашенный остаток – непогашенная задолженность клиента сумма
Balance Non-Owner alanceAllButOwner по всем обязательствам плюс сумма кредита субъекта, указанная вами в запросе,
кроме счетов в которых субъект является основным заемщиком. Сумма в рублях.
Potential Outstanding PotentialOutstandingB Numeric 15 Потенциальный непогашенный остаток – непогашенная задолженность клиента сумма
Balance Owner alanceOwner по всем обязательствам плюс сумма кредита субъекта, указанная вами в запросе.
Сумма в рублях.

www.bki-okb.ru
43
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Дли Описание


на
Total Monthly TotalMonthlyInstalme Numeric 15 Ежемесячный платеж субъекта сумма по всем обязательствам (по счетам CAIS), кроме
Installments Non- ntsAllButOwner счетов в которых субъект является основным заемщиком. Сумма в рублях.
Owner
Total Monthly TotalMonthlyInstalme Numeric 15 Ежемесячный платеж субъекта сумма по всем обязательствам (по счетам CAIS), в
Instalments Owner ntsOwner которых субъект является основным заемщиком. Сумма в рублях
Total Outstanding TotalOutstandingBalan Numeric 15 Текущий непогашенный остаток – непогашенная сумма по всем обязательствам, кроме
Balance Non-Owner ceAllButOwner счетов в которых субъект является основным заемщиком. Сумма в рублях.
Total Outstanding TotalOutstandingBalan Numeric 15 Текущий непогашенный остаток – непогашенная сумма по всем обязательствам, в
Balance Owner ceOwner которых субъект является основным заемщиком. Сумма в рублях.
Worst Current Pay WorstCurrentPayStatu Account 1 Худший текущий платежный статус принципала
Status Guarantor sGuarantor Payment
Status
Worst Current Pay WorstCurrentPayStatu Account 1 Худший текущий платежный статус для счета
Status Joint sJoint Payment
Status
Worst Current Pay WorstCurrentPayStatu Account 1 Худший текущий платежный статус владельца счета
Status Owner sOwner Payment
Status
Worst Current Pay WorstCurrentPayStatu Account 1 Худший текущий платежный статус конкурсного управляющего
Status Referee sReferee Payment
Status
Worst Ever Pay Status WorstEverPayStatusG Account 1 Исторически худший платежный статус для принципала
Guarantor uarantor Payment
Status
Worst Ever Pay Status WorstEverPayStatusJoi Account 1 Исторически худший платежный статус счета
Joint nt Payment
Status
Worst Ever Pay Status WorstEverPayStatusO Account 1 Исторически худший платежный статус для владельца счета
Owner wner Payment
Status

www.bki-okb.ru
44
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Дли Описание


на
Worst Ever Pay Status WorstEverPayStatusRe Account 1 Исторически худший платежный статус конкурсного управляющего
Referee feree Payment
Status

При запросе «Проверка наличия кредитной истории» (CPU Existence Check Enquiry, Function Number = 51) доступен только тег “CAISRecordsOwner”.
Переменная ConsumerEnquiryCountLast12Month – доступна только при запросе Субъекта кредитной истории (CPU Consumer Enquiry, Function Number = 52)

6.4 Предупреждения Consumer.[].Warnings.[]


Коллекция Warnings хранит атрибуты, каждый из которых характеризует конкретное предупреждение, возвращенное Кредитным Бюро.

<c n=”Warnings”>
<a>WARNING_CAIS_QUERIED</a>
<a>WARNING_TOO_MANY_CAPS_RECORDS</a>
</c>
Полный перечень предупреждений представлен в разделе «Описание предупреждений».

6.5 Записи CAIS (фактически имеющиеся кредиты) Consumer.[].CAIS.[]


Каждая CAIS-запись для данного клиента возвращается в виде структуры, входящей в коллекция структур “Consumer.[].CAIS”. В рамках этой структуры имеется
коллекция структур “MonthlyHistory” и коллекция структур “Consumer”. Коллекция “Consumer” содержит только информацию о владельце счета, который
соответствует этому конкретному клиенту. Коллекция “Consumer” содержит коллекцию структур Address и необязательную структуру Employer. Помните, что
коллекции могут быть пустыми или полностью опускаться.
Ниже представлен пример XML-структуры возвращенного счета CAIS.
<c n=”CAIS”>
<s>
—-- CAIS (финансовая информация здесь опущена) -->
<c n=”MonthlyHistory” (история платежей)>
—-- CAIS (статистика здесь опущена) -->
<s n=”MortgageHoliday”>
<!-- Информация о льготном периоде здесь опущена -->

www.bki-okb.ru
45
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

</c>
<s n=”Assignee”>
—-- Информация о переуступке прав здесь опущена -->
</s>
<s n=”Lien”>
—-- Информация о договорах залога здесь опущена -->
</s>
<s n=”Guarantee”>
—-- Информация о банковских гаранитях здесь опущена -->
</s>
<c n=”Consumer” (клиент) >
<s>
—-- Account holder (владелец счета) - информация здесь опущена -->
<s n=”Employer” (работодатель)>
—-- информация о работодателе здесь опущена -->
</s>
<c n=”Address” (адрес)>
<s>
—-- информация об адресе здесь опущена -->
</s>
<s>
—-- информация о втором адресе здесь опущена -->
</s>
<s n=”Legal”>
—-- Информация о судебных решениях здесь опущена -->
</s>
<s n=”Warranty”>
—-- Информация о поручительстве здесь опущена -->
</s>
<c n=”WarrantyHistory”>
—-- Информация о договорах поручительства здесь опущена -->
</c>
</c>

www.bki-okb.ru
46
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

</s>
</c>
</s>
<s>
—-- информация о второй записи CAIS здесь опущена -->
</s>
</c>

6.6 Финансовая информация счета CAIS (фактически имеющийся кредит)


Name XML-имя Тип Дли Описание
на
accountClass accountClass accountClass 1 Класс счета
Consumer Account consumerAccountNum Text 40 Номер счета Субъекта
Number ber
Account Open Date openDate Date 8 Дата открытия счета
Number of Account numOFApplicants Numeric 3 Число Владельцев Счета, связанных со счетом.
Holders У счета может быть несколько владельцев. (пример: Когда у счета нет
поручителей то 01. Если у счета есть владелец и 2 поручителя то 03, и т.д. )
Currency currency Currency Code 3 Основная валюта, в которой обслуживается счет
Finance Type financeType Finance Type 2 Код, идентифицирующий тип используемого кредитного счета.
Purpose of Finance purposeOfFinance Purpose of Finance 2 Цель кредитования
Amount of Finance amountOfFinance Numeric 9 Размер кредитования на дату заключения договора
Credit Limit creditLimit Numeric 9 Лимит кредитования
Duration of duration Numeric 3 Срок действия кредитного соглашения
Agreement
Duration Units durationUnit Duration Unit 2 Единица измерения срока соглашения (День, Неделя, Месяц, Год)
Payment / Instalment instalment Numeric 9 Размер периодического платежа
Payment Frequency paymentFrequency Payment Frequency 2 Частота платежей, может быть «ежедневно», «еженедельно»,
«ежемесячно» и т.д.

www.bki-okb.ru
47
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Дли Описание


на
Type of Security typeOfSecurity Type of Security (См. п. 1 Тип обеспечения для обеспеченного кредита. Для запроса Business Enquiry
6.6.1) (Function Number = 53), будут возвращаться старые значения в соответствии
со «Значения кодов полей_1.28».
Insured Loan insuredLoan Insured loan 1 Это поле определяет, защищена ли ссуда страхованием.
Amount Insured Loan amountInsuredLoan Numeric 9 Это поле определяет размер финансового покрытия, если ссуда является
застрахованной.
Interest Rate interestRate Decimal (См. п. 6.6.2) 4.3 Процентная ставка – числовое значение годового процента, определенное в
кредитном соглашении. Для запроса Business Enquiry (Function Number = 53)
в поле Interest Rate будет возвращаться 4-значное числовое значение (не
дробное 4.3).
Credit Facility Status creditFacilityStatus Credit Facility Status 1 Статус кредитной линии
Account Payment accountPaymentStatus Account Payment 1 Поле отражает исполнение платежей по счету
Status Status

Outstanding Balance outstandingBalance Numeric 9 Общая сумма задолженности по счету на дату учета. Включает сумму
просроченной задолженности, где любые дополнительные расходы
(например, пени) внесены в дебет счета, включая проценты, если они
внесены в дебет счета.
Arrears Balance arrearsBalance Numeric 9 Сумма просроченной задолженности – это поле содержит сумму, которая не
оплачена в срок. Она может включать процент и расходы.
Fulfilment Date fulfilmentDueDate Date 8 Договорная дата исполнения обязательств
Last Payment Date lastPaymentDate Date 8 Это дата, когда была зарегистрирована самая недавняя выплата по счету
Account Closed Date accountClosedDate Date 8 Дата Закрытия счета
Default Date defaultDate Date 8 Дата, когда состояние платежа стало «дефолт»
Litigation Date litigationDate Date 8 Дата, когда состояние платежа стало «тяжба»
Write Off Date writeOffDate Date 8 Дата, когда состояние платежа стало «списан»
Reason for Closure reasonForClosure Reason for Closure 2 Причина закрытия счета
Account Special Status accountSpecialStatus Account Special Status 2 Дополнительное поле для счетов, находящихся в особых обстоятельствах.
Last Missed Payment lastMissedPaymentDat Date 8 Дата последнего неуплаченного взноса
Date e

www.bki-okb.ru
48
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Дли Описание


на
Record Block / Dispute recordBlockDisputeIndi Record Block / Dispute 1 Флаг, указывающий, что запись была блокирована и может быть извлечена,
Indicator cator Indicator но с предупреждением (индикатор спорности).
Account Added dateAccountAdded Timestamp 14 Временная метка первого добавления к счету
Timestamp
Last Update lastUpdateTS Timestamp 14 Временная метка последнего обновления
Timestamp
Accounting Date of monthOfLastUpdate Date 8 Дата учета данных в последнем файле обновления.
Last Update
Subscriber Comments subscriberComments Text 250 Это поле может содержать информацию относительно фактов рассмотрения
судом, и (или) арбитражным судом споров по договору ссуды (кредита) и
информацию резолютивных частей судебных актов, которые вступили в силу
Это поле может также содержать информацию относительно:
- изменения соглашения
- прочую официальную информацию, полученную от государственных
органов
- о выплате ссуды за счет обеспечения в случае неисполнения заемщиком
обязательств по договору
Account Holder accountHolderComme Text 150 Дополнительные комментарии от Владельца счета
Comments nts
Worst Payment Status worstPaymentStatus Account Payment 1 Наихудшее состояние платежей по данному счету
Status
Total Amount of totalAmountOfFinance Numeric
Finance 15 Полная стоимость займа
Secured Amount securedAmount Numeric 15 Объем обязательства, обеспеченного поручительством
Security Start Date securityStartDate Date 8 Дата начала обеспечения поручительством
Security End Date securityEndDate Date 8 Дата окончания обеспечения поручительством
Interest Payment date interestPaymentDate Date 8 Дата наступления срока уплаты процентов
Source of Payment sourceOfPayment Payment Source 2 Источник платежа
Application Number applicationNumber Text 40 Идентификатор кредитного заявления (Application ID)
InfoPart Flag InfoPartFlag Info part output flag 1 Флаг признака формирования информационной части

www.bki-okb.ru
49
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Дли Описание


на
CBR Finance Type cbrFinanceType CBR Finance Type 3 Тип кредита ЦБ
Legal Account Number legalAccountNumber Text 80 Номер договора юридический
Total Cost of Finance totalCostOfFinanceInP Decimal 4.3 Полная стоимость займа в процентах
in percent’s ercent
Unique Loan identifier uniqueLoanIdentifier Text 70 Уникальный идентификатор договора
Current Balance currentBalance Numeric 15 Текущий остаток по счету

6.6.1 Тип обеспечения счета CAIS.


В запросе кредитной истории юридичесого лица(номер функции - 53), используются старые кодовые значения. Их значения содержатся в документе «Значение
кодов полей».

6.6.2 Формат Процентной ставки.


В запросе кредитной истории юридичесого лица (номер функции - 53), формат поля «Процентная ставка» - Numeric 4 (не Decimal 4.3).

6.6.3 Запрос кредитной истории юридичесого лица.

В запросе кредитной истории юридичесого лица (номером функции – 53) и запросе кредитной истории субъекта (номером функции 72 и кодом пола
компания(03)), следующие поля не возвращаются в кредитном отчете:

• Total Amount of Finance


• Total Cost of Finance in percent
• Application Number
• CBR Finance Type
• Account Special Status

6.6.4 Запрос кредитной истории поручителя

В запросе кредитной истории поручителя (Тип владельца счета – 03), следующие теги обязательно должны быть предствалены в ответе независимо от наличия
значения:

• Account Closed Date

www.bki-okb.ru
50
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

• Reason for Closure


• Account Special Status (Должно быть отражено в ответе, только если принимает значение 08)
6.7 История платежей счета CAIS Consumer.[].CAIS.[].MonthlyHistory.[]
Структура “Consumer.[].CAIS.[].MonthlyHistory.[0]” содержит информацию о прошлых периодах из CAIS-записи.
Name XML-имя Тип Длина Описание
History Date historyDate Date 8 Дата прошлого (исторического) периода
Account Payment accountPaymentHistor Account Payment Status 1 Поле отражает исполнение платежей по счету в прошлом (исорическом)
Status y периоде.
Outstanding Balance accountBalance Numeric 15 Остаток задолженности за прошлый (исторический) период
Arrears Balance arrearsBalance Numeric 15 Сумма просроченной задолженности
Payment / instalment Numeric 15 Размер периодического платежа
Instalment
Credit Limit creditLimit Numeric 15 Лимит кредитования
Source of Payment paymentSource Payment Source 2 Источник платежа
Current Balance. currentBalance Numeric 15 Текущий остаток по счету

6.8 Информация о владельце счета CAIS Consumer.[].CAIS.[].Consumer.[0]


Структура “Consumer.[].CAIS.[].Consumer.[0]” содержит информацию из счета CAIS о владельце счета, который соответствовал критериям запроса.
Name XML-имя Тип Длина Описание
Account Holder Type accountHolderType Account Holder 2 Типы отношения к счету со стороны владельца счета/заявителя.
Type Владелец, совладелец, принципал или поручитель
Title title Title 2 Обращение
First Name name1 Text 100 Имя или краткое наименование организации
Patronymic name2 Text 100 Отчество или иностранное наименование организации
name3 name3 Не используется
Surname surname Text 150 Фамилия или полное наименование организации
Primary ID Type primaryIDType Identity Type 2 Тип основного удостоверения личности
Primary ID Number primaryID Text 20 Номер основного удостоверения личности

www.bki-okb.ru
51
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Primary ID Issue Date primaryIDIssueDate Date 8 Дата выдачи основного удостоверения личности
Primary ID Issue Place primaryIDPlaceOfIssue Text 30 Место выдачи основного удостоверения личности.
Primary ID Expiry primaryIDExpiry Date 8 Дата окончания срока действия основного удостоверения личности
Primary ID Authority primaryIDAuthority Text 100 Код и наименование органа, выдавшего основной удостоверяющий документ.
Secondary ID Type secondaryIDType Identity Type 2 Тип дополнительного (второго) удостоверения личности.
Secondary ID Number secondaryID Text 20 Номер дополнительного (второго) удостоверения личности
Secondary ID Issue Date secondaryIDIssueDate Date 8 Дата выдачи второго удостоверения личности
Secondary ID Issue secondaryIDPlaceOfIss Text 30 Место выдачи второго удостоверения личности
Place ue
Secondary ID Expiry secondaryIDExpiry Date 8 Дата окончания срока действия второго удостоверения личности.
Secondary ID Authority secondaryIDAuthority Text 100 Код и наименование органа, выдавшего второй удостоверяющий документ.
Pension Number pensionNbr Text 20 Номер свидетельства государственного пенсионного страхования.
Private Entrepreneur ID privateEntrepreneurN Text 20 Номер свидетельства о регистрации в качестве Индивидуального
br предпринимателя.
Issue date Entrepreneur privateEntrepreneurN Date 8 Дата выдачи свидетельства о регистрации в качестве Индивидуального
brIssueDate предпринимателя.
EGRN Entrepreneur privateEntrepreneurE Text 20 ЕГРН индивидуального предпринимателя.
GRN
Previous ID previousPassportNbr Text 20 Номер предыдущего или старого паспорта / ЕГРН (или ОКПО) реорганизованного
юридического лица
Maiden Name aliasName Text 100 Девичья фамилия клиента, или Название материнской компании.
Девичья фамилия применима, когда Код пола - женский.
Становится Названием материнской компании, когда Код пола - Компания.
Previous company name PreviousCompanyNam Text 100 Наименование реорганизованного юридического лица до реорганизации
e
Sex sex Sex Code 1 Код, указывающий пол клиента, или то, что клиент – юридическое лицо
Date of Birth dateOfBirth Date 8 Дата рождения
Place of Birth placeOfBirth Text 100 Место рождения
Nationality nationality Country 2 Гражданство
Consent Flag consentFlag Consumer Consent 1 Флаг, указывающий, подписал ли данный клиент соглашение, позволяющее
Indicator кредитной организации предавать информацию о кредитной истории в Бюро.

www.bki-okb.ru
52
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Date Consent Given dateConsentGiven Date 8 Дата, когда было дано согласие
Mobile Telephone mobileTelNbr Text 16 Номер мобильного телефона владельца счета.
Number
Primary ID Authority primaryIDAuthorityCo Text 7 Код органа, выдавшего основной удостоверяющий документ
code. de

6.9 Информация о работодателе владельца счета CAIS Consumer.[].CAIS.[].Consumer.[0].Employer


Структура “Consumer.[].CAIS.[].Consumer.[0].Employer” содержит сведения по счету CAIS о работодателе владельца данного счета, который соответствовал данному
запросу.
Name XML-имя Тип Длина Описание
Employer Name name Text 150 Имя работодателя
Employer EGRN or OKPO IdNumber Text 20 ЕГРН или ОКПО Налоговый номер работодателя (ИНН)
when EGRN is not known
Current / Previous currentPreviousIndicator Employer Current / Previous Indicator 1 нынешний/ предыдущий работодатель
Start Date startDate Date 8 дата начала работы
End Date endDate Date 8 дата окончания работы
Flat Number flatNbr Text 6 Номер квартиры / Номер офиса
House Number houseNbr Text 6 Номер дома
Building/Construction buildingNbr Text 6 Строение /корпус
Number
Block/Building line1 Text 20 Номер блока
Prospect/Lane line2 Text 50 Название проспекта / улицы / переулка
Town/City line3 Text 50 Населенный пункт / Поселок / Город
District/County/State line4 Text 100 округ/район/штат
Republic/Region regionCode Region / Republic Code 2 республика/регион/область
Post Code postcode Text 10 почтовый код
Country country Country 2 страна
Work Telephone Number telephoneNumber Text 16 номер телефона работодателя

www.bki-okb.ru
53
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.10 Информация об адресе владельца счета CAIS Consumer.[].CAIS.[].Consumer.[0].Address.[]


Коллекция “Consumer.[].CAIS.[].Consumer.[0].Address” содержит структуры, в которые хранится информация со счета CAIS об адресе владельца счета, который
соответствовал критериям запроса.
Name XML-имя Тип Длина Описание
Address Type type Address Type 1 Тип адреса
Current / Previous addressCurrPrev Address Current / Previous 1 Нынешний/прежний адрес
Indicator
Flat Number flatNbr Text 6 Номер квартиры / Номер офиса
House Number houseNbr Text 6 Номер дома
Building/Construction buildingNbr Text 6 Строение /корпус
Number
Block/Building line1 Text 20 Номер блока
Prospect/Lane line2 Text 50 Название проспекта / улицы / переулка
Town/City line3 Text 50 Населенный пункт / Поселок / Город
District/County/State line4 Text 100 Округ/район/штат
Republic/Region regionCode Region / Republic Code 2 Республика/регион/область
Post Code postcode Text 10 Индекс
Country country Country 2 Страна
Start Date startDate Date 8 Дата начала
End Date endDate Date 8 Дата окончания
Telephone Number homeTelNbr Text 16 Номер домашнего телефона

6.11 Информация о судебных решениях Consumer.[].CAIS.[]. Consumer.[].Legal.[]


Коллекция Consumer .[].CAIS.[]. Consumer.[].Legal.[] содержит структуры, в которых хранится информация со счетов CAIS о решениях суда для найденного владельца
счета

www.bki-okb.ru
54
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Court Judgment courtJudgmentNumber Text 60 Это поле содержит номер решения суда. Это должен быть уникальный идентификатор
Number решения суда.
Court Name courtName Text 200 В этом поле указывается орган, принявший судебное решение. Поле обязательное для
заполнения.
Date of dateOfJudgment Date 8 В этом поле указывается дата вынесения судебного решения.
Judgment Дата не может быть в будущем.
Date of Judgment <= Accounting Date
Judgment Type judgmentType Judgment Type 2 В этом поле указывается тип судебного решения, в соответствие со справочником
Resolution resolution Text 2000 В этом поле в текстовом формате передается содержание резолютивной части решения
суда. Только буквы, цифры, знаки пунктуации. Поле не может быть пустым.
Amount of amountOfRecovery Numeric 15 В этом поле указывается сумма взыскания по решению суда, если она была указана в
recovery решении. Заполнение зависит от Типа судебного решения и заполняется для 01 и 06
типов.
Currency currency Currency 3 В этом поле указывается валюта суммы к взысканию. Заполнение зависит от Типа
судебного решения и заполняется для 01 и 06 типов.

6.12 Информация о договорах поручительства Consumer.[].CAIS.[]. Consumer.[].Warranty.[]


Коллекция Consumer.[].CAIS.[]. Consumer.[].Warranty.[] содержит структуры, в которых хранится информация о договорах поручительства по найденному
владельцу счета.

www.bki-okb.ru
55
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Warranty Agreement Number warrantyAgreementNumber Text 40 В этом поле указывается идентификатор договора поручительства
Warranty Current Balance warrantyCurrentBalance Numeric 15 Текущий остаток по счету поручительства
Account Finance Type accFinanceType Finance Type 2 Тип финансирования счета
Account CBR Finance Type accCBRFinanceType CBR Finance Type 2 В этом поле указывается тип кредита из договора займа, в
соответствие с классификацией займов Банка России
Account Currency accCurrency Currency Code 3 Валюта обязательства по договору
Account Amount of Finance accAmountOfFinance Numeric 15 Объем обязательства из договора займа, по которому данный
договор поручительства является обеспечением
Account Total Amount of Finance accTotalAmountOfFinance Numeric 15 Полная стоимость кредита по договору займа, по которому
данный договор поручительства является обеспечением
Account Total Outstanding accTotalOutstandingBalance Numeric 15 Сумма остатка задолженности по основному договору займа на
Balance дату платежа
Accounting date of last update warrantyMonthOfLastUpdate Date 8 Дата внесения изменения
Timestamp of last update warrantyLastUpdateTS Timestamp 14 Временная метка обновления счета
Warranty Amount warrantyAmount Numeric 15 Сумма поручительства.
Warranty Amount <= Total Amount of Finance
Warranty Open date warrantyOpenDate Date 8 Дата начала срока договора поручительства
Warranty Due date warrantyDueDate Date 8 Дата окончания срока действия договора поручительства
Warranty Due date >= Warranty Open date
Warranty Claim date warrantyClaimDate Date 8 Дата, в которую кредитор истребовал погашение основного долга
с поручителя
Warranty Claim date >= Warranty Open date
Warranty Credit LImit warrantyCreditLimit Numeric 15 Лимит кредитования поручительства
Warranty Currency warrantyCurrency Currency Code 3 Валюта обязательства по договору поручительства
Timestamp of first take-on dateWarrantyAdded Timestamp 8 Дата добавления записи о поручительстве
Warranty Outstanding Balance warrantyOutstandingBalance Numeric 15 В этом поле указывается сумма остатка задолженности по
договору поручительства на дату платежа.
При заполнении должны учитываться следующие правила:
Warranty Outstanding Balance > 0 if Warranty Payment Status > 0
Warranty Outstanding Balance <= Account.Total Outstanding Balance
Warranty Outstanding Balance = 0 if Warranty Close Date present

www.bki-okb.ru
56
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Warranty Instalment Amount warrantyInstalmentAmount Numeric 15 Размер платежа, внесенный поручителем, в дату платежа
Warranty Instalment Date warrantyInstalmentDate Date 8 Дата внесения платежа
Warranty Instalment Date ≥ Warranty Open date
Warranty Payment Status warrantyPaymentStatus Account Payment 1 Статус просрочки по договору поручительства на дату внесения
Status записи
Warranty Arrears Balance warrantyArrearsBalance Numeric 15 Сумма просроченной задолженности по договору поручительства
на дату платежа
Warranty Arrears Balance ≤ Warranty Outstanding Balance
Warranty Arrears Balance > 0 если Warranty Payment Status > 0
Warranty Close Date warrantyCloseDate Date 8 Фактическая дата окончания срока действия договора
поручительства
Warranty Close Date ≥ Warranty Open date
Warranty Reason For Closure warrantyReasonForClosure Security reason 2 Причина окончания срока действия договора поручительства
for closure Заполняется значением из справочника Security Reason For Closure
Warranty Reason For Closure заполняется если Warranty Close Date
present
Legal Warranty Agreement legalWarrantyAgreementNum Text 80 Юридический номер (реквизиты) договора поручительства.
Number ber
Subscriber Comments subscriberComments Text 250 Это поле содержит комментарии подписчика о договоре
поручительства.
Unique Loan identifier uniqueLoanIdentifier Text 70 Уникальный идентификатор договора
До тех пор пока Дата истребования поручительства (Warranty Claim date) не заполнена, по соглашению кредитного договора выгружаются только следующие
поля из записи «Информация о договоре поручительства»:

• accTotalOutstandingBalance – Остаток задолженности по основному договору займа


• accFinanceType – Тип финансирования
• accTotalAmountOfFinance – Объем обязательства по договору займа
• warrantyAmount – Сумма поручительства
• warrantyDueDate – Плановая дата окончания срока действия договора поручительства
• warrantyReasonForClosure – Причина окончания срока действия договора поручительства
• accCurrency - Валюта обязательства по договору поручительства
• warrantyAgreementNumber - Идентификатор договора поручительства

www.bki-okb.ru
57
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

• dateWarrantyAdded - Дата добавления записи о поручительстве


• warrantyLastUpdateTS - Временная метка обновления счета
• warrantyMonthOfLastUpdate - Дата внесения изменения
• warrantyOpenDate - Дата начала срока договора поручительства
• warrantyCloseDate – Фактическая дата окончания срока действия договора поручительства warrantyCurrency - Валюта обязательства по договору поручительства
• legalWarrantyAgreementNumber – Юридический номер (реквизиты) договора поручительства
• subscriberComments - Комментарии подписчика о договоре поручительства

6.13 История по договору поручительства Consumer.[].CAIS.[]. Consumer.[].Warranty.[].History.[]


Коллекция Consumer.[].CAIS.[]. Consumer.[].Warranty.[].History.[] содержит структуры, в которых хранится информация со счета CAIS о истории по договору
поручительства, по найденному владельцу счета. Эта история содержит только записи платежей, сделанных поручителем.

www.bki-okb.ru
58
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Account Total accTotalOutstandi Numeric 15 В этом поле указывается сумма остатка задолженности в основному договору займа на
Outstanding Balance ngBalance дату платежа
Warranty Current warrantyCurrentB Numeric 15 Текущий остаток по счету поручительства
Balance. alance
Warranty Outstanding warrantyOutstan Numeric 15 В этом поле указывается сумма остатка задолженности по договору поручительства на
Balance dingBalance дату платежа.
При заполнении должны быть соблюдены следующие правила:
Warranty Outstanding Balance > 0 если Warranty Payment Status > 0
Warranty Outstanding Balance ≤ Account. Total Outstanding Balance
Warranty TOB > 0 для любой записи истории в последовательности (History Number <
Max History Record Number) для неревольверных счетов (01, 02, 03, 04, 05, 11, 12, 41, 50)
Warranty Instalment warrantyInstalme Numeric 15 Размер платежа, внесенный поручителем, на дату платежа
Amount ntAmount Данное поле заполняется по правилам Приложения A - Перекрестное заполнение полей
«Тип Финансирования».
History date historyDate Date 8 Дата внесения платежа
History Date >= Account Open date
History Date <= min (Accounting date, Account Closed date)
History_record.History_Date[n] > History_record.History_Date[n-1] (Wrong History Sequence)
Warranty Payment warrantyPayment Account 1 Статус выплат по договору поручительства
Status HistoryStatus Payment Status Warranty Payment Status > 0 если Warranty Arrears Balance > 0
Warranty Arrears warrantyArrearsB Numeric 15 Поле содержит размер просроченной задолженности по договору поручительства
Balance alance Warranty Arrears Balance > 0 если Warranty Payment Status > 0

Все записи «Истории по договору поручительства» возвращаются в ответе в том виде, в каком они хранятся в БД Бюро, вне зависимости от того, заполнено ли
поле «Дата истребования поручительства» в соответствующей записи «Информация о договоре поручительства» или нет.
6.14 Информация о договорах залога Consumer.[].CAIS.[].Lien.[]
Коллекция Consumer.[].CAIS.[].Lien.[] содержит структуры в которых хранится информация о договорах залога.

www.bki-okb.ru
59
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Lien Agreement lienAgreementNumber Text 40 В этом поле указывается идентификатор договора залога.
Number
Lienee name lieneeName Text 150 В этом поле указывается наименование организации-залогодателя
Collateral ID collateralID Text 40 В этом поле указывается идентификатор предмета залога, если он применим.
Например, указывается VIN номер залогового автомобиля или номер свидетельства о
регистрации для объекта недвижимости.
Collateral ID Type collateralIDType Lien subject ID 2 В этом поле указывается кодовое значение типа идентификатора предмета залога.
type
Collateral Name collateralName Type of Security 2 В этом поле указывается кодовое значение типа предмета залога.
Collateral address collateralAddress Text 200 В этом поле указывается адрес нахождения или регистрации предмета залога.
Collateral collateralEstimatedValue Numeric 15 В этом поле указывается оценочная стоимость предмета залога по договору.
Estimated value
Collateral Currency collateralCurrency Currency 3 В этом поле указывается валюта, в которой произведена оценка предмета залога.
Collateral Estimate collateralEstimateDate Date 8 В этом поле указывается дата проведения оценки предмета залога.
date
Lien Agreement lienAgreementOpenDate Date 8 В этом поле указывается дата, в которую был заключен договор залога. Lien
Open date Agreement Open date < Lien Agreement Due date
Lien Agreement lienAgreementDueDate Date 8 В этом поле указывается плановая дата окончания срока действия договора залога
Due date Lien Agreement Due date ≥ Lien Agreement Open date
Lien Closed date lienClosedDate Date 8 В этом поле указывается фактическая дата окончания срока действия договора
залога.
Lien Closed date должно быть заполнено для закрытых счетов (Account Close date)
Lien Closed date ≥ Lien Agreement Open date
Collateral start collateralStartDate Date 8 В этом поле указывается дата ввода объекта залога (дата, когда объект, указанный в
date договоре залога, становится объектом залога).
Lien Agreement Open date < Lien Agreement Due date
Collateral end date collateralEndDate Date 8 В этом поле указывается дата вывода объекта залога (дата, когда объект, указанный в
договоре залога, перестает быть объектом залога).
Collateral end date > Lien Agreement Open date
Lien Reason for lienReasonForClosure Security reason 2 В этом поле указывается код причины закрытия договора залога
closure for closure Lien Agreement Due date ≥ Lien Agreement Open date

www.bki-okb.ru
60
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Lien Comments lienComments Text 150 В этом поле указываются комментарии и дополнительная информация.
Unique Loan uniqueLoanIdentifier Text
identifier 70 Уникальный идентификатор договора
6.15 Информация о льготном периоде (ипотечные каникулы) Consumer.[].CAIS.[]. MortgageHoliday.[]
В блоке Информация о льготном периоде (ипотечные каникулы) Consumer.[].CAIS.[]. MortgageHoliday.[] содержится информация о о льготном периоде (ипотечные
каникулы), в случае, если заемщик его запросил. Состав возвращаемых атрибутов описан в таблице ниже.

Информация о льготном периоде (ипотечные каникулы) выдается в отчетах только при выполнении следующих запросов:

• CPU Extended Enquiry 40


• CPU Standard Credit Enquiry 70
• CPU Consumer Enquiry (new) 72
• CPU Retro Enquiry 56

Name XML-имя Тип Длина Описание


Reason For Request mortReasonForRequest Text 1 Обстоятельство для требования льготного периода
Start Date mortStartDate Date 8 Дата начала льготного периода
Planned End Date mortPlannedEndDate Date 8 Плановая дата окончания льготного периода
Actual End Date mortActualEndDate Date 8 Фактическая дата окончания льготного периода
Grace Period Type mortGracePeriodType Text 2 Тип льготного периода
Reason For Termination mortReasonForTermination Text 2 Причина прекращения льготного периода

6.16 Информация о переуступке прав Consumer.[].CAIS.[]. Assignee.[]


Коллекция Consumer.[].CAIS.[]. Assignee.[] включает в себя структуры, которые содержат информацию со счета CAIS о том, кому этот счет был продан или передан
по договору цессии.
Name XML-имя Тип Длина Описание
Assignee Date assDate Date 8 Дата переуступки прав
Comments assComments Text 2000 Реквизиты физического лица с указанием полной идентификационной
информации, в случае, если права требования уступлены физическому
лицу

www.bki-okb.ru
61
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Тег аssComments доступен только субъекту при запросе кредитной истории.


В дополнение к указанной выше структуре будет возвращена структура Consumer.[].CAIS.[]. Assignee.[0].SubscriberDetails[], в которой будет содержаться информация
о подписчике.

6.17 Банковская гарантия Consumer.[].CAIS.[].Guarantee.[]


В блоке Банковская гарантия - “Consumer.[].CAIS.[].Guarantee.[] содержится информация о счете, обеспеченном Банковской гарантией. Состав возвращаемых
атрибутов описан в таблице ниже.
Name XML-имя Тип Длина Описание
Guarantee Agreement guarAgreementNumber Text 40 В этом поле указывается идентификатор договора банковской гарантии
Number
Guarantor Name guarantorName Text 150 В этом поле указывается текстовое наименование банка-гаранта, в случае,
если информация передается банком-кредитором
Guarantee Covered guarCoveredAmount Numeric 15 В этом поле указывается сумма займа или ее часть из договора займа,
Amount обеспечиваемая договором гарантии
Guarantee Covered guarCoveredAmountCurrency Currency Code 3 В этом поле указывается валюта сумма займа или ее части из договора займа,
Amount Currency обеспечиваемая договором гарантии
Guarantee Amount guarAmount Numeric 15 В этом поле указывается сумма, на которую выдана гарантия
Guarantee Currency guarAmountCurrency Currency Code 3 В этом поле указывается валюта в которой выдана гарантия
Guarantee Open date guarOpenDate Date 8 В этом поле указывается дата начала срока действия договора гарантии
Guarantee Due date guarDueDate Date 8 В этом поле указывается дата планового окончания срока действия договора
гарантии
Guarantee Close Date guarCloseDate Date 8 В этом поле указывается дата фактического окончания срока действия
договора гарантии
Guarantee Reason For guarReasonForClosure Security reason 2 В этом поле указывается причина окончания срока действия договора
Closure for closure гарантии
Unique Loan identifier uniqueLoanIdentifier Text 70 Уникальный идентификатор договора
6.18 Банковская гарантия Consumer.[].GUAR[].
Коллекция Consumer.[].GUAR.[]. Содержит структуры, в которых хранится информация о Банковских Гарантиях, которая была передана в Бюро источниками этих
гарантий.

www.bki-okb.ru
62
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Информация об отдельно переданных Банковских гарантиях выдается в отчетах только при выполнении следующих запросов:
• CPU Extended Enquiry 40
• CPU Consumer Enquiry (new) 72
• CPU Business Enquiry (new) 73
• CPU Standard Credit Enquiry 70
Name XML-имя Тип Длина Описание
Guarantee Agreement Number guarAgreementNumber Text 40 Идентификатор договора банковской гарантии
Guarantor Name guarantorName Text 150 Наименование банка выдавшего гарантию
Guarantee Covered Amount guarCoveredAmount Numeric 15 Объем обязательства, обеспеченного гарантией
Guarantee Covered Amount guarCoveredAmountCurrency Currency Code 3 Валюта объема обязательства, обеспеченного
Currency гарантией
Guarantee Amount guarAmount Numeric 15 Сумма гарантии
Guarantee Currency guarAmountCurrency Currency Code 3 Валюта гарантии
Guarantee Open date guarOpenDate Date 8 Дата начала срока действия гарантии
Guarantee Due date guarDueDate Date 8 Плановая дата окончания срока действия гарантии
Guarantee Close Date guarCloseDate Date 8 Фактическая дата окончания срока действия гарантии
Guarantee Reason For Closure guarReasonForClosure Security reason for closure 2 Причина окончания срока действия гарантии
Number of Bank Guarantee guarNumOfHolders Numeric 2 Число владельцев Банковской гарантии
Holders
Timestamp of first take-on guarDateAdded Timestamp 14 Временная метка первого добавления
Timestamp of last update lastUpdateTS Timestamp 14 Временная метка последнего обновления
Guarantee date of last update monthOfLastUpdate Date 8 Дата учета последнего файла с обновлением.
Вместе с этим блоком также выдается блок Consumer.[].GUAR.[]. SubscriberDetails в тех случаях, когда информация о подписчике SubscriberDetails может быть
выдана при запросе.
6.19 Информация о субъекте Банковской гарантии в бюро Consumer.[].GUAR.[].Consumer.[0]
Коллекция “Consumer.[].GUAR.[].Consumer.[]” содержит структуры, в которых хранится информация из ответа Кредитного Бюро о владельце Банковской гарантии и
владельце счета.

www.bki-okb.ru
63
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Account Holder Type accountHolderType Account 2 Типы отношения к счету со стороны владельца Банковской гарантии
Holder Type
Title title Title 2 Обращение
First Name name1 Text 100 Имя или краткое наименование организации
Patronymic name2 Text 100 Отчество или иностранное наименование организации
Surname surname Text 150 Фамилия или полное наименование организации
Primary ID Type primaryIDType Identity Type 2 Тип основного удостоверения личности
Primary ID Number primaryID Text 20 Номер основного удостоверения личности
Primary ID Issue Date primaryIDIssueDate Date 8 Дата выдачи основного удостоверения личности
Primary ID Issue Place primaryIDPlaceOfIssue Text 30 Место выдачи основного удостоверения личности.
Primary ID Expiry primaryIDExpiry Date 8 Дата окончания срока действия основного удостоверения личности
Primary ID Authority primaryIDAuthority Text 100 Код и наименование органа, выдавшего основной удостоверяющий документ.
Secondary ID Type secondaryIDType Identity Type 2 Тип дополнительного (второго) удостоверения личности.
Secondary ID Number secondaryID Text 20 Номер дополнительного (второго) удостоверения личности
Secondary ID Issue Date secondaryIDIssueDate Date 8 Дата выдачи второго удостоверения личности
Secondary ID Issue secondaryIDPlaceOfIssue Text 30 Место выдачи второго удостоверения личности
Place
Secondary ID Expiry secondaryIDExpiry Date 8 Дата окончания срока действия второго удостоверения личности.
Secondary ID Authority secondaryIDAuthority Text 100 Код и наименование органа, выдавшего второй удостоверяющий документ.
Pension Number pensionNbr Text 20 Номер свидетельства государственного пенсионного страхования.
Private Entrepreneur ID privateEntrepreneurNbr Text 20 Номер свидетельства о регистрации в качестве Индивидуального
предпринимателя.
Issue date Entrepreneur privateEntrepreneurNbrIs Date 8 Дата выдачи свидетельства о регистрации в качестве Индивидуального
sueDate предпринимателя.
EGRN Entrepreneur privateEntrepreneurEGRN Text 20 ЕГРН индивидуального предпринимателя.
Previous ID previousPassportNbr Text 20 Номер предыдущего или старого паспорта / ЕГРН (или ОКПО) реорганизованного
юридического лица
Maiden Name aliasName Text 100 Девичья фамилия клиента, или Название материнской компании.
Девичья фамилия применима, когда Код пола - женский.
Становится Названием материнской компании, когда Код пола - Компания.

www.bki-okb.ru
64
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Previous company previousCompanyName Text 100 Наименование реорганизованного юридического лица до реорганизации
name
Sex sex Sex Code 1 Код, указывающий пол клиента, или то, что клиент – юридическое лицо
Date of Birth dateOfBirth Date 8 Дата рождения
Place of Birth placeOfBirth Text 100 Место рождения
Nationality nationality Country 2 Гражданство
Consent Flag consentFlag Consumer 1 Флаг, указывающий, подписал ли данный клиент соглашение, позволяющее
Consent кредитной организации передавать информацию о кредитной истории в Бюро.
Indicator
Date Consent Given dateConsentGiven Date 8 Дата, когда было дано согласие
Mobile Telephone mobileTelNbr Text 16 Номер мобильного телефона владельца счета.
Number
Primary ID Authority primaryIDAuthorityCode Text 7 Код органа, выдавшего основной удостоверяющий документ
code.

6.20 Информация об адресе субъекта Банковской гарантии в бюро Consumer.[].GUAR.[].Consumer.[].Address.[]


Коллекция “Consumer.[].GUAR.[].Consumer.[].Address.[]” содержит структуры, в которых хранится информация из ответа Кредитного Бюро на запрос об адресе
владельца Банковской гарантии, который совпал с критериями запроса.

www.bki-okb.ru
65
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Address Type type Address Type 1 Тип адреса
Current / Previous addressCurrPrev Address Current / Previous Indicator 1 Индикатор адреса текущий/предыдущий
Flat Number flatNbr Text 6 Номер квартиры / Номер офиса
House Number houseNbr Text 6 Номер дома
Building/Construction Number buildingNbr Text 6 Строение /корпус
Block/Building line1 Text 20 Строение
Prospect/Lane line2 Text 50 Название проспекта / улицы / переулка
Town/City line3 Text 50 Населенный пункт / Поселок / Город
District/County/State line4 Text 100 Округ/район/штат
Republic/Region regionCode Region / Republic Code 2 Республика/регион/область
Post Code postcode Text 10 Индекс
Country country Country 2 Страна
Start Date startDate Date 8 Дата начала
End Date endDate Date 8 Дата окончания
Telephone Number homeTelNbr Text 16 Номер домашнего телефона

6.21 История паспортов и имен Consumer.[].NameIDHistory.[]

www.bki-okb.ru
66
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


ID Change Source idChangeSource Primary ID Type/Secondary 2 Источник информации
ID Change Source
ID Change Date idChangeDate Date 8 Дата изменения информации
ID Type idType Identity Type 2 Тип документа
ID Number idNbr Text 20 Номер документа
ID Issue Date idIssueDate Date 8 Дата выдачи паспорта
ID Place of Issue idPlaceOfIssue Text 30 Место выдачи паспорта
ID Authority idAuthority Text 100 Наименование органа, выдавшего паспорт, код подразделения
ID Expiry Date idExpiryDate Date 8 Дата окончания срока действия документа
Passport Status idStatus Passport status 2 Статус паспорта
Pension Number pensionNbr Text 20 СНИЛС
Surname surname Text 150 Фамилия
First Name name1 Text 100 Имя
Second Name name2 Text 100 Отчество
Date of Birth dateOfBirth Date 8 Дата рождения
Place of Birth placeOfBirth Text 100 Место рождения
Sex Sex Sex Code 1 Пол
Judgment Type judgmentType Judgment Type 2 Признак судебного решения
New ID Number newIdNbr Text 20 Номер нового документа
Comments Comments Text 2000 Комментарии
Эта секция предназначена только для физических лиц и не будет возвращаться при запросе КИ по юридическому лицу.

6.22 Запрос в бюро CAPS Consumer.[].CAPS.[]


Информация обо всех ранее выполненных запросах в Кредитное Бюро по этому клиенту возвращается в виде структуры, включенной в коллекцию
“Consumer.[].CAPS”. Внутри этой структуры находится коллекция “Consumer” и другие структуры, такие, как “Decision” и “SubscriberDetails”. Коллекция “Consumer”
содержит только информацию о владельце счета, которая удовлетворяет данным, указанным в запросе. Коллекция Consumer включает в себя коллекцию Address,
необязательную структуру Employer и структуру Verification. Коллекции могут быть пустыми или полностью опускаться.
Ниже представлен пример XML-структуры ответа на запрос Кредитного Бюро.
<c n=”CAPS”>
<s>

www.bki-okb.ru
67
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<!—Финансовая информация здесь опущена -->


<c n=”Consumer” (клиент)>
<s>
<!— Информация о заявителе здесь опущена -->

<c n=”Address” (адрес)>


<s>
<!— Информация об адресе здесь опущена -->
</s>
<s>
<!— Информация о втором адресе здесь опущена -->
</s>
</c>
<s n=”Employer” (работодатель)>
<!— Информация о работодателе здесь опущена -->
</s>
<s n=”Verification” (верификация)>
<a n=”status”>
<!—Информация о статусе здесь опущена -->
</a>
</s>
</s>
</c>

<s n=”Decision” (решение)>


<!— Информация о решении здесь опущена -->
</s>
<s n=”SubscriberDetails” (информацию о подписчике)>
<!-- Информацию о подписчике здесь опущена -->
</s>
</s>
<s>
<!— Информация о втором ответе Кредитного Бюро здесь опущена -->

www.bki-okb.ru
68
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

</s>
</c>

6.23 Финансовая информация запроса в бюро


Name XML-имя Тип Длина Описание
accountClass accountClass accountClass 1 Класс счета
Reference Number streamID Numeric 20 Ссылочный номер запроса, автоматически сгенерированный бюро
Reason for Enquiry reason Reason for Enquiry 2 Основание для запроса
Enquiry Date enquiryDate Date 8 Дата запроса
Number of Applicants nbrOfApplicants Numeric 3 Число заявителей
Purpose of Finance purposeOfFinance Purpose of Finance 2 Цель финансирования
Application Number applicationNumber Text 30 Номер заявки
Application Date applicationDate Date 8 Дата подачи заявки
Finance Type financeType Finance Type 2 Тип финансирования
Currency currency Currency Code 3 Валюта
Credit Limit creditLimit Numeric 15 Лимит кредитования
Amount of Finance amountOfFinance Numeric 15 Размер кредитования (сумма средств)
Initial Deposit initialDepositAmount Numeric 15 Начальный депозит
Final Payment finalPaymentAmount Numeric 15 Окончательный платеж
Duration of duration Numeric 3 Срок действия соглашения
Agreement
Duration Units durationUnits Duration Units 2 Единица измерения срока действия договора
Payment / Instalment instalmentAmount Numeric 15 Размер периодического платежа (сумма взноса)
Payment Frequency paymentFrequency Payment Frequency 2 Частота платежей
Type of Security typeOfSecurity Type of Security 1 Тип обеспечения кредита
Dispute Indicator disputeIndicator Record Block / Dispute Indicator 1 Индикатор блокировки
Comments comments Text 150 Комментарии
Application channel applicationChannel Application channel 2 Способ подачи заявления
CBR Finance Type CBRFinanceType CBR Finance Type 2 Тип финансирования в соответствии с классификацией ЦБ России

www.bki-okb.ru
69
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.24 Информация о решениях по заявлениям Consumer.[].CAPS.[].Decision


Структура Consumer.[].CAPS.[].Decision содержит информацию из ответа Кредитного Бюро на запрос в отношении решения по кредитному заявлению.
Возвращаемые поля указаны в таблице ниже:
Name XML-имя Тип Длина Описание
Decision Stream ID streamID Numeric 20 Ссылочный номер решения. Может отличаться от такого же поля в
блоке CAPS, если решение было передано с помощью функции Decision
Update
Type of Decision typeOfDecision Decision type 2 Тип принятого решения
Date of Decision dateOfDecision Date 8 Дата принятия решения
Decision End Date decisionEndDate Date 8 Дата окончания срока действия решения
Decision Reason decisionReason Decision Reason 2 Причина по решению, которое было принято по кредитному
заявлению
Decision Amount decisionAmount Numeric 15 Сумма, по которой было принято решение по кредитному заявлению.
Возвращается в ответе только в случае отказа.
Currency Code currency Currency Code 3 Валюта кредита, на получение которого подавалось кредитное
заявление
Comments comments Text 256 Дополнительные комментарии или информация по решению, которое
принято по заявке
Данная секция предназначена только для физического лица и не возвращается в ответе на запрос по юридическому лицу.
Данная секция может быть возвращена в ответ на следующие три типа запросов:
• CPU Extended Enquiry
• CPU Consumer Enquiry
• CPU Info Part Enquiry

Если секция Decision была передана для запроса с причиной Reason for Enquiry = “11”, то она не будет возвращена в ответ на указанные выше типы запросов.

www.bki-okb.ru
70
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.25 Информация о субъекте запроса в бюро Consumer.[].CAPS.[].Consumer.[0]


Структура “Consumer.[].CAPS.[].Consumer.[0]” содержит информацию из ответа Кредитного Бюро на запрос в отношении потенциального заявителя, который
соответствует клиенту, указанному в этом запросе.
Name XML-имя Тип Длина Описание
Applicant Type applicantType Applicant 2 тип заявителя: Владелец, совладелец, принципал или поручитель
Type
Title title Title 2 обращение
First Name name1 Text 100 Имя / Краткое наименование организации
Patronymic name2 Text 100 Отчество / Наименование организации на иностранном языке
name3 name3 Не используется
Surname surname Text 150 Фамилия / Полное наименование компании
Date of Birth dateOfBirth Date 8 дата рождения
Place of Birth placeOfBirth Text 100 место рождения
aliasName aliasName Text 40 Девичья фамилия
PreviousCompanyNa PreviousCompanyName Text 40 Наименование реорганизованного юр. лица
me
Sex sex Sex Code 1 код пола
Nationality nationality Country 2 гражданство
Consent consentFlag Consumer 1 флаг согласия клиента
Consent
Indicator
Date Consent Given dateConsentGiven Date 8 дата получения согласия клиента
Primary ID Type primaryIDType Identity Type 2 тип основного удостоверяющего документа
Primary ID primaryID Text 20 номер основного удостоверяющего документа
Primary ID Expiry primaryIDExpiry Date 8 дата истечения срока действия удостоверяющего документа
Date
Primary ID Issue Date primaryIDIssueDate Date 8 дата выдачи основного удостоверяющего документа
Primary ID Issue Place primaryIDIssuePlace Text 30 место выдачи основного удостоверяющего документа
Primary ID Authority primaryIDAuthority Text 100 орган, выдавший основной удостоверяющий документ
Secondary ID Type secondaryIDType Identity Type 2 тип второстепенного удостоверяющего документа
Secondary ID secondaryID Text 20 номер второстепенного удостоверяющего документа

www.bki-okb.ru
71
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Secondary ID Expiry secondaryIDExpiry Date 8 дата истечения срока действия второстепенного удостоверяющего документа
Date
Secondary ID Issue secondaryIDIssueDate Date 8 дата выдачи второстепенного удостоверяющего документа
Date
Secondary ID Issue secondaryIDIssuePlace Text 30 место выдачи второстепенного удостоверяющего документа
Place
Secondary ID secondaryIDAuthority Text 100 орган, выдавший второстепенный удостоверяющий документ
Authority
Driving licence drivinglicenceNbr Text 10 Водительское удостоверение
Medical Insurance medicalNbr Text 25 Номер медицинского страхования
Number
Pension Number pensionNbr Text 20 Номер свидетельства государственного пенсионного страхования.
Private Entrepreneur privateEntrepreneurNbr Text 20 Номер свидетельства о регистрации в качестве Индивидуального
ID предпринимателя.
Issue date privateEntrepreneurNbrIssueD Date 8 Дата выдачи свидетельства о регистрации в качестве Индивидуального
Entrepreneur ate предпринимателя
EGRN Entrepreneur privateEntrepreneurEGRN Text 20 ЕГРН индивидуального предпринимателя
Previous ID previousPassportNbr Text 20 Номер предыдущего или старого паспорта / ЕГРН (или ОКПО) реорганизованного
юридического лица
Income primaryIncome Numeric 15 доход
Income Frequency primaryIncomeFreq Income 1 Частота получения дохода
Frequency

www.bki-okb.ru
72
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Net Gross primaryIncomeFlag Income Net / 1 общий доход
Gross
Indicator
Other Income otherIncome Numeric 15 другие виды дохода
Residential Status residentialStatus Residential 1 статус проживания
Status
Occupation Occupation Occupation / 2 работа
Activity Code
Occupation Status occupationStatus Occupation 2 состояние занятости
Status
Marital Status maritalStatus Marital 2 семейное положение
Status
No. of Dependants numberDependants Numeric 3 количество иждивенцев
Education Education Education 1 образование
Mobile Telephone mobileTelNbr Text 16 номер мобильного телефона
Mobile Phone mobileRegistration Mobile 1 Регистрация мобильного телефона
Registration Phone
Registration
Visa Credit Card visaCCHeld Card Held 1 имеющаяся платежная карта Visa
MasterCard mastercardCCHeld Card Held 1 имеющаяся платежная карта Master
Diners Credit Card dinersCCHeld Card Held 1 имеющаяся платежная карта Diners
American Express amExpressCCHeld Card Held 1 имеющаяся платежная карта American Express
JCB Credit Card jcbCCHeld Card Held 1 имеющаяся кредитная карта JCB
Debit Card debitCCHeld Card Held 1 имеющаяся дебетовая карта
Cheque Guarantee chqGteeCCHeld Card Held 1 имеющаяся чековая карта
Retail Credit Card retailCCHeld Card Held 1 имеющаяся кредитная карта Retail
Other Credit Card otherCCHeld Card Held 1 другие имеющиеся кредитные карты

www.bki-okb.ru
73
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.26 Информация о работодателе субъекта запроса в бюро Consumer.[].CAPS.[].Consumer.[0].Employer


Информация о работодателе субъекта запроса в бюро больше не будет возвращаться в отчетах, для более подробной информации см. раздел «Маскируемая
часть» - поля и правила отображения.
Структура “Consumer.[].CAPS.[].Consumer.[0].Employer” содержит информацию из ответа Кредитного Бюро на запрос о работодателе данного потенциального
заявителя, который соответствует этому запросу.

Name XML-имя Тип Длина Описание


Employer Name employerName Text 150 имя работодателя
EGRN/ OKPO IdNumber Text 20 ЕГРН или ОКПО
Current / Previous currentPreviousIndicator Employer 1 нынешний/ предыдущий работодатель
Current /
Previous
Indicator
Start Date startDate Date 8 дата начала работы
End Date endDate Date 8 дата окончания работы
Years with Employer timeWithEmployer Numeric 3 количество лет работы на работодателя
Flat Number flatNbr Text 6 Номер квартиры / Номер офиса
House Number houseNbr Text 6 Номер дома
Building Number buildingNbr Text 6 Строение /корпус
Block/Building line1 Text 20 Номер блока
Prospect/Lane line2 Text 50 Название проспекта / улицы / переулка
Town/City line3 Text 50 Населенный пункт / Поселок / Город
District/County/State line4 Text 100 округ/район/штат
Republic/Region regionCode Region / 2 республика/регион/область
Republic
Post Code postcode Text 10 почтовый код
Country country Country 2 страна
Work Telephone Number workTelNbr Text 16 номер рабочего телефона
Work Mobile Telephone workMobileTelNbr Text 16 номер мобильного рабочего телефона
Number

www.bki-okb.ru
74
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.27 Информация об адресе субъекта запроса в бюро Consumer.[].CAPS.[].Consumer.[0].Address.[]


Коллекция “Consumer.[].CAPS.[].Consumer.[0].Address” содержит структуры, в которых хранится информация из ответа Кредитного Бюро на запрос об адресе
владельца, который совпал с критериями запроса.
Name XML-имя Тип Длина Описание
Address Type addressType Address Type 1 тип адреса. Если в поле Function Number указано значение 53 (запрос о
юридическом лице), то значение поле Adress Type всегда будет иметь значение 6
(рабочий адрес организации)
Current/Previous addressFlag Address 1 нынешний/прежний адрес
Current
Previous
Indicator
Flat Number flatNbr Text 6 Номер квартиры / Номер офиса
House Number houseNbr Text 6 Номер дома
Building Number buildingNbr Text 6 Строение /корпус
Block/Building line1 Text 20 Номер блока
Prospect/Lane line2 Text 50 Название проспекта / улицы / переулка
Town/City line3 Text 50 Населенный пункт / Поселок / Город
District/County/State line4 Text 100 округ/район/штат
Republic/Region regionCode Region / 2 республика/регион/область
Republic
Code
Post Code postcode Text 10 Индекс
Country country Country 2 Страна
Start Date startDate Date 8 дата начала
End Date endDate Date 8 Дата окончания
Years at Address timeAtAddress Number 3 Количество лет проживания по адресу
Telephone homeTelNbr Text 16 номер домашнего телефона

www.bki-okb.ru
75
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.28 Информация о предыдущем результате проверки субъекта запроса в бюро Consumer.[].CAPS.[]. Consumer.[0].Verification
Коллекция “Consumer.[].CAPS.[].Consumer.[0].Verification” содержит информацию о предыдущем результате Проверки личности для владельца банковского счета,
который совпал с критериями запроса. Возвращенные атрибуты описаны в следующей таблице:
Name XML-имя Тип Длина Описание
Person Status status PersonStatus Статус проверки личности, основанный на результате проверки удостоверения личности и адреса

Значения поля Статус проверки личности (PersonStatus)


Значения статуса проверки личности (Person Verification Status) используются в поле типа PersonStatus:
Value Description
NotFound Все поля запроса не найдены
Found Все поля запроса соответствуют базе данных и найдены
Mismatch Все поля запроса не соответствуют базе данных или не найдены
PartialMismatch Некоторые поля запроса соответствуют базе данных, а некоторые не соответствуют базе данных
NotValid Некоторые документы были найдены в базе данных со статусом Не Действительно (например, Потерянный или Украденный)
NotVerified Значение NotVerified возвращается из Бюро в следующих случаях:
- с системой проверки личности нет связи по различным нестандартным причинам, таким как проблемы сети
- гражданство субъекта не RU
- система проверки личности выключена Оператором Бюро
- Бюро не содержит данные, для проверки, относящиеся к субъекту
- Тип запроса запрос субъекта
- Пользователь не имеет прав на выполнение запроса

6.29 Информация о результате проверки субъекта запроса в бюро Consumer.[].PVS


Коллекция “Consumer.[].PVS” содержит информацию о результате Проверки личности для владельца банковского счета, который совпал с критериями запроса.
Не присутствует, если тип запроса «запрос по верификации он-лайн пользователей», «запрос субъекта» или запрос выполнен Оператором бюро.
<s n=”PVS”>
<a n=”status”>
<! Информация о статусе здесь опущена →
</a>
</s>

www.bki-okb.ru
76
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Возвращенные атрибуты описаны в следующей таблице:


Name XML-имя Тип Длина Описание
Person Status status PersonStatus Статус проверки личности, основанный на результате проверки удостоверения личности и адреса

Значения поля Статус проверки личности (PersonStatus)


Значения см. Значения поля Статус проверки личности (PersonStatus)

6.30 Информация из базы данных СПАРК о юридических лицах Consumer.[]. ExtDB1[]


Коллекция “Consumer.[]. ExtDB1[]”содержит информацию из базы данных СПАРК о юридических лицах.
Информация появляется в случае заключения дополнительного соглашения об этой услуге.
Возвращенные атрибуты описаны в следующей таблице:
XML имя Тип Длина Описание
address Text 500 Адрес регистрации
companyAge Numeric 2 Возраст компании
companyFullName Text 512 Полное наименование
companyShortName Text 30 Краткое наименование
egrn Text 13 ЕГРН
employeeNumber Numeric 6 Количество работников
inn Text 12 ИНН
name1 Text 200 Имя руководителя
name2 Text 200 Отчество руководителя
okato Text 150 ОКАТО
okpo Text 8 ОКПО
okved Text 500 ОКВЕД
ownershipCode Numeric 3 Код собственности
phoneNbr1 Text 100 Телефон 1
phoneNbr2 Text 100 Телефон 2
phoneNbr3 Text 100 Телефон 3
position Text 2000 Должность
sFlag Text Тип поиска: Руководитель; Работодатель; Телефон работодателя

www.bki-okb.ru
77
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

XML имя Тип Длина Описание


sparkProfit Text 300 Прибыль
sparkScore Text 2000 Скоринговая оценка
surname Text 200 Фамилия руководителя

Результат поиска ограничен 15 записями, по 5 записей каждого типа поиска.


Алгоритм поиска в базе данных СПАРК и возможные значения полей смотрите в документе: Search algorithms in External Databases SPARK and Entrepreneurs.
При запросе по верификации он-лайн пользователей теги недоступны.
6.31 Информация из базы данных СПАРК о индивидуальных предпринимателях Consumer.[]. ExtDB2[]
Коллекция “Consumer.[]. ExtDB2[]”содержит информацию из базы данных СПАРК о индивидуальных предпринимателях.
Информация появляется в случае заключения дополнительного соглашения об этой услуге.

Возвращенные атрибуты описаны в следующей таблице:


XML Name Тип Длина Описание
name1 Text 250 Имя руководителя
name2 Text 250 Отчество руководителя
ogrn Text 30 ОГРН
okato Text 150 ОКАТО
okpo Text 10 ОКПО
okved Text 500 ОКВЕД
regDate Date 8 Дата регистрации
surname Text 250 Фамилия руководителя

Результат поиска ограничен 15 записями.


Алгоритм поиска в базе данных СПАРК и возможные значения полей смотрите в документе: Search algorithms in External Databases SPARK and Entrepreneurs
6.32 Информация Скоринг Бюро Consumer.[0].BureauScore[]
Коллекция тегов блока BureauScore содержит результат запроса с данными запроса, предназначенный для Модуля принятия решений. На данный момент
используется десять типов скоринговых карт, в зависимости от того, какие типы доступны подписчику Наименования скоринговых карт и соответствующие им
коды приведены в документе «Значение кодов полей». Скоринг Бюро доступен только для запросов по физическому лицу и не возвращается в запросах кредитной
истории юридического лица.

www.bki-okb.ru
78
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Блок BureauScore будет присутствовать в ответе для следующих запросов:

• CPU Extended Enquiry 40


• CPU Credit Enquiry 50
• CPU Consumer Enquiry 52 (когда тип заемщика не юрлицо)
• CPU New Consumer Enquiry 72 (когда тип заемщика не юрлицо)
• CPU Retro Credit Enquiry 56
• CPU Score Credit Enquiry 58
• CPU Standard Credit Enquiry 70

Ниже приводится структура XML сообщения со Скорингом.


<c n="BureauScore">
<s>
<a n="confidenceFlag">
<!—Status information omitted here →
</a>
<a n="scoreCardType">
<!—Status information omitted here →
</a>
<a n="scoreInterval">
<!—Status information omitted here →
</a>
<a n="scoreNumber">
<!—Status information omitted here →
</a>
</s>
<s>
<a n="confidenceFlag">
<!—Status information omitted here →
</a>
<a n="scoreCardType">

www.bki-okb.ru
79
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<!—Status information omitted here →


</a>
<a n="scoreInterval">
<!—Status information omitted here →
</a>
<a n="scoreNumber">
<!—Status information omitted here →
</a>
</s>
...
</c>

В ответ возвращаются данные, описанные в таблице ниже.

XML-имя Формат Описание


confidenceFlag Числовой Индикатор достоверности
scoreCardType Числовой Тип скоринговой карты
scoreInterval Числовой Рисковый индикатор
scoreNumber Числовой Скоринговый балл

Примеры XML Скоринга бюро для конкретных скоринговых карт:

<s>
<a n="confidenceFlag">1</a>
<a n="scoreCardType">12</a>
<a n="scoreInterval">1</a>
<a n="scoreNumber">-222</a>
</s>

<s>
<a n="confidenceFlag">1</a>
<a n="scoreCardType">1</a>

www.bki-okb.ru
80
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<a n="scoreInterval">4</a>
<a n="scoreNumber">858</a>
</s>

Если по каким-то причинам рассчитать скоринг для одного из типов скоринговой карты будет невозможно, ‘scoreNumber’ примет значение «-9999», ‘scoreCardType’
будет отображаться корректно, а ‘confidenceFlag’ и ‘scoreInterval’ примут нулевое значение.

Пример:
<s>
<a n="confidenceFlag">0</a>
<a n="scoreCardType">1</a>
<a n="scoreInterval">0</a>
<a n="scoreNumber">-9999</a>
</s>

www.bki-okb.ru
81
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.33 Информация о подписчике Subsection .[0].SubscriberDetails


Данная секция возвращается как подраздел в CAIS и CAPS, Assignee и Consumer.Garantee и не привязана к счету.
Name XML-имя Тип Длина Описание
Private Entrepreneur Licensce privateEntrLicNbr Text Номер свидетельства индивидуального
Number предпринимателя
Private Entrepreneur Licence Issue privateEntrLicIssueDate Date 8 Дата выдачи свидетельства индивидуального
Date предпринимателя
Private Entrepreneur Surname privateEntrSurname Text 150 Фамилия индивидуального предпринимателя
Private Entrepreneur Name privateEntrName Text 100 Имя индивидуального предпринимателя
Private Entrepreneur Patroymic privateEntrPatronymic Text 100 Отчество индивидуального предпринимателя
Private Entrepreneur Date of Birth privateEntrDOB Date 8 Дата рождения индивидуального предпринимателя
Private Entrepreneur ID Number privateEntrIdNbr Text 20 ID индивидуального предпринимателя
Private Entrepreneur ID Issue Date privateEntrIdIssueDate Date 8 Дата выдачи ID индивидуального предпринимателя
Private Entrepreneur Issue Place privateEntrIssuePlaceAuthority Text 100 Наименование органа, выдавшего свидетельство
Authority индивидуального предпринимателя.
Subscriber Description subscriberDescr Text 255 Описание подписчика
Subscriber ID subscriberID Numeric 5 Код подписчика
Subscriber Name subscriberName Text 100 Имя подписчика
Subscriber OGRN subscriberOgrn Text 13 ОГРН подписчика
Subscriber OKPO subscriberOkpo Text 8 ОКПО подписчика
Subscriber Special Status subscriberSpecialStatus Subscriber 2 Специальный статус подписчика
Special Status
Subscriber Special Status Start Date subscriberSpecStatusStartDate Date 8 Дата выставления специального статуса подписчика
Subsriber Tax Number subscriberTaxNbr Text 10 ИНН подписчика
Business Type subscriberType Subscriber 2 Тип подписчика
Type

Поля, начинающиеся с маски «privateEntr*» будут возвращаться только в кредитном отчете Субъекта кредитной истории в том случае, когда subscriberType is
“Private Entrepreneur”.
Поля subscriberType, subscriberSpecialStatus, subscriberSpecStatusStartDate будут всегда возвращаться как для своих, так и для чужих данных для всех типов
запросов.
Теги subscriberName и subscriberID раскрываются только подписчику, являющемуся владельцем данной записи (CAIS, CAPS, и др.).

www.bki-okb.ru
82
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.34 Информация о банкротстве Consumer.[].BankruptcyProcedure[]


Данная секция может возвращаться в Расширенном и Стандартном кредитных отчетах. Информация возвращается в структуре внутри коллекции
«Consumer.[].BankruptcyProcedure». Структура содержит коллекцию «BankruptcyRecord» и структуры «BankruptcyConsumer» и «BankruptcyCommissioner».
Коллекции могут быть как пустыми так и отсутствовать целиком.
6.33.1 Consumer.[]. BankruptcyProcedure[]
Name XML-имя Тип Длина Описание
Bankruptcy procedure ID bprProcedureID Numeric 10 Идентификатор записи о банкротстве
Bankruptcy commissioner ID bprComissionerID Numeric 10 Идентификатор финансового управляющего
Bankruptcy Consumer ID bprConsumerID Numeric 10 Идентификатор банкрота
Court procedure start date bprCourtPrStartDate Date 8 Дата открытия судебного производства
Court procedure end date brpCoutrPrEndDate Date 8 Дата завершения судебного производства
Court decision date bprCourtDecisionDate Date 8 Дата принятия решения суда
Court decision authority bprCourtDEcisionAuth Text 100 Наименование судебного органа, вынесшего решение
Court decision resolution bprCourtDecisionRes Text 1000 В этом поле в текстовом формате передается содержание
резолютивной части решения суда.
Bankruptcy commissioner authority bprAuthStartDate Date 8 Дата начала действия полномочий финансового
start date управляющего
Bankruptcy commissioner authority bprAuthEndData Date 8 Дата окончания действия полномочий финансового
end date управляющего
Link to the UFRBI record bprUFRBILink Text 100 Ссылка на запись в ЕФРСБ

www.bki-okb.ru
83
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.34.2 Consumer.[].BankruptcyProcedure[].BankruptcyComissioner
Name XML-имя Тип Длина Описание
Bankruptcy commissioner ID bcmCommissionerID Numeric 10 Идентификатор финансового управляющего
Bankruptcy commissioner ID in the bcmUFRBI Text 40 Идентификатор финансового управляющего в ЕФРСБ
UFRBI
Surname bcmSurname Text 150 Фамилия
First name bcmName Text 100 Имя
Patronymic bcmPatronymic Text 100 Отчество
Date of birth bcmDateOfBirth Date 8 Дата рождения
Name of self-regulatory organization bcmRegulatoryOrgName Text 1000 Название СРО
Address of self-regulatory bcmRegulatoryOrgAddress Text 200 Адрес СРО
organization
OGRN of self-regulatory organization bcmRegulatoryOrgOGRN Text 20 ОГРН СРО
INN of self-regulatory organization bcmRegulatoryOrgINN Text 20 ИНН СРО
Поля данной секции возвращаются только в субъектном кредитном отчете, для Собственных данных и в ответе на запрос Оператора Бюро. Во всех остальных
случаях данный блок возвращается пустым.

www.bki-okb.ru
84
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.34.3 Consumer.[].BankruptcyProcedure[].BankruptcyConsumer
Name XML-имя Тип Длина Описание
Bankruptcy Consumer ID bcoConsumerID Numeric 10 Идентификатор банкрота
Surname bcoSurname Text 150 Фамилия
Maiden Name bcoAliasName Text 150 Девичья фамилия
First name bcoName Text 100 Имя
Patronymic bcoPatronymic Text 100 Отчество
Date of birth bcoDateOfBirth Date 8 Дата рождения
Place of birth bcoPlaceOfBirth Text 100 Место рождения
Sex code bcoSexCode Sex code 1 Пол
SNILS (Pension Number) bcoSNILS Text 20 СНИЛС
INN (Individual TAX Number) bcoINN Text 20 ИНН
Primary ID Type bcoPrimaryIDType Identity Type 2 Тип основного удостоверяющего документа
Primary ID Number bcoPrimaryID Text 20 Номер основного удостоверяющего документа
ID Issue Place bcoIDPlaceOfIssue Text 20 Место выдачи основного удостоверяющего документа
ID Issue Date bcoIDIssueDate Date 8 Дата выдачи основного удостоверяющего документа
Region bcoRegionCode Republic / 2 Республика/регион/область
Region
District bcoDistrict Text 100 Округ/район/штат
City bcoCity Text 50 Населенный пункт / Поселок / Город
Street bcoStreet Text 50 Название проспекта / улицы / переулка
House number bcoHouseNumber Text 6 Номер дома
Construction bcoConstruction Text 6 Строение /корпус
Building bcoBuilding Text 20 Номер блока
Flat number bcoFlatNbr Text 6 Номер квартиры
Post Code bcoPostCode Text 6 Индекс

www.bki-okb.ru
85
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

6.34.4 Consumer.[].BankruptcyProcedure[].BankruptcyRecord[]
Name XML-имя Тип Длина Описание
Bankruptcy Record ID breRecordID Numeric 10 Идентификатор записи о банкротстве
Bankruptcy procedure ID breProcedureID Numeric 10 Идентификатор процесса банкротства
Last update date breLastUpdateDate Date 8 Дата последнего обновления
Date of report to Credit Bureau breDateOfReportCB Date 8 Дата передачи данных в кредитное Бюро
Court decision date breCourtDecisionDate Date 8 Дата принятия решения суда
Court decision authority breCourtDecisionAuth Text 100 Наименование судебного органа, вынесешего решение
Court decision resolution breCourtDecisionRes Text 1000 В этом поле в текстовом формате передается содержание
резолютивной части решения суда.
Bankruptcy procedure stage breProcedureStageCode Bankruptcy 2 Стадия процедуры банкротства
procedure
stages
Bankruptcy procedure stage details breProcedureStageDet Text 1000 Детали текущей стадии банкротства
Date of inclusion to UFRBI breDateOfUFRBI Date 8 Дата включения сведений в ЕФРСБ
Reference to UFRBI breUFRBIRef Text 50 Ссылка на ЕФРСБ

7. Типы запросов
7.1 Стандартный запрос (Standard Credit Enquiry)

7.1.1 XML Input


Стандартный запрос кредитного отчета включает следующие параметры:

• Номер функции : 70
• Используется стандартный шаблон запроса (Input Request)
• Входящий запрос (Input Request) проверяется как Credit Enquiry
• Разрешено включать в него блок «Решения по кредитному заявлению» (Decision)
• В отчете вернется информация о Банковских Гарантиях, переданных в Бюро в GDS-файлах

www.bki-okb.ru
86
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Для новых субъектов запроса должна использоваться причина запроса 01 – “Заявка на кредит”. Также поля “Application Number” и “Application date” должны
быть корректно заполнены. При этом информация о заявлении будет сохранена в информационной части КИ субъекта.

7.1.2 XML Output

Ответ на Запрос (Standart Credit Enquiry) представляет собой структуру “XML Output” без блока «Решения по кредитному заявлению» (CAPS decision section).
В данной структуре не будет отображена информация по полям: уникальный номер договора, текущий остаток по счету и код органа, выдавшего основной
удостоверяющий документ.

Все заявления (записи CAPS), выполненны с причиной (Reason for enquiry) 08 будут исключены из ответа на данный Запрос.

Выходной XML ответ для стандартного запроса кредитного отчета состоит из следующих основных блоков:
<s>
<c n=”Consumer” (client) >
<s>
<c n=”BankruptcyProcedure” (Bankruptcy details)>
<s>
<!-- Bankruptcy information omitted here -->

<s n=”BankruptcyConsumer”>
<!-- Consumer information omitted here -->
</s>
<c n=”BankruptcyRecord”>
<s>
<!—Bankruptcy Record information omitted here -->
</s>
<s>
<!—Second Bankruptcy Record information omitted here -->
</s>
</c>
<s n=”BankruptcyCommissioner”>
<!—Bankruptcy Commissioner details information omitted here -->
</s>

www.bki-okb.ru
87
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

</s>
<s>
<!-- Second Bankruptcy information omitted here -->
</s>
</c>
<c n=”BureauScore” (bureau score)>
<s>
<!-- Score information omitted here -->
</s>
</c>

<c n=”CAIS” (CAIS infomration)>


<s>
<!-- CAIS account information omitted here -->
<s n=”MortgageHoliday (mortgage holiday details)
<!-- MortgageHoliday information omitted here -->
<s n=”Assignee” (assignee details)>
<!-- Assignee information omitted here -->

<s n=”SubscriberDetails” (subscriber details details)>


<!-- Subscriber details information omitted here -->
</s>
</s>
<c n=”Consumer” >
<s>
<!-- Account holder - information omitted here -->
<c n=”Address” (address details)>
<s>
<!-- Address information omitted here -->
</s>
<s>
<!-- Second address information omitted here -->
</s>

www.bki-okb.ru
88
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

</c >
<s n=”Employer” {employer details}>
<!-- Employer information omitted here -->
</s>
<c n=”Legal” (court decisions)>
<!-- Legal information omitted here -->
</c>
<s n=”Warranty” (warranty details)>
<!-- Warranty information omitted here -->
</s>
<c n=”WarrantyHistory” (warranty history details)>
<s>
<s>
<!-- Warranty historical information omitted here -->
</s>
</s>
</c>
</s>
</s>
</c>
<c n=”Guarantee” (bank gurantee details)>
<s>
<!-- Guarantee information tied to account is omitted here -->
</s>
</c>
<c n=”Lien” (lien details)>
<s>
<!-- Lien information omitted here -->
</s>
</c>
<c n=”MonthlyHistory” (account history details)>
<!-- CAIS historical information omitted here -->
</c>

www.bki-okb.ru
89
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<s n=”SubscriberDetails” (subscriber details details)>


<!-- Subscriber details information omitted here -->
</s>
</s>
<s>
<!-- Second CAIS account information omitted here -->
</s>
</c>
<c n=”CAPS” (caps details)>
<s>
<!-- Financial information omitted here -->

<c n=”Consumer” (client)>


<s>
<!-- Applicant information omitted here -->

<c n=”Address” (addres details)>


<s>
<!-- Address information omitted here -->
</s>
<s>
<!-- Second address omitted here -->
</s>
</c>
<s n=”Employer” (employer details)>
<!-- Employer fields will be blanked -->
</s>
<s n="Verification">
<a n=”status”>
<!-- Status information omitted here -->
</a>
</s>
</s>

www.bki-okb.ru
90
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

</c>
<s n=”SubscriberDetails”> (subscriber details details)>
<!-- Subscriber details information omitted here -->
</s>
</s>
<s>
<!-- Second Bureau Enquiry information omitted here -->
</s>
</c>
<c n=”ExtDB1” (SPARK DB1)>
<!-- External Database 1 - SPARK information omitted here -->
</c>
<c n=”ExtDB2” (SPARK DB2 Entrepreneurs)>
<!-- External Database 2 - SPARK Entrepreneurs information omitted here -->
</c>

<c n=”Guarantee” (Bank guarantee details /not tied to account/)>


<s>
<!—Guarantee information omitted here -->
<s>
<c n=”Consumer” (client)>
<s>
<!-- Client information omitted here -->
<!-- partly, some fields are masked * -->
<c n=”Address” (address details, partly, some fields are masked *)>
<s>
<!-- Address information omitted here -->
</s>
<s>
<!-- Second address omitted here -->
</s>
</c>
<c n=”Guarantee” (bank guarantee details)>

www.bki-okb.ru
91
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<s>
<!-- Bank guarantee information omitted here -->
</s>
<s>
<!-- Second bank guarantee omitted here -->
</s>
</c>
</s>
</c>
<s n=”SubscriberDetails”> (subscriber details details)>
<!-- Subscriber details information omitted here -->
</s>
</s>
</c>
<c n=”NameIDHistory” (name and passport history changes)>
<s>
<!-- Name and passport history changes information omitted here -->
</s>
</c>
<s n=”PVS”>
<!-- Person Verification Service response information omitted here -->
</s>
<s n=”Summary” (summary details)>
<!-- Summary Information omitted here -->
</s>
<c n=”Warnings” (report warnings) >
<!-- Warnings information omitted here -->
</c>

</s>
</c>

<c n=”ValidationErrors” (validations error details)>

www.bki-okb.ru
92
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<!-- ValidationErrors information omitted here -->


</c>
<a n=”errorCode”>0</a>
<a n=”responseDate”>20141224101436</a>
<a n=”streamID” (Referance ID) >12345</a>
</s>

Часть полей (см. Раздел 10) маскируется и не выдается в ответе при Стандартном типе запроса кредитного отчета в Бюро.
7.2 Запрос Расширенного кредитного отчета (Extended Credit Enquiry)
7.2.1 XML – запрос
Запрос на получение расширенного кредитного отчета выполняется со следующими параметрами:
• Номер функции 40 (Header.Function = 40)
• Запрос имеет ту же структуру и использует те же данные, что и запрос на стандартный кредитный отчет
• Запрос валидируется по алгоритму валидации Credit Enquiry
• Допускается включение в запрос секции Decision
• В отчете вернется информация о Банковских Гарантиях, переданных в Бюро в GDS-файлах
Дополнительную информацию по формату запроса можно получить в разделах 4, 5 этого документа.

Для новых кредитных заявлений тег «Причина запроса» (Reason for Enquiry) должен быть заполнен 01 (Заявка на новый кредит). Поля “Application Number” и
“Application date” должны быть заполнены корректно. При этом информация о заявлении будет сохранена в информационной части КИ субъекта.

7.2.2 XML ответ


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

7.2.3 Структура XML Расширенного кредитного отчета приведена ниже

1 Validation Errors
errorCode
2 responseDate
3 streamID

www.bki-okb.ru
93
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

4
5 Consumer
6 Consumer.[].Summary
7 Consumer.[].BankruptcyProcedure[]
8 Consumer.[].BankruptcyProcedure[].BankruptcyCommissioner
9 Consumer.[].BankruptcyProcedure[].BankruptcyConsumer
10 Consumer.[].BankruptcyProcedure[].BankruptcyRecord[]
11 Consumer.[].CAIS.[]
12 Consumer.[].CAIS.[].MortgageHoliday
13 Consumer.[].CAIS.[].Assignee
14 Consumer.[].CAIS.[].Assignee.[0].SubscriberDetails
15 Consumer.[].CAIS.[].Consumer.[0]
16 Consumer.[].CAIS.[].Consumer.[0].Address.[]
17 Consumer.[].CAIS.[].Consumer.[0].Employer.[]
18 Consumer.[].CAIS.[].Consumer.[0].Legal.[]
19 Consumer.[].CAIS.[].Consumer.[0].Warranty.[]
20 Consumer.[].CAIS.[].Consumer.[0].Warranty History.[]
21 Consumer.[].CAIS.[].Guarantee.[]
22 Consumer.[].CAIS.[].Lien.[]
23 Consumer.[].CAIS.[].Monthly History.[]
24 Consumer.[].CAIS.[].SubscriberDetails
25 Consumer.[].GUAR.[] (when guarantor is not tied to account)
26 Consumer.[].GUAR.[].Consumer.[0]
27 Consumer.[].GUAR.[].Consumer.[0].Address.[]
28 Consumer.[].GUAR.[]. SubscriberDetails
29 Consumer.[].NameIDHistory.[]
30 Consumer.[].CAPS.[]
31 Consumer.[].CAPS.[].Decision
32 Consumer.[].CAPS.[].Consumer[0]
33 Consumer.[].CAPS.[].Consumer[0].Employer
34 Consumer.[].CAPS.[].Consumer[0].Address.[]
35 Consumer.[].CAPS.[].Consumer[0].Verification

www.bki-okb.ru
94
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

36 Consumer.[].CAPS.[].SubscriberDetails
37 Consumer.[].PVS
38 Consumer.[].ExtDB1.[]
39 Consumer.[].ExtDB2.[]
40 Consumer.[].Bureau Score.[]

В секции Consumer.[].CAPS.[].Decision ответа Бюро значение суммы решения отражается только для типа решения “03 (Отказ)”.
Часть полей (см. Раздел 10) маскируется и не выдается в ответе при Стандартном типе запроса кредитного отчета в Бюро.
7.3 Запрос на передачу заявления на получение кредита (Application Load Enquiry)
Информационная часть кредитной истории субъекта на стороне Бюро может быть сформирована двумя способами:
1. Запрос кредитного отчета (функции запроса FN=40, 67, 70) с причиной запроса 01 (заявление на получение кредита). Это стандартный процесс передачи
информационных частей в Бюро в он-лайн режиме. При этом информация о заявлении субъекта на стороне Бюро формируется автоматически.
2. Передача заявления без выполнения запроса (Application Load Enquiry). Относится к тем заявлениям субъектов, по которым не направлялись запросы в
Бюро.

7.3.1 XML – запрос


Запрос на передачу кредитного заявления используется для передачи кредитного заявления в Бюро без выполнения запроса на кредитный отчет и выполняется
со следующими параметрами:
• Номер функции 42 (Header.Function = 42)
• Запрос направляется на адрес https://ch-test.bki-okb.com/cpuDecision.asp (тестовый сайт)
• Запрос имеет ту же структуру и использует те же данные, что и запрос на стандартный кредитный отчет (в структуре запроса так же как и в структуре стандартного
запроса присутствует блок с адресной информацией)
• Запрос на передачу заявления на получение кредита может быть направлен только по физическому лицу.
• Допускается включение в запрос секции Decision
Дополнительную информацию по формату запроса можно получить в разделах 4, 5 этого документа.

Этот запрос может предавать блок Решение по кредитному заявленю для записи CAPS.
Поэтому, следующие дополнительные условия должны быть соблюдены:
• Блок «Решение» является опциональным
• Тег Stream ID запрещен, не передается
• Эту функцию нельзя использовать для обновления информации по решению.

www.bki-okb.ru
95
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Если необходимо обновить ранее переданное заявление (CAPS) или решение по заявлению (CAPS Decision), то необходимо использовать запрос на обновление
решения по заявлению (CAPS Decision Update).
7.3.2 XML – ответ
Ответ содержит структуру, содержащую только поля указанные ниже и коллекцию Validation Errors, содержащую ошибки валидации (если были).
XML Name Type Описание
responseDate Timestamp Дата и время запроса
errorCode Numeric Код ошибки
streamID Numeric Номер ссылки этого запроса

Ниже приведен пример XML:


<s>
<a n=”responseDate”>20031021101436</a>
<a n=”errorCode”>0</a>
<a n=”streamID”>12345</a>
<c n=”ValidationErrors” />
</s>
7.4 Запрос на обновление Решения по заявлению на получение кредита (CAPS Decision Update)
Функция “CAPS Decision Update” применима в равной степени к обновлению решений по заявлениям, переданным в бюро двумя методами:
1. Запрос кредитного отчета (функции запроса FN=40, 67, 70) с причиной запроса 01 (заявление на получение кредита).
2. Передача заявления без выполнения запроса (Application Load Enquiry).

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

Допустимые последовательности процессов:


1) Credit Enquiry (FN = 40, 67, 70) (with Decision [0..1]) -> CAPS Decision Update (any time 1..n)
2) Application Load Enquiry (FN = 42) (with Decision [0..1]) -> CAPS Decision Update (any time 1..n)
7.4.1 XML-запрос
Запрос на обновление Решения по заявлению на получение кредита позволяет обновить ранее переданное в Бюро решение (CAPS Decision) или передать новое
по уже существующей в Бюро записи CAPS , используя следующиепараметры:
• Номер функции 41

www.bki-okb.ru
96
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

• Запрос направляется на адрес https://ch-test.bki-okb.com/cpuDecision.asp (тестовый сайт)


• Использование структуры Decision в дополнение к стандартному запросу в Бюро. Структура является обязательной.
• Запрос валидируется как Запрос по физическому лицу
• Тег “EnquiryRequest” обязателен. Также заполняются тего: Application Number, Application Date, Finance Type, Currency Code и в зависимости от типа
финансирования - Amount of Finance или Credit Limit
• В Enquiry Consumer обязательно должны быть заполнены теги: name1, surname, dateOfBirth, nationality, primaryIDType, primaryID, primaryIDIssueDate
• Enquiry Employer не используется
• Enquiry Address не используется
Дополнительную информацию по формату запроса можно получить в разделах 4, 5 этого документа.

Функция Обновление решения по заявлению на получение кредита (CAPS Decision Update) применяется для передачи или обновления решения по заявлению при
условии использования в качестве причины запроса значений 01 или 08.

Запрос на обновление решения по заявлению содежит только поля из таблиц ниже:

EnquiryRequest
Name Имя поля XML-имя Тип Длина M Примечания
Application Number номер заявки applicationNumb Text 30 С Если значением поля Reason for Enquiry является «Заявление на
er получение кредита» (01) или «Передача заявления без запроса» (08),
то заполнение поля Application Number является обязательным. Если
значением поля Reason for Enquiry не является «Заявление на
получение кредита» (01) или «Передача заявления без запроса» (08),
то поле Application Number не используется.
Application Date дата подачи applicationDate Date 8 С Если значением поля Reason for Enquiry является «Заявление на
заявки получение кредита» (01) или «Передача заявления без запроса» (08),
то заполнение поля Application Date является обязательным. Если
значением поля Reason for Enquiry не является «Заявление на
получение кредита» (01) или «Передача заявления без запроса» (08),
то поле Application Date не используется.
Значение поля Application Date не должно быть в будущем или
раньше 20150301.
Finance Type тип financeType Finance 2 M Код, идентифицирующий тип кредитного счета.
финансирования Type

www.bki-okb.ru
97
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Currency валюта currency Currency 3 M


Code
Credit Limit лимит creditLimit Number 15 С Поле опциональное.
кредитования
Amount of Finance размер amountOfFinanc Number 15 С Поле опциональное.
кредитования e
(сумма средств)

www.bki-okb.ru
98
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Дли
DecisionName Имя поля XML-имя Тип M Примечания
на
Присутствует и является обязательным только в запросе на
Предыдущий
Previous Stream ID streamID Numeric 20 С обновление решения по заявлению - CPU Decision Update, Function
Stream ID
Number = 41
Type of Decision typeOfDecision Decision 2 Тип решения. Поле должно быть заполнено значением 01 (Заявление
type одобрено) если в поле «причина принятия решения» выбрано
значение 01(Заявление одобрено).
В Бюро предусмотрены следующие типы решений:
Тип решения М
01 – Заявление одобрено
02 – На рассмотрении
03 – Отказ
99 – Нет информации
Date of Decision Дата принятия dateOfDecision Date 8 Дата принятия решения. Не должна быть в будущем.
М
решения
Decision End Date Дата окончания decisionEndDate Date 8 Дата окончания срока действия решения. Поле обязательно для
срока действия заполнения, если Тип решения «01 - Approved», в остальных случаях
решения поле условно обязательное
М
Decision End date >= Date of Decision
Может быть в будущем по отношению к Дате принятия решения не
более чем на 12 месяцев.

www.bki-okb.ru
99
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Decision Reason Причина по decisionReason Decision 2 Причина, по которой по кредитному заявлению было принято данное
принятому Reason решение. Поле обязательно для заполнения. Поле должно быть
решению, заполнено значением 01 (Заявление одобрено) если в поле «тип
решения» выбрано значение 01(Заявление одобрено).
В Бюро предусмотрены следующие причины принятия решения:
01 – Заявление одобрено
М 02 – Кредитная история заемщика
03 – Избыточная долговая нагрузка на заемщика (поручителя)
04 – Кредитная политика заимодавца (кредитора)
05 – Несоответствие информации о заемщике, указанной заемщиком в
заявлении, сведениям, которыми располагает заимодавец (кредитор)
98 – Прочее
99 – Нет информации
Decision Amount Сумма решения decisionAmount Numeric 15 М Сумма, по которой было принято решение по кредитному заявлению
Currency Валюта кредита, currency Currency 3 Валюта кредита, на получение которого подавалось кредитное
М
Code заявление
Comments Комментарии comments Text 256 Комментарии

www.bki-okb.ru
100
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Consumer
Name Имя поля XML-имя Тип Длина M Примечания
Если значением поля Sex не является Company
(компания) (3), то заполнение поля First Name (имя)
First Name Имя name1 Text 100 С обязательно.
Если значением поля Sex (пол) является Company
(компания) (3), то First Name (имя) не используется.
Если значением поля Sex (пол) является Company
Фамилия/ Название
Surname surname Text 150 M (компания) (3), то в поле Surname (фамилия) вводится
компании
название компании
Вводимое значение поля Date of Birth (дата рождения)
не должно относиться к будущему периоду времени.
Если значением поля Sex (пол) не является Company (3),
Date of Birth дата рождения dateOfBirth Date 8 С
то значение поля Date of Birth должно соответствовать
минимальному возрасту потенциального Заявителя - 16
лет
Nationality гражданство nationality Country 2 M
тип основного Смотрите Допустимые Типы основного удостоверения
Primary ID Type удостоверяющего primaryIDType Identity Type 2 M и типы дополнительного удостоверения (Primary ID
документа Type and Secondary ID Type)
номер основного
Primary ID удостоверяющего primaryID Text 20 M
документа
дата выдачи
основного Значение поля Primary ID Issue Date не может
Primary ID Issue Date primaryIDIssueDate Date 8 M
удостоверяющего относиться к будущему периоду времени
документа

www.bki-okb.ru
101
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

<?xml version="1.0" encoding="windows-1251"?>


<s>
<a n="applicationNumber">application_003</a>
<a n="applicationDate">20100219</a>
<a n="financeType">23</a>
<a n="currency">RUB</a>
<!-- amountOfFinance or creditLimit, based on the financeType →
<!--<a n="amountOfFinance">123456789</a>→
<a n="creditLimit">12345</a>
<s n="Decision">
<a n="streamID ">1234567890</a>
<a n="typeOfDecision">01</a>
<a n="dateOfDecision">20140125</a>
<a n="decisionEndDate">20140225</a>
<a n="decisionReason">01</a>
<a n="decisionAmount">123</a>
<a n="currency">RUB</a>
<a n="comments">some text</a>
</s>
<c n="Consumer">
<s>
<a n="name1">Имя_3</a>
<a n="surname">Фамилия_3</a>
<a n="dateOfBirth">19751203</a>
<a n="nationality">RU</a>
<a n="primaryIDType">01</a>
<a n="primaryID">1187654303</a>
<a n="primaryIDIssueDate">20030103</a>
</s>
</c>
</s>

www.bki-okb.ru
102
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

7.4.2 XML-ответ
Структура xml-ответа на запрос обновления принятого решения содержит только поля из таблицы ниже, а также набор ошибок валидации.
XML Name Type Description
responseDate Timestamp Временная метка запроса
errorCode Numeric Код ошибки запроса
streamID Numeric Сгенерированный номер запроса
<s>
<a n=”responseDate”>20031021101436</a>
<a n=”errorCode”>0</a>
<a n=”streamID”>12345</a>
<c n=”ValidationErrors” />
</s>
7.5 Запрос наличия кредитной истории (Existence Check Enquiry)
7.5.1 XML – запрос
Запрос на проверку наличия кредитной истории выполняется со следующими параметрами:
• Номер функции 51 (Header.Function = 51)
• Запрос имеет ту же структуру и использует те же данные, что и запрос на стандартный кредитный отчет
Дополнительную информацию по формату запроса можно получить в разделах 4, 5 этого документа.
• Струкутра Decision не передается.

7.5.2 XML ответ


Ответ представляет собой стандартный ответ Бюро, который содержит только одну переменную в блоке Summary.
XML Name Type Description
CAISRecordsOwner Numeric Содержит информацию о количестве счетов (записей CAIS), где данные основного заявителя совпали с данными субъекта,
указанными в запросе. Содержит числовое значение в диапазоне от 0+

При запросе могут возникать Validation Errors, информация о которых также включается в коллекцию. Ниже представлен пример XML с блоком Validation Errors.

Структура ответа выглядит следующим образом:

Enquiry Response
Validation Errors

www.bki-okb.ru
103
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

errorCode
responseDate
streamID

Пример XML ответа:

<s n="EnquiryResponse">
<c n="Consumer">
<s>
<s n="Summary">
<a n="CAISRecordsOwner">3</a>
</s>
</s>
</c>
<c n="ValidationErrors" />
<a n="errorCode">0</a>
<a n="responseDate">20141002181653</a>
<a n="streamID">30807</a>
7.6 Запрос информационной части (Info Part Enquiry)
7.6.1 XML – запрос
Запрос на проверку наличия кредитной истории выполняется со следующими параметрами:
• Номер функции 67 (Header.Function = 67)
• Запрос имеет ту же структуру и использует те же данные, что и запрос на стандартный кредитный отчет
Дополнительную информацию по формату запроса можно получить в разделах 4, 5 этого документа.
• Запрос информационной части может быть выполнен только по физическому лицу.
• Поля Application Number и Application Date должны быть корректно заполнены.
• Структура Decision не заполняется.

7.6.2 XML – ответ

В этот отчет включаются только те записи CAIS, по которым флаг “Info Part Contribution flag” выставлен 1.

www.bki-okb.ru
104
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

В этот отчет включаются только те записи CAPS, в которых “Reason for Enquiry” (причина запроса) = 01 (заявление на кредит) или 08 (Загрузка заявления) и “Application
Date” (Дата заявления) >= 20150301.
В этом отчете обязательно выводится информация по следующим полям:
• Application Number (CAPS)
• Application Date (CAPS)
• Legal Account Number (CAIS)
Должно быть пустым для данного типа отчета:
• fulfilmentDueDate (CAIS)
• openDate (CAIS)
• paymentSource (CAIS)
• subscriberSpecialStatus (CAIS)
• subscriberSpecStatusStartDate (CAIS)
Структура отчета:
Validation Errors
errorCode
responseDate
streamID

Consumer
Consumer.[].Summary
Consumer.[].CAIS.[]
Consumer.[].CAIS.[].Consumer.[0]
Consumer.[].CAIS.[].Consumer.[0].Warranty.[]
Consumer.[].CAIS.[].SubscriberDetails
Consumer.[]. NameIDHistory.[]
Consumer.[].CAPS.[]
Consumer.[].CAPS.[].Consumer[0]
Consumer.[].CAPS.[].Decision
Consumer.[].CAPS.[].SubscriberDetails

Ответ представляет собой стандартный ответ Бюро, который содержит только следующие блоки:
Consumer.[].Summary.[]

www.bki-okb.ru
105
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Consumer.[].CAIS.[]
Name XML-имя Тип Длина Описание
Account Open Date openDate Date 8 Дата открытия счета. Должно быть пустым для данного типа отчета
Finance Type financeType Finance Type 2 Код, идентифицирующий тип кредита.
Account Payment accountPaymentStatu Account Payment 1 Поле отражает исполнение платежей по счету. Поле возвращается только в
Status s Status случае когда его значение 120+ дней просроченной задолженности (статусы
4,5,6,8,L,W)
Account Special Status accountSpecialStatus Account Special Status 2 Поле возвращается в ответе только когда его значение равно 08 (Отсутствие
двух и более подряд платежей в течение 120 календарных дней с даты
наступления срока исполнения обязательства)
CBR Finance Type CBRFinanceType CBR Finance Type 3 Тип кредита по классификации ЦБ РФ
Legal Account Number legalAccountNumber Text 80 Номер договора юридический
Reason for Closure reasonForClosure Reason for Closure 2 Причина закрытия счета
Account Closed Date accountClosedDate Date 8 Дата Закрытия счета
Application Number applicationNumber Text Номер заявления. Поле должно быть заполнено реальным значением.
Consumer Account consumerAccountNu Text 40 Номер счета Субъекта. Поле возвращается только для собственных данных.
Number mber
Fulfilment Date fulfilmentDueDate Date 8 Договорная дата исполнения обязательств. Должно быть пустым для данного
типа отчета
Accounting Date of Last monthOfLastUpdate Date 8 Дата учета последнего загруженного файла с обновлением.
Update
Last Update Timestamp lastUpdateTS Timestamp 14 Временная метка последнего обновления
Source of Payment paymentSource Payment Source 2 Источник платежа. Должно быть пустым для данного типа отчета
Subscriber Comments subscriberComments Text 2000 Комментарии

www.bki-okb.ru
106
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Consumer.[].CAIS.[0].SubscriberDetails
Name XML-имя Тип Длина Описание
Private Entrepreneur Licensce privateEntrLicNbr Text Номер свидетельства индивидуального предпринимателя
Number
Private Entrepreneur Licence Issue privateEntrLicIssueDate Date 8 Дата выдачи свидетельства индивидуального предпринимателя
Date
Private Entrepreneur Surname privateEntrSurname Text 150 Фамилия индивидуального предпринимателя
Private Entrepreneur Name privateEntrName Text 100 Имя индивидуального предпринимателя
Private Entrepreneur Patroymic privateEntrPatronymic Text 100 Отчество индивидуального предпринимателя
Private Entrepreneur Date of Birth privateEntrDOB Date 8 Дата рождения индивидуального предпринимателя
Private Entrepreneur ID Number privateEntrIdNbr Text 20 ID индивидуального предпринимателя
Private Entrepreneur ID Issue Date privateEntrIdIssueDate Date 8 Дата выдачи ID индивидуального предпринимателя
Private Entrepreneur Issue Place privateEntrIssuePlaceAuthority Text 100
Authority
Subscriber Description subscriberDescr Text 255 Описание подписчика
Subscriber ID subscriberID Numeric 5 Код подписчика
Subscriber Name subscriberName Text 100 Имя подписчика
Subscriber OGRN subscriberOgrn Text 13 ОГРН подписчика
Subscriber OKPO subscriberOkpo Text 8 ОКПО подписчика
Subscriber Special Status subscriberSpecialStatus Subscriber 2 Специальный статус подписчика. Должно быть пустым для
Special Status данного типа отчета
Subscriber Special Status Start Date subscriberSpecStatusStartDate Date 8 Дата выставления специального статуса подписчика. Должно
быть пустым для данного типа отчета
Subsriber Tax Number subscriberTaxNbr Text 10 ИНН подписчика
Subscriber Type subscriberType Subscriber 2 Тип подписчика
Type

www.bki-okb.ru
107
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Consumer.[].CAIS.[].Consumer.[0]
Name XML-имя Тип Длина Описание
Account Holder Type accountHolderType Account 2 типы отношения к счету со стороны владельца счета/заявителя.
Holder Владелец, совладелец, принципал или поручитель
Type
First Name name1 Text 100 Имя или краткое наименование организации
Patronymic name2 Text 100 Отчество или иностранное наименование организации
Surname surname Text 150 Фамилия или полное наименование организации
Primary ID Type primaryIDType Identity 2 Тип основного удостоверения личности
Type
Primary ID Number primaryID Text 20 Номер основного удостоверения личности
Primary ID Issue Date primaryIDIssueDate Date 8 Дата выдачи основного удостоверения личности
Primary ID Issue Place primaryIDPlaceOfIssue Text 30 Место выдачи основного удостоверения личности.
Primary ID Expiry primaryIDExpiry Date 8 Дата окончания срока действия основного удостоверения личности
Primary ID Authority primaryIDAuthority Text 100 Код и наименование органа, выдавшего основной удостоверяющий
документ.
Date of Birth dateOfBirth Date 8 Дата рождения
Place of Birth placeOfBirth Text 100 Место рождения

Consumer.[].CAIS.[].Consumer.[0].Warranty.[]
Name XML-имя Тип Длина Описание
Warranty Agreement Number warrantyAgreementNumber Text 40 идентификатор договора поручительства
Account Finance Type accFinanceType Finance Type 2 Тип финансирования счета
Account CBR Finance Type accCBRFinanceType CBR Finance Type 3 Тип кредита из договора займа, в соответствие с
классификацией займов Банка России.
Accounting date of last update warrantyMonthOfLastUpdate Date Дата внесения изменения
Timestamp of last update warrantyLastUpdateTS Timestamp 14 Временная метка обновления счета
Warranty Claim date warrantyClaimDate Date 8 Дата, в которую кредитор истребовал погашение основного
долга с поручителя
Warranty Payment Status warrantyPaymentStatus Account Payment Status 1 Статус просрочки по договору поручительства на дату
внесения записи

www.bki-okb.ru
108
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Warranty Close Date warrantyCloseDate Date 8 Фактическая дата окончания срока действия договора
поручительства
Warranty Reason For Closure warrantyReasonForClosure Security reason for 2 Причина окончания срока действия договора
closure поручительства

Consumer.[].NameIDHistory.[]
Name XML-имя Тип Длина Описание
ID Change Source idChangeSource Primary ID Type/Secondary ID 2 Тип документа
Change Source
ID Change Date idChangeDate Date 8 Дата изменения документа
ID Type idType Identity Type 2 Тип документа
ID Number idNbr Text 20 Номер документа
ID Issue Date idIssueDate Date 8 Дата выдачи паспорта
ID Place of Issue idPlaceOfIssue Text 30 Место выдачи паспорта
ID Authority idAuthority Text 100 Наименование органа, выдавшего паспорт, код подразделения
ID Expiry Date idExpiryDate Date 8 Дата окончания действия документа
Passport Status idStatus Passport status 2 Статус паспорта
Country Code nationality Country 3 Страна
Pension Number pensionNbr Text 20 СНИЛС
Surname surname Text 150 Фамилия
First Name name1 Text 100 Имя
Second Name name2 Text 100 Отчество
Date of Birth dateOfBirth Date 8 Дата рождения
Place of Birth placeOfBirth Text 100 Место рождения
New ID Number newIdNbr Text 20 Новый номер документа

www.bki-okb.ru
109
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Consumer.[].CAPS.[]
Записи CAPS возвращаются только в случае выбора причины запроса 01 (Завление на получение кредита) или 08 (Загрузка заявления без запроса)
Name XML-имя Тип Длина Описание
Generated streamID Numeric 20 Сформированный номер ссылки. Поле будет заполнено только для
Reference Number собственных данных.
Reason for Enquiry reason Reason for Enquiry 2 Основание для запроса
Date of Enquiry enquiryDate Date 8 Дата запроса
Application Number applicationNumber Text 30 номер заявки
Application Date applicationDate Date 8 дата подачи заявки
Finance Type financeType Finance Type 2 тип финансирования
Credit Limit creditLimit Numeric 9 лимит кредитования
Amount of Finance amountOfFinance Numeric 9 размер кредитования (сумма средств)
Application channel applicationChannel Application channel 2 Способ подачи заявления
CBR Finance Type CBRFinanceType CBR Finance Type 3 Тип финансирования в соответствии с классификацией ЦБ России

www.bki-okb.ru
110
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Consumer.[].CAPS.[0].SubscriberDetails
Name XML-имя Тип Длина Описание
Private Entrepreneur privateEntrLicNbr Text Номер свидетельства индивидуального предпринимателя
Licensce Number
Private Entrepreneur privateEntrLicIssueDate Date 8 Дата выдачи свидетельства индивидуального предпринимателя
Licence Issue Date
Private Entrepreneur privateEntrSurname Text 150 Фамилия индивидуального предпринимателя
Surname
Private Entrepreneur privateEntrName Text 100 Имя индивидуального предпринимателя
Name
Private Entrepreneur privateEntrPatronymic Text 100 Отчество индивидуального предпринимателя
Patroymic
Private Entrepreneur privateEntrDOB Date 8 Дата рождения индивидуального предпринимателя
Date of Birth
Private Entrepreneur ID privateEntrIdNbr Text 20 ID индивидуального предпринимателя
Number
Private Entrepreneur ID privateEntrIdIssueDate Date 8 Дата выдачи ID индивидуального предпринимателя
Issue Date
Private Entrepreneur privateEntrIssuePlaceAuthority Text 100
Issue Place Authority
Subscriber Description subscriberDescr Text 255 Описание подписчика
Subscriber ID subscriberID Numeric 5 Код подписчика
Subscriber Name subscriberName Text 100 Имя подписчика
Subscriber OGRN subscriberOgrn Text 13 ОГРН подписчика
Subscriber OKPO subscriberOkpo Text 8 ОКПО подписчика
Subscriber Special Status subscriberSpecialStatus Subscriber Special Status 2 Специальный статус подписчика
Subscriber Special Status subscriberSpecStatusStartDate Date 8 Дата выставления специального статуса подписчика
Start Date
Subsriber Tax Number subscriberTaxNbr Text 10 ИНН подписчика
Subscriber Type subscriberType Subscriber Type 2 Тип подписчика

www.bki-okb.ru
111
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Consumer.[].CAPS.[].Consumer[0]
Name XML-имя Тип Длина Описание
Applicant Type applicantType Applicant 2 тип заявителя: Владелец, совладелец, принципал или поручитель
Type
First Name name1 Text 100 Имя / Краткое наименование организации
Patronymic name2 Text 100 Отчество / Наименование организации на иностранном языке
Surname surname Text 150 Фамилия / Полное наименование компании
Date of Birth dateOfBirth Date 8 дата рождения
Place of Birth placeOfBirth Text 100 место рождения
Primary ID Type primaryIDType Identity Type 2 тип основного удостоверяющего документа
Primary ID primaryID Text 20 номер основного удостоверяющего документа
Primary ID Issue primaryIDIssueDate Date 8 дата выдачи основного удостоверяющего документа
Date
Primary ID Issue primaryIDIssuePlace Text 30 место выдачи основного удостоверяющего документа
Place
Primary ID Expiry primaryIDExpiry Date 8 дата истечения срока действия удостоверяющего документа
Date
Primary ID Authority primaryIDAuthority Text 100 орган, выдавший основной удостоверяющий документ

Consumer.[].CAPS.[].Decision
Name XML-имя Тип Длина Описание
Previous Stream ID streamID Numeric 20 Сформированный номер ссылки для этого решения. Может отличаться от такого
же поля в блоке CAPS, если решение было передано с помощью функции
Decision Update
Type of Decision decisionType Decision type 2 Тип принятого решения
Date of Decision dateOfDecision Date 8 Дата принятия решения
Decision End Date decisionEndDate Date 8 Дата окончания срока действия решения
Decision Reason decisionReason Decision 2 Причина по решению, которое было принято по кредитному заявлению
Reason
Decision Amount decisionAmount Numeric 15 Сумма, по которой было принято решение по кредитному заявлению.
Возвращается в ответе только в случае одобрения.

www.bki-okb.ru
112
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Name XML-имя Тип Длина Описание


Currency Code currency Currency 3 Валюта кредита, на получение которого подавалось кредитное заявление
Code
Comments comments Text 256 Дополнительные комментарии или информация по решению, которое принято
по заявке

7.7 Запрос Отдельного Скоринга бюро (Score Credit Enquiry)


Есть возможность выполнять запросы Отдельного Скоринга бюро без записей CAIS, CAPS и других данных.
7.7.1 XML-запрос
Запрос Отдельного Скоринга бюро может быть выполнен при соблюдении следующих условий:
• Номер функции – 58
• Запрос имеет ту же структуру и используются те же данные, что и запрос на стандартный кредитный отчет по физическим лицам
• Запрос валидируется как Запрос по физическому лицу
• Запрос может быть выполнен только по одному субъекту
Дополнительную информацию по формату запроса можно получить в разделах 4, 5 этого документа.

Если запрос выполняется по новому заемщику, то в качестве причины запроса (Reason for Enquiry) необходимо уазывать «01 – New credit Application». Поля
Application Number и Application Date должны быть также правильно заполнены.
7.7.2 XML-ответ
В ответе Скоринга бюро выдаются только скоринговый балл, номер скоринговой карты, рисковый индекс и индикатор достоверности. Структура XML-ответа
Скоринга бюро сходна со структурой CAIS, CAPS и EXDBs.
Ответ включает в себя только поля блока “Bureau Score” и, в случае наличия ошибок, блок “Validation Errors”.

В таблице ниже описаны атрибуты блока “Bureau Score”:


XML имя Тип Описание
confidenceFlag Numeric Индикатор достоверности
scoreCardType Numeric Номер скоринговой карты
scoreInterval Numeric Рисковый индикатор
scoreNumber Numeric Скоринговый балл

См. дополнительную информацию по формату ответа Скоринга Бюро в разделе Информация Скоринг Бюро Consumer.[0].BureauScore[].

www.bki-okb.ru
113
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Блок Summary возвращается пустым.

8. Ошибки
Все ошибки закодированы, ниже приведен полный перечень возможных ошибок.
В блоке <a n=”errorCode” (код ошибки) >0</a>,
возвращается значение: 0-нет ошибок, 1-есть ошибки.
8.1 Ошибки обработки
Ошибки обработки являются следствием сбоя. При использовании протокола HTTPS используется значение состояния ответа.
Описание ошибки Состояние (HTTPS)
Пустое поле User name (имя пользователя) или недействительное значение “403 Forbidden” (запрещено)
поля Function number (номер функции)
Неверный XML “400 Bad Request” (неправильный запрос)
Неверный формат XML “400.1 Bad Request” (неправильный запрос)
Сбой в процессе запроса “503 Service unavailable” (сервис недоступен)

8.2 Ошибки проверки корректности


В процессе запроса выполняются различные проверки корректности. В случае наличия ошибок они возвращаются с номерами:
Номер Описание Description
ошибки
02 Недействительный идентификатор сессии. Идентификатор сессии перед Invalid Session ID. The Session ID before the Enquiry request to be processed is
обрабатываемым запросом недействителен. invalid.
31 Слишком много записей CAIS Record. Обнаружено слишком много записей CAIS Too many CAIS Records. Too many CAIS records have been retrieved and cannot be
record, не может быть обработано. processed.
51 Ошибка преобразования внешнего кода во внутренний. Переданные External to Internal Code Conversion error. The supplied data contains an
данные содержат неправильный внешний код. Также указываются имя invalid external code. The internal field name and path are also identified
внутреннего поля, путь к полю, а также неправильное значение и along with the incorrect value and expected code set internal id.
ожидаемый внутренний идентификатор кода.

www.bki-okb.ru
114
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Номер Описание Description


ошибки
52 Ошибка преобразования внутреннего кода во внешний. Возвращенные Internal to External Code Conversion error. The returned data contains an
данные содержат неправильный внутренний код. В настоящее время эти invalid internal code. Currently, these errors are ignored. If they occur then
ошибки игнорируются. Если они случаются, это указывает на наличие очень something very bad has happened to the database data.
серьезной ошибки в базе данных.
99 Нет полномочий. Неправильные данные входа в систему или пользователь No Right. The logon information is incorrect or the user does not have the
не имеет права осуществлять выбранный вид запроса. В этом случае другие right to perform the requested kind of Enquiry. No other validation errors are
ошибки проверки корректности не сообщаются. reported in this case.
101 Обязательное значение. Не введено обязательное значение поля. Mandatory. A mandatory field value has not been supplied. The name and
Указываются имя поля и путь к нему. path for the field are identified.
102 Не требуемое значение. В поле введено значение, для которого оно не Not Required. A value has been supplied for a field that requires no value.
требуется. Указываются имя поля и путь к нему. The name and path for the field are identified.
103 Слишком длинное значение. Введенное значение является слишком Too Long. The value supplied is too long. The name, path and expected
длинным. Указываются имя поля, путь к полю и ожидаемая максимальная maximum length are identified.
длина.
104 Слишком короткое значение. Введенное значение является слишком Too Short. The value supplied is too short. The name, path and expected
коротким. Указываются имя поля, путь к полю и ожидаемая минимальная minimum length are identified.
длина.
105 Неправильный номер. В числовое поле введен неправильный номер. Bad Number. An invalid number has been supplied for a numeric field. The
Указываются имя поля, путь к полю и неправильный номер. name, path and bad number are identified.
106 Неправильная дата. В поле даты введена неправильная дата. Указываются Bad Date. An invalid date has been supplied for a date field. The name, path
имя поля, путь к полю и неправильная дата. and bad date are identified.
107 Недействительное значение. Введенное значение является Invalid. The supplied value is invalid.
недействительным. Например, значения поля Function Number не 50 и не For example, Function Number not 50 or 52.
52. Reason for Enquiry and Function Number validation
Основание для запроса и проверка значений поля Function Number. Unknown Duration Units
Неизвестные единицы длительности Unknown or Variable Payment Frequency.
Неизвестная или непостоянная частота платежей.
108 Сравнение. Введенное значение не находится в требуемом диапазоне Comparison. The supplied value is not in the correct range according to some
относительно другого значения. Например, значение поля Installment other value. For example, the Installment Amount cannot exceed the Amount
of Finance.

www.bki-okb.ru
115
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Номер Описание Description


ошибки
Amount (сумма взноса) не может превышать значение поля Amount of
Finance (сумма финансирования).
109 Будущая дата. Указанная дата соответствует будущему периоду. Future Date. The given date is in the future.
110 Прошлая дата. Указанная дата соответствует прошлому периоду. Past Date. The given date is in the past.
111 Слишком молод. Лицо с указанной датой рождения является слишком Too Young. The person with the given date of birth is too young
молодым.
150 Согласие. Согласие субъекта отсутствует или заполнено некорректным Consent. Consumer Consent is not supplied or invalid, when it’s mandatory
значением, но оно является обязательным для данного вида запроса. for this type of Enquiry. The name and path for the field are identified.
Указывается имя и место поля.

8.3 Ошибки кодирования


Если опция «проверка кодировки» активна, то каждый запрос будет проверен на наличие посторонних и недопустимых символов. Описание ошибок результатов
проверки представлены ниже.
Номер ошибки Описание ошибки Description
112 Тип кодировки не поддерживается. Значение кодировки Codepage not supported. The supplied value of the encoding attribute in the
в заголовке xml-запроса не поддерживается. Типы request’s xml header is not supported. Supported encodings: windows-1251, utf-8
поддерживаемых кодировок: windows-1251, utf-8, or none.
пустое значение (тип кодировки не указан).
113 В тексте запроса найден недопустимый символ. Unexpected character found. A character that is not allowed by the CB software
is found.

116 Невозможно определить тип ошибки. Обратитесь в Unable to log. Contact CB operator
техническую поддержку.

8.4 Ошибки по блоку «Решение по кредитному заявлению»


Номер ошибки Описание ошибки Description
201 Отсутствует запись CAPS с указанным Stream ID Missing CAPS. There is no CAPS record with the provided Stream ID.

www.bki-okb.ru
116
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

202 Запись CAPS найдена, но некоторые поля отличаются от CAPS mismatch. CAPS record found, but some field(s) does not match.
указанных в запросе
204 Дополнительная проверка корректности. Некоторые из Extra Validation failed. Some of the Decision field(s) is invalid.
полей запроса некорректны
205 Найдена запись CAPS, но не совпадают поля основного CAPS ID mismatch. CAPS record found, but Primary ID field(s) does not match.
удостоверения личности.
207 Запись CAPS найдена, но причина запроса не Credit CAPS Reason for Enquiry mismatch. CAPS Record found, but Reason For Enquiry
Application (01) или Application Load (08). is not Credit Application (01) or Application Load (08)
208 Запись CAPS найдена, но номер заявки не совпадает. CAPS Application number mismatch. CAPS record found but Application Number
does not match.
209 Запись CAPS найдена, но тип финансирования не CAPS Account Type mismatch. CAPS record found but Account Type does not
совпадает. match.
210 Тип решения и Причина решения имеют разные Type of Decision and Decision reason are different. Type of Decision must be
значения. Тип решения должен иметь значение “01/Approved” when Decision reason = “01/Approved” (and vice versa).
01/Одобрено если Причина решения = 01/Одобрено (и
наоборот)
8.5 Описание предупреждений
В приведенной ниже таблице описаны возможные значения возвращаемых предупреждений. Некоторые из них заканчиваются числом (<n>), показывающим
сколько раз данное предупреждение было обнаружено.
Имя предупреждения Описание Description
WARNING_CAIS_BLOCKED Данный клиент имеет, по крайней мере, один This client has at least one blocked CAIS account. Blocked
блокированный счет CAIS. Блокированные счета не accounts are not returned.
возвращаются.
WARNING_CAIS_QUERIED Данный клиент имеет, по крайней мере, один This client has at least one queried CAIS account. Queried
сомнительный счет CAIS. Сомнительные счета accounts are returned.
возвращаются.
WARNING_TOO_MANY_ Данный клиент имеет слишком много счетов CAIS. This client has too many CAIS accounts. Only the worst accounts
CAIS_RECORDS Возвращаются только счета с наибольшей просрочкой are returned.
выплат.
WARNING_TOO_MANY_ На данного клиента имеется слишком много запросов This client has too many Bureau Enquiries. Only the most recent
CAPS_RECORDS Бюро. Возвращаются только самые последние из них. enquiries are returned.

www.bki-okb.ru
117
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Имя предупреждения Описание Description


WARNING_NO_INCOME_ Для данного клиента был введен нулевой доход. An income of 0 was entered for this client.
AMOUNT_ENTERED
WARNING_POTENTIAL_ Превышен потенциальный месячный лимит платежей по Potential Monthly Installment limit exceeded for accounts
LIMIT_OWNER счетам, владельцем которых является данный клиент. where this client is the Owner.
WARNING_POTENTIAL_ Превышен потенциальный месячный лимит платежей по Potential Monthly Installment limit exceeded for accounts
LIMIT счетам, где данный клиент не является владельцем. where this client is not the Owner.
WARNING_CAIS_ Не были обнаружены суммы в валюте на <n> кредитных A currency value was not found for <n> CAIS accounts.
CURRENCY_<n> счетах CAIS.
WARNING_NUM_OF_ Частота платежей по <n> кредитным счетам CAIS не A payment frequency was not found, unknown or variable for
INSTALMENT_FREQ_ обнаружена, неизвестна или является переменной. <n> CAIS accounts
EXCLUSIONS_<n>
WARNING_CAPS_NOT_ Из ответа были удалены CAPS без положительного Non-consented CAPS records have been removed from the
CONSENTED индикатора согласия о запросе в Бюро search results
WARNING_CAIS_NOT_ Из ответа были удалены CAIS без положительного Non-consented CAIS records have been removed from the
CONSENTED индикатора согласия о передаче информации по кредиту в search results.
Бюро

9. Собственные данные
Счет CAIS или запись CAPS считаются «Собственными Данными», если выполняются условия:
• Пользователь является владельцем данных.
• Пользователь является Оператором Бюро.
• Владелец данных является дочерним подписчиком Пользователя.
• Пользователь и Владелец данных являются дочерними подписчиками одного и того же подписчика.
Если счет субъекта (CAIS) не относится к Собственным Данным, то поле Consumer Account Number (номер счета клиента), Legal Account Number (номер счета
юридический) and the Account Owner Name (имя владельца счета) не будет содержать значения.
Набор следующих полей также не будет содержать значения для не Собственных Данных:
Секция «Guarantee» – поля « Guarantee Agreement Number» и «Guarantor Name».
Секция «Warrantee» – поле «Warranty Agreement Number» и «Legal Warranty Agreement Number».
Секция «Assignee» – все поля заполняются в соответствии с правилами, определенными в разделах SubscriberDetails и «Собственные данные».
Секция «Lien» – поле «Lien Agreement Number».

www.bki-okb.ru
118
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Если запрос в Бюро (CAPS) не относится к Собственным Данным, то поля «Generated Reference Number» (Stream ID)/(сформированный ссылочный номер) и
«Application Number» остаются не заполненными, а поле «Owner Name» (имя владельца) меняется на поле «Business Type» (вид бизнеса).
Поля « subscriberType», «subscriberSpecialStatus», «subscriberSpecStatusStartDate» содержат значения и для Собственных и для не Собственных данных для всех
видов запросов.
Поля «subscriberID» и «subscriberName» доступны только для Пользователя, являющегося Владельцем данных.
Правила отображения собственных данных не применяются для запросов Оператора Бюро.

10. «Маскируемая часть» - поля и правила отображения


Значения следующих полей будут скрыты в кредитных отчетах:

Consumer.[].CAIS.[].Consumer.[0]
- Mobile Telephone Number (Номер мобильного телефона)

Consumer.[].CAIS.[].Consumer.[0].Address.[]
- Home Telephone Number (Номер домашнего телефона)

Consumer.[].CAIS.[].Consumer.[0].Employer.[]
- Все поля

Consumer.[].CAPS.[].Consumer.[0]
- Driving license (Номер водительского удостоверения), Medical Insurance Number (Номер медицинского страхования)
- Income (Доход), Income Frequency (Частота получения дохода), Net Gross (общий доход), Other Income (Другие доходы)
- Residential Status (стаус проживания), Occupation (работа), Occupation Status (статус занятости), Marital Status (семейное положение), No. of Dependants
(количество иждивенцев), Education (образование)
- Mobile Telephone (мобильный телефон), Mobile Phone Registration (регистрация мобильного телефона)
- Visa Credit Card, MasterCard, Diners Credit Card, American Express, JCB Credit Card, Debit Card, Cheque Guarantee, Retail Credit Card, Other Credit Card

Consumer.[].CAPS.[].Consumer[0].Address.[]
- Telephone (телефон)

Consumer.[].CAPS.[].Consumer[0].Employer
- Все поля

www.bki-okb.ru
119
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Consumer.[].GUAR.[].Consumer.[] (когда гарант не привязан к счету)


- Mobile Telephone Number (мобильный телефон)

Consumer.[].GUAR.[].Consumer.[0].Address.[]
- Home Telephone Number (номер домашнего телефона)

11. Проверки
Проверки, выполняются в соответствии с Приложением С «Описания данных CAIS»

www.bki-okb.ru
120
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Приложение 1. Схемы запросов и формирования информационной части

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

Extended Enquiry App Stream ID


(FN = 40)
Reason = 01 anytime 1..n

Rejected
Decision [0..1]
Application App Stream ID CAPS Decision Update
App Stream ID (FN = 41)
Application
number
Approved CAIS
Standard Enquiry
(FN = 70)
Reason = 01
App Stream ID
anytime 1..n
Request Details
Decision [0..1] registration

InfoPart Enquiry
(FN = 67)
Reason = 01

www.bki-okb.ru
121
Спецификация B2B-интерфейса. V. 2.35 от 25.09.2019

Схема загрузки в Бюро информационной части кредитной истории субъекта


App Stream ID
anytime 1..n

Rejected

Application Load Application App Stream ID CAPS Decision Update


(FN = 42)
Reason = 08 App Stream ID (FN = 41) Application
number
Approved CAIS

Decision [0..1]
App Stream ID
anytime 1..n

Схема запросов в Бюро на получение кредитных отчетов

Extended Enquiry
(FN = 40)
All Reasons (not 01)

Standard Enquiry Request Details


(FN = 70)
All Reasons (not 01) registration

InfoPart Enquiry
(FN = 67)
All Reasons (not 01)

www.bki-okb.ru
122

Вам также может понравиться