Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »


Assessment of the probability of default of an individual entrepreneur based on his credit history and data from open sources.


Request XML
( ** the parameters are transferred optionally if there is a credit history for this client from your organization)

  body:

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

<doc>

<ubki sessid="Session key (obtained from the authorization API)">

<req_envelope descr="Request envelope">

<req_xml descr="Request object">

<!-- Request parameters -->

<request version="1.0" reqtype="Template code (code from ref.49): 'Scoring of an individual entrepreneur ' - 44" reqreason="Request objective (code from ref.24)">

<!-- Parameters describing search criteria-->

<i reqlng="Search criteria language (code from ref.23)">

<!-- Subject identification parameters-->

<ident okpo="INN-RNUKPN (for natural persons)" lname="**surname" fname="**name" mname="**patronymic" bdate="**Date of Birth" orgname="**Name of organization">

</ident>

<contacts>

<cont ctype="Contact type (Code from the ref.10)" cval="The value of the contact" />

</contacts>

<docs>

<doc dtype="Type of document (Code from the ref.7)" dser="A series of documents" dnom="Document number" />

</docs>

<additionaldata datescore="Scoring date. Not filled in if the scoring is currently calculated" />

</i>

</request>

</req_xml>

</req_envelope>

</ubki>

</doc>

Response XML

 body:

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

<ubkidata>

<!-- System information block -->

<tech>

<trace>

<step name="Step name" stm="Date-stamp of the step start" ftm="Date-stamp of the step end">

<!-- The trace block contains the timing metrics of the components formation steps -->

</step>

</trace>

<error errtype="Error code (Code from ref.0)" errtext="Error text (Meaning from ref.0)">

</error>

<reqinfo reqid="The outgoing ID request, generated by the Ukrainian Bureau of the Credit History">

</reqinfo>

<!-- Block of information on the current state of the prepaid account-->

<billing>

<balance value="Balance amount" date="Date" time="Time" />

</billing>

</tech>

<!-- Identification block -->

<comp id="1" descr="Components name">

<cki inn="INN of the subject of credit history" lname="Surname/Name of the legal entity" fname="Name" mname="Father’s name" reqlng="Search language (during search) / Identification language (during transmission) (Code from ref.23)" reqlngref="Search language (during search) / Identification language (during transmission) (Meaning from ref.23)" bdate="Date of Birth">

<ident donor="A source of information (code from ref. 54)" vdate="Date of information of this block" lng="Block representation language (Code from ref.23)" lngref="Block representation language (Meaning of ref.23)" inn="INN SKI" lname="Surname" fname="Name" mname="Father’s name" bdate="Date of Birth" csex="Sex (Code from ref.1)" csexref="Sex (Meaning from ref.1)" family="Marital status (Code from ref.2)" familyref="Marital status (Meaning from ref.2)" ceduc="Education (Code from ref.3)" ceducref="Education (Meaning from ref.3)" cgrag="Citizenship (Code from ref.4)" cgragref="Citizenship (Meaning from ref.4)" spd="Availability of SPD registration (Code from ref.5)" spdref="Availability of SPD registration (meaning from ref.5)" sstate="Social status (Code from ref.6)" sstateref="Social status (Meaning from ref.6)" cchild="Number of children">

<!--This block can and has to consist of 1 .. * elements-->

</ident>

<!-- Block of the Information History about place of work -->

<work wdonor="A source of information (code from ref. 54)" vdate="Date of this block information" lng="Block representation language (Code from ref.23)" lngref="Block representation language (Meaning from ref.23)" cdolgn="Occupational status (Code from ref.8)" cdolgnref="Occupational status (Meaning from ref.8)" wokpo="EGRPOU of the place of work" wname="Name of the place of work in the basic language" wstag="Work experience, full years" wdohod="Monthly customer income">

<!--This block can consist of 0 .. * elements-->

</work>

<!-- Block of the Information History of the documents -->

<doc ddonor="A source of information (code from ref. 54)" vdate="Date of information of this block" lng="Block representation language (Code from ref.23)" lngref="Block representation language (Meaning from ref.23)" dtype="Document type (Code from ref.7)" dtyperef="Document type (Meaning from ref.7)" dser="Document series" dnom="Document Number" dterm="Validity term" dwho="Document is issued by" dwdt="Date of issue of the document">

