22 - Досьє підприємця


Сукупність документованої інформації про фізичну особу-підприємця з державних реєстрів, інших баз даних публічного користування та джерел, відкритих для загального користування.


Http Method

POST

Request JSON
( ** параметри передаються опціонально)

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"ident": {

"okpo": "РНОКПП (ІПН) фізособи",

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

"fname": "**Ім'я",

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

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

},

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

},

"version": "1.0",

"reqtype": "Код шаблону (Код із дов.49): Звіт 'Досьє підприємця' - 22",

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

},

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

},

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

},

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

}

}

}

Response JSON

{

"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": [

{

"entrepreneurdossier": {

"record": {

"bankruptcy": {

"date": "Дата запису про реєстрацію провадження банкрутства",

"state": "Статус суб'єкта",

"statetext": "Текстове відображення статусу",

"docdate": "Дата відкриття провадження",

"courtname": "Найменування суду",

"docnumber": "Номер виробництва",

"datejudge": "Дата набуття чинності"

},

"openenforcements": {

"openenforcement": {

"date": "Дата відкриття виконавчого провадження"

}

},

"terminationcancel": {

"date": "Дата скасування запису про припинення діяльності",

"recordnumber": "Номер запису",

"docnumber": "Номер документа про банкрутство",

"docdate": "Дата документа",

"datejudge": "Дата набуття чинності",

"courname": "Найменування суду"

},

"names": {

"name": "Прізвище, ім'я, по батькові фізичної особи",

"shortname": "Скорочена назва",

"display": "Коротке найменування",

"country":"Назва країни громадянства"

},

"registration": {

"date": "Дата реєстрації в ЄДР",

"recordnumber": "Номер запису про реєстрацію в ЄДР",

"recorddate": "Дата запису в ЄДР",

"isseparation": "Державна реєстрація юридичної особи шляхом виділення",

"isdivision": "Державна реєстрація юридичної особи шляхом поділу",

"ismerge": "Державна реєстрація юридичної особи шляхом злиття",

"istransformation": "Державна реєстрація юридичної особи шляхом перетворення",

"objectname": "Місце зберігання реєстраційної справи",

"pervregistrationendterm": "Термін, до якого ФОП на обліку в Міндоходів, при зміні місця проживання"

},

"registrations": {

"name": "Найменування органу реєстрації",

"code": "ЄДРПОУ органу реєстрації",

"type": "Тип органу реєстрації",

"description": "Відомості про відомчий реєстр",

"startdate": "Дата постановки на облік",

"startnum": "Номер постановки на облік",

"enddate": "Дата зняття з обліку",

"endnum": "Номер зняття з обліку"

},

"primaryactivitykind": {

"name": "Найменування виду основної діяльності",

"code": "Код виду основної діяльності за КВЕД",

"regnumber": "Номер запису про реєстрацію виду основної діяльності"

},

"activitykinds": {

"name": "Найменування виду діяльності",

"code": "Код виду діяльності за КВЕД",

"isprimary": "Ознака основного виду діяльності (1 - основний, 0 - не основний)"

},

"contacts": {

"type": "Типу контакту (webpage, email, tel, fax)",

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

},

"address": {

"zip": "Поштовий індекс місця проживання",

"country": "Країна проживання",

"address": "Повна адреса місця проживання"

},

"termination": {

"state": "Код статусу запису про припинення діяльності (2 - в стані припинення, 3 - припинено)",

"statetext": "Опис статусу запису про припинення",

"date": "Дата запису",

"recordnumber": "Номер зняття з обліку",

"cause": "Підстави для його внесення"

},

"iscurrent": "0/1 (1 - актуальний запис про підприємницьку діяльність, 0 - попередній запис про підприємницьку діяльність)"

},

"found": "Статус знаходження в Єдиному державному реєстрі (Код з дов.27)",

"inn": "РНОКПП (ІПН) суб'єкта підприємницької діяльності",

"curstate": "Поточний статус суб'єкта в ЄДР (Код з дов.64)",

"curstatetxt": "Додатковий коментар поточного статусу суб'єкта (Значення з дов.64)",

"currecorddate": "Дата поточної реєстрації"

},

"id": "24",

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

},

{

"lawyerinfo": {

"registration": {

"numsv": "Номер свідоцтва про право на зайняття адвокатською діяльністю",

"datesv": "Дата видачі свідоцтва",

"issuedsv": "Орган видачі",

"numdec": "Номер рішення про видачу свідоцтва",

"datedec": "Дата рішення",

"stopinfo": "Інформація про припинення права на адвокатську діяльність"

},

"found": "Наявність інформації (Код із дов.27)",

"foundref": "Наявність інформації, розшифровка",

"typesearch": "Тип пошуку (Код із дов.67)",

"typesearchtext": "Текстове тлумачення типу пошуку (Код із дов.67)",

"lname": "Прізвище суб’єкта",

"fname": "Ім’я суб’єкта",

"mname": "По батькові суб’єкта",

"vdate": "Дата версії (дата актуалізації інформації за даним суб’єктом)"

},

"notaryinfo": {

"found": "Наявність інформації (Код із дов.27)",

"foundref": "Наявність інформації, розшифровка",

"typesearch": "Тип пошуку (Код із дов.67)",

"typesearchtext": "Текстове тлумачення типу пошуку (Код із дов.67)",

"lname": "Прізвище суб’єкта",

"fname": "Ім’я суб’єкта",

"mname": "По батькові суб’єкта",

"vdate": "Дата версії (дата актуалізації інформації за даним суб’єктом)",

"numsv": "Номер свідоцтва про право на зайняття нотаріальною діяльністю",

"registeredin": "Місце реєстрації",

"nameoffice": "Назва зареєстрованої установи"

},

"id": "27",

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

},

{

"bankruptcyinfo": {

"bankruptcy": {

"subname": "Найменування суб'єкта",

"subcode": "ІПН/ЄДРПОУ",

"eventtype": "Подія",

"eventclaimer": "Ініціатор події",

"eventcourtcase": "Номер справи",

"eventdate": "Дата події"

},

"found": "0/1 - чисельне визначення факту наявності інформації про банкрутство",

"foundref": " Не знайдено/ знайдено - текстове визначення факту наявності інформації про банкрутство"

},

"id": "54",

"descr": "Інформація про банкрутство"

},

{

"pdvPayer": {

"okpo": "ЄДРПОУ",

"found": "0/1 - чисельне визначення факту наявності реєстрації ПДВ",

"foundref": "Текстове визначення факту наявності реєстрації ПДВ",

"codePDV": "Індивідуальний податковий номер",

"dateRegistry": "Дата реєстрації платником податку",

"dateCancel": "Дата анулювання реєстрації",

"reasonCancel": "Підстава анулювання",

"lawReason": "Причина анулювання",

"pubRegister": "Назва реєстру",

"vdate": "Дата оновлення в базі"

},

"id": "66",

"descr": "Інформація з реєстру платників ПДВ"

}

]

}

