Versions Compared

Version Old Version 1 New Version 2
Changes made by

Оксана Нечепоренко

Оксана Нечепоренко

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Http Method

POST

Request URL

https://secure.ubki.ua/b2_api_xml/ubki/xml

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

Expand
title body:

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"ident": {

"okpo": "РНОКПП (ІПН) (для фіз.осіб)/ЄДРПОУ (для юр.осіб)",

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

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

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

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

},

"additionaldata": {

"source": "**Найменування реєстру для перевірки (fiskregistration - реєстр платників податків, edpod - реєстр платників єдиного податку, bpartner - перевірка податкового боргу"

},

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

},

"version": "1.0",

"reqtype": "Код шаблону (Код із дов.49): 'Інформація про реєстрацію платника податків' - 36",

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

},

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

},

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

},

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

}

}

}

...

Request JSON

Code Block
{
	"doc": {
		"ubki": {
			"req_envelope": {
				"req_xml": {
					"request": {
						"i": {
							"ident": {
								"bdateokpo": "1957-10-19"9876543211"
							},
								"mnameadditionaldata": "ІГОРЕВНА",{
								"fnamesource": "АННАfiskregistration",
								"lname": "РИБАЧКА"},
								"okporeqlng": "21111187242"
							},
							"livenessversion": {
		"1.0",
						"imgdata0reqtype": "Фото в base6436",
								"imgdata1reqreason": "Фото в base642",
					},
					"imgdata2descr": "ФотоОб`єкт в base64запиту",
				},
				"imgdata3descr": "ФотоКонверт в base64запиту",
			},
					"imgdata4sessid": "Фото в base644EC8D647B0DB4D9A862CDC25AB00000F"
							},
							"reqlng": "2"
						},
						"version": "1.0",
						"reqtype": "35",
						"reqreason": "2"
					},
					"descr": "Об`єкт запиту"
				},
				"descr": "Конверт запиту"
			},
			"sessid": "4EC8D647B0DB4D9A862CDC25AB00000F"
		}
	}
}

Response JSON

