22 - Entrepreneur Dossier
A body of documented information about an individual entrepreneur from state registers, other public databases, and open sources.
Http Method | POST |
---|---|
Request URL | https://secure.ubki.ua/b2_api_xml/ubki/xml |
Request JSON |
Response JSON{ "ubkidata": { "tech": { "trace": { "step": { "name": "Step name", "stm": "Step start stamp date", "ftm": "Step finish stamp date" } }, "error": { "errtype": "Error code (code from ref.0)", "errtext": "Error text (value from ref.0)" }, "reqinfo": { "reqid": "Outgoing request ID generated by UBKI" }, "billing": { "balance": { "value": "Total assets", "date": "Date", "time": "Time" }, "billdetails": { "freemon": "Sign of free of charge according to the request type 'Monitoring the client of the organization' (reqreason=1), code (0 - No, 1 - Yes)", "freemonref": "Sign of free of charge according to the request type ‘Monitoring the client of the organization’ (reqreason=1), value (0 - No, 1 - Yes)" } } }, "comp": [ { "entrepreneurdossier": { "record": { "bankruptcy": { "date": "Date of recording bankruptcy proceedings registration", "state": "Status of a subject", "statetext": "Textual display of status", "docdate": "Proceedings opening date", "courtname": "Name of court", "docnumber": "Proceedings number", "datejudge": "Effective date" }, "openenforcements": { "openenforcement": { "date": "Enforcement proceedings opening date" } }, "terminationcancel": { "date": "Date of canceling the record of business termination", "recordnumber": "Record number", "docnumber": "Bankruptcy document number", "docdate": "Document date", "datejudge": "Effective date", "courname": "Name of court" }, "names": { "name": "Full name of an individual", "shortname": "Abbreviated name", "display": "Display name", "country":"Name of the country of citizenship" }, "registration": { "date": "Date of registration in EDR (Unified State Register)", "recordnumber": "Date of recording of registration in EDR (Unified State Register)", "recorddate": "Date of recording in EDR (Unified State Register)", "isseparation": "State registration of a legal entity by allotment", "isdivision": "State registration of a legal entity by separation", "ismerge": "State registration of a legal entity by way of merger", "istransformation": "State registration of a legal entity by reorganization", "objectname": "Storage location of a registration file", "pervregistrationendterm": "Duration of registration of an individual entrepreneur in the Ministry of Revenue, in case of change of place of residence" }, "registrations": { "name": "Registration office name", "code": "EDRPOU of a registration office", "type": "Registration office type", "description": "Information about the departmental registry", "startdate": "Date of registration", "startnum": "Registration number", "enddate": "Date of de-registration", "endnum": "De-registration number" }, "primaryactivitykind": { "name": "Name of principal activity type", "code": "Code of principal activity type under the Classifier of economic activities", "regnumber": "Date of recording of principal activity type registration", "class": "Principal activity risk class" }, "activitykinds": { "name": "Name of activity type", "code": "Code of activity type under the Classifier of economic activities", "isprimary": "Indication of the principal activity type (1 – principal, 0 – non-principal)" }, "contacts": { "type": "Contact type (webpage, email, tel, fax)", "value": "Contact value" }, "address": { "zip": "Place of residence postal code", "country": "Country of residence", "address": "Full residential address" }, "termination": { "state": "Status code of the record of business termination (2 – pending termination, 3 – terminated)", "statetext": "Description of termination record status", "date": "Record date", "recordnumber": "De-registration number", "cause": "Grounds for its entering" }, "iscurrent": "0/1 (1 – relevant record of business activities, 0 – previous record of business activities)" }, "found": "Status in the Unified State Register (code from ref.27)", "inn": "Business entity TIN", "curstate": "Current status of a subject in EDR (code from ref.64)", "curstatetxt": "Additional comment on current status of a subject (value from ref.64)", "currecorddate": "Current registration date" }, "id": "24", "descr": "Names of components" }, { "lawyerinfo": { "registration": { "numsv": "Number of the certificate of the right to practice law", "datesv": "Certificate issue date", "issuedsv": "Issuing authority", "numdec": "Number of the decision on issuing a certificate", "datedec": "Date of decision", "stopinfo": "Information on the termination of the right to advocate" }, "found": "Availability of information (Code from ref.27)", "foundref": "Availability of information, decoding", "typesearch": "Search type (Code from ref.67)", "typesearchtext": "Search type, decoding", "lname": "Subject's last name", "fname": "Subject's first name", "mname": "Subject's patronymic", "vdate": "Version date (date of update of information for this subject)" }, "notaryinfo": { "found": "Availability of information (Code from ref.27)", "foundref": "Availability of information, decoding", "typesearch": "Search type (Code from ref.67)", "typesearchtext": "Search type, decoding", "lname": "Subject's last name", "fname": "Subject's first name", "mname": "Subject's patronymic", "vdate": "Version date (date of update of information for this subject)", "numsv": "Number of the certificate on the right to engage in notarial activity", "registeredin": "Place of registration", "nameoffice": "Name of the registered institution" }, "id": "27", "descr": "Information from the register of lawyers and notaries" }, { "bankruptcyinfo": { "bankruptcy": { "subname": "Subject’s name", "subcode": "TIN/EDRPOU", "eventtype": "Event type", "eventclaimer": "Initiator of the event", "eventcourtcase": "Case number", "eventdate": "Date of event" }, "found": "Availability of information about bankruptcy, numerical designation 0-1", "foundref": " Availability of information about bankruptcy, textual meaning 0-not found / 1-found" }, "id": "54", "descr": "Bankruptcy information" }, { "pdvPayer": { "okpo": "TIN", "found": "0/1 - numerical determination of the fact of VAT registration", "foundref": "Textual definition of the fact of VAT registration", "codePDV": "Individual tax number", "dateRegistry": "Date of registration by the taxpayer", "dateCancel": "Date of cancellation of registration", "reasonCancel": "Legal grounds for cancellation", "lawReason": "Reason for cancellation", "pubRegister": "Registry name", "vdate": "Date of update in the database" }, "id": "66", "descr": "Information from the register of VAT payers" } ] } } |
Request XML |
Response XML<?xml version="1.0" encoding="utf-8"?> <ubkidata> <!-- System information part --> <tech> <trace> <step name="Step name" stm="Step start stamp date" ftm="Step finish stamp date"> <!-- The trace part contains timing metrics of components generation steps --> </step> </trace> <error errtype="Error code (code from ref.0)" errtext="Error text (value from ref.0)"> </error> <reqinfo reqid="Outgoing request ID generated by UBKI"> </reqinfo> <!-- Information about the current status of the prepaid account part--> <billing> <balance value="Total assets" date="Date" time="Time" /> <billdetails freemon="Sign of free of charge according to the request type ‘Monitoring the client of the organization’ (reqreason=1), code (0 - No, 1 - Yes)" freemonref="Sign of free of charge according to the request type 'Monitoring the client of the organization' (reqreason=1), value (0 - No, 1 - Yes)"/> </billing> </tech> <!-- Search for an entrepreneur’s records from state registers --> <comp id="24" descr="Names of components"> <entrepreneurdossier found="Status in the Unified State Register (code from ref.27)" inn="Business entity TIN" curstate="Current status of a subject in EDR (code from ref.64)" curstatetxt="Additional comment on current status of a subject (value from ref.64)" currecorddate="Current registration date"> <record iscurrent="0/1 (1 – relevant record of business activities, 0 – previous record of business activities)"> <bankruptcy date="Date of recording bankruptcy proceedings registration" state="Status of a subject" statetext="Textual display of status" docdate="Proceedings opening date" courtname="Name of court" docnumber="Proceedings number" datejudge="Effective date" /> <openenforcements> <openenforcement date="Enforcement proceedings opening date" /> </openenforcements> <terminationcancel date="Date of canceling the record of business termination" recordnumber="Record number" docnumber="Bankruptcy document number" docdate="Document date" datejudge="Effective date" courname="Name of court" /> <names name="Full name of an individual" shortname="Abbreviated name" display="Display name" country="Назва країни громадянства"/> <registration date="Date of registration in EDR (Unified State Register)" recordnumber="Date of recording of registration in EDR (Unified State Register)" recorddate="Date of recording in EDR (Unified State Register)" isseparation="State registration of a legal entity by allotment" isdivision="State registration of a legal entity by separation" ismerge="State registration of a legal entity by way of merger" istransformation="State registration of a legal entity by reorganization" objectname="Storage location of a registration file" pervregistrationendterm="Duration of registration of an individual entrepreneur in the Ministry of Revenue, in case of change of place of residence" /> <registrations name="Registration office name" code="EDRPOU of a registration office" type="Registration office type" description="Information about the departmental registry" startdate="Date of registration" startnum="Registration number" enddate="Date of de-registration" endnum="De-registration number" /> <primaryactivitykind name="Name of principal activity type" code="Code of principal activity type under the Classifier of economic activities" regnumber="Date of recording of principal activity type registration" class="Principal activity risk class" /> <activitykinds name="Name of activity type" code="Code of activity type under the Classifier of economic activities" isprimary="Indication of the principal activity type (1 – principal, 0 – non-principal)" /> <contacts type="Contact type (webpage, email, tel, fax)" value="Contact value" /> <address zip="Place of residence postal code" country="Country of residence" address="Full residential address" /> <termination state="Status code of the record of business termination (2 – pending termination, 3 – terminated)" statetext="Description of termination record status" date="Record date" recordnumber="De-registration number" cause="Grounds for its entering" /> </record> </entrepreneurdossier> </comp> <!-- Information from the register of lawyers and notaries --> <comp id="27" descr="Information from the register of lawyers and notaries"> <lawyerinfo found="Availability of information (Code from ref.27)" foundref="Availability of information, decoding" typesearch="Search type (Code from ref.67)" typesearchtext="Search type, decoding " lname="Subject's last name" fname="Subject's first name" mname="Subject's patronymic" vdate="Version date (date of update of information for this subject)"> <registration numsv="Number of the certificate of the right to practice law" datesv="Certificate issue date" issuedsv="Issuing authority" numdec="Number of the decision on issuing a certificate" datedec="Date of decision" stopinfo="Information on the termination of the right to advocate"/> </lawyerinfo> <notaryinfo found="Availability of information (Code from ref.27)" foundref="Availability of information, decoding" typesearch="Search type (Code from ref.67)" typesearchtext="Search type, decoding " lname="Subject's last name" fname="Subject's first name" mname="Subject's patronymic" vdate="Version date (date of update of information for this subject)" numsv="Number of the certificate on the right to engage in notarial activity" registeredin="Place of registration" nameoffice="Name of the registered institution"/> </comp> <!-- Bankruptcy information--> <comp id="54" descr="Bankruptcy information"> <bankruptcyinfo found="Availability of information about bankruptcy, numerical designation 0-1" foundref=" Availability of information about bankruptcy, textual meaning 0-not found / 1-found"> <bankruptcy subname="Subject’s name" subcode="TIN/EDRPOU" eventtype="Event type" eventclaimer="Initiator of the event" eventcourtcase="Case number" eventdate="Date of event" /> </bankruptcyinfo> </comp> <!-- Information from the register of VAT payers --> <comp id="66" descr="Information from the register of VAT payers"> <pdvPayer okpo="TIN" found="0/1 - numerical determination of the fact of VAT registration" foundref="Textual definition of the fact of VAT registration" codePDV="Individual tax number" dateRegistry="Date of registration by the taxpayer" dateCancel="Date of cancellation of registration" reasonCancel="Legal grounds for cancellation" lawReason="Reason for cancellation" pubRegister="Registry name" vdate="Date of update in the database" /> </comp> </ubkidata> |
Example |
---|
Request JSON | {
"doc": {
"ubki": {
"req_envelope": {
"req_xml": {
"request": {
"i": {
"ident": {
"okpo": "3389956584"
},
"reqlng": "4"
},
"version": "1.0",
"reqtype": "22",
"reqreason": "2"
}
}
},
"sessid": "F936E3872D7740D7910BB32C933318B3"
}
}
} |
Response JSON | {
"ubkidata": {
"tech": {
"trace": {
"step": {
"name": "build report",
"stm": "2024-12-05 11:18:07.412",
"ftm": "2024-12-05 11:18:07.488"
}
},
"reqinfo": {
"reqid": "req2#000003355552"
}
},
"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"
},
{
"name": "Консультування з питань інформатизації",
"code": "62.02",
"isprimary": "0"
},
{
"name": "Інша діяльність у сфері інформаційних технологій і компютерних систем",
"code": "62.09",
"isprimary": "0"
},
{
"name": "Оброблення даних, розміщення інформації на веб-вузлах і повязана з ними діяльність",
"code": "63.11",
"isprimary": "1"
},
{
"name": "Консультування з питань комерційної діяльності й керування",
"code": "70.22",
"isprimary": "0"
},
{
"name": "Дослідження конюнктури ринку та виявлення громадської думки",
"code": "73.20",
"isprimary": "0"
}
],
"contacts": [
{
"type": "email",
"value": ""
},
{
"type": "fax",
"value": ""
},
{
"type": "webpage",
"value": ""
},
{
"type": "tel",
"value": "+380500000000"
}
],
"address": {
"zip": "83111",
"country": "УКРАЇНА",
"address": "Києвська обл., місто ПИРЯТИН, Ворошиловський район БУЛЬВАР ПУШКІНА"
},
"termination": {
"state": "3",
"statetext": "припинено",
"date": "2018-01-25",
"recordnumber": "2266232346004040627",
"cause": "Припинення ФОП за її рішенням"
},
"terminationcancel": "",
"openenforcements": "",
"state": "",
"statetxt": ""
}
],
"found": "1",
"inn": "3389956584",
"curstate": "3",
"curstatetxt": "припинено",
"currecorddate": "2008-01-09"
},
"id": "24",
"descr": "Information about entrepreneur from the public registries"
},
{
"lawyerinfo": {
"found": "0",
"foundref": "Інформація відсутня",
"typesearch": "-1",
"typesearchtext": "",
"lname": "",
"fname": "",
"mname": "",
"vdate": "2024-12-01"
},
"notaryinfo": {
"found": "0",
"foundref": "Інформація відсутня",
"typesearch": "-1",
"typesearchtext": "",
"lname": "",
"fname": "",
"mname": "",
"vdate": "",
"numsv": "",
"registeredin": "",
"nameoffice": ""
},
"id": "27",
"descr": "Information from the Lawyers Registry"
},
{
"bankruptcyinfo": {
"found": "0",
"foundref": "Bankruptcy information unknown"
},
"id": "54",
"descr": "Bankruptcy information"
},
{
"pdvPayer": {
"okpo": "3389956584",
"found": "1",
"foundref": "Found information",
"codePDV": "2829454394",
"dateRegistry": "1998-11-09",
"dateCancel": "2009-01-15",
"reasonCancel": "Анульовано за iнiцiативою платника",
"lawReason": "Пп.184.1 ст.184 Кодексу",
"pubRegister": "Реєстр платників ПДВ",
"vdate": "2022-03-22"
},
"id": "66",
"descr": "Information from the register of VAT payers"
}
]
}
} |
Request XML | <?xml version="1.0" encoding="UTF-8"?>
<doc>
<ubki sessid="F936E3872D7740D7910BB32C933318B3">
<req_envelope>
<req_xml>
<request version="1.0" reqtype="22" reqreason="2">
<i reqlng="4">
<ident okpo="3389956584" />
</i>
</request>
</req_xml>
</req_envelope>
</ubki>
</doc> |
Response XML |
XSD Schema request | |
---|---|
XSD Schema response | https://secure.ubki.ua/b2/js/xsd/response22.xsd |
Test URL | |
---|---|
Test data |
<comp id="27" descr="Information from the register of lawyers and notaries"> okpo="2661152187" okpo="1993081882" <comp id="66" descr="Information from the register of VAT payers"> okpo="3389956584" |