GetSubjectBasicReport - CZ

Metoda GetSubjectBasicReport (GSBR) je používána pro prověřování fyzických osob (tzn. osoby nepodnikající). Na jejím vstupu je potřeba uvést minimálně následující informace o osobě:

Jméno
Příjmení
RČ nebo Datum narození
Bydliště

JPDN je zkratka pro identifikátor definovaný pomocí hodnot: Jméno, Příjmení, Datum narození.

na základě těchto vstupních parametrů, můžete z metody obdržet následující informace:

insolvence dle RČ (případně JPDN)
- insolvence jsou dohledávány primárně podle RČ pokud je k dispozici.
- V případě, že RČ není k dispozici nebo podle něho nebyla dohledána žádná insolvence, potom je vyhledávání prováděno podle JPDN.
bydliště na úřadě
- je nutné vyplnit kompletní adresu bydliště (tzn. ulice, čp, město, psč)
- Ve výstupu je uvedeno v elementu: <domicileMunicipality> (pokud je nalezena shoda)
vlastnictví nemovitosti
- data metoda vrací pouze v případě, že je nepovinný parametr <checkInRealEstate>1</checkInRealEstate > nastaven na hodnotu 1 (True)
- pro toto prověření, je nutné aby uživatel byl kreditovým zákazníkem. Tzn. aby v rámci systému Creditcheck jeho účet disponoval kreditním zůstatkem.
- dotaz je prováděn pomocí JPDN. Tzn. dotaz není prováděn podle RČ !
  - z principu věci může ve výsledku prověření být shoda podle jména, příjmení, data narození
platný občanský průkaz
- Data metoda vrací pouze pokud je vyplněn parametr: <idCard>XXXXXXXXXX</idCard>
- Id card představuje ID dokladu (občanský průkaz)
- Výsledek prověření říká pouze jestli daný doklad je nebo není validní. (OK / INVALID)
dluhy na zdravotním pojištění
- Z důvodu GDPR, již zdroje neposkytují detailní informace o klientech, proto metoda nadále neposkytuje dlužnická data o fyzických osobách
CEE
- Data metoda vrací, pouze pokud je nepovinný parametr: <checkInExecutionRegistry>1</checkInExecutionRegistry> nastaven na hodnotu 1 (True).
- Tento dotaz je zpoplatněný, uživatel tedy musí disponovat kreditním zůstatkem.
- Prověřování je vždy prováděno na základě JPDN.
JustitiaCZ
- Data z důvodu ukončení zdroje informací již nadále metoda neposkytuje
Angažmá osoby v dalších firmách
element <involvements> poskytuje informace o angažmá osoby v dalších subjektech..

Doporučujeme při každém volání nastavovat parametr <reportVersion> na hodnotu = 3, která je nejaktuálnější a vrací kompletní data.

SOAP header:

Credit check SOAP header, obsahuje přihlašovací údaje uživatelského účtu který provádí dotaz.

Pozor, přihlašovací údaje účtu použité v této hlavičce slouží k identifikaci účtu z kterého bude stržen kredit za placené dotazy.

SOAP header

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

WSDL

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

SOAP 1.1

SOAP 1.1.

POST /CreditCheckWebServices/CreditCheckAktualizace.asmx HTTP/1.1
Host: creditwebservices.creditcheck.cz
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://creditcheck.cz/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.cz/">
<Login>string</Login>
<Password>string</Password>
</CreditCheckHeader>
</soap:Header>
<soap:Body>
<GetSubjectBasicReport xmlns="http://creditcheck.cz/">
<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.cz/">
<GetSubjectBasicReportResult>xml</GetSubjectBasicReportResult>
</GetSubjectBasicReportResponse>
</soap:Body>
</soap:Envelope>

Requests to webmethod - input parameter description

request for private person, version 3

Request with the birthDate element (with a relations) is less accurate as request with the birthNumber element.

private person request