<!--This block has to consist of 1 .. * elements and is filled with at least by one document-->

</doc>

<!-- Block of the Information History of addresses -->

<addr addonor="A source of information (code from ref. 54)" vdate="Date of information of this block" lng="Block representation language (Code from ref.23)" lngref="Block representation language (Meaning from ref.23)" adtype="Address type (Code from ref.9)" adtyperef="Address type (Meaning from ref.9)" adcountry="country" adindex="ZIP code" adstate="Region" adarea="District" adcity="Settlement" adcitytype="Settlement type (Code from ref.22)" adcitytyperef="Settlement type (Meaning from ref.22)" adstreet="Street" adhome="House" adcorp="Block" adflat="Apartment" addrdirt="Address in one line (in case if the address is not decomposed in the old data) as agreed with the Ukrainian Bureau of the Credit History">

<!--This block has to consist of 1 .. * elements and has to be filled, at least, with one address-->

</addr>

</cki>

<!-- Block for converting documents for validity -->

<identdocmvds>

<identdocmvd found="Found? (Code from ref.27)" foundref="Found? (Value from ref.27)" foundtitle="Search result description" pser="Series of the required passport" pnom="Number of required passport or ID-card number" dtype="Document type (Code from ref.7)" dtyperef="Document type (Meaning from ref.7)">

<foundsource name="Data source for verification (Code from ref. 63)" found="0/1 - digital indication of the presence of an invalid passport (Code from ref.27)" foundref="Text indication of the presence of an invalid passport (Value from ref.27)" />

<!--This part must contain 1..* units and at least one document -->

</identdocmvd>

</identdocmvds>

</comp>

<!-- Block – a register of requests -->

<comp id="4" descr="Components name">

<credres redate="Date of decision" retime="Time of decision" inn="INN" reqid="Request identifier in the Bureau" result="Report result (Code from ref.19)" resultref="Report result (Meaning from ref.19)" reqreason="Reason for the request in to the bureau (Code from ref.24)" reqreasonref="Reason for the request in to the bureau (Meaning from ref.24)" org="Initiating agency (code from ref. 54)">

<!--This block has to consist of 1 .. * elements -->

</credres>

<reestrtime hr="Number of requests per hour" da="Number of requests per day" wk="Number of requests per week" mn="Number of requests per month" qw="Number of requests per quarter" ye="Number of requests per year" yu="Number of requests per over a year">

<!--This block has to consist of the 1st element-->

</reestrtime>

</comp>

<!-- Block – Monitoring -->

<comp id="6" descr="Components name">

<moncredres org="Initiating organization (code from ref. 54)" resultref="Monitoring result (value from ref.19)" result="Monitoring result (Code from дов.19)" monid="Unique Monitoring Identifier" inn="TIN" startdate="Monitoring start date" enddate="Date of last monitoring " />

<!--This part can contain 0..* items -->

</comp>

<!-- Client alert -->

<comp id="18" descr="Components name">

<pret nonewdeal="Sign of reluctance to draw up new loan products, connection status of the FREEZE option: 0 - not enabled, 1 - enabled" nonewdealref="The value of the sign of unwillingness to draw up new credit products, the connection status of the FREEZE option is 0-no (the option is not connected), 1-yes (the option is connected)" inn="INN (for natural persons) / OKPO (for legal entities)">

<pretension inn="INN (for natural persons) / OKPO (for legal entities)" crdeal="Transaction identifier (reference)" source="Disputing type (Code from ref.48)" sourceref="Disputing type (Value from ref.48)" vdate="Date of the request creation" />

<commentcki comment="Commentary of the subject of credit history" vdate="Date of a comment creation" />

<plost pser="Passport series claimed by the client as lost (theft)" pnom="Passport number declared by the client as lost (theft)" crdate="Date of creation of an application for the loss / theft of a client's passport in UBCH" ldate="The date of loss / theft of the client's passport indicated in the application in UBCH" />

