Versions Compared

Key

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

Description and definition.

...

 

Element nameData typeMandatoryNotice

subjectType

string

yes

privatePerson

birthNumber

string

yes

 

firstName

string

yes

 

surname

string

yes

 

address

  

Root element for data of address.

street

string

yes

 

number

string

yes

 

city

string

yes

 

zip

string

yes

 

 

Response from webmethod - data description:

...

 

Element nameDatatypeMandatoryNotice

webMethod

string

yes

Name of web service method

time

datetime

yes

Time of data generation on our server

requestSubject

 

yes

Root element with input data.

subjectType

string

yes

privatePerson

birthNumber

string

yes

Unique identifier of a person. Ussualy it consists of 2 parts, the first part are numbers taken from the date of birth, whereas the second part is a random number.

e.g. 760816/1245 (where the date of birth is 16.08.1976 and random number 1245)

firstName

string

yes

 

surname

string

yes

 

address

  

Root element for data of address.

street

string

yes

 

number

string

yes

 

city

string

yes

 

zip

string

yes

 

report

  

Root element for data with risk info.

status

int

no

CreditCheck status.  This value will display when subject is same as privateBussines subject inside our database. It is same as ic element.

fullReportUrl

string

yes

Url to CreditCheck FullReport as timelink.

birthNumber

string

yes

 

firstName

string

yes

 

surname

string

yes

 

invalidBirthNumber

String

No

Result of the Birth number validation. This value will display when validation not right.

Value in element is INVALID . Warning, invalid birth number can exist !

address

  

Root element for data of address.

street

string

yes

 

number

string

yes

 

city

string

yes

 

zip

string

yes

 

ic

string

no

This value will display when subject is same as privateBussines subject inside our database.

skKons

  

Root element for the Slovenska konsolidacni risk data. When subject has not SkKons risk data then element will not exist.

Element contains a set of matching records.

skKonsRecord

  

Envelope element for one record.

id

guid

yes

Record id from our database.

dluhCelkem

number

yes

Total debt

mena

string

yes

Currency

evidovanoOd

datetime

yes

Evidence from. (In our database.)

evidovanoDo

datetime

no

Evidence to. (In our database.) If don’t exists then record is current.

privateFullName

string

yes

Debtor’s full name from a record.

birthNumber

date

no

Debtor’s birth number.

ic

string

no

Bussines identification number.

privateFullAddress

string

yes

Debtor’s full address from a rekord.

skUnion

 

no

Root element for the SK Union risk data. When subject has not SK Union risk data then element will not exist. Element contains a set of matching records.

skUnionRecord

  

Envelope element for one record.

id

guid

yes

Record id from our database.

dluhCelkem

number

yes

Total debt

evidovanoOd

datetime

yes

Evidence from. (In our database.)

evidovanoDo

datetime

no

Evidence to. (In our database.) If don’t exists then record is current.

privateFullName

string

yes

Debtor’s full name from a record.

birthYear

int

yes

Debtor’s date of birth.

privateFullAddress

string

yes

Debtor’s full address from a rekord.

skVzpRecord

  

Envelope element for one record.

id

guid

yes

Record id from our database.

dluhCelkem

number

yes

Total debt

evidovanoOd

datetime

yes

Evidence from. (In our database.)

evidovanoDo

datetime

no

Evidence to. (In our database.) If don’t exists then record is current.

privateFullName

string

yes

Debtor’s full name from a record.

birthYear

int

yes

Debtor’s date of birth.

privateFullAddress

string

yes

Debtor’s full address from a rekord.

skFinRed

  

Root element for the Financne riaditelstvo risk data. When subject has not risk data then element will not exist.

Element contains a set of matching records.

skFinRedRecord

  

Envelope element for one record.

id

guid

yes

Record id from our database.

dluhCelkem

number

yes

Total debt

evidovanoOd

datetime

yes

Evidence from. (In our database.)

evidovanoDo

datetime

no

Evidence to. (In our database.) If don’t exists then record is current.

privateFullName

string

yes

Debtor’s full name from a record.

privateFullAddress

string

yes

Debtor’s full address from a rekord.

rokDluhu

int

yes

Year of debt.

skSocPoj

  

Root element for the Socialna poistovna risk data. When subject has not risk data then element will not exist.

Element contains a set of matching records.

skSocPojRecord

  

Envelope element for one record.

id

int

yes

Record id from our database.

dluhCelkem

number

yes

Total debt

mena

string

yes

Currency

evidovanoOd

datetime

yes

Evidence from. (In our database.)

evidovanoDo

datetime

no

Evidence to. (In our database.) If don’t exists then record is current.

privateFullName

string

yes

Debtor’s full name from a record.

privateFullAddress

string

yes

Debtor’s full address from a rekord.

skOvKonkurz

  

Root element for the Obchodny vestnik - konkurz risk data. When subject has not risk data then element will not exist.

Element contains a set of matching records.

skOvKonkurzRecord

  

Envelope element for one record.

id

guid

yes

Record id from our database.

evidovanoOd

datetime

yes

Evidence from. (In our database.)

evidovanoDo

datetime

no

Evidence to. (In our database.) If don’t exists then record is current.

privateFullName

string

yes

Debtor’s full name from a record.

birthYear

int

yes

Debtor’s date of birth.

privateFullAddress

string

yes

Debtor’s full address from a rekord.

skOvDrazbyExekuce

  

Root element for the Obchodny vestnik – drazby exekuce risk data. When subject has not risk data then element will not exist.

Element contains a set of matching records.

SkOvDrazbyExekuceRecord

  

Envelope element for one record.

id

guid

yes

Record id from our database.

nazev

string

yes

Name and some additional data asbirth date or id number, etc.

vidanieOv

string

yes

Number of Obchodni vestnik.

