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
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</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 Financne riaditelstvo - debtors
Code Block | ||
---|---|---|
| ||
<creditCheck version="1.0" encoding="utf-8" xmlns=""> <webMethod>GetSubjectBasicReport</webMethod> <country>SK</country> <time>13.2.2015 10:15:18</time> <requestSubject> <subjectType>privatePerson</subjectType> <birthNumber>7710109856</birthNumber> <firstName>Juraj</firstName> <surname>Mrázik</surname> <address> <street>Cabaj</street> <number>38</number> <city>Cabaj</city> <zip /> </address> </requestSubject> <report> <status>4</status> <birthNumber /> <firstName>Juraj</firstName> <surname>Mrázik</surname> <invalidBirthNumber>INVALID</invalidBirthNumber> <finRedFo> <skFinRedRecord> <id>535f42f1-59f8-49a6-80ba-b368cf457748</id> <dluhCelkem>192923.48</dluhCelkem> <evidovanoOd>2013-11-19T13:16:56.71</evidovanoOd> <evidovanoDo>14.10.2014 10:21:23</evidovanoDo> <privateFullName>Juraj Mrázik</privateFullName> <privateFullAddress>Cabaj 38, Cabaj - Čápor 95117</privateFullAddress> <rokDluhu>2011</rokDluhu> </skFinRedRecord> <skFinRedRecord> <id>2f2eb3e7-4dde-4f8a-8517-00e02723ec1f</id> <dluhCelkem>193403.72</dluhCelkem> <evidovanoOd>2011-01-01T00:00:00</evidovanoOd> <evidovanoDo>14.10.2014 10:21:23</evidovanoDo> <privateFullName>Juraj Mrázik</privateFullName> <privateFullAddress>Cabaj 38, Cabaj - Čápor</privateFullAddress> <rokDluhu>2010</rokDluhu> </skFinRedRecord> </finRedFo> <skEosKsi> <registered>NIE</registered> <total_cases>0</total_cases> <active_cases>0</active_cases> </skEosKsi> </report> </creditCheck> |
Code Block | ||
---|---|---|
| ||
<creditCheck version="1.0" encoding="utf-8" xmlns=""> <webMethod>GetSubjectBasicReport</webMethod> <country>SK</country> <time>13.2.2015 10:21:26</time> <requestSubject> <subjectType>privatePerson</subjectType> <birthNumber>7710109867</birthNumber> <firstName>Abašanov</firstName> <surname>Peter</surname> <address> <street>Niva</street> <number>17</number> <city>Medzibrod</city> <zip /> </address> </requestSubject> <report> <status>4</status> <birthNumber /> <firstName>Abašanov</firstName> <surname>Peter</surname> <invalidBirthNumber>INVALID</invalidBirthNumber> <skSocPoj> <socPojRecord> <id>-2137050778</id> <dluhCelkem>133.42</dluhCelkem> <mena>EUR</mena> <evidovanoOd>2015-02-04T00:00:00</evidovanoOd> <privateFullName>Abašanov Peter</privateFullName> <privateFullAddress>Niva 17, Medzibrod</privateFullAddress> </socPojRecord> <socPojRecord> <id>-2137778556</id> <dluhCelkem>538.11</dluhCelkem> <mena>EUR</mena> <evidovanoOd>2014-12-18T00:00:00</evidovanoOd> <privateFullName>Abašanov Peter</privateFullName> <privateFullAddress>Niva 17, Medzibrod</privateFullAddress> </socPojRecord> <socPojRecord> <id>1174711609</id> <dluhCelkem>404.69</dluhCelkem> <mena>EUR</mena> <evidovanoOd>2014-11-27T00:00:00</evidovanoOd> <privateFullName>Abašanov Peter</privateFullName> <privateFullAddress>Niva 17, Medzibrod</privateFullAddress> </socPojRecord> <socPojRecord> <id>2131411024</id> <dluhCelkem>271.27</dluhCelkem> <mena>EUR</mena> <evidovanoOd>2014-10-23T00:00:00</evidovanoOd> <privateFullName>Abašanov Peter</privateFullName> <privateFullAddress>Niva 17, Medzibrod</privateFullAddress> </socPojRecord> </skSocPoj> </report> </creditCheck> |
Example for VZP ZP - debtors
Code Block | ||
---|---|---|
| ||
<creditCheck version="1.0" encoding="utf-8" xmlns=""> <webMethod>GetSubjectBasicReport</webMethod> <country>SK</country> <time>13.2.2015 10:24:44</time> <requestSubject> <subjectType>privatePerson</subjectType> <birthNumber>7710109856</birthNumber> <firstName>INGRID</firstName> <surname>JAKABOVÁ</surname> <address> <street /> <number>20</number> <city>VAJKOVCE</city> <zip>04443</zip> </address> </requestSubject> <report> <status>4</status> <birthNumber /> <firstName>INGRID</firstName> <surname>JAKABOVÁ</surname> <invalidBirthNumber>INVALID</invalidBirthNumber> <skVzp> <skVzpRecord> <id>79ba7887-6644-4a26-8f72-2d12c52ca734</id> <dluhCelkem>149.91</dluhCelkem> <evidovanoOd>2014-10-20T00:00:00</evidovanoOd> <privateFullName>JAKABOVÁ INGRID</privateFullName> <privateFullAddress>č.d. 20, VAJKOVCE, 04443</privateFullAddress> </skVzpRecord> <skVzpRecord> <id>6cef8784-0ac1-4819-a241-996371e98393</id> <dluhCelkem>180.31</dluhCelkem> <evidovanoOd>2014-09-20T00:00:00</evidovanoOd> <privateFullName>JAKABOVÁ INGRID</privateFullName> <privateFullAddress>č.d. 20, VAJKOVCE, 04443</privateFullAddress> </skVzpRecord> <skVzpRecord> <id>9cf0f90d-efae-4e6c-81e5-6a53f66be7b4</id> <dluhCelkem>180.31</dluhCelkem> <evidovanoOd>2014-08-20T00:00:00</evidovanoOd> <privateFullName>JAKABOVÁ INGRID</privateFullName> <privateFullAddress>č.d. 20, VAJKOVCE, 04443</privateFullAddress> </skVzpRecord> <skVzpRecord> <id>203d18da-e643-42d1-ae41-b5eb57d55d4b</id> <dluhCelkem>187.91</dluhCelkem> <evidovanoOd>2014-07-21T00:00:00</evidovanoOd> <privateFullName>JAKABOVÁ INGRID</privateFullName> <privateFullAddress>č.d. 20, VAJKOVCE, 04443</privateFullAddress> </skVzpRecord> <skVzpRecord> <id>8c5da574-1aaa-4e81-8da7-724258933ffe</id> <dluhCelkem>203.11</dluhCelkem> <evidovanoOd>2014-06-20T00:00:00</evidovanoOd> <privateFullName>JAKABOVÁ INGRID</privateFullName> <privateFullAddress>č.d. 20, VAJKOVCE, 04443</privateFullAddress> </skVzpRecord> </skVzp> </report> </creditCheck> |
Example for OV drazby a exekuce risk subject:
Code Block | ||
---|---|---|
| ||
<creditCheck version="1.0" encoding="utf-8" xmlns=""> <webMethod>GetSubjectBasicReport</webMethod> <country>SK</country> <time>1.2.2014 7:24:18</time> <requestSubject> <subjectType>privatePerson</subjectType> <birthNumber>196006170829</birthNumber> <firstName>Milan</firstName> <surname>Fuljer</surname> <address> <street>Osiková</street> <number>12</number> <city>Žilina</city> <zip /> </address> </requestSubject> <report> <status>4</status> <birthNumber /> <firstName>Milan</firstName> <surname>Fuljer</surname> <invalidBirthNumber>INVALID</invalidBirthNumber> <skOvDrazbyExekuce> <SkOvDrazbyExekuceRecord> <id>6e723caf-0c94-4bab-96d9-1600359ee697</id> <nazev>Milan Fuljer, nar. 17.06.1960, IČO: 10936629</nazev> <vidanieOv>224/2012</vidanieOv> <cisloKonania>EX-268/2006</cisloKonania> <datumKonania>2012-12-28T00:00:00</datumKonania> <datumVyhlasenia>2012-11-16T00:00:00</datumVyhlasenia> <znaleckaHodnota>14800</znaleckaHodnota> <realnaHodnota>14800</realnaHodnota> </SkOvDrazbyExekuceRecord> </skOvDrazbyExekuce> </report> </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> <address> <street>Krátká</street> <number>8</number> <city>Praha</city> <zip>10100</zip> </address> </requestSubject> <report > <status>3</status> <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>1977</birthYear> <privateFullAddress> Krátká 8, PRAHA</ privateFullAddress > </skUnionRecord> </report> </creditCheck> |
Example for Stolen ID cards
Code Block | ||
---|---|---|
| ||
<creditCheck version="1.0" encoding="utf-8" xmlns=""> <webMethod>GetSubjectBasicReport</webMethod> <country>SK</country> <time>2015-02-13T10:42:50.5940376+01:00</time> <requestId>4c00995c-d358-40f8-ab85-c82841b7f7b3</requestId> <requestSubject> <reportVersion>2</reportVersion> <subjectType>privatePerson</subjectType> <birthNumber>7710109867</birthNumber> <firstName>Abašanov</firstName> <surname>Peter</surname> <address> <street>Niva</street> <number>17</number> <city>Medzibrod</city> <zip /> </address> <idCard>SP418059</idCard> </requestSubject> <report> <status>4</status> <birthNumber /> <firstName>Abašanov</firstName> <surname>Peter</surname> <idCard>INVALID</idCard> <invalidBirthNumber>INVALID</invalidBirthNumber> </report> </creditCheck> |
Example for Municipality check
Code Block | ||
---|---|---|
| ||
<creditCheck version="1.0" encoding="utf-8" xmlns=""> <webMethod>GetSubjectBasicReport</webMethod> <country>SK</country> <time>2015-02-13T10:44:13.2897676+01:00</time> <requestId>14dd7943-fc25-4f79-9160-025f6dda3367</requestId> <requestSubject> <reportVersion>2</reportVersion> <subjectType>privatePerson</subjectType> <birthNumber>7005158655</birthNumber> <firstName>Roman</firstName> <surname>Arolon</surname> <address> <street>Rumanová</street> <number /> <city>Rumanová</city> <zip /> </address> </requestSubject> <report> <status>4</status> <birthNumber /> <firstName>R</firstName> <surname>A</surname> <domicileMunicipality> <ic>00308412</ic> <muniName>Obec Rumanová</muniName> <isHistoryAddress>false</isHistoryAddress> <fullAddress>Rumanová 1, Rumanová, 95137</fullAddress> </domicileMunicipality> </report> </creditCheck> |
...
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. |
...