...
...
Звіт містить такі компоненти:
...
...
2 - Блок інформації про кредитні угоди
...
3 - Інформація про виконавчі провадження СКІ
...
...
...
...
...
40 - Інформація з списку санкцій РНБО
...
41 - Інформація з відкритого реєстру національних громадських діячів України
...
A credit report of a legal entity will be useful, in case of registration of a loan contract, execution of the contract with a new partner, as wells as when the verification of the existing contractors is required. The report allows you to verify the existence, location of the founders, as well as dept obligations of a legal entity.
...
Info |
---|
The report contains the following components: |
Http Method | POST |
---|---|
Request URL | https://secure.ubki.ua/b2_api_xml/ubki/xml |
Request |
</ubki>
</doc>
Response XMLJSON
|
<?xml version="1.0" encoding="utf-8"?>
<doc>
<ubki sessid="Сесійна ключ (отримуємо з API авторизації)">
<req_envelope descr="Конверт запиту">
<req_xml descr="Об'єкт запиту">
<!-- Параметри запиту --><request version="1.0" reqtype="Код шаблону (Код із дов.49): 'Кредитний звіт юридичної особи' - 15" reqreason="Мета надання запиту (Код із дов.24)">
<!-- Параметри, що описують критерії пошуку-->
<i reqlng="Мова критеріїв пошуку (Код із дов.23)">
<!-- Параметри ідентифікації суб'єкта-->
<ident okpo="ЄДРПОУ (для юр.осіб)" />
</i>
</request>
</req_xml>
</req_envelope>
|
Response JSON
|
<?xml version="1.0" encoding="utf-8"?>
<ubkidata>
<!-- Блок системної інформації -->
<tech>
<trace>
<step name="Найменування кроку" stm="Дата штамп старту кроку" ftm="Дата штамп фінішу кроку">
<!-- Блок trace містить метрики таймінгу кроків формування компонентів -->
</step>
</trace>
<error errtype="Код помилки(Код із дов.0)" errtext="Текст помилки(Значення із дов.0)">
</error>
<reqinfo reqid="Вихідний ІД запиту, згенерований УБКІ">
</reqinfo>
<!-- Блок інформації щодо поточного стану рахунку припейд-->
<billing>
<balance value="Сума балансу" date="Дата" time="Час" />
</billing>
</tech>
<!-- Блок ідентифікації -->
<comp id="1" descr="Назва компоненти">
<cki inn="ЄДРПОУ юрособи"
lname="Прізвище/Найменування юрособи"
reqlng="Мова пошуку (при пошуку)/Мова ідентифікації (при передачі)(Код із дов.23)"
reqlngref="Мова пошуку (при пошуку)/Мова ідентифікації (при передачі) (Значення із дов.23)">
<!-- Блок історії ідентифікації юрособи-->
<urident donor="Джерело інформації (Значення із дов.54)"
vdate="Дата інформації даного блоку"
lng="Мова надання блоку (Код із дов.23)"
lngref="Мова надання блоку (Значення із дов.23)"
okpo="ЄДРПОУ юрособи" urname="Найменування юрособи"
urfrms="Форма власності (Код із дов.38)"
urfrmsref="Форма власності (Значення із дов.38)"
ureconom="Галузь економіки (Секція КВЕД2010)(Код із дов.36)"
ureconomref="Галузь економіки (Секція КВЕД2010) (Значеннч із дов.36)"
urvide="Вид діяльності (КВЕД2010) (Код із дов.37)"
urvideref="Вид діяльності (КВЕД2010) (Значення із дов.37)"
urdatreg="Дата реєстрації в ЄДР"
urdatregnal="Дата реєстрації в податковій">
<!--Даний блок може і повинен складатися з 1 .. * елементів-->
</urident>
<!-- Блок пов'язаних осіб для юросіб (Директор, бухгалтер ...)-->
<linked okpo2="РНОКПП (ІПН) / ЄДРПОУ пов'язаної особи"
okpo2_name="ПІБ / Найменування пов'язаної особи"
linkrole="Тип зв'язку (Код із дов.39)"
linkroleref="Тип зв'язку (Значення із дов.39)"
rdate="Дата актуалізації зв'язку">
<!--Даний блок може і повинен складатися з 1 .. * елементів-->
</linked>
<!-- Блок історії інформації адрес -->
<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 поле вважається неприпустимим)">
<!--Даний блок повинен складатися з 1 .. * елементів та бути заповненим принаймні однією адресою-->
</addr>
</cki>
<!-- Блок перевірки документів на дійсність --><identdocmvds>
<identdocmvd found="Знайдений? (Код із дов.27)"
foundref="Знайдений? (Значение із дов.27)"
foundtitle="Опис результату пошуку"
pser="Серія паспорта"
pnom="Номер паспорта або номер ID-картки"
dtype="Тип документа (Код із дов.7)"
dtyperef="Тип документа (Значення із дов.7)">
<foundsource name="Джерело даних для перевірки (Код із дов.63)"
found="0/1 - цифрове позначення наявності недійсного паспорту (Код із дов.27)"
foundref="Текстове позначення наявності недійсного паспорту (Значення із дов.27)" />
<!--Даний блок повинен складатись з 1 .. * елементів-->
</identdocmvd>
</identdocmvds>
</comp>
<!-- Блок інформації про кредитні угоди -->
<comp id="2" descr="Назва компоненти">
<crdeal dlref="Ідентифікатор угоди"
lng="Мова надання блоку (Код із дов.23)"
lngref="Мова надання блоку (Значення із дов.23)"
inn="ЄДРПОУ"
lname="Прізвище"
fname="Ім'я"
mname="По батькові"
bdate="Дата народження"
dlcelcred="Тип угоди(Код із дов.17)"
dlcelcredref="Тип угоди(Значення із дов.17)"
dlvidobes="Вид забезпечення (Код із дов.15)"
dlvidobesref="Вид забезпечення (Значення із дов.15)"
dlporpog="Порядок погашения (Код із дов.18)"
dlporpogref="Порядок погашення (Значення із дов.18)"
dlcurr="Валюта угоди (Код із дов.12)"
dlcurrref="Валюта угоди (Значення із дов.12)"
dlamt="Сума (початкова) угоди"
dldonor="Джерело інформації (Значення із дов.54)"
dlrolesub="Роль суб'єкта (Код із дов.14)"
dlrolesubref="Роль суб'єкта (Значення із дов.14)"
dlamtobes="Вартість забезпечення в базовій валюті">
<!-- Блок змінних значень кредитної історії --><deallife dlref="Ідентифікатор угоди"
dlmonth="Період даних (місяць)"
dlyear="Період даних (рік)"
dlds="Дата початку угоди"
dldpf="Дата закінчення угоди за договором"
dldff="Фактична дата закінчення угоди"
dlflstat="Статус угоди в поточному періоді (Код із дов.16)"
dlflstatref="Статус угоди в поточному періоді (Значення із дов.16)"
dlamtlim="Поточний ліміт угоди (для поновлюваних угод, кредитних карт)"
dlamtpaym="Сума планового обов'язкового платежу в поточному періоді"
dlamtcur="Сума поточної заборгованості" dlamtexp="Сума поточної простроченої заборгованості"
dldayexp="Поточна кількість днів прострочення"
dlflpay="Ознака виконання платежу в поточному періоді (Код із дов.13)"
dlflpayref="Ознака виконання платежу в поточному періоді (Значення із дов.13)"
dlflbrk="Ознака наявності прострочення в поточному періоді (Код із дов.13)"
dlflbrkref="Ознака наявності прострочення в поточному періоді (Значення із дов.13)"
dlfluse="Ознака кредитного траншу в поточному періоді (Код із дов.13)"
dlfluseref="Ознака кредитного траншу в поточному періоді (Значення із дов.13)"
dldateclc="Дата розрахунку">
<!--Даний блок повинен складатись з 1 .. * елементів-->
</deallife>
</crdeal>
</comp>
<!-- Блок інформації про виконавчі провадження СКІ --><comp id="3" descr="Інформація про виконавчі провадження СКІ">
<penaltiesCount totalCount="Загальна кількість виконавчих проваджень за весь час"
activeCount="Кількість активних виконавчих проваджень" />
<susd votesudname="Виконавець"
votetype="Тип виконавчого провадження"
votedate="Дата відкриття виконавчого провадження"
inn="ЄДРПОУ"
voteid="Номер виконавчого провадження"
votedonor="Джерело інформації"
votesudphone="Номер телефону виконавця"
votesudemail="Email виконавця"
vdate="Дата актуалізації запису"
credname="Найменування кредитор"
credokpo="Код ЄГРПОУ кредитора"
vpstate="Статус виконавчого провадження">
<changes voteid="Номер виконавчого провадження"
inn="ЄДРПОУ"
votedate="Дата відкриття виконавчого провадження"
votesudname="Найменування виконавця"
vdate="Дата появи запису"
credname="Найменування кредитора"
credokpo="Код ЄГРПОУ кредитора"
vpstate="Статус виконавчого провадження" />
<!--Даний блок повинен складатись з 0 .. * елементів-->
</susd>
</comp>
<!-- Блок реєстр запитів -->
<comp id="4" descr="Назва компоненти">
<credres redate="Дата рішення"
retime="Час рішення"
inn="ЄДРПОУ"
reqid="Ідентифікатор запиту в бюро"
result="Результат надання звіту (Код із дов.19)"
resultref="Результат надання звіту (Значення із дов.19)"
reqreason="Причина запиту в бюро (Код із дов.24)"
reqreasonref="Причина запиту в бюро (Значення із дов.24)"
org="Організація ініціатор (Значення із дов.54)" />
<!--Даний блок повинен складатись з 1 .. * елементів -->
<reestrtime hr="Кількість запитів за годину"
da="Кількість запитів за день"
wk="Кількість запитів за тиждень"
mn="Кількість запитів за місяць"
qw="Кількість запитів за квартал"
ye="Кількість запитів за рік"
yu="Кількість запитів понад рік" />
<!--Даний блок повинен складатись з 1 .. * елементів-->
</comp>
<!-- Блок моніторинг --><comp id="6" descr="Название компоненты">
<moncredres org="Організація ініціатор (Значення із дов.54)"
resultref="Значення з довідника результат надання звіту (Значення із дов.19)"
result="Результат моніторингу (Код із дов.19)"
monid="Ідентифікатор моніторингу в Бюро"
inn="ЄДРПОУ"
startdate="Дата старту моніторингу"
enddate="Дата останнього моніторингу " />
<!--Даний блок може складатися з 0 .. *-->
</comp>
<!-- Блок СтатусКонтрагента -->
<comp id="13" descr="Назва компоненти">
<stcont sinn="ЄДРПОУ"
sname="Найменування юрособи"
sdate="Дата реєстрації юрособи"
snds="Статус платника ПДВ (0-Ні/1-Так)"
sndsdate="Дата актуалізації"
sipn="Індивідуальний податковий номер"
saddr="Адреса"
dreg="Дата реєстрації платником ПДВ"
contacts="Контакти">
<state val="Поточний статус (Код із дов.41)"
valref="Значення поточний статус (Значення із дов.41)"
setdate="Дата актуалізації"
src="Джерело інформації (Код із дов.42)"
srcref="Значення джерело інформації (Значениння із дов.42)" />
</stcont>
</comp>
<!-- Попередження від СКІ --><comp id="18" descr="Назва компоненти">
<pret nonewdeal="Ознака небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE: 0 - не включена, 1 - включена"
nonewdealref="Значення ознаки небажання оформлювати нові кредитні продукти, статус підключення опції FREEZE - 0-ні (не підключена опція), 1-так (підключена опція)"
inn="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)">
<pretension inn="РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)"
crdeal="Ідентифікатор угоди (референс)"
source="Вид оскарження (Код із дов.48)"
sourceref="Вид оскарження (Значення із дов.48)"
vdate="Дата створення заявки" />
<commentcki comment="Коментар суб'єкта кредитної історії"
vdate="Дата створення коментаря" />
<plost pser="Серія паспорта, заявлено СКІ як загублений (крадіжка)"
pnom="Номер паспорта, заявлено СКІ як загублений (крадіжка)"
crdate="Дата створення заявки на втрату/крадіжку паспорта СКІ в УБКІ"
ldate="Зазначена в заявці дата втрати/крадіжки паспорта СКІ в УБКІ" />
<changedeal crdeal="Ідентифікатор угоди (референс)"
changecode="Код причини коригування/видалення даних (Код із дов.62)"
changeref="Текст причини коригування/видалення даних (Значення із дов.62)"
vdate="Дата коригування/видалення даних" />
</pret>
</comp>
<!-- Блок інформації з списку санкцій РНБО-->
<comp id="40" descr="Інформація із списку санкцій РНБО">
<rnbo found="Знайдений? (Код із дов.27)"
foundref="Знайдений? (Значение із дов.27)"
subname="Найменування суб'єкта"
bdate="Дата народження суб'єкта"
info="Інформація із суб'єкта"
sanctions="Накладені санкції"
sanctionsterm="Термін дії санкцій"
edictdate="Дата указу президента"
enddate="Дата закінчення обмеження"
url="Посилання на документ-підтвердження"
typesearch="Тип пошуку (0 - пошук по ЄДРПОУ, -1 - Суб'єкт не підпадає під санкції РНБО)"
typesearchtext="Текстове тлумачення типу пошуку (0 - пошук по ЄДРПОУ, -1 - Суб'єкт не підпадає під санкції РНБО)" /> -- 1..* записів
</comp>
<!-- Блок інформації з відкритого реєстру національних громадських діячів України-->
<comp id="41" descr="Інформація з відкритого реєстру національних громадських діячів України">
<pep found="Знайдений? (Код із дов.27)"
foundref="Знайдений? (Значение із дов.27)"
subname="Найменування суб'єкта"
bdate="Дата народження суб'єкта"
category="Категорія публічного діяча"
lastpost="Остання посада"
dateofrelease="Дата звільнення з останньої посади"
isur="Ознака юр.особи"
state="Статус юр.особи"
url="Посилання на документ-підтвердження"
typesearch="Тип пошуку (0 - пошук по ЄДРПОУ, -1 - нічого не знайдено)"
typesearchtext="0 - Знайдено по ЄДРПОУ, -1 - Суб'єкт не належить до публічних осіб" /> -- 1..* записів
</comp>
<!-- Інформація про банкрутство--><comp id="54" descr="Інформація про банкрутство">
<bankruptcyinfo found="0/1 - чисельне визначення факту наявності інформації про банкрутство"
foundref=" Не знайдено/ знайдено - текстове визначення факту наявності інформації про банкрутство">
<bankruptcy subname="Найменування суб'єкта"
subcode="ІПН/ЄДРПОУ"
eventtype="Подія"
eventclaimer="Ініціатор події"
eventcourtcase="Номер справи"
eventdate="Дата події" />
</bankruptcyinfo>
</comp>
</ubkidata>
Приклад
Request
|
Request XML
|
Response XML
|
Example |
---|
Request JSON |
|
Response JSON |
|
Request XML |
|
Response XML |
|
Response
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
XSD Schema request | https://secure.ubki.ua/b2/js/xsd/request15.xsd |
---|---|
XSD Schema response | https://secure.ubki.ua/b2/js/xsd/response15.xsd |
Test URL | https://test.ubki.ua/b2_api_xml/ubki/xml |
---|---|
Test data |
<comp id="18" descr=" |
Alert"> tag <changedeal>
<comp id="40" descr=" |
Information from sanctions lists">, <comp id="54"descr=" |
Bankruptcy information">
<comp id="41" descr=" |
Information from the Public Register of Politically Exposed Persons of Ukraine">
|