cisloKonania

string

no

Number of event.

datumKonania

string

no

Event date.

datumVyhlasenia

string

no

Date of publication.

znaleckaHodnota

string

no

Valuation.

realnaHodnota

string

no

Fair value.

 

 

Exemplary responses

  • Slovenska konsolidacna - debtors
  • Union ZP - debtors
  • Financne riaditelstvo - debtors
  • Socialna poistovna - debtors
  • VZP ZP - debtors
  • Konkurzy a likvidace – bankruptcy
  • Obchodny vestnik dražby a exekuce – bankruptcy
  • Birth number validity
  • Stolen ID cards

  • Municipality check
  •  

     

     

    Example for Slovenska konsolidacni risk subject:

    Code Block
    titleExample for Slovenska konsolidacni risk subject
    <creditCheck version="1.0" encoding="utf-8" >
     <webMethod>GetSubjectBasicReport</webMethod>
     <country>SK</country>
     <time>21.10.2012 8:43:36</time>
     <requestSubject>
       <subjectType>privatePerson</subjectType>
       <birthNumber>7710109856</birthNumber>
       <firstName>Jan</firstName>
       <surname>Novák</surname>
       <address>
         <street>Krátká</street>
         <number>8</number>
         <city>Praha</city>
         <zip>10100</zip>
       </address>
     </requestSubject>
     <report >
       <status>3</status>
       <fullReportUrl>http//...</ fullReportUrl> 
       <birthNumber>7710109856</birthNumber>
       <firstName>Jan</firstName>
       <surname>Novák</surname>
       <ic>701689523</ic>
       <skKons>
         <skKonsRecord>
           <id>17b1cc27-d159-4a7d-8672-0429e7f252c5</id>
           <dluhCelkem>300219</dluhCelkem>
    <mena>EUR</mena>
           <evidovanoOd>2010-02-11 10:07:40.613</evidovanoOd>
           <evidovanoDo>2010-09-11 11:07:40.613</evidovanoDo>
    <privateFullName>Jan Novák</privateFullName>
    <birthNumber>7710109856</birthNumber>
    <privateFullAddress>Krátká 8/65, Praha, 10101</ privateFullAddress >
         </skKonsRecord>
         <skKonsRecord>
           <id>16b1cc27-d159-4a7d-8672-0429e7f252c5</id>
           <dluhCelkem>150</dluhCelkem>
    <mena>EUR</mena>
           <evidovanoOd>2010-02-10 10:07:40.613</evidovanoOd>
           <evidovanoDo>2010-09-11 11:07:40.613</evidovanoDo>
    <dluhCelkem>300219</dluhCelkem>
    <privateFullName>Jan Josef Novák</privateFullName>
    <ic>12345678</ic>
    <privateFullAddress>Krátká 8/65, Praha, 10101</ privateFullAddress >
         </skKonsRecord>
       </skKons>
     </report>
    </creditCheck>



    Example for Slovenska konsolidacni and Union risk subject:

    Code Block
    titleExample for Slovenska konsolidacni and Union risk subject
    <creditCheck version="1.0" encoding="utf-8" >
     <webMethod>GetSubjectBasicReport</webMethod>
     <country>SK</country>
     <time>21.10.2012 8:43:36</time>
     <requestSubject>
       <subjectType>privatePerson</subjectType>
       <birthNumber>7710109856</birthNumber>
       <firstName>Jan</firstName>
       <surname>Novák</surname>
       <address>
         <street>Krátká</street>
         <number>8</number>
         <city>Praha</city>
         <zip>10100</zip>
       </address>
     </requestSubject>
     <report >
       <status>3</status>
       <fullReportUrl>http//...</ fullReportUrl> 
       <birthNumber>7710109856</birthNumber>
       <firstName>Jan</firstName>
       <surname>Novák</surname>
       <ic>701689523</ic>
       <skKons>
         <skKonsRecord>
           <id>17b1cc27-d159-4a7d-8672-0429e7f252c5</id>
           <dluhCelkem>300219</dluhCelkem>
    <mena>EUR</mena>
           <evidovanoOd>2010-02-11 10:07:40.613</evidovanoOd>
           <evidovanoDo>2010-09-11 11:07:40.613</evidovanoDo>
    <privateFullName>Jan Novák</privateFullName>
    <birthNumber>7710109856</birthNumber>
    <privateFullAddress>Krátká 8/65, Praha, 10101</ privateFullAddress >
         </skKonsRecord>      
       <skUnionRecord>
           <id>434e3bb4-5485-4f4a-a29c-001dae1f0c24</id>
           <dluhCelkem>12589</dluhCelkem>
           <evidovanoOd>2010-02-10 10:07:40.613</evidovanoOd>
           <evidovanoDo>2010-09-11 11:07:40.613</evidovanoDo>
    <dluhCelkem>300219</dluhCelkem>
    <privateFullName>Jan Novák</privateFullName>
    <birthYear>1984</birthYear>
    <privateFullAddress>Dlouhá 15, BRNO</ privateFullAddress >
         </skUnionRecord>
     </report>
    </creditCheck>

     

     

     

     

     

     

    Example for subject without credit risk data

    ...

     

    Element nameData typeMandatoryNotice

    errorId

    GUID as string

    yes

    Id for matching our error db inside

    message

    string

    yes

    Short information about error.

    Description

    string

    no

    Description.

     

    List of error messages

     

    Error numberError descriptionNotice

    01

    unknown subject type

    Unknown subjekt type inside the

    <requestSubject>

     <subjectType>privatePersonnn</subjectType>

    element

    02

    invalid input

    Input request is not valid.

    05

    invalid birth date

    When system can’t parsed a birth date for a specific date format.

    06

    error generating section

    This error is displayed in sections when current section has problem with data generating.

     

    ...