Versions Compared

Old Version 22

changes.mady.by.user Оксана Нечепоренко

Saved on

compared with

New Version Current

changes.mady.by.user Оксана Нечепоренко

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Http Method

POST

Request URL

https://secure.ubki.ua/b2_api_xml/ubki/xml

Request JSON

Expand
title body:

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"fotoident": {

"foto": "base64(Фото)",

"fotoext": "Розширення до фото вхідної заявки (jpeg)",

"phone": "Телефон для порівняння",

"facelogic": "Тип алгоритму пошуку особи"

},

"reqlng": "Мова критеріїв пошуку (Код із дов.23)"

},

"version": "1.0",

"reqtype": "Код шаблону (Код із дов.49): Звіт 'Ідентифікація за номером телефону та фото' - 06",

"reqreason": "Мета подання запиту (Код із дов.24)"

},

"descr": "Об’єкт запиту"

},

"descr": "Конверт запиту"

},

"sessid": "Сесійний ключ отримуємо із API авторизації)"

}

}

}

Response

Response JSON

Expand
titlebody:

{

"ubkidata": {

"tech": {

"trace": {

"step": {

"name": "Найменування кроку",

"stm": "Дата штамп старту кроку",

"ftm": "Дата штамп фінішу кроку"

}

},

"error": {

"errtype": "Код помилки(Код із дов.0)",

"errtext": "Текст помилки(Значення із дов.0)"

},

"reqinfo": {

"reqid": "Вихідний ІД запиту, згенерований УБКІ"

},

"billing": {

"balance": {

"value": "Сума балансу",

"date": "Дата",

"time": "Час"

},

"billdetails": {

"freemon": "Ознака безоплатності за типом запиту "Моніторинг клієнта організації" (reqreason=1), код (0 - Ні, 1 - Так)",

"freemonref": "Ознака безоплатності за типом запиту "Моніторинг клієнта організації" (reqreason=1), значення (0 - Ні, 1 - Так)"

}

}

},

"comp": [

{

"cki": {

"ident": {

"donor": "Джерело інформації (Значення із дов.54)",

"vdate": "Дата інформації даного блоку",

"lng": "Мова надання блоку (Код із дов.23)",

"lngref": "Мова надання блоку (Значення із дов.23)",

"inn": "РНОКПП (ІПН) СКІ",

"lname": "Прізвище",

"fname": "Ім'я",

"mname": "По батькові",

"bdate": "Дата народження",

"csex": "Стать (Код із дов.1)",

"csexref": "Стать(Значення із дов.1)",

"family": "Сімейний стан (Код із дов.2)",

"familyref": "Сімейний стан (Значення із дов.2)",

"ceduc": "Освіта (Код із дов.3)",

"ceducref": "Освіта (Значення із дов.3)",

"cgrag": "Громадянство (Код із дов.4)",

"cgragref": "Громадянство (Значення із дов.4)",

"spd": "Наявність реєстрації СПД (Код із дов.5)",

"spdref": "Наявність реєстрації СПД (Значення із дов.5)",

"sstate": "Соціальный статус (Код із дов.6)",

"sstateref": "Соціальный статус (Значення із дов.6)",

"cchild": "Кількість дітей"

},

"work": {

"wdonor": "Джерело інформації (Значення із дов.54)",

"vdate": "Дата інформації даного блоку",

"lng": "Мова надання блоку (Код із дов.23)",

"lngref": "Мова надання блоку (Значення із дов.23)",

"cdolgn": "Службове становище (Код із дов.8)",

"cdolgnref": "Службове становище (Значення із дов.8)",

"wokpo": "ЄДРПОУ місця роботи",

"wname": "Назва місця роботи оригінальною мовою",

"wstag": "Стаж роботи, повних років",

"wdohod": "Щомісячний дохід клієнта"

},

"doc": {

"ddonor": "Джерело інформації (Значення із дов.54)",

"vdate": "Дата інформації даного блоку",

"lng": "Мова надання блоку (Код із дов.23)",

"lngref": "Мова надання блоку (Значення із дов.23)",

"dtype": "Тип документа (Код із дов.7)",

"dtyperef": "Тип документа (Значення із дов.7)",

"dser": "Серія документа",

"dnom": "Номер документа",

"dterm": "Термін дії",

"dwho": "Ким виданий документ",

"eddr_number": "Унікальний номер запису в Єдиному державному демографічному реєстрі (ЄДДР)",

"dwdt": "Дата видачі документа"

},

"addr": {

"addonor": "Джерело інформації (Значення із дов.54)",

"vdate": "Дата інформації даного блоку",

"lng": "Мова надання блоку (Код із дов.23)",

"lngref": "Мова надання блоку (Значення із дов.23)",

"adtype": "Тип адреси (Код із дов.9)",

"adtyperef": "Тип адреси (Значення із дов.9)",

"adcountry": "Країна (однорядкове резюме код з довідника ISO 3166)",

"adindex": "Поштовий індекс",

"adstate": "Область",

"adarea": "Район",

"adcity": "Населений пункт",

"adcitytype": "Тип населеного пункту (Код із дов.22)",

"adcitytyperef": "Тип населеного пункту (Значення із дов.22)",

"adstreet": "Вулиця",

"adhome": "Дім",

"adcorp": "Корпус",

"adflat": "Квартира",

"addrdirt": "Адреса в одному рядку (буде виведений з експлуатації в наступних версіях АPІ, з 13.11.2019 поле вважається неприпустимим)"

},

"inn": "РНОКПП (ІПН) СКІ/ЕДРППУ юрособи",

"lname": "Прізвище/Найменування юрособи",

"fname": "Ім'я",

"mname": "По батькові",

"reqlng": "Мова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Код із дов.23)",

"reqlngref": "Мова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Значення із дов.23)",

"bdate": "Дата народження"

},

"identdocmvds": {

"identdocmvd": {

"foundsource": {

"name": "Джерело даних для перевірки (Код із дов.63)",

"found": "0/1 - цифрове позначення наявності недійсного паспорту (Код із дов.27)",

"foundref": "Текстове позначення наявності недійсного паспорту (Значення із дов.27)",

"sourcedate": "Дата оновлення інформації у БД чи отримання відповіді від АПІ першоджерла."

},

"found": "Знайдений? (Код із дов.27)",

"foundref": "Знайдений? (Значение із дов.27)",

"foundtitle": "Опис результату пошуку",

"pser": "Серія паспорта",

"pnom": "Номер паспорта або номер ID-картки",

"dtype": "Тип документа (Код із дов.7)",

"dtyperef": "Тип документа (Значення із дов.7)"

}

},

"id": "1",

"descr": "Назва компоненти"

},

{

"fotoident": {

"match": "Результат звірки телефону і фотографії (Код із дов.56)",

"matchref": "Результат звірки телефонів в текстовому вигляді (Значення із дов.56)",

"verifclient": "Ознака збігу фото (Код із дов.47)",

"fotovc": " base64 (Фото) еталонної фотографії",

"fotoextvc": "Розширення до фото еталонної фотографії",

"commentvc": "Коментар за результатами порівняння з еталонною фотографією",

"confidencevc": "Міра схожості осіб на фотографіях клієнтів",

"datefotovc": "Дата еталонної фотографії"

},

"id": "12",

"descr": "Назва компоненти"

},

{

"pret": {

"pretension": {

"inn": "РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)",

"crdeal": "Ідентифікатор угоди (референс)",

"source": "Вид оскарження (Код із дов.48)",

"sourceref": "Вид оскарження (Значення із дов.48)",

"claim": "Предмет оскарження (Код із дов.69)",

"claimref": "Предмет оскарження (Значення із дов.69)",

"sourceref": "Вид оскарження (Значення із дов.48)",

"vdate": "Дата створення заявки"

},

"commentcki": {

"comment": "Коментар суб'єкта кредитної історії",

"vdate": "Дата створення коментаря"

},

"plost": {

"pser": "Серія паспорта, заявлено СКІ як загублений (крадіжка)",

"pnom": "Номер паспорта, заявлено СКІ як загублений (крадіжка)",

"crdate": "Дата створення заявки на втрату/крадіжку паспорта СКІ в УБКІ",

"ldate": "Зазначена в заявці дата втрати/крадіжки паспорта СКІ в УБКІ"

},

"changedeal": {

"crdeal": "Ідентифікатор угоди (референс)",

"changecode": "Код причини коригування/видалення даних (Код із дов.62)",

"changeref": "Текст причини коригування/видалення даних (Значення із дов.62)",

"vdate": "Дата коригування/видалення даних"

},

"freezedate": "Дата підключення опції FREEZE",

"nonewdealcomment": "Коментар",

"nonewdeal": "Ознака небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE: 0 - не включена, 1 - включена",

"nonewdealref": "Значення ознаки небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE - 0-ні (не підключена опція), 1-так (підключена опція)",

"inn": "РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)"

},

"idfcert": "18",{

"descrinn": "Назва компонентиІПН" }, {

"contactcert": {

"cval": "Значення контакту",

"ctype": "Тип контакту "Ознака наявності сертифіката від УБКІ (Код із дов. 10)",

"ctyperef": "Тип контакту в текстовому вигляді (Значення із дов.10)",

"cstate": "Статус контакту (Код із дов.5756) - 0 - ні (немає зареєстрованого сертифіката), 1 - так (є зареєстрований сертифікат) ",

"cstaterefcertref": "Статус контакту (Текстове значення Ознака наявності сертифіката від УБКІ (Значення із дов. 5756)",

"vdatestartcertid": "Дата першої актуалізаціїНомер сертифіката",

"vdatecerturl": "Дата останньої актуалізаціїПосилання на сертифікат"

},

"idmaybegone": {

"46",

"descr": "Назва компоненти"

}

]

}

}

Request XML

Expand
title body:

<?xml version="1.0" encoding="utf-8"?>

<doc>

<ubki sessid="Сесійний ключ отримуємо із API авторизації)">

<req_envelope descr="Конверт запиту">

<req_xml descr="Об’єкт запиту">

<!-- Параметри запиту -->

<request version="1.0" reqtype="Код шаблону (Код із дов.49): Звіт 'Ідентифікація за номером телефону та фото' - 06" reqreason="Мета подання запиту (Код із дов.24)">

<!-- Параметри, що описують критерії пошуку-->

<i reqlng="Мова критеріїв пошуку (Код із дов.23)">

<!-- Параметри ідентифікації суб'єкта-->

<fotoident foto="base64(Фото)"

fotoext="Розширення до фото вхідної заявки (jpeg)"

phone="Телефон для порівняння"

facelogic="Тип алгоритму пошуку особи" />

</i>

</request>

</req_xml>

</req_envelope>

</ubki>

</doc>

inn": "РНОКПП (ІПН) (для фіз. осіб)",

"vdate": "Дата? на яку передана інформація",

"dldonor": "Донор інформації (Значення із дов.54)"

},

"id": "18",

"descr": "Назва компоненти"

},