<changedeal crdeal="Transaction identifier (reference)" changecode="Code for the reason of correction/deletion of data (Code from ref.62)" changeref="Text of the reason for correcting/deleting data (Value from ref.62)" vdate="Date of data correction/deletion " />

</pret>

</comp>

<!-- Scoring of an individual entrepreneur -->

<comp id="67" descr="Scoring of an individual entrepreneur">

<scorefop score="Score" scoreproba="Score (probability)" scoredate="Date of score " />

</comp>

</ubkidata>

Example

Request

<?xml version="1.0" encoding="UTF-8"?>
<doc>
  <ubki sessid="EDF4309796114D6D9B8365370DA2DEE9">
    <req_envelope>
      <req_xml>
        <request version="1.0" reqtype="44" reqreason="2">
          <i reqlng="4">
            <ident bdate="1957-10-19" mname="Igorevna" fname="ANNA" lname="RYBACHKA" okpo="2111118724" />
            <docs>
              <doc dtype="1" dser="ВВ" dnom="142228" />
            </docs>
            <contacts>
              <cont cval="+380662134234" ctype="3" />
            </contacts>
            <additionaldata datescore="" />
          </i>
        </request>
      </req_xml>
    </req_envelope>
  </ubki>
</doc>

Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ubkidata>
    <tech>
        <trace>
            <step name="build report" stm="2022-08-29 14:21:53.703" ftm="2022-08-29 14:21:53.903"/>
        </trace>
        <reqinfo reqid="req2#000002461694"/>
    </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="Passport" dtype="1" lngref="Ukrainian" lng="1" vdate="2021-08-01" 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="Passport ВВ-142228 not found in the list of cancelled." pser="ВВ" pnom="142228" dtype="1" dtyperef="Passport">
                <foundsource name="MVS" found="0" foundref="Not found"/>
                <foundsource name="DMS" found="0" foundref="Not found"/>
                <foundsource name="UBKI" found="0" foundref="Not found"/>
            </identdocmvd>
        </identdocmvds>
    </comp>
    <comp id="4" descr="Inquiries registry">
        <credres org="OWN" reqreasonref="Credit request" reqreason="2" resultref="Report provided successfully" result="1" reqid="req2#000002461391" inn="2111118724" redate="2022-08-29" retime="10:42:50"/>
        <credres org="BNK" reqreasonref="Credit request" reqreason="2" resultref="Report provided successfully" result="1" reqid="req2#000002461298" inn="2111118724" redate="2022-08-29" retime="01:14:02"/>
        <credres org="BNK" reqreasonref="Credit request" reqreason="2" resultref="Report provided successfully" result="1" reqid="req2#000002461203" inn="2111118724" redate="2022-08-28" retime="01:14:03"/>
        <credres org="BNK" reqreasonref="Credit request" reqreason="2" resultref="Report provided successfully" result="1" reqid="req2#000002461164" inn="2111118724" redate="2022-08-27" retime="01:14:08"/>
        <reestrtime hr="0" da="2" wk="11" mn="31" qw="76" ye="379" yu="39"/>
    </comp>
    <comp id="6" descr="Monitoring (does not affect credit rating)">
        <moncredres org="BNK" resultref="Report provided successfully" result="1" monid="MFB50ED6A7683C1E8" inn="2111118724" startdate="2022-02-10" enddate="2022-08-26"/>
        <moncredres org="FIN" resultref="Report provided successfully" result="1" monid="ME926E3B7CAD27B78" inn="2111118724" startdate="2021-04-02" enddate="2021-04-19"/>
       </comp>
    <comp id="18" descr="Client alert">
        <pret inn="2111118724" nonewdeal="0" nonewdealref="No" nonewdealcomment=""/>
    </comp>
    <comp id="67" descr="Scoring of an individual entrepreneur">
        <scorefop score="" scoreproba="0.0169" scoredate="2022-08-29"/>
    </comp>
</ubkidata>

Test URL

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

Test data

  • okpo="2726020593" additionaldata="2022-07-21"

  • okpo="2726020593" additionaldata="2022-01-20"

  • No labels