Request XML
( ** параметри передаються опціонально)

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

<doc>

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

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

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

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

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

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

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

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

<ident okpo="РНОКПП (ІПН) фізособи"

lname="**Прізвище"

fname="**Ім'я"

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

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

</i>

</request>

</req_xml>

</req_envelope>

</ubki>

</doc>

Response XML

<?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="Час" />

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

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

</billing>

</tech>

<!-- Пошук відомостей з державних реєстрів про підприємця -->

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

<entrepreneurdossier found="Статус знаходження в Єдиному державному реєстрі (Код з дов.27)"

inn="РНОКПП (ІПН) суб'єкта підприємницької діяльності"

curstate="Поточний статус суб'єкта в ЄДР (Код з дов.64)"

curstatetxt="Додатковий коментар поточного статусу суб'єкта (Значення з дов.64)"

currecorddate="Дата поточної реєстрації">

<record iscurrent="0/1 (1 - актуальний запис про підприємницьку діяльність, 0 - попередній запис про підприємницьку діяльність)">

<bankruptcy date="Дата запису про реєстрацію провадження банкрутства"

state="Статус суб'єкта"

statetext="Текстове відображення статусу"

docdate="Дата відкриття провадження"

courtname="Найменування суду"

docnumber="Номер виробництва"

datejudge="Дата набуття чинності" />