{

"contact": {

"cval": "Значення контакту",

"ctype": "Тип контакту (Код із дов.10)",

"ctyperef": "Тип контакту в текстовому вигляді (Значення із дов.10)",

"cstate": "Статус контакту (Код із дов.57)",

"cstateref": "Статус контакту (Текстове значення із дов.57)",

"vdatestart": "Дата першої актуалізації",

"vdate": "Дата останньої актуалізації"

},

"id": "46",

"descr": "Назва компоненти"

}

]

}

}

<step name="Найменування кроку" stm="Дата штамп старту кроку" ftm="Дата штамп фінішу кроку

Request XML

Expand
title body:

<?xml version="1.0" encoding="utf-8"?>

<ubkidata>

<!-- Блок системної інформації -->

<tech>

<trace>

<doc>

<ubki sessid="Сесійний ключ отримуємо із API авторизації)">

<req_envelope descr="Конверт запиту">

<req_xml descr="Об’єкт запиту">

<!--

Блок trace містить метрики таймінгу кроків формування компонентів <error errtype

Параметри запиту -->

</step>

</trace>

<request version="1.0" reqtype="Код

помилки

шаблону (Код із дов.

0)" errtext="Текст помилки(Значення

49): Звіт 'Ідентифікація за номером телефону та фото' - 06" reqreason="Мета подання запиту (Код із дов.

0

24)">

