36 - Taxpayer registration information
Service for obtaining information on the registration of an entity with tax authorities as a taxpayer or as a single tax payer.
The report contains the following components:
Http Method | POST |
---|---|
Request URL | https://secure.ubki.ua/b2_api_xml/ubki/xml |
Request XML |
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": { "taxagent": { "okpo": "Taxpayer Identification Number (TIN) /USREOU", "found": "Availability of taxpayer registration information, numeric value: -2/-1/0/1", "foundref": "Availability of taxpayer registration information, text value (code from ref.58)", "source": "Name of the data source, text value", "response": "Taxpayer registration information in JSON format" }, "id": "48", "descr": "Taxpayer registration information" } } } |
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> <!-- Taxpayer registration information --> <comp id="48" descr="Taxpayer registration information"> <taxagent okpo="Taxpayer Identification Number (TIN) /USREOU" found="Availability of taxpayer registration information, numeric value: -2/-1/0/1" foundref="Availability of taxpayer registration information, text value (code from ref.58)" source="Name of the data source, text value" response="Taxpayer registration information in JSON format"/> </comp> </ubkidata> |
Example |
---|
Request JSON | {
"doc": {
"ubki": {
"req_envelope": {
"req_xml": {
"request": {
"i": {
"ident": {
"okpo": "9876543211"
},
"additionaldata": {
"source": "fiskregistration"
},
"reqlng": "4"
},
"version": "1.0",
"reqtype": "36",
"reqreason": "2"
},
"descr": "Request object"
},
"descr": "Request envelope"
},
"sessid": "4EC8D647B0DB4D9A862CDC25AB00000F"
}
}
} |
Response JSON | {
"ubkidata": {
"tech": {
"trace": {
"step": [
{
"name": "build report",
"stm": "2025-01-24 13:45:50.011",
"ftm": "2025-01-24 13:45:50.168"
}
]
},
"error": [],
"reqinfo": {
"reqid": "req2#000003432928"
}
},
"comp": [
{
"id": "48",
"descr": "Taxpayer registration information",
"taxagent": {
"found": "1",
"foundref": "Found information",
"okpo": "3233312110",
"source": "bpartner",
"response": "[{\"registry_id\":\"b-partner\",\"registry_name\":\"Дізнайся більше про свого бізнес-партнера\",\"updated_datetime\":null,\"short_info\":\"Дані відсутні - зараз не оновлюються\",\"short_info_color\":\"gray\",\"message\":\"Дані відсутні - зараз не оновлюються\",\"data\":null}]"
}
}
]
}
} |
Request XML | <doc>
<ubki sessid="C1D901B26FFF4277B443FC432791A4B9">
<req_envelope descr="Request object">
<req_xml descr="Request envelope">
<request version="1.0" reqtype="36" reqreason="2" >
<i reqlng="1">
<ident okpo="9876543211" />
<additionaldata source="fiskregistration" />
</i>
</request>
</req_xml>
</req_envelope>
</ubki>
</doc> |
Response XML |
XSD Schema request | |
---|---|
XSD Schema response | https://secure.ubki.ua/b2/js/xsd/response36.xsd |
Test URL | |
---|---|
Test data |
|