<openenforcements>

<openenforcement date="Дата відкриття виконавчого провадження" />

</openenforcements>

<terminationcancel date="Дата скасування запису про припинення діяльності"

recordnumber="Номер запису"

docnumber="Номер документа про банкрутство"

docdate="Дата документа"

datejudge="Дата набуття чинності"

courname="Найменування суду" />

<names name="Прізвище, ім'я, по батькові фізичної особи"

shortname="Скорочена назва"

display="Коротке найменування"

country="Назва країни громадянства"/>

<registration date="Дата реєстрації в ЄДР"

recordnumber="Номер запису про реєстрацію в ЄДР"

recorddate="Дата запису в ЄДР"

isseparation="Державна реєстрація юридичної особи шляхом виділення"

isdivision="Державна реєстрація юридичної особи шляхом поділу"

ismerge="Державна реєстрація юридичної особи шляхом злиття"

istransformation="Державна реєстрація юридичної особи шляхом перетворення"

objectname="Місце зберігання реєстраційної справи"

pervregistrationendterm="Термін, до якого ФОП на обліку в Міндоходів, при зміні місця проживання" />

<registrations name="Найменування органу реєстрації"

code="ЄДРПОУ органу реєстрації"

type="Тип органу реєстрації"

description="Відомості про відомчий реєстр"

startdate="Дата постановки на облік"

startnum="Номер постановки на облік"

enddate="Дата зняття з обліку"

endnum="Номер зняття з обліку" />

<primaryactivitykind name="Найменування виду основної діяльності"

code="Код виду основної діяльності за КВЕД"

regnumber="Номер запису про реєстрацію виду основної діяльності" />

<activitykinds name="Найменування виду діяльності"

code="Код виду діяльності за КВЕД"

isprimary="Ознака основного виду діяльності (1 - основний, 0 - не основний)" />

<contacts type="Типу контакту (webpage, email, tel, fax)"

value="Значення контакту" />

<address zip="Поштовий індекс місця проживання"

country="Країна проживання"

address="Повна адреса місця проживання" />

<termination state="Код статусу запису про припинення діяльності (2 - в стані припинення, 3 - припинено)"

statetext="Опис статусу запису про припинення"

date="Дата запису"

recordnumber="Номер зняття з обліку" cause="Підстави для його внесення" />

</record>

</entrepreneurdossier>

</comp>

<!-- Інформація з реєстру адвокатів та нотаріусів -->

<comp id="27" descr="Інформація з реєстру адвокатів та нотаріусів">

<lawyerinfo found="Наявність інформації (Код із дов.27)"

foundref="Наявність інформації, розшифровка"

typesearch="Тип пошуку (Код із дов.67)"

typesearchtext="Текстове тлумачення типу пошуку (Код із дов.67) "

lname="Прізвище суб’єкта"

fname="Ім’я суб’єкта"

mname="По батькові суб’єкта"

vdate="Дата версії (дата актуалізації інформації за даним суб’єктом)">

<registration numsv="Номер свідоцтва про право на зайняття адвокатською діяльністю"

datesv="Дата видачі свідоцтва"

issuedsv="Орган видачі"

numdec="Номер рішення про видачу свідоцтва"

datedec="Дата рішення"

stopinfo="Інформація про припинення права на адвокатську діяльність"/>