<

/error> <reqinfo reqid="Вихідний ІД запиту, згенерований УБКІ

!-- Параметри, що описують критерії пошуку-->

<i reqlng="Мова критеріїв пошуку (Код із дов.23)">

<

/reqinfo><

!--

Блок інформації щодо поточного стану рахунку припейд <balance value

Параметри ідентифікації суб'єкта-->

<billing>

<fotoident foto="

Сума балансу" date="Дата" time="Час

base64(Фото)"

fotoext="Розширення до фото вхідної заявки (jpeg)"

phone="Телефон для порівняння"

facelogic="Тип алгоритму пошуку особи" />

</

billing> </tech>

i>

</request>

</req_xml>

</req_envelope>

</ubki>

</doc>

Response XML

Expand
titlebody:

<?xml version="1.0" encoding="utf-8"?>

<ubkidata>

<!-- Блок ідентифікації системної інформації -->

<comp id <tech>

<trace>

<step name="1Найменування кроку" descrstm="Назва компоненти">

<cki inn="РНОКПП (ІПН) СКІ/ЕДРППУ юрособи"

lname="Прізвище/Найменування юрособи"

fname="Ім'я"

mname="По батькові"

reqlng="Мова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Код із дов.23)"

reqlngref="Мова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Значення із дов.23)"

bdate="Дата народження">

<ident donor="Джерело інформації (Значення із дов.54)"

vdate="Дата інформації даного блоку"

lng="Мова надання блоку (Код із дов.23)"

lngref="Мова надання блоку (Значення із дов.23)"

inn="РНОКПП (ІПН) СКІ"

lname="ПрізвищеДата штамп старту кроку" ftm="Дата штамп фінішу кроку">

<!-- Блок trace містить метрики таймінгу кроків формування компонентів -->

</step>

</trace>

<error errtype="Код помилки(Код із дов.0)" errtext="Текст помилки(Значення із дов.0)">

</error>

<reqinfo reqid="Вихідний ІД запиту, згенерований УБКІ">

</reqinfo>

<!-- Блок інформації щодо поточного стану рахунку припейд-->

<billing>

<balance value="Сума балансу" date="Дата" time="Час" />

<billdetails freemon="Ознака безоплатності за типом запиту "Моніторинг клієнта організації" (reqreason=1), код (0 - Ні, 1 - Так)"

freemonref="Ознака безоплатності за типом запиту "Моніторинг клієнта організації" (reqreason=1), значення (0 - Ні, 1 - Так)"/>

</billing>

</tech>

<!-- Блок ідентифікації -->

<comp id="1" descr="Назва компоненти">

<cki inn="РНОКПП (ІПН) СКІ/ЕДРППУ юрособи"

lname="Прізвище/Найменування юрособи"

fname="Ім'я"

mname="По батькові"

bdate="Дата народження"

csex="Стать reqlng="Мова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Код із дов.123)" csexref

reqlngref="СтатьМова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Значення із дов.123)" family

bdate="Сімейний стан (Код із дов.2)" familyref="Сімейний стан Дата народження">

<ident donor="Джерело інформації (Значення із дов.2)54)"

