Popis služby GSBR SK

Owned by Former user (Deleted)
Last updated: Nov 28, 2019

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:

  1. Slovenska konsolidacna - debtors
  2. Union ZP - debtors
  3. Financne riaditelstvo - debtors
  4. Socialna poistovna - debtors
  5. VZP ZP - debtors
  6. Konkurzy a likvidace – bankruptcy
  7. Obchodny vestnik dražby a exekuce – bankruptcy
  8. Birth number validity
  9. Stolen ID cards
  10. Municipality check
  11. EOS KSI debtors

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



For sources (1, 2, 3, 5) the only search parameters taken into account are: 

firstName

surname

zip (omitted if not supplied)


Source 4 (Socialna poistovna) takes into account only:

firstName

surname 

That is because, the source almost never provides information about zip code of the subject.


Source 6 (Konkurzy a likvidace) takes into account:

firstName

surname

dateOfBirth (omitted if not supplied). 





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

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 nameDatatypeMandatoryNotice

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 nameDatatypeMandatoryNotice
registeredboolyesTake notice ! Possible values are ANO/NIE (true/false) ; Flag that means if the subject is registered in Eos Ksi database or not.
total_casesintyesCount of all cases registered in Eos Ksi for the specified subject
active_casesintyes

Count of cases that are still active, they don't have element case_close.

case

Envelope element for one record.
typestring (enum ?)

rolestring (enum ?)

take_overdate

case_closedate

total_amountfloat

total_paymentfloat

statusstring

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

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

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

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

URL response inside - all links are URL encoded.