Versions Compared

Old Version 15

changes.mady.by.user Оксана Нечепоренко

Saved on

compared with

New Version 16

changes.mady.by.user Оксана Нечепоренко

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 JSON
( **the parameters are transferred optionally if there is a credit history for this client from your organization)

Expand
title body:

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"ident": {

"okpo": "Tax/Taxpayer Identification Number (INN-RNUKPN, for individuals)/EDRPOU (for legal entities)",

"lname": "**Last name",

"fname": "**First name",

"mname": "**Middle name",

"bdate": "**Date of birth"

},

"contacts": {

"cont": {

"ctype": "**Contact type (code from ref.10)",

"cval": "**Contact value"

}

},

"docs": {

"doc": {

"dtype": "**Document type (code from ref.7)",

"dser": "**Document series",

"dnom": "**Document number"

}

},

"reqlng": "Search criteria language (code from ref.23)"

},

"version": "1.0",

"reqtype": "Template code (code from ref.49): 'Contacts' report – 04",

"reqreason": "Request objective (code from ref.24)"

},

"descr": "Request object"

},

"descr": "Request envelope"

},

"sessid": "Session key (obtained from the authorization API)"

}

}

}

...

Response JSON

Code Block
{
	"ubkidata": {
		"tech": {
			"trace": {
				"step": {
					"name": "build report",
					"stm": "2022-11-23 14:08:56.087",
					"ftm": "2022-08-23 14:08:56.316"
				}
			},
			"reqinfo": {
				"reqid": "req2#000002458408"
			}
		},
		"comp": [
			{
				"cki": {
					"ident": {
						"cchild": "",
						"sstateref": "",
						"sstate": "",
						"spdref": "natural person",
						"spd": "1",
						"cgragref": "",
						"cgrag": "802",
						"ceducref": "",
						"ceduc": "",
						"familyref": "",
						"family": "",
						"csexref": "woman",
						"csex": "2",
						"bdate": "1957-10-19",
						"mname": "ІГОРЕВНА",
						"fname": "АННА",
						"lname": "РИБАЧКА",
						"inn": "2111118724",
						"lngref": "Russian",
						"lng": "2",
						"vdate": "2022-02-06",
						"donor": "BNK"
					},
					"work": {
						"wdohod": "",
						"wstag": "",
						"wname": "ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ 'УКРАЇНСЬКА КОМПАНІЯ 'О'",
						"wokpo": "34745377",
						"cdolgnref": "Worker/specialist/performer",
						"cdolgn": "3",
						"lngref": "Ukrainian",
						"lng": "1",
						"vdate": "2021-11-07",
						"wdonor": "BNK"
					},
					"doc": {
						"dwdt": "2004-03-10",
						"dwho": "ХЕРСОНСКИМ ГО УМВД",
						"dterm": "",
						"dnom": "142228",
						"dser": "ВВ",
						"dtyperef": "Ukrainian citizen passport",
						"dtype": "1",
						"lngref": "Ukrainian",
						"lng": "1",
						"vdate": "2021-08-01",
						"eddr_number": "19571019-00027",
						"ddonor": "BNK"
					},
					"addr": {
						"adflat": "81",
						"adcorp": "",
						"adhome": "11",
						"adstreet": "ВУЛ.ЕЖЕЛЕ",
						"adcitytyperef": "",
						"adcitytype": "",
						"adcity": "М.ХЕРСОН",
						"adarea": "",
						"adstate": "ХЕРСОНСЬКА",
						"adindex": "10000",
						"adcountry": "UA",
						"adtyperef": "Address of registration",
						"adtype": "2",
						"lngref": "Ukrainian",
						"lng": "1",
						"vdate": "1900-01-01",
						"addonor": "BNK"
					},
					"bdate": "1957-10-19",
					"reqlngref": "Russian",
					"reqlng": "2",
					"mname": "ІГОРЕВНА",
					"fname": "АННА",
					"lname": "РИБАЧКА",
					"inn": "2111118724"
				},
				"identdocmvds": {
					"identdocmvd": {
						"foundsource": [
							{
								"name": "MVS",
								"found": "0",
								"foundref": "Not found",
								"sourcedate": "2022-10-16"
							},
							{
								"name": "DMS",
								"found": "0",
								"foundref": "Not found",
								"sourcedate": "2022-10-16"
							},
							{
								"name": "UBKI",
								"found": "0",
								"foundref": "Not found",
								"sourcedate": "2022-10-16"
							}
						],
						"found": "0",
						"foundref": "Not found",
						"foundtitle": "Ukrainian citizen passportPassport ВВ-142228 is not found in the list of invalid passports",
						"pser": "ВВ",
						"pnom": "142228",
						"dtype": "1",
						"dtyperef": "Ukrainian citizen passport"
					}
				},
				"id": "1",
				"descr": "Identification of the Credit History Subject (CHS)"
			},
			{
				"cont": [
					{
						"cval": "+380931656411",
						"ctyperef": "home phone",
						"ctype": "1",
						"vdate": "2022-02-13",
						"cdonor": "BNK"
					},
					{
						"cval": "+380662134234",
						"ctyperef": "mobile phone",
						"ctype": "3",
						"vdate": "2021-11-08",
						"cdonor": "BNK"
					},
					{
						"cval": "+380992254422",
						"ctyperef": "mobile phone",
						"ctype": "3",
						"vdate": "2021-08-14",
						"cdonor": "BNK"
					}
				],
				"id": "10",
				"descr": "Contacts"
			},
			{
				"contact": [
					{
						"cval": "+380662134234",
						"ctype": "3",
						"ctyperef": "mobile phone",
						"cstate": "2",
						"cstateref": "Deactualization",
						"vdatestart": "2020-08-03",
						"vdate": "2020-10-08"
					},
					{
						"cval": "+380661111111",
						"ctype": "3",
						"ctyperef": "mobile phone",
						"cstate": "1",
						"cstateref": "Actualization",
						"vdatestart": "2020-05-12",
						"vdate": "2020-09-30"
					}
				],
				"id": "46",
				"descr": "Сontacts confirmation of the subject of the credit history"
			}
		]
	}
}