vdate="Дата інформації даного блоку"

ceduc lng="Освіта Мова надання блоку (Код із дов.323)" ceducref

lngref="Освіта Мова надання блоку (Значення із дов.323)" cgrag

inn="Громадянство (Код із дов.4)РНОКПП (ІПН) СКІ" cgragref

lname="Громадянство (Значення із дов.4)" spd="Наявність реєстрації СПД Прізвище"

fname="Ім'я"

mname="По батькові"

bdate="Дата народження"

csex="Стать (Код із дов.51)"

spdref csexref="Наявність реєстрації СПД Стать(Значення із дов.51)"

sstate family="Соціальный статус Сімейний стан (Код із дов.62)" sstateref

familyref="Соціальный статус Сімейний стан (Значення із дов.62)"

cchild ceduc="Кількість дітей">

<!--Даний блок може і повинен складатися з 1 .. * елементів-->

</ident>

<!-- Блок історії інформації місця роботи -->

<work wdonor="Джерело інформації Освіта (Код із дов.3)"

ceducref="Освіта (Значення із дов.3)"

cgrag="Громадянство (Код із дов.4)"

cgragref="Громадянство (Значення із дов.544)" vdate

spd="Дата інформації даного блоку" lng="Мова надання блоку Наявність реєстрації СПД (Код із дов.235)"

lngref spdref="Мова надання блоку Наявність реєстрації СПД (Значення із дов.235)"

cdolgn sstate="Службове становище Соціальный статус (Код із дов.86)" cdolgnref

sstateref="Службове становище Соціальный статус (Значення із дов.86)"

wokpo cchild="ЄДРПОУ місця роботиКількість дітей"

wname="Назва місця роботи оригінальною мовою"

wstag="Стаж роботи, повних років"

wdohod="Щомісячний дохід клієнта">

<!--Даний блок може складатися з 0 .. *>

<!--Даний блок може і повинен складатися з 1 .. * елементів-->

</work>ident>

<!-- Блок історії інформації документів місця роботи -->

<doc ddonor <work wdonor="Джерело інформації (Значення із дов.54)"

vdate="Дата інформації даного блоку"

lng="Мова надання блоку (Код із дов.23)"

lngref="Мова надання блоку (Значення із дов.23)"

dtype cdolgn="Тип документа Службове становище (Код із дов.78)" dtyperef

cdolgnref="Тип документа Службове становище (Значення із дов.78)"

dser wokpo="Серія документаЄДРПОУ місця роботи" dnom

wname="Номер документаНазва місця роботи оригінальною мовою"

dterm wstag="Термін діїСтаж роботи, повних років"

dwho wdohod="Ким виданий документ"

eddr_number="Унікальний номер запису в Єдиному державному демографічному реєстрі (ЄДДР)"

dwdt="Дата видачі документа">

<!--Даний блок повинен складатися з 1 .. * елементів і заповнений принаймні одним документомЩомісячний дохід клієнта">

<!--Даний блок може складатися з 0 .. *-->

</doc>work>

<!-- Блок історії інформації адрес документів -->

<addr addonor <doc ddonor="Джерело інформації (Значення із дов.54)"

vdate="Дата інформації даного блоку"

lng="Мова надання блоку (Код із дов.23)"

lngref="Мова надання блоку (Значення із дов.23)"

adtype dtype="Тип адреси документа (Код із дов.97)"

adtyperef dtyperef="Тип адреси документа (Значення із дов.97)"

adcountry dser="Країна (однорядкове резюме код з довідника ISO 3166)Серія документа"

adindex dnom="Поштовий індексНомер документа"

adstate dterm="ОбластьТермін дії"

adarea dwho="РайонКим виданий документ"

adcity="Населений пункт"

adcitytype="Тип населеного пункту (Код із дов.22 eddr_number="Унікальний номер запису в Єдиному державному демографічному реєстрі (ЄДДР)"

adcitytyperef="Тип населеного пункту (Значення із дов.22)"

adstreet="Вулиця"

adhome="Дім"

adcorp="Корпус"

adflat="Квартира"

addrdirt="Адреса в одному рядку (буде виведений з експлуатації в наступних версіях АPІ, з 13.11.2019 поле вважається неприпустимим)" dwdt="Дата видачі документа">

<!--Даний блок повинен складатися з 1 .. * елементів бути заповненим принаймні однією адресоюі заповнений принаймні одним документом-->

</addr> </cki>doc>

<!-- Блок перевірки документів на дійсність історії інформації адрес -->

<identdocmvds>

<identdocmvd found <addr addonor="Знайдений? Джерело інформації (Код Значення із дов.2754)" foundref="Знайдений? (Значение

vdate="Дата інформації даного блоку"

lng="Мова надання блоку (Код із дов.2723)"

foundtitle lngref="Опис результату пошуку"

pser="Серія паспорта"

pnom="Номер паспорта або номер ID-картки"

dtype="Тип документа Мова надання блоку (Значення із дов.23)"

adtype="Тип адреси (Код із дов.79)"

dtyperef adtyperef="Тип документа адреси (Значення із дов.79)" > <foundsource name