</lawyerinfo>

<notaryinfo found="Наявність інформації (Код із дов.27)"

foundref="Наявність інформації, розшифровка"

typesearch="Тип пошуку (Код із дов.67)"

typesearchtext="Текстове тлумачення типу пошуку (Код із дов.67) "

lname="Прізвище суб’єкта"

fname="Ім’я суб’єкта"

mname="По батькові суб’єкта"

vdate="Дата версії (дата актуалізації інформації за даним суб’єктом)"

numsv="Номер свідоцтва про право на зайняття нотаріальною діяльністю"

registeredin="Місце реєстрації"

nameoffice="Назва зареєстрованої установи"/>

</comp>

<!-- Інформація про банкрутство-->

<comp id="54" descr="Інформація про банкрутство">

<bankruptcyinfo found="0/1 - чисельне визначення факту наявності інформації про банкрутство"

foundref=" Не знайдено/ знайдено - текстове визначення факту наявності інформації про банкрутство">

<bankruptcy subname="Найменування суб'єкта"

subcode="ІПН/ЄДРПОУ"

eventtype="Подія"

eventclaimer="Ініціатор події"

eventcourtcase="Номер справи"

eventdate="Дата події" />

</bankruptcyinfo>

</comp>

<!-- Інформація з реєстру платників ПДВ -->

<comp id="66" descr="Інформація з реєстру платників ПДВ">

<pdvPayer okpo="ЄДРПОУ"

found="0/1 - чисельне визначення факту наявності реєстрації ПДВ"

foundref="Текстове визначення факту наявності реєстрації ПДВ"

codePDV="Індивідуальний податковий номер"

dateRegistry="Дата реєстрації платником податку"

dateCancel="Дата анулювання реєстрації"

reasonCancel="Підстава анулювання"

lawReason="Причина анулювання"

pubRegister="Назва реєстру"

vdate="Дата оновлення в базі" />

</comp>

</ubkidata>

Приклад

Приклад

Request JSON

{ "doc": { "ubki": { "req_envelope": { "req_xml": { "request": { "i": { "ident": { "okpo": "2726020593" }, "reqlng": "1" }, "version": "1.0", "reqtype": "22", "reqreason": "2" }, "descr": "Об'єкт запиту" }, "descr": "Конверт запиту" }, "sessid": "7BD7E136E3BF470EAA2CFE20101010ED" } } }

Response JSON

