Versions Compared

Old Version 6

changes.mady.by.user Former user

Saved on

compared with

New Version 7

changes.mady.by.user Former user

Saved on

Key

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

Description and definition.

...

Warning
titleParameters - precision

It is NOT recommended to use inadequately specified input parameters. It is bad practice to use strings with the length of only few character like ("A", "Ho", "Abe") for parameters name and surname. In most cases it leads to a prolonged search of records in database, sometimes even exceeding the limited time each request has reserved for it's fullfilment. Therefore basically invoking timeout sometime during the search. The resulting response in such a case, WON'T contain all the possible data that meet the conditions, practically making the request useless. To avoid this mishap, try to always specify your input parameters to the most detailed level.

  • Use full names, instead of initials or monograms
  • If possible, use city AND street
  • If not, use at least city (when you fail to specify city in your request, there is a big chance you will receive records concerning several different people)

 

Type 1 :  request for private person

...

 

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.

 

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.

 

...