adcountry="Джерело даних для перевірки (Код із дов.63)" found="0/1 - цифрове позначення наявності недійсного паспорту Країна (однорядкове резюме код з довідника ISO 3166)"

adindex="Поштовий індекс"

adstate="Область"

adarea="Район"

adcity="Населений пункт"

adcitytype="Тип населеного пункту (Код із дов.2722)"

foundref adcitytyperef="Текстове позначення наявності недійсного паспорту Тип населеного пункту (Значення із дов.2722)"

sourcedate adstreet="Дата оновлення інформації у БД чи отримання відповіді від АПІ першоджерла." />

<!--Даний блок повинен складатись з 1 .. * елементів-->

</identdocmvd>

</identdocmvds>

</comp>Вулиця"

adhome="Дім"

adcorp="Корпус"

adflat="Квартира"

addrdirt="Адреса в одному рядку (буде виведений з експлуатації в наступних версіях АPІ, з 13.11.2019 поле вважається неприпустимим)">

<!--Даний блок повинен складатися з 1 .. * елементів бути заповненим принаймні однією адресою-->

</addr>

</cki>

<!-- Блок ідентифікації за телефоном та фото перевірки документів на дійсність -->

<comp id="12" descr="Назва компоненти">

<fotoident match="Результат звірки телефону і фотографії <identdocmvds>

<identdocmvd found="Знайдений? (Код із дов.5627)" matchref

foundref="Результат звірки телефонів в текстовому вигляді (Значення Знайдений? (Значение із дов.5627)"

foundtitle=" verifclient="Ознака збігу фото Опис результату пошуку"

pser="Серія паспорта"

pnom="Номер паспорта або номер ID-картки"

dtype="Тип документа (Код із дов.477)"

fotovc dtyperef=" base64 (Фото) еталонної фотографії"

fotoextvc="Розширення до фото еталонної фотографії"

commentvc="Коментар за результатами порівняння з еталонною фотографією"

confidencevc="Міра схожості осіб на фотографіях клієнтів" datefotovc="Дата еталонної фотографії" />Тип документа (Значення із дов.7)">

<foundsource name="Джерело даних для перевірки (Код із дов.63)"

found="0/1 - цифрове позначення наявності недійсного паспорту (Код із дов.27)"

foundref="Текстове позначення наявності недійсного паспорту (Значення із дов.27)"

sourcedate="Дата оновлення інформації у БД чи отримання відповіді від АПІ першоджерла." />

<!--Даний блок повинен складатись з 1 .. * елементів-->

</identdocmvd>

</identdocmvds>

</comp>

<!-- Попередження Блок ідентифікації за телефоном та фото -->

<comp id="1812" descr="Назва компоненти">

<pret nonewdeal="Ознака небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE: 0 - не включена, 1 - включена"

nonewdealref="Значення ознаки небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE - 0-ні (не підключена опція), 1-так (підключена опція)"

nonewdealcomment="Коментар"

freezedate="Дата підключення опції FREEZE"

inn="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)">

<pretension inn="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)"

<fotoident match="Результат звірки телефону і фотографії (Код із дов.56)"

matchref="Результат звірки телефонів в текстовому вигляді (Значення із дов.56)"

verifclient="Ознака збігу фото (Код із дов.47)"

fotovc=" base64 (Фото) еталонної фотографії"

fotoextvc="Розширення до фото еталонної фотографії"

commentvc="Коментар за результатами порівняння з еталонною фотографією"

confidencevc="Міра схожості осіб на фотографіях клієнтів" datefotovc="Дата еталонної фотографії" />

</comp>

<!-- Попередження -->

<comp id="18" descr="Назва компоненти">

<pret nonewdeal="Ознака небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE: 0 - не включена, 1 - включена"

nonewdealref="Значення ознаки небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE - 0-ні (не підключена опція), 1-так (підключена опція)"

nonewdealcomment="Коментар"

freezedate="Дата підключення опції FREEZE"

inn="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)">

<pretension inn="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)"

crdeal="Ідентифікатор угоди (референс)"

source="Вид оскарження (Код із дов.48)"

sourceref="Вид оскарження (Значення із дов.48)"

claim="Предмет оскарження (Код із дов.69)"

claimref="Предмет оскарження (Значення із дов.69)"

vdate="Дата створення заявки" />

<commentcki comment="Коментар суб'єкта кредитної історії"

vdate="Дата створення коментаря" />

<plost pser="Серія паспорта, заявлено СКІ як загублений (крадіжка)"

pnom="Номер паспорта, заявлено СКІ як загублений (крадіжка)"

crdate="Дата створення заявки на втрату/крадіжку паспорта СКІ в УБКІ"

ldate="Зазначена в заявці дата втрати/крадіжки паспорта СКІ в УБКІ" />

<changedeal crdeal="Ідентифікатор угоди (референс)"

source changecode="Вид оскарження (Код із дов.48)"

sourceref="Вид оскарження (Значення із дов.48)"

claim="Предмет оскарження (Код причини коригування/видалення даних (Код із дов.6962)" claimref

changeref="Предмет оскарження Текст причини коригування/видалення даних (Значення із дов.6962)"

vdate="Дата створення заявкикоригування/видалення даних" />

