Description and definition.

The web service method for subject’s info genaration. This method returned information about credit risk data.

Credit risk data

Output contais data from the:

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
EOS KSI debtors
Intrum Justicia Debtors

debt collection companies

The last 2 sources can be utilized only if you have the necessary credentials. Which means, you have to purchase (or already own) a product directly from those debt collection companies. Afterwards we will gladly help to set up your connection to those sources via this web service.

Web method input parameters

The web method has the one input parameter only. This parameter is a XML with subject’s data.

name	datatype	mandatory	Notice
subjectData	XMLDocument	yes

Web method output data

The output is XML with any information about risks or about subject’s state. In error case output contains an error information.

datatype	mandatory	Notice
XMLDocument	yes

SOAP header

The web method has the SOAP header. This header contains login values.

SOAP header

<soap:Header>
 <CreditCheckHeader xmlns="http://creditcheck.sk/">
   <Login>string</Login>
   <Password>string</Password>
 </CreditCheckHeader>
</soap:Header>

WSDL

WSDL bellow will be available on url: http://creditwebservices.creditcheck.sk/CreditCheckAktualizace.asmx?op=GetBasicReport

SOAP 1.1

SOAP 1.1.

POST /CreditCheckWebServices/CreditCheckAktualizace.asmx HTTP/1.1
Host: creditwebservices.creditcheck.sk
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://creditcheck.sk/GetSubjectBasicReport"


<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
 <soap:Header>
   <CreditCheckHeader xmlns="http://creditcheck.sk/">
     <Login>string</Login>
     <Password>string</Password>
   </CreditCheckHeader>
 </soap:Header>
 <soap:Body>
   <GetSubjectBasicReport xmlns="http://creditcheck.sk/">
     <subjectData>xml</subjectData>
   </GetSubjectBasicReport>
 </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length


<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
 <soap:Body>
   <GetSubjectBasicReportResponse xmlns="http://creditcheck.sk/">
     <GetSubjectBasicReportResult>xml</GetSubjectBasicReportResult>
   </GetSubjectBasicReportResponse>
 </soap:Body>
</soap:Envelope>

SOAP 1.2

SOAP 1.2

POST /CreditCheckWebServices/CreditCheckAktualizace.asmx HTTP/1.1
Host: creditwebservices.creditcheck.sk
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length


<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
 <soap12:Header>
   <CreditCheckHeader xmlns="http://creditcheck.sk/">
     <Login>string</Login>
     <Password>string</Password>
   </CreditCheckHeader>
 </soap12:Header>
 <soap12:Body>
   <GetSubjectBasicReport xmlns="http://creditcheck.sk/">
     <subjectData>xml</subjectData>
   </GetSubjectBasicReport>
 </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length


<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
 <soap12:Body>
   <GetSubjectBasicReportResponse xmlns="http://creditcheck.sk/">
     <GetSubjectBasicReportResult>xml</GetSubjectBasicReportResult>
   </GetSubjectBasicReportResponse>
 </soap12:Body>
</soap12:Envelope>

Requests to webmethod - input parameter description:

You must put valid XML into parameter. This XML has 1 type of structure.

Parameters - precision

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 possible data that meet the conditions, practically making the request useless. It can lead to several records missing, or even whole sections returned with error message (which is furthermore made unpredictable because the missing sections/data may vary). To avoid this mishap, try to always specify your input parameters to the most detailed level.

Use full names, instead of initials or monograms
If possible, use city AND street
If not, use at least city (when you fail to specify city in your request, there is a big chance you will receive records concerning several different people)

As of 01.06.2019, the searching logic for method GSBR has been changed. From now on, only records with EXACT MATCH of input parameters will be returned. Which means, that inadequately specified input parameters like ("A", "Ho", "Abe") are no longer supported. It also means, that forgoing the specification of City and Street input variables, will effectively limit the search only to records, that do not have their address specified → which means pretty much no records at all.

Type 1 : request for private person

Private person request

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

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:

The output XML 1 type of structure.

Notice: Some data between the requestSubject element and report element can be different.

Type 1 : response for private person request

response for private person request

<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>14b1cc27-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>
<ic />
<privateFullAddress>Krátká 8/65, Praha, 10101</ privateFullAddress >
     </skKonsRecord>
     <skKonsRecord>
       <id>17b1cc27-d159-4a7d-8672-0429e7f252c5</id>
       <dluhCelkem>3335.72</dluhCelkem>
       <mena>EUR</mena>
       <evidovanoOd>2012-08-17T11:25:11.55</evidovanoOd>
       <privateFullName>Jan Novák a manž. Marta</privateFullName>
       <birthNumber />
       <ic />
       <privateFullAddress>Krátká 8, Praha, 5801</privateFullAddress>
     </skKonsRecord>
   </skKons>
   <skUnion>
     <skUnionRecord>
       <id>434e3bb4-5485-4f4a-a29c-001dae1f0c24</id>
       <dluhCelkem>489</dluhCelkem>
       <evidovanoOd>2010-02-11 10:07:40.613</evidovanoOd>
       <evidovanoDo>2010-09-11 11:07:40.613</evidovanoDo>
