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

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)

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

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

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 subject without credit risk data

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 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 OV drazby a exekuce risk subject:

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>

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