<commentcki comment="Коментар суб'єкта кредитної історії"

vdate="Дата створення коментаря" />

<plost pser="Серія паспорта, заявлено СКІ як загублений (крадіжка)"

pnom="Номер паспорта, заявлено СКІ як загублений (крадіжка)"

crdate="Дата створення заявки на втрату/крадіжку паспорта СКІ в УБКІ"

ldate="Зазначена в заявці дата втрати/крадіжки паспорта СКІ в УБКІ" />

<changedeal crdeal="Ідентифікатор угоди (референс)"

changecode="Код причини коригування/видалення даних (Код із дов.62)"

changeref="Текст причини коригування/видалення даних (Значення із дов.62)"

vdate="Дата коригування/видалення даних" />

</pret> </pret>

<fcert inn="РНОКПП (ІПН) (для фіз. осіб)"

cert="Ознака наявності сертифіката від УБКІ (Код із дов. 56) - 0 - ні (немає зареєстрованого сертифіката), 1 - так (є зареєстрований сертифікат) "

certref="Ознака наявності сертифіката від УБКІ (Значення із дов. 56)"

certid="Номер сертифіката"

certurl="Посилання на сертифікат" />

<maybegone inn="РНОКПП (ІПН) (для фіз. осіб)"

vdate="Дата, на яку передана інформація"

dldonor="Донор інформації (Значення із дов.54)"/>

</comp>

<!-- Блок підтвердження контактів СКІ -->

<comp id="46" descr="Назва компоненти">

<contact cval="Значення контакту"

ctype="Тип контакту (Код із дов.10)"

ctyperef="Тип контакту в текстовому вигляді (Значення із дов.10)"

cstate="Статус контакту (Код із дов.57)"

cstateref="Статус контакту (Текстове значення із дов.57)"

vdatestart="Дата першої актуалізації"

vdate="Дата останньої актуалізації" />

<!--Даний блок може складатися з 0 .. * елементів -->

</comp>

</ubkidata>

Приклад