<privateFullName>Jan Novák</privateFullName>
<birthYear>1977</birthYear>
<privateFullAddress>Krátká 8/65, Praha, 10101</ privateFullAddress >
     </skUnionRecord>
     <skUnionRecord>
       <id>334e3bb4-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>
<privateFullName>Jan Novák</privateFullName>
<birthYear>1977</birthYear>
<privateFullAddress>Dlouhá 15, BRNO</ privateFullAddress >
     </skUnionRecord>
   </skUnion>
   <skVzp>
     <skVzpRecord>
       <id>1e2833af-1297-40f6-8116-0002a3b09b43</id>
       <dluhCelkem>460.60</dluhCelkem>
       <evidovanoOd>2012-11-13T07:01:44.107</evidovanoOd>
       <privateFullName>Jan Novák</privateFullName>
       <birthYear>1977</birthYear>
       <privateFullAddress> Dlouhá 15, BRNO, 44700</privateFullAddress>
     </skVzpRecord>
   </skVzp>
   </skVzp>
   <skFinRed>
     <skFinRedRecord>
       <id>2f2eb3e7-4dde-4f8a-8517-00e02723ec1f</id>
       <dluhCelkem>193403.72</dluhCelkem>
       <evidovanoOd>2011-01-01T00:00:00</evidovanoOd>
       <privateFullName>Jan Novák</privateFullName>
       <privateFullAddress> Krátká 15, Praha</privateFullAddress>
       <rokDluhu>2010</rokDluhu>
     </skFinRedRecord>
   </skFinRed>
   <skSocPoj>
     <socPojRecord>
       <id>734407</id>
       <dluhCelkem>861.9400</dluhCelkem>
       <mena>EUR</mena>
       <evidovanoOd>2012-11-14T11:57:40.52</evidovanoOd>
       <privateFullName>Jan Novák</privateFullName>
       <privateFullAddress>Krátká 8, Praha, 10100</privateFullAddress>
     </socPojRecord>
   </skSocPoj>
   <skOvKonkurz>
<skOvKonkurzRecord>
       <id>1e2833af-1297-40f6-8116-0002a3b09b43</id>
       <evidovanoOd>2012-11-13T07:01:44.107</evidovanoOd>
       <privateFullName>Jan Novák</privateFullName>
       <birthYear>1977</birthYear>
       <privateFullAddress> Dlouhá 15, BRNO, 44700</privateFullAddress>
     </skOvKonkurzRecord>    
 </skOvKonkurz>
 </report>
