Description and definition.
...
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. |
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 | ||
---|---|---|
|
...
| |
<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</ |
...
Example for invalid birth number:
...
title | Example for invalid birth number |
---|
...
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 | ||
---|---|---|
| ||
<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 Slovenska konsolidacni and Union risk subject:subject without credit risk data
Code Block | ||
---|---|---|
| ||
<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>-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>1</status> <fullReportUrl>http//...</ fullReportUrl> <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> </report> <number>8</number> <city>Praha</city> <zip>10100</zip> </address> </requestSubject> <report > <status>3</status> <fullReportUrl>http//...</ fullReportUrl> </creditCheck> |
Example for invalid birth number:
Code Block | ||
---|---|---|
| ||
<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> <ic>701689523</ic><address> <skKons> <street>Krátká</street> <skKonsRecord> <number>8</number> <id>17b1cc27-d159-4a7d-8672-0429e7f252c5</id><city>Praha</city> <zip>10100</zip> <dluhCelkem>300219</dluhCelkem> <mena>EUR<</mena>address> </requestSubject> <report > <evidovanoOd>2010-02-11 10:07:40.613</evidovanoOd> <status>3</status> <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> <fullReportUrl>http//...</ fullReportUrl> <birthNumber>7710109333</birthNumber> <firstName>Jan</firstName> <surname>Novák</surname> <invalidBirthNumber>INVALID</invalidBirthNumber> <ic>701689523</ic> <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>1977</birthYear> <privateFullAddress> <privateFullAddress>DlouháKrátká 158, BRNO<PRAHA</ privateFullAddress > </skUnionRecord> </report> </creditCheck> |
Example for OV drazby a exekuce risk subject:
...
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. |
...