<requestSubject>
<reportVersion>3</reportVersion>
<subjectType>privatePerson</subjectType>
<birthNumber>8005161124</birthNumber>
<birthDate>10.10.1977</birthDate>
<firstName>Jan</firstName>
<surname>Novák</surname>
<address>
	<street>Krátká</street>
	<number>8</number>
	<city>Praha</city>
	<zip>10100</zip>
</address>
<idCard>123456KK</idCard>
<checkInExecutionRegistry>1</checkInExecutionRegistry>
<checkInRealEstate>1</checkInRealEstate>
<checkInJustitiaCz>1</checkInJustitiaCz>
reportVersion
</requestSubject>

Element name	datatype	mandatory	reportVersion	relation	Description
subjectType	string	yes			privatePerson
birthNumber	string	yes
birthDate	string	relation	3		Při zadání RČ je přesto důležité uvádět i Jméno a Příjmení hledané osoby.
firstName	string	yes
surname	string	yes
address
street	string	yes
number	string	yes
city	string	yes
zip	string	yes
idCard	string	no	2		ID dokladu který chcete prověřit. Typicky ID občanského průkazu.
reportVersion	string	no
checkInExecutionRegistry	string	no	2
checkInRealEstate	string	no	2
checkInJustitiaCz	string	no	2		From 2014/03 and reportVersion 2 only. When element exists and value is 1 than subject wil check in the Justitia CZ registry.

Response from webmethod - data description

Type 1: response for private person request

private person response

<creditCheck version="1.0" encoding="utf-8" >
<webMethod>GetSubjectBasicReport</webMethod>
<time>21.10.2011 8:43:36</time>
<requestSubject>
<requestVersion>2</requestVersion>
<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>
<idCard>123456KK</idCard>
<checkInExecutionRegistry>1</ checkInExecutionRegistry >
</requestSubject>
<report>
<status>3</status>
<fullReportUrl>http//...</ fullReportUrl>
<birthNumber>7710109856</birthNumber>
<firstName>Jan</firstName>
<surname>Novák</surname>
<ic>701689523</ic>
<idCard>OK</idCard>
<invalidBirthNumber>INVALID</invalidBirthNumber>
<isir>
<isirRecord>
<id>5698</id>
<spisZnacka>INS 4/2008</spisZnacka>
<cas>2008-01-02 12:49:37.000</cas>
<udalost>Sdělení</udalost>
<druhStavRizeni>NEVYRIZENA</druhStavRizeni>
<isirUrl>https://isir.justice.cz/...</isirUrl> <dokumentUrl>https://isir.justice.cz:8443/isir_ws/doc/Document?idDokument=1408981</dokumentUrl>
</isirRecord>
</isir>
<domicileMunicipality >
<muniName>Obecní úřad Praha 6</muniName>>
<fullAddress>Krátká 8/12, Praha, 30100</fullAddress>
</domicileMunicipality>
</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
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	Přehlasovaná písmena jako (ö, ü, ä) jsou z pohledu systémů unikátní znaky. Není tedy možné je implicitně nahrazovat jiným znakem jako např. ("OE", "UE", "AE"). Takové jméno osoby by pak nebylo úspěšně dohledáno.
surname	string	yes
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.
idCard	String	no	When requestVersion is 2 only. This element have got two values. OK = card is OK. INVALID = card was stolen , lost or other problem.
invalidBirthNumber	String	no	When requestVersion is 2 only. This element will show when our validation of birth number was wrong. Value element inside will INVALID . When birth number is right then element missing.
isir		no	Root element for the ISIR risk data. When subject has not ISIR risk data then element will not exist. Last record from database only. This data domain is unique and collection not exist.
isirRecord			Envelope element for one record.
id	int	yes	Record Id from our database.
spisZnacka	string	yes
cas	datetime	yes
udalost	string	yes
druhStavRizeni	string	yes
isirUrl	string	yes	Link directtly to ISIR page.
dokumentUrl	string	yes	Link directtly to document’s copy on ISIR pages.
id	int	yes	Record id from our database.
privateFullName	string	yes	If the requestVersion element exists and value is 2.
dluhCelkem	number	yes