{ "ubkidata": { "tech": { "trace": { "step": { "name": "build report", "stm": "2024-12-05 11:23:47.868", "ftm": "2024-12-05 11:23:47.943" } }, "reqinfo": { "reqid": "req2#000003355574" } }, "comp": [ { "entrepreneurdossier": { "record": [ { "names": { "name": "ВОДЯНОЙ СЕРГІЙ ФЕДОРОВИЧ", "shortname": "", "display": "ВОДЯНОЙ СЕРГІЙ ФЕДОРОВИЧ", "country": "Україна" }, "registration": { "date": "2004-12-27", "recordnumber": "22660002628", "recorddate": "2004-12-27", "isseparation": "0", "isdivision": "0", "ismerge": "0", "istransformation": "0", "objectname": "Ворошиловське районне управління юстиції у м. Донецьку", "prevregistrationendterm": "" }, "bankruptcy": "", "primaryactivitykind": { "name": "ОПТОВА ТОРГІВЛЯ ПРОДУКТАМИ ХАРЧУВАННЯ, НАПОЯМИ ТА ТЮТЮНОВИМИ ВИРОБАМИ", "code": "51.3", "regnumber": "", "class": "" }, "activitykinds": [ { "name": "ОПТОВА ТОРГІВЛЯ ПРОДУКТАМИ ХАРЧУВАННЯ, НАПОЯМИ ТА ТЮТЮНОВИМИ ВИРОБАМИ", "code": "51.3", "isprimary": "1" }, { "name": "ОПТОВА ТОРГІВЛЯ ІНШИМИ ПРОДУКТАМИ ХАРЧУВАННЯ", "code": "51.38", "isprimary": "0" }, { "name": "ІНШІ ВИДИ ОПТОВОЇ ТОРГІВЛІ", "code": "51.7", "isprimary": "0" }, { "name": "РОЗДРІБНА ТОРГІВЛЯ ПОЗА МАГАЗИНАМИ", "code": "52.6", "isprimary": "0" }, { "name": "РОЗДРІБНА ТОРГІВЛЯ ПОЗА МАГАЗИНАМИ, Н. В. І. Г.", "code": "52.63", "isprimary": "0" } ], "contacts": [ { "type": "email", "value": "" }, { "type": "fax", "value": "" }, { "type": "webpage", "value": "" }, { "type": "tel", "value": "8(062)348-17-79" } ], "address": { "zip": "83000", "country": "УКРАЇНА", "address": "БР.ПУШКІНА, М.ПИРЯТИН, ВОРОШИЛОВСЬКИЙ РАЙОН, Києвська ОБЛАСТЬ" }, "termination": { "state": "3", "statetext": "припинено", "date": "2007-03-22", "recordnumber": "22660062342342002628", "cause": "Припинення ФОП за її рішенням" }, "terminationcancel": "", "openenforcements": "", "state": "", "statetxt": "" }, { "names": { "name": "ВОДЯНОЙ СЕРГІЙ ФЕДОРОВИЧ", "shortname": "", "display": "ВОДЯНОЙ СЕРГІЙ ФЕДОРОВИЧ", "country": "" }, "registration": { "date": "2008-01-09", "recordnumber": "22600040627", "recorddate": "2008-01-09", "isseparation": "0", "isdivision": "0", "ismerge": "0", "istransformation": "0", "objectname": "Ворошиловське районне управління юстиції у м. Донецьку", "prevregistrationendterm": "" }, "bankruptcy": "", "registrations": [ { "name": "ГОЛОВНЕ УПРАВЛІННЯ РЕГІОНАЛЬНОЇ СТАТИСТИКИ", "code": "21680000", "type": "", "description": "", "startdate": "", "startnum": "", "enddate": "", "endnum": "" }, { "name": "МАРIУПОЛЬСЬКА ОБЄДНАНА ДЕРЖАВНА ПОДАТКОВА IНСПЕКЦIЯ ГОЛОВНОГО УПРАВЛIННЯ ДФС У ДОНЕЦЬКIЙ ОБЛАСТI (ПIВНIЧНЕ ВIДДIЛЕННЯ ВОРОШИЛОВСЬКИЙ РАЙОН М.ДОНЕЦЬК)", "code": "395553670", "type": "4002", "description": "дані про взяття на облік як платника податків", "startdate": "", "startnum": "", "enddate": "", "endnum": "" }, { "name": "МАРIУПОЛЬСЬКА ОБЄДНАНА ДЕРЖАВНА ПОДАТКОВА IНСПЕКЦIЯ ГОЛОВНОГО УПРАВЛIННЯ ДФС У ДОНЕЦЬКIЙ ОБЛАСТI (ПIВНIЧНЕ ВIДДIЛЕННЯ ВОРОШИЛОВСЬКИЙ РАЙОН М.ДОНЕЦЬК)", "code": "395553670", "type": "4001", "description": "дані про взяття на облік як платника єдиного внеску", "startdate": "", "startnum": "", "enddate": "", "endnum": "" } ], "primaryactivitykind": { "name": "Оброблення даних, розміщення інформації на веб-вузлах і повязана з ними діяльність", "code": "63.11", "regnumber": "05-15-11-99786", "class": "" }, "activitykinds": [ { "name": "Неспеціалізована оптова торгівля", "code": "46.90", "isprimary": "0" },