</creditCheck>

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 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 is invalid, or 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.) In best case scenario shows a date when the negative status (e.g. debt) started to be registered by info source. This can sometimes be untrue due to the difference between: 1/ Date when the info source registered the neg. status and 2/ Date when the info source publishes this information. In practice, some info sources publish their records several times a month (e.g. once a week), in such a case it can make a several day difference between the negative status "discover date" and "publish date". And we are usually only aware of the "publish date" value, so bear that in mind. The same ¨ goes the other way too, if a negative status has been removed from source, it can take up to several days before we receive the latest data.
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.) In best case scenario shows a date when the negative status (e.g. debt) started to be registered by info source. This can sometimes be untrue due to the difference between: 1/ Date when the info source registered the neg. status and 2/ Date when the info source publishes this information. In practice, some info sources publish their records several times a month (e.g. once a week), in such a case it can make a several day difference between the negative status "discover date" and "publish date". And we are usually only aware of the "publish date" value, so bear that in mind. The same ¨ goes the other way too, if a negative status has been removed from source, it can take up to several days before we receive the latest data.
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.) In best case scenario shows a date when the negative status (e.g. debt) started to be registered by info source. This can sometimes be untrue due to the difference between: 1/ Date when the info source registered the neg. status and 2/ Date when the info source publishes this information. In practice, some info sources publish their records several times a month (e.g. once a week), in such a case it can make a several day difference between the negative status "discover date" and "publish date". And we are usually only aware of the "publish date" value, so bear that in mind. The same ¨ goes the other way too, if a negative status has been removed from source, it can take up to several days before we receive the latest data.
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. Shows the year when the negative status (e.g. debt) was registered.
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.
SocPojRecord			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.) In best case scenario shows a date when the negative status (e.g. debt) started to be registered by info source. This can sometimes be untrue due to the difference between: 1/ Date when the info source registered the neg. status and 2/ Date when the info source publishes this information. In practice, some info sources publish their records several times a month (e.g. once a week), in such a case it can make a several day difference between the negative status "discover date" and "publish date". And we are usually only aware of the "publish date" value, so bear that in mind. The same ¨ goes the other way too, if a negative status has been removed from source, it can take up to several days before we receive the latest data.
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.) In best case scenario shows a date when the negative status (e.g. debt) started to be registered by info source. This can sometimes be untrue due to the difference between: 1/ Date when the info source registered the neg. status and 2/ Date when the info source publishes this information. In practice, some info sources publish their records several times a month (e.g. once a week), in such a case it can make a several day difference between the negative status "discover date" and "publish date". And we are usually only aware of the "publish date" value, so bear that in mind. The same ¨ goes the other way too, if a negative status has been removed from source, it can take up to several days before we receive the latest data.
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. Slovak info source Obchodni vestnik publishes several "issues" a month. Every issue is identified by number, year and date of it's release. The number sequence starts at value = 1, anew every year. Example : 141 ; 2014 ; 21.08.2014
cisloKonania	string	no	Number of event. Unique identifier that specifies particular case of foreclosure/auction. Note that more than one record can hold the same ID (cisloKonania). It's similar to several documents marked as belonging to one contract. If more than 1 record has the same ID, it means that the records belong to the same case.
datumKonania	string	no	Event date.
datumVyhlasenia	string	no	Date of publication. Date when the "event" was made public to other parties.
znaleckaHodnota	string	no	Valuation. Value of the commodity evaluated by a designated expert with a neccessary knowledge in the field.
realnaHodnota	string	no	Fair value. Real market value of the commodity.

Response for private person request + Eos Ksi

Response for private person request - Eos Ksi only

<creditCheck version="1.0" encoding="utf-8" xmlns="">
  <webMethod>GetSubjectBasicReport</webMethod>
  <country>SK</country>
  <time>4.3.2015 11:51:17</time>
  <requestSubject>
    <subjectType>privatePerson</subjectType>
    <birthNumber>6252240016</birthNumber>
    <firstName>DARINA</firstName>
    <surname>Rusnáková</surname>
    <address>
      <street>Beňadiková</street>
      <number />
      <city>Beňadiková</city>
      <zip />
    </address>
  </requestSubject>
  <report>
    <status>4</status>
    <birthNumber />
    <firstName>DARINA</firstName>
    <surname>Rusnáková</surname>
    <skEosKsi>
      <registered>ANO</registered>
      <total_cases>3</total_cases>
      <active_cases>0</active_cases>
      <case>
        <type>B2C</type>
        <role>DLZNIK</role>
        <take_over>2007-07-10</take_over>
        <case_close>2013-03-22</case_close>
        <total_amount>1242.68</total_amount>
        <total_payment>0</total_payment>
        <status>MIMOSUDNE_VYMAHANIE_UZATVORENE</status>
      </case>
      <case>
        <type>B2C</type>
        <role>DLZNIK</role>
        <take_over>2007-06-29</take_over>
        <case_close>2013-03-22</case_close>
        <total_amount>1537.1</total_amount>
        <total_payment>0</total_payment>
        <status>MIMOSUDNE_VYMAHANIE_UZATVORENE</status>
      </case>
      <case>
        <type>Telekomunikacie</type>
        <role>DLZNIK</role>
        <take_over>2003-03-03</take_over>
        <case_close>2003-05-25</case_close>
        <total_amount>404.9</total_amount>
        <total_payment>0</total_payment>
        <status>MIMOSUDNE_VYMAHANIE_UZATVORENE</status>
      </case>
    </skEosKsi>
  </report>
</creditCheck>

Element name	Datatype	Mandatory	Notice
registered	bool	yes	Take notice ! Possible values are ANO/NIE (true/false) ; Flag that means if the subject is registered in Eos Ksi database or not.
total_cases	int	yes	Count of all cases registered in Eos Ksi for the specified subject
active_cases	int	yes	Count of cases that are still active, they don't have element case_close.
case			Envelope element for one record.
type	string (enum ?)
role	string (enum ?)
take_over	date
case_close	date
total_amount	float
total_payment	float
status	string

Eos Ksi elements

For more information about elements of Eos Ksi section, you have to contact Eos Ksi directly.

Exemplary responses

Example for Slovenska konsolidacni:

Example for Slovenska konsolidacni risk subject

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