...

Response XML

Code Block
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
  <tech>
    <trace>
      <step name="build report" stm="2022-11-23 14:08:56.087" ftm="2022-08-23 14:08:56.316" />
    </trace>
    <reqinfo reqid="req2#000002458408" />
  </tech>
  <comp id="1" descr="Identification of the Credit History Subject (CHS)">
    <cki bdate="1957-10-19" reqlngref="Russian" reqlng="2" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" inn="2111118724">
      <ident cchild="" sstateref="" sstate="" spdref="natural person" spd="1" cgragref="" cgrag="802" ceducref="" ceduc="" familyref="" family="" csexref="woman" csex="2" bdate="1957-10-19" mname="ІГОРЕВНА" fname="АННА" lname="РИБАЧКА" inn="2111118724" lngref="Russian" lng="2" vdate="2022-02-06" donor="BNK" />
      <work wdohod="" wstag="" wname="ТОВАРИСТВО З ОБМЕЖЕНОЮ ВІДПОВІДАЛЬНІСТЮ 'УКРАЇНСЬКА КОМПАНІЯ 'О'" wokpo="34745377" cdolgnref="Worker/specialist/performer" cdolgn="3" lngref="Ukrainian" lng="1" vdate="2021-11-07" wdonor="BNK" />
      <doc dwdt="2004-03-10" dwho="ХЕРСОНСКИМ ГО УМВД" dterm="" dnom="142228" dser="ВВ" dtyperef="Ukrainian citizen passport" dtype="1" lngref="Ukrainian" lng="1" vdate="2021-08-01" eddr_number="19571019-00027" ddonor="BNK" />
      <addr adflat="81" adcorp="" adhome="11" adstreet="ВУЛ.ЕЖЕЛЕ" adcitytyperef="" adcitytype="" adcity="М.ХЕРСОН" adarea="" adstate="ХЕРСОНСЬКА" adindex="10000" adcountry="UA" adtyperef="Address of registration" adtype="2" lngref="Ukrainian" lng="1" vdate="1900-01-01" addonor="BNK" />
    </cki>
    <identdocmvds>
      <identdocmvd found="0" foundref="Not found" foundtitle="Ukrainian citizen passportPassport ВВ-142228 is not found in the list of invalid passports" pser="ВВ" pnom="142228" dtype="1" dtyperef="Ukrainian citizen passport">
        <foundsource name="MVS" found="0" foundref="Not found" sourcedate="2022-10-16" />
        <foundsource name="DMS" found="0" foundref="Not found" sourcedate="2022-10-16" />
        <foundsource name="UBKI" found="0" foundref="Not found" sourcedate="2022-10-16" />
      </identdocmvd>
    </identdocmvds>
  </comp>
  <comp id="10" descr="Contacts">
    <cont cval="+380931656411" ctyperef="home phone" ctype="1" vdate="2022-02-13" cdonor="BNK" />
    <cont cval="+380662134234" ctyperef="mobile phone" ctype="3" vdate="2021-11-08" cdonor="BNK" />
    <cont cval="+380992254422" ctyperef="mobile phone" ctype="3" vdate="2021-08-14" cdonor="BNK" />
  </comp>
  <comp id="46" descr="Сontacts confirmation of the subject of the credit history">
    <contact cval="+380662134234" ctype="3" ctyperef="mobile phone" cstate="2" cstateref="Deactualization" vdatestart="2020-08-03" vdate="2020-10-08" />
    <contact cval="+380661111111" ctype="3" ctyperef="mobile phone" cstate="1" cstateref="Actualization" vdatestart="2020-05-12" vdate="2020-09-30" />
  </comp>
</ubkidata>

...