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 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. |
...