Example for Slovenska konsolidacni and Union risk subject

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

Example for Financne riaditelstvo - debtors

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

Example for Socialna poistovna - debtors:

Example for Socialna poistovna - debtors

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

Example for VZP ZP - debtors

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

Example for OV drazby a exekuce risk subject:

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

Example for invalid birth number

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

Example for Stolen ID cards

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

Example for Municipality check

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

Example for subject without credit:

Example for subject without credit risk data

<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>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>
</creditCheck>

Example for Eos Ksi:

Example for Eos Ksi

<creditCheck version="1.0" encoding="utf-8" xmlns="">
  <webMethod>GetSubjectBasicReport</webMethod>
  <country>SK</country>
  <time>4.3.2015 11:51:17</time>
  <requestSubject>
    <subjectType>privatePerson</subjectType>
    <birthNumber>6252240016</birthNumber>
    <firstName>DARINA</firstName>
    <surname>Rusnáková</surname>
    <address>
      <street>Beňadiková</street>
      <number />
      <city>Beňadiková</city>
      <zip />
    </address>
  </requestSubject>
  <report>
    <status>4</status>
    <birthNumber />
    <firstName>DARINA</firstName>
    <surname>Rusnáková</surname>
    <domicileMunicipality>
      <ic>00315079</ic>
      <muniName>Obec Beňadiková</muniName>
      <isHistoryAddress>false</isHistoryAddress>
      <fullAddress>Beňadiková 17, Beňadiková, 03204</fullAddress>
    </domicileMunicipality>
    <skEosKsi>
      <registered>ANO</registered>
      <total_cases>3</total_cases>
      <active_cases>0</active_cases>
      <case>
        <type>B2C</type>
        <role>DLZNIK</role>
        <take_over>2007-07-10</take_over>
        <case_close>2013-03-22</case_close>
        <total_amount>1242.68</total_amount>
        <total_payment>0</total_payment>
        <status>MIMOSUDNE_VYMAHANIE_UZATVORENE</status>
      </case>
      <case>
        <type>B2C</type>
        <role>DLZNIK</role>
        <take_over>2007-06-29</take_over>
        <case_close>2013-03-22</case_close>
        <total_amount>1537.1</total_amount>
        <total_payment>0</total_payment>
        <status>MIMOSUDNE_VYMAHANIE_UZATVORENE</status>
      </case>
      <case>
        <type>Telekomunikacie</type>
        <role>DLZNIK</role>
        <take_over>2003-03-03</take_over>
        <case_close>2003-05-25</case_close>
        <total_amount>404.9</total_amount>
        <total_payment>0</total_payment>
        <status>MIMOSUDNE_VYMAHANIE_UZATVORENE</status>
      </case>
    </skEosKsi>
  </report>
</creditCheck>

Error messages

This section is under development. But here is base envelope for it.

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.

Example for error 01

Example for error 01

<creditCheck version="1.0" encoding="utf-8" >
 <webMethod>GetSubjectBasicRecord</webMethod>
 <time>28.7.2012 6:12:38</time>
 <error>
   <errorId>1ef6df0c-06b9-4dc2-a1b0-31a2ef133189</errorId>
   <message>01 - unknown subject type</message>
 </error>
</creditCheck>.

Example for error 02

Example for error 02

<creditCheck version="1.0" encoding="utf-8" >
 <webMethod>GetSubjectBasicRecord</webMethod>
 <time>28.7.2012 6:14:38</time>
 <error>
   <errorId>8ef6df0c-06b9-4dc2-a1b0-31a2ef133189</errorId>
   <message>02 - invalid birth date</message>
 </error>
</creditCheck>

Example for error 05

Example for error 05

<creditCheck version="1.0" encoding="utf-8" >
 <webMethod>GetSubjectBasicRecord</webMethod>
 <time>28.7.2012 6:14:38</time>
 <error>
   <errorId>8ef6df0c-06b9-4dc2-a1b0-31a2ef133189</errorId>
   <message>05 - invalid input</message>
   <description> Our system can not create birth date from personal number. Personal            number is: 752299123</description>
 </error>
</creditCheck>

Example for error 06

Example for error 06

<creditCheck version="1.0" encoding="utf-8" >
 <webMethod>GetSubjectBasicReport</webMethod>
 <country>SK</country>
 <time>6.2.2014 11:11:22</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>
     <error>
       <errorId>d2b84bc0-5506-4de0-9c19-d36d432632d8</errorId>
       <message>Nepodarilo se vygenerovat sekci. 06 - error generating section</message>
       <description> Our system can not generate section.</description>
     </error>
   </skOvDrazbyExekuce>
 </report>
</creditCheck>

Important notices