Code Block{ "ubkidata": { "tech": { "trace": { "step": { 
}
	}
}

Response JSON

Code Block
{
    "ubkidata": {
        "tech": {
            "trace": {
                "step": [
                    {
                        "name": "build report",
					
                        "stm": "20222025-01-1024 1011:4814:5620.276673",
					                        "ftm": "20222025-01-1024 1011:4814:5620.288981"
 				} 			}, 			"reqinfo": { 				"reqid": "req2#000002012398" 			} 		}, 		"comp": { 			"liveness": { 				"inn": "2111118724", 				"lname": "РИБАЧКА",
				"fname": "АННА",
				"mname": "ІГОРЕВНА",
				"bdate": "1957-10-19",
				"probabilityspoof": "0.3"
			},
			"id": "47",
			"descr": "Liveness detection"
		}
	}
}

Request XML

Code Block<?xml version="1.0" encoding="UTF-8"?> <doc> <ubki sessid="4EC8D647B0DB4D9A862CDC25AB00000F">
    }
                ]
<req_envelope
descr="Конверт
запиту"> <req_xml descr="Об`єкт запиту">
 },
<request
version=
"
1.0
error"
reqtype="35" reqreason="2">
: [],
<i
reqlng="2">
"reqinfo": {
<ident
bdate="1957-10-19"
mname="ІГОРЕВНА"
fname=
"
АННА
reqid":
lname=
"
РИБАЧКА
req2#000003432553"
okpo="2111118724"
/>
           }
<liveness
imgdata0="Фото
в
base64"
imgdata1="Фото
в
base64" imgdata2="Фото в base64" imgdata3="Фото в base64" imgdata4="Фото в base64" />
 },
        "comp": [
</i>
 {
</request>
</req_xml>
  "id": "48",
</req_envelope>
</ubki> </doc>

Response XML

Code Block<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ubkidata> <tech>
            "descr": "Інформація про реєстрацію платника податків",
<trace>
<step
name="build report" stm="2022-01-10 10:48:56.276" ftm="2022-01-10 10:48:56.288" />
"taxagent": {
</trace>
<reqinfo
reqid="req2#000002012398"
/>
</tech>
<comp
id=
"
47
found":
descr="Liveness detection">
"1",
<liveness
inn="2111118724"
lname="РИБАЧКА"
fname="АННА"
mname="ІГОРЕВНА"
bdate="1957-10-19"
probabilityspoof="0.3"
/>
</comp> </ubkidata>

XSD Schema request

https://secure.ubki.ua/b2/js/xsd/request35.xsd

XSD Schema response

https://secure.ubki.ua/b2/js/xsd/response35.xsd

Test URL

https://test.ubki.ua/b2_api_xml/ubki/xml

Test data

  • bdate="1991-03-30" mname="ПЕТРОВИЧ" fname="ВАДИМ" lname="НИКОЛАЕВ" okpo="3332643095"

  • bdate="1974-08-20" mname="БОГДАНОВИЧ" fname="БОГДАН" lname="БОГДАНОВ" okpo="2726020593"

  • bdate="1981-05-20" mname="ПЕТРОВНА" fname="МАРИЯ" lname="ИВАНЦОВА" okpo="2972566397"

  • bdate="1988-07-10" mname="ІВАНОВИЧ" fname="БОГДАН" lname="ПОШТАР" okpo="3233312116"

  • bdate="1991-04-06" mname="ВОЛОДИМИРОВИЧ" fname="ВОЛОДИМИР" lname="ТКАЧУК" okpo="3333312110"

  • bdate="1985-03-20" mname="НИКИФОРОВНА" fname="АННА" lname="ЯРЦЕВА" okpo="3112579786"

  • bdate="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" okpo="2111118724"

  • bdate="1989-10-05" mname="ВАСИЛІВНА" fname="ІРІНА" lname="ГАРНА" okpo="3278508288"

<comp id="72" descr="Пошук по ПІБ+ДР при результаті більше 1 особи">

bdate="1985-03-20" mname="НИКИФОРОВНА" fname="АННА" lname="ЯРЦЕВА
 "foundref": "Знайдена інформація",
                    "okpo": "9876543211",
                    "source": "fiskregistration",
                    "response": "[{\"registry_id\":\"registration\",\"registry_name\":\"Дані про взяття на облік платників податків\",\"updated_datetime\":\"2021-01-26 11:34:15.590\",\"message\":\"\",\"data\":{\"FULL_NAME\":\"ІВАНОВ ІВАН ІВАНОВИЧ\",\"TIN_S\":null,\"ADRESS\":null,\"D_REG_STI\":\"19.01.2006\",\"N_REG_STI\":\"95-Ц\",\"C_STI_MAIN_NAME\":\"1229, ГОЛОВНЕ УПРАВЛІННЯ ДПС У ЛУГАНСЬКІЙ ОБЛАСТІ, СТАНИЧНО-ЛУГАНСЬКЕ УПРАВЛІННЯ, СТАНИЧНО-ЛУГАНСЬКА ДПІ(СТАНИЧНО-ЛУГАНСЬКИЙ РАЙОН)\",\"VED_LIC\":null,\"D_ZAKR_STI\":null}}]"
                }
            }
        ]
    }
}

Request XML

Code Block
<doc>
   <ubki sessid="C1D901B26FFF4277B443FC432791A4B9">
      <req_envelope descr="Конверт запиту">
         <req_xml descr="Об’єкт запиту">
            <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

Code Block
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
    <tech>
        <trace>
            <step name="build report" stm="2025-01-24 11:12:51.95" ftm="2025-01-24 11:12:52.384"/>
        </trace>
        <reqinfo reqid="req2#000003432549"/>
    </tech>
    <comp id="48" descr="Інформація про реєстрацію платника податків">
        <taxagent found="1" foundref="Знайдена інформація" okpo="9876543211" source="fiskregistration" response="[{&quot;registry_id&quot;:&quot;registration&quot;,&quot;registry_name&quot;:&quot;Дані про взяття на облік платників податків&quot;,&quot;updated_datetime&quot;:&quot;2021-01-26 11:34:15.590&quot;,&quot;message&quot;:&quot;&quot;,&quot;data&quot;:{&quot;FULL_NAME&quot;:&quot;ІВАНОВ ІВАН ІВАНОВИЧ&quot;,&quot;TIN_S&quot;:null,&quot;ADRESS&quot;:null,&quot;D_REG_STI&quot;:&quot;19.01.2006&quot;,&quot;N_REG_STI&quot;:&quot;95-Ц&quot;,&quot;C_STI_MAIN_NAME&quot;:&quot;1229, ГОЛОВНЕ УПРАВЛІННЯ ДПС У ЛУГАНСЬКІЙ ОБЛАСТІ, СТАНИЧНО-ЛУГАНСЬКЕ УПРАВЛІННЯ, СТАНИЧНО-ЛУГАНСЬКА ДПІ(СТАНИЧНО-ЛУГАНСЬКИЙ РАЙОН)&quot;,&quot;VED_LIC&quot;:null,&quot;D_ZAKR_STI&quot;:null}}]"/>
    </comp>
</ubkidata>

XSD Schema request

https://secure.ubki.ua/b2/js/xsd/request36.xsd

XSD Schema response

https://secure.ubki.ua/b2/js/xsd/response36.xsd

Test URL

https://test.ubki.ua/b2_api_xml/ubki/xml

Test data

  • okpo=”2726020593” source="fiskregistration/edpod/bpartner"

  • okpo=”9876543211” source="fiskregistration/edpod/bpartner"

  • okpo=”3233312110” source="fiskregistration/edpod/bpartner"

  • okpo=”1231231231” source="fiskregistration/edpod/bpartner"

  • okpo=”33359334” source="bpartner"