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. When a private subject is uniquely defined by birthNumber and that birthNumber is found in our database, this field indicates if the subject passed our risk control procedure. The possible values for this field birthNumber is supplied, we try to find an enterprise associated with the subject. If such an enterprise is found, the credit risk status of that enterprise is returned. The possible values of credit risk status are: 1 - Subject passed all checks (Subject doesn't have a negative record in any of the source databases we process) 2 - Subject has at least one negative record in a secondary source database 3 - Subject has at least one negative record in a primary source database 0 ; 4 - The supplied birthNumber vas is invalid, or wasn't no associated enterprise was found in our database As of today (16.02.2015) no Slovak info source provides date births with their records, which basically means that the only possible results are 0 or 4. |
fullReportUrl | string | yes | Url to CreditCheck FullReport as timelink. |
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 | |
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 debtor data. When subject has not SkKons debtor 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 debtor data. When subject has not SK Union debtor 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 debtor data. When subject has not debtor 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 debtor data. When subject has not debtor 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 debtor data. When subject has not debtor 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 debtor data. When subject has not debtor 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:
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:
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:
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. |
...