Description and definition.
...
You must put valid XML into parameter. This XML has 1 type of structure.
Warning | ||
---|---|---|
| ||
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 data, practically making the request useless. |
Type 1 : request for private person
...
Element name | Data type | Mandatory | Notice |
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 name | Datatype | Mandatory | Notice |
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 name | Data type | Mandatory | Notice |
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 number | Error description | Notice |
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. |
...