...
Info |
---|
Звіт містить такі компоненти:
|
Request JSON (headers: "SessId: Session key (obtained from the authorization API)", "Content-Type: application/json")
|
<?xml version="1.0" encoding="utf-8"?>
<doc>
<ubki sessid="Сесійний ключ (отримуємо з API авторизації)">
<req_envelope descr="Конверт запиту">
<req_xml descr="Об'єкт запиту">
<!-- Параметри пошуку -->
<request version="1.0"
reqtype="Режим обробки інформації (Код із дов.50)"
delreason="Причина видалення даних, при режимі d (Код із дов.62)"
reqreason="Мета подачі запиту (Код із дов.24): Передача даних - 0">
<comp id="1" descr="Назва компоненти">
<!-- Блок ідентифікації --><!-- Даний блок повинен складатися з одного елемента -->
<cki inn="ЄДРПОУ"
lname="Прізвище/Найменування юрособи"
fname="Ім'я"
mname="По батькові"
reqlng="Мова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Код із дов.23)"
bdate="Дата народження">
<!-- Блок історії ідентифікації -->
<!-- Даний блок може і повинен складатися з 1 .. елементів * -->
<urident vdate="Дата верифікації даних кредитором"
lng="Мова надання блоку (Код із дов.23)"
okpo="ЄДРПОУ"
urname="Найменування юр.особи"
urfrms="Форма власності (Код із дов.38)"
ureconom="Галузь економіки (Секція КВЕД2010) (Код із дов.36)"
urvide="Вид діяльності (КВЕД2010) (Код із дов.37)"
urdatreg="Дата реєстрації в ЄДР"
urdatregnal="Дата реєстрації в податковій">
</urident>
<!-- Блок пов'язаних осіб для юр.осіб (Директор, бухгалтер ...) --><!-- Даний блок може і повинен складатися з 1 .. елементів * -->
<linked okpo2="РНОКПП (ІПН)/ЄДРПОУ пов'язаної особи"
okpo2_name="ПІБ/Найменування пов'язаної особи"
linkrole="Тип зв'язку (Код із дов.39)"
linkroleref="Тип зв'язку (Значення із дов.39)"
rdate="Дата актуалізації зв'язку">
</linked>
<!-- Блок історії інформації про документи -->
<!-- Даний блок повинен складаються з 0 .. * елементів -->
<doc vdate="Дата верифікації даних кредитором"
lng="Мова надання блоку (Код із спр.23)"
dtype="Тип документа (Код із спр.7)"
dser="Серія документа"
dnom="Номер документа"
dterm="Срок дії"
dwho="Ким виданий документ"
dwdt="Дата видачі документа">
</doc>
<!-- Блок історії інформації про адреси -->
<!-- Даний блок повинен складатися з 1 .. * елементів і заповнений принаймні однією адресою -->
<addr vdate="Дата верифікації даних кредитором"
lng="Мова надання блоку (Код із дов.23)"
adtype="Тип адреси (Код із дов.9)"
adcountry="Країна (однорядкове резюме код з довідника ISO 3166)"
adindex="Поштовий індекс"
adstate="Область"
adarea="Район"
adcity="Населений пункт"
adcitytype="Тип населеного пункту (Код із дов.22)"
adstreet="Вулиця"
adhome="Дім"
adcorp="Корпус"
adflat="Квартира"
addrdirt="Адреса в одному рядку (буде виведений з експлуатації в наступних версіях АPІ, з 13.11.2019 поле вважається неприпустимим)">
</addr>
</cki>
</comp>
<comp id="2" descr="Назва компоненти">
<!-- Блок інформації про кредитні угоди --><!-- Даний блок повинен складаються з 1 .. * елементів -->
<crdeal dlref="Ідентифікатор угоди"
lng="Мова надання блоку (Код із дов.23)"
inn="РНОКПП (ІПН) СКІ" lname="Прізвище"
fname="Ім'я"
mname="По батькові"
bdate="Дата народження"
dlcelcred="Тип операції (Код із дов.17)"
dlvidobes="Вид забезпечення (Код із дов.15)"
dlporpog="Порядок погашення (Код із дов.18)"
dlcurr="Валюта угоди (Код із дов.12)"
dlamt="Сума (початкова) угоди"
dlrolesub="Роль суб'єкта (Код із дов.14)"
dlamtobes="Вартість забезпечення в базовій валюті">
<!-- Блок змінних значень кредитної історії -->
<deallife dlref="Ідентифікатор угоди"
dlmonth="Період даних (місяць)"
dlyear="Період даних (рік)"
dlds="Дата початку операції"
dldpf="Дата закінчення угоди за договором"
dldff="Фактична дата закінчення угоди"
dlflstat="Статус угоди в поточному періоди (Код із дов.16)"
dlkontragent="ЄДРПОУ нового кредитора/старого кредитора (обов'язкове при статусі угоди проданий/куплений)"
dlsale_date="Дата продажу (обов'язково при продажу/купівлі угоди з 15.03.2021)"
dlsale_name="Повне найменування юридичної особи (обов'язково при продажу/купівлі договору юридичній особі з 15.03.2021)"
dlsale_addr="Місцезнаходження юридичної особи (обов'язково при продажу/купівлі договору юридичній особі з 15.03.2021)"
dlsale_email="Адреса електронної пошти (обов'язково при продажу/купівлі договору юридичній особі з 15.03.2021)"
dlsale_phone="Номер телефону (обов'язково при продажу/купівлі договору юридичній особі з 15.03.2021)"
dlamtlim="Поточний ліміт угоди (для поновлюваних угод, кредитних карт)"
dlamtpaym="Сума планового обов'язкового платежу в поточному періоді"
dlamtcur="Сума поточної заборгованості"
dlamtexp="Сума поточної простроченої заборгованості"
dldayexp="Поточна кількість днів прострочення"
dlflpay="Озанка виконання платежу в поточному періоді (Код із дов.13)"
dlflbrk="Ознака наявності прострочення в поточному періоді (Код із дов.13)"
dlfluse="Ознака кредитного траншу в поточному періоді (Код із дов.13)"
dldateclc="Дата розрахунку">
</deallife>
</crdeal>
</comp>
<comp id="10" descr="Назва компоненти">
<!-- Блок історії своїх контактних даних -->
<!-- Даний блок повинен складатися з 1 .. * елементів і заповнений принаймні одним контактом -->
<cont inn="ЄДРПОУ"
vdate="Дата верифікації даних кредитором"
ctype="Тип контакту (Код із дов.10)"
cval="Значення контакту">
</cont>
</comp>
</request>
</req_xml>
</req_envelope>
</ubki>
</doc>
Response XML
Expand | ||
---|---|---|
| ||
<TECH> <!-- Звіт про результат запиту-передачі даних буде знаходитися у відповідному XML, тег--> <!-- Блок статистики часу відпрацювання на стороні УБКІ--> <trace> <step name="START" stm="1574049134.650" ftm="1574049134.651" /> <step name="FINISH" stm="1574049134.650" ftm="1574049135.224" /> </trace> <!-- заповнюється в разі системної помилки і неможливості продовження успішної передачі пакетів (наприклад при закінченні дії сесійного ключа) --> <error errtext="" errtype="числовий код помилки з довідника errtype дов.0" /> <!--Звіт про результат запиту-передачі даних--> <sentdatainfo reqid="Вихідний ІД запиту, згенерований УБКІ" state="Стан пакета (sy - системна помилка в сервісах УБКІ, ok - успіх, er - помилка, nt - успіх з позначкою)" sy="системна помилка в сервісах УБКІ, повторіть відправку пакета, при повторенні помилки призупиніть відправку нових пакетів до з'ясування причин з бюро" ok="кількість прийнятих компонент без зауважень" nt="кількість прийнятих компонент із зауваженнями" ig="кількість не прийнятих/відхилених/проігнорованих компонент" er="кількість компонент з критичною помилкою, призводять до відбраковування всього пакету" errtype="Максимальний код помилки з усіх помилок компонент"> <item compid="ІД компоненти" tag="Тег" attr="Атрибут" code="sy - системна помилка в сервісах УБКІ, er - критична помилка, ig - відхилено з зауваженням, nt - прийнято з зауваженням" msg="Текст повідомлення" errtype="Всі помилки і/або нотифікації з довідника" /> </sentdatainfo> </TECH> |
Приклад
Request
|
Response JSON
|
Request XML
|
Response XML
|
Example |
---|
Request JSON |
|
Request XML |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Response JSON |
|
|
|
|
|
|
|
|
|
Response XML |
|
XSD Schema request | https://secure.ubki.ua/upload.xsd |
---|---|
XSD Schema response | https://secure.ubki.ua/response.xsd |
Test URL | https://test.ubki.ua/upload/data |
---|
Див. у цьому розділі також
Фізична особа
Параметри запиту передачі даних
API отримання реєстру передачі даних
Помилки і нотифікації при передачі даних
Журнал версій API
Вступ
Авторизація
Отримання інформації із бюро
Моніторинг
Тестове середовище
Довідники
...
...
See also in this section
Individual
Parameters of the data transfer request
Data transfer register reception API
Errors and notifications when transferring data
API version history
...