{ "doc

JSON

Request JSON

Code Block
Code Block
{
	"doc": {
		"ubki": {
			"req_envelope": {
				"req_xml": {
					"request": {
						"i": {
							"ubkifotoident": {
								"foto": "base64(Фото)",
								"fotoext": "jpeg",
								"req_envelopephone": {"+380662134234",
				"req_xml				"facelogic": {
"3"
							},
							"requestreqlng": {"1"
						"i": {
	},
						"fotoidentversion": {
		"1.0",
						"fotoreqtype": "base64(Фото)06",
								"fotoextreqreason": "jpeg6",
					},
					"phonedescr": "+380662134234",Об'єкт запиту"
				},
				"facelogicdescr": "3Конверт запиту"
							},
							"reqlngsessid": "17BD7E136E3BF470EAA2CFE2E8700000D"
		}
	}
}

Response JSON

Code Block
{
	"ubkidata": {
},
"tech": {
			"trace": {
				"
version
step":
"1.0",
{
					
"
reqtype
name": "
06
build report",
					
"
reqreason
stm": "
6" }
2022-01-09 18:46:33.421",
					"
descr
ftm": "
Об'єкт запиту
2022-01-09 18:46:33.520"
				}
			},
			
"
descr
reqinfo":
"Конверт
{
запиту"
}, 
	
"
sessid
reqid": "
7BD7E136E3BF470EAA2CFE2E8700000D
req2#000002007683"
			}
		}
}

Response JSON

Code Block
{
,
		"ubkidatacomp": [
			{
				"techcki": {
					"traceident": [
						{
							"stepcchild": {"",
							"namesstateref": "build report",
							"stmsstate": "2022-01-09 18:46:33.421",
							"ftmspdref": "2022-01-09 18:46:33.520"физическое лицо",
				}
			}"spd": "1",
			"reqinfo": {
				"reqidcgragref": "req2#000002007683Украина",
			}
		},
		"compcgrag": ["804",
			{
				"ckiceducref": {"",
							"identceduc": ["",
						{	"familyref": "",
							"cchildfamily": "",
							"sstaterefcsexref": "женщина",
							"sstatecsex": "2",
							"spdrefbdate": "физическое лицо1985-10-05",
							"spdmname": "1ВАСИЛІВНА",
							"cgragreffname": "УкраинаІРІНА",
							"cgraglname": "804ГАРНА",
							"ceducrefinn": "3278508288",
							"ceduclngref": "Украинский",
							"familyreflng": "1",
							"familyvdate": "2015-02-25",
							"csexrefdonor": "женщина",BNK"
						},
						{
							"csexcchild": "2",
							"bdatesstateref": "1985-10-05",
							"mnamesstate": "ВАСИЛІВНА",
							"fnamespdref": "ІРІНАфизическое лицо",
							"lnamespd": "ГАРНА1",
							"inncgragref": "3278508288",
							"lngrefcgrag": "Украинский804",
							"lngceducref": "1",
							"vdateceduc": "2015-02-25",
							"donorfamilyref": "BNK"
						},
						{
							"cchildfamily": "",
							"sstaterefcsexref": "женщина",
							"sstatecsex": "2",
							"spdrefbdate": "физическое лицо1985-10-05",
							"spdmname": "1ВАСИЛІВНА",
							"cgragreffname": "ІРИНА",
							"cgraglname": "802ГАРНА",
							"ceducrefinn": "3278508288",
							"ceduclngref": "Украинский",
							"familyreflng": "1",
							"familyvdate": "2006-04-04",
							"csexrefdonor": "женщина",
BNK"
						}
					],
					"csexwork": "2",{
							"bdatewdohod": "1985-10-05",
							"mnamewstag": "ВАСИЛІВНА",
							"fnamewname": "ІРИНА",
							"lnamewokpo": "ГАРНА",
							"inncdolgnref": "3278508288",
							"lngrefcdolgn": "Украинский",
							"lnglngref": "1",
							"vdatelng": "2006-04-04",
							"donorvdate": "BNK"
						}
					],
					"workdoc": {
						"wdohoddwdt": "",
						"wstag": "2002-08-01",
						"wnamedwho": "ІВАНГОРОДСЬКИМ",
						"wokpodterm": "",
						"cdolgnrefdnom": "578072",
						"cdolgndser": "АМ",
						"lngrefdtyperef": "Паспорт громадянина України",
						"lngdtype": "1",
						"vdatelngref": "Украинский",
					},
					"doclng": {"1",
						"dwdtvdate": "20022019-0809-0110",
						"dwhoeddr_number": "ІВАНГОРОДСЬКИМ19891005-00022",
						"dtermddonor": "BNK"
					},
						"dnomaddr": "578072",{
						"dseradflat": "АМ",
						"dtyperefadcorp": "Паспорт",
						"dtypeadhome": "17",
						"lngrefadstreet": "УкраинскийТИХА",
						"lngadcitytyperef": "1",
						"vdateadcitytype": "2019-09-10",
						"eddr_numberadcity": "19891005-00022JВDКВJ",
						"ddonoradarea": "BNKІВАНГОРОДСКИЙ",
					}	"adstate": "ДНЕПРОПЕТРОВСКАЯ",
						"addradindex": {"23201",
						"adflatadcountry": "UA",
						"adcorpadtyperef": "Адрес регистрации",
						"adhomeadtype": "72",
						"adstreetlngref": "ТИХАУкраинский",
						"adcitytypereflng": "1",
						"adcitytypevdate": "2018-01-25",
						"adcityaddonor": "JВDКВJ"BNK"
					},
						"adareabdate": "ІВАНГОРОДСКИЙ1989-10-05",
						"adstatereqlngref": "ДНЕПРОПЕТРОВСКАЯУкраинский",
						"adindexreqlng": "232011",
						"adcountrymname": "UAВАСИЛІВНА",
						"adtypereffname": "Адрес регистрацииІРІНА",
						"adtypelname": "2ГАРНА",
						"lngrefinn": "Украинский3278508288",
				},
				"lngidentdocmvds": "1",{
						"vdateidentdocmvd": "2018-01-25",{
						"addonorfoundsource": "BNK"[
					},		{
								"bdatename": "1989-10-05MVS",
								"reqlngreffound": "Украинский1",
								"reqlngfoundref": "1Знайдений",
								"mnamesourcedate": "ВАСИЛІВНА"2022-01-09"
							},
					"fname": "ІРІНА",
		{
								"lnamename": "ГАРНАDMS",
								"innfound": "32785082880",
				},
				"identdocmvdsfoundref": { "Не знайдений",
								"identdocmvdsourcedate": {"2022-01-09"
						"foundsource": [	},
							{
								"name": "MVSUBKI",
								"found": "10",
								"foundref": "ЗнайденийНе знайдений",
								"sourcedate": "2022-01-09"
							}
						],
							{"found": "1",
						"foundref": "Знайдений",
						"namefoundtitle": "DMSПаспорт АМ-578072 знайдено в списку недійсних документів",
								"foundpser": "0АМ",
								"foundrefpnom": "Не знайдений578072",
								"sourcedatedtype": "2022-01-09"
							}1",
							{
								"name"dtyperef": "UBKIПаспорт громадянина України",
					}
				"found": "0"},
								"foundrefid": "Не знайдений1",
								"sourcedatedescr": "2022-01-09"
				Ідентифікація Суб’єкта кредитної історії (СКІ)"
			},
			{
				],
	"fotoident": {
					"foundmatch": "1",
						"foundrefmatchref": "ЗнайденийДа",
						"foundtitleverifclient": "Паспорт АМ-578072 знайдено в списку недійсних паспортів.2",
						"pserfotovc": "АМ /9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAI//2Q==",
						"pnomfotoextvc": "578072jpg",
						"dtypecommentvc": "1face found",
						"dtyperefconfidencevc": "Паспорт0.95986",
					}"datefotovc": ""
				},
				"id": "112",
				"descr": "Ідентифікація Суб’єктаза фото кредитноїта історіїномером (СКІ)телефону"
			},
			{
				"fotoidentpret": {
					"matchinn": "13278508288",
					"matchrefnonewdeal": "Да0",
					"verifclientnonewdealref": "2Ні",
					"fotovcnonewdealcomment": " /9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAI//2Q==",
					"fotoextvcfreezedate": "jpg"
				},
					"commentvcfcert": "face found",
{
					"confidencevcinn": "0.959863278508288",
					"datefotovccert": "0",
				},
				"idcertref": "12Ні",
					"descrcertid": "Ідентифікація за фото та номером телефону"
			},
			{
				"pretcerturl": {""
					"inn": "3278508288"},
					"nonewdealmaybegone": "0",{
					"nonewdealrefinn": "Ні3278508288",
					"nonewdealcommentvdate": "2022-12-01",
					"freezedatedldonor": "BNK"
				},
				"id": "18",
				"descr": "Попередження"
			},
			{
				"contact": [
					{
						"cval": "+380662134234",
						"ctype": "3",
						"ctyperef": "мобільний тел.",
						"cstate": "1",
						"cstateref": "Актуалізація",
						"vdatestart": "2020-09-03",
						"vdate": "2020-09-08"
					},
					{
						"cval": "+380111111111",
						"ctype": "3",
						"ctyperef": "мобільний тел.",
						"cstate": "2",
						"cstateref": "Деактуалізація",
						"vdatestart": "2020-06-12",
						"vdate": "2020-08-30"
					}
				],
				"id": "46",
				"descr": "Підтвердження контактів СКІ"
			}
		]
	}
}

...

Response XML

Code Block
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
  <tech>
    <trace>
      <step name="build report" stm="2022-01-09 18:46:33.421" ftm="2022-01-09 18:46:33.520" />
    </trace>
    <reqinfo reqid="req2#000002007683" />
  </tech>
  <comp id="1" descr="Ідентифікація Суб’єкта кредитної історії (СКІ)">
    <cki bdate="1989-10-05" reqlngref="Украинский" reqlng="1" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" inn="3278508288">
      <ident cchild="" sstateref="" sstate="" spdref="физическое лицо" spd="1" cgragref="Украина" cgrag="804" ceducref="" ceduc="" familyref="" family="" csexref="женщина" csex="2" bdate="1985-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" inn="3278508288" lngref="Украинский" lng="1" vdate="2015-02-25" donor="BNK" />
      <ident cchild="" sstateref="" sstate="" spdref="физическое лицо" spd="1" cgragref="" cgrag="802804" ceducref="" ceduc="" familyref="" family="" csexref="женщина" csex="2" bdate="1985-10-05" mname="ВАСИЛІВНА" fname="ІРИНА" lname="ГАРНА" inn="3278508288" lngref="Украинский" lng="1" vdate="2006-04-04" donor="BNK" />
      <work wdohod="" wstag="" wname="" wokpo="" cdolgnref="" cdolgn="" lngref="" lng="" vdate="" />
      <doc dwdt="2002-08-01" dwho="ІВАНГОРОДСЬКИМ" dterm="" dnom="578072" dser="АМ" dtyperef="Паспорт громадянина України" dtype="1" lngref="Украинский" lng="1" vdate="2019-09-10" eddr_number="19891005-00022" ddonor="BNK" />
      <addr adflat="" adcorp="" adhome="7" adstreet="ТИХА" adcitytyperef="" adcitytype="" adcity="JВDКВJ" adarea="ІВАНГОРОДСКИЙ" adstate="ДНЕПРОПЕТРОВСКАЯ" adindex="23201" adcountry="UA" adtyperef="Адрес регистрации" adtype="2" lngref="Украинский" lng="1" vdate="2018-01-25" addonor="BNK" />
    </cki>
    <identdocmvds>
         <identdocmvd found="1" foundref="Знайдений" foundtitle="Паспорт АМ-578072 знайдено в списку недійсних паспортів.документів" pser="АМ" pnom="578072" dtype="1" dtyperef="Паспорт громадянина України">
            <foundsource name="MVS" found="1" foundref="Знайдений" sourcedate="2022-01-09" />
            <foundsource name="DMS" found="0" foundref="Не знайдений" sourcedate="2022-01-09" />
            <foundsource name="UBKI" found="0" foundref="Не знайдений" sourcedate="2022-01-09" />
         </identdocmvd>
      </identdocmvds>
  </comp>
  <comp id="12" descr="Ідентифікація за фото та номером телефону">
    <fotoident match="1" matchref="Да" verifclient="2" fotovc=" /9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAI//2Q==" fotoextvc="jpg" commentvc="face found" confidencevc="0.95986" datefotovc="" />
  </comp>
  <comp id="18" descr="Попередження">
    <pret inn="3278508288" nonewdeal="0" nonewdealref="Ні" nonewdealcomment="" freezedate="" />
    <fcert inn="3278508288" cert="0" certref="Ні" certid="" certurl="" />
    <maybegone inn="3278508288" vdate="2022-12-01" dldonor="BNK" />
  </comp>
  <comp id="46" descr="Підтвердження контактів СКІ">
    <contact cval="+380662134234" ctype="3" ctyperef="мобільний тел." cstate="1" cstateref="Актуалізація" vdatestart="2020-09-03" vdate="2020-09-08" />
    <contact cval="+380111111111" ctype="3" ctyperef="мобільний тел." cstate="2" cstateref="Деактуалізація" vdatestart="2020-06-12" vdate="2020-08-30" />
  </comp>
</ubkidata>

...