ExportMonitoringGetLatestReport CZ

Tato webová metoda webové služby CreditCheckAktualizace umožňuje stažení vygenerovaného reportu monitoringu.

SOAP header

SOAP header

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

Popis elementů SOAP headeru.

Název	Popis
Login	uživatelské jméno
Password	uživatelské heslo

Tyto údaje jsou rozdílné pro různé uživatele systému a jsou poskytovány obchodním oddělením Credit Check, s.r.o.

Vstupní parametry webové metody

Webová metoda má jeden vstupní parametr. Očekává XmlNode s daty pro identifikaci požadavku exportu reportu monitoringu.

název	datatype	mandatory	poznámka
reportRequest	XmlNode	yes

Vstup parametru webové metody

Příklad požadavku na report

<exportMonitoringLatestReport>
  <monitoringType>IsirPersonal</monitoringType>
  <reportType>MonthlyReport</reportType>
  <fileType>csv</fileType> 
</exportMonitoringLatestReport>

Popis elementů vstupu

Název	Popis	Specifikace
monitoringType	Typ monitoringu	V současné době pouze hodnota IsirPersonal .
reportType	Typ reportu	V současné době pouze hodnota MonthlyReport .
fileType	Typ souboru reportu.	V současné době pouze hodnota csv .

Výstup webové metody

Výstup webové metody poskytuje data o dotazu na základě kterého byl report poskytnutý, data reportu a v případě chyby informaci o chybě..

Příklad výstupního XML

<creditCheck version="1.0" encoding="utf-8">
  <webMethod>ExportMonitoringGetLatestReportTime</webMethod>
  <country>CZ</country>
  <time>2016-07-13T13:32:49.4445760+02:00</time>
  <exportMonitoringLatestReport xmlns="">
    <monitoringType>IsirPersonal</monitoringType>
    <reportType>MonthlyReport</reportType>
    <fileType>csv</fileType>
  </exportMonitoringLatestReport>
  <report>
    <reportId>6e2f3014-d798-45d3-9a9e-706790d17fad</reportId>
    <latestTime>2016-07-01T10:04:47.5370000+02:00</latestTime>
    <count>2</count>
    <data>
      <![CDATA[Jméno;Příjmení;Datum narození;Spisová značka;Poslední známý stav;Evidujeme od;Odkaz na dokument
Luděk;Lacina;1.8.1979 0:00:00;INS 28399/2012;ODDLUŽENÍ;30.6.2016 21:26:58;https://isir.justice.cz/isir/ueu/vysledek_lustrace.do?nazev_osoby=&vyhledat_pouze_podle_zacatku=on&podpora_vyhledat_pouze_podle_zacatku=true&bc_vec=28399&rocnik=2012&aktualnost=AKTUALNI_I_UKONCENA&spis_znacky_obdobi=14DNI
Jan;Staněk;22.3.1983 0:00:00;INS 21880/2011;ODSKRTNUTA;13.6.2016 8:28:00;https://isir.justice.cz/isir/ueu/vysledek_lustrace.do?nazev_osoby=&vyhledat_pouze_podle_zacatku=on&podpora_vyhledat_pouze_podle_zacatku=true&bc_vec=21880&rocnik=2011&aktualnost=AKTUALNI_I_UKONCENA&spis_znacky_obdobi=14DNI
]]>
    </data>
  </report>
</creditCheck>

Popis elementů výstupu

element name	datatype	mandatory	poznámka
webMethod	string	yes	Název webové metody, která data poskytla.
country	string	yes	Národní prostředí systému CreditCheck, který poskytl data.
time	DateTime	yes	Čas vygenerování výstupu XML.
exportMonitoringLatestReport	string	yes	Kopie dotazu, který odběratel dat poslal ve svém požadavku.
report		no	Element s daty report. Nemusí být poskytován v případě chyby. To znamená také to, že pokud nebude tento element vygenerován, nebudou zobrazeny jeho vnitřní elementy, které jsou jinak povinné.
reportId	Guid	yes	Id reportu. Jedná se o id které patří reportu vygenerovanému z této webové metody a není to id reportu z DB který tato webová metoda vrací. Slouží k identifikaci požadavku v rámci celého systému CreditCheck.
latestTime	DateTime	yes	Čas vygenerování reportu, který systém vrací. Tento čas je tedy časem, kdy systém CreditCheck report vygeneroval a uložil do databáze.
count	int	yes	Počet záznamů v elementu <data>
data	string	yes	Element s daty reportu. data jsou obalena do CData. Obsah je závislý na typu reportu, typu monitoringu a typu formátu souboru.

Popis formátu dat v elementu pro typ reportu Monthly, typ monitoringu IsirPersonal a formát csv.

Element obsahuje blok dat oddělených oddělovači, která jsou obalena do CDATA. Jeden záznam reprezentuje jeden řádek. Záznamy jsou odděleny znakem newLine – nová řádka. Jeden záznam obsahuje data, která jsou oddělená středníkem.

první pozice: jméno subjektu
druhá pozice: příjmení subjektu
třetí pozice: datum narození subjektu
čtvrtá pozice : číslo spisové značky ISIRu
pátá pozice: poslední známý stav
šestá pozice: datum evidence v systému CreditCheck
sedmá pozice: odkaz na řízení

Poznámka Formát a oddělovače dat můžou být na základě klientského požadavku změněné.

Error messages

Pokud se vyskytne v průběhu zpracování v systému CreditCheck chyba, je chyba vygenerována do elementu <error> . V této chvíli nemusí výstupní XML obsahovat element <report>, protože se jej nepodařilo vygenerovat.

error messages

<creditCheck version="1.0" encoding="utf-8">
  <webMethod>ExportMonitoringGetLatestReportTime</webMethod>
  <country>CZ</country>
  <time>2016-07-14T10:20:48.3883351+02:00</time>
  <exportMonitoringLatestReport xmlns="">
    <monitoringTypes>IsirPersonal</monitoringTypes>
    <reportType>MonthlyReport</reportType>
    <fileType>csv</fileType>
  </exportMonitoringLatestReport>
  <error>
    <errorId>4b201297-03ab-4943-bf42-e0ba910c22a5</errorId>
    <message>Input validation: The element 'exportMonitoringLatestReport' has invalid child element 'monitoringTypes'. List of possible elements expected: 'monitoringType'.</message>
    <description />
    <reportId>3d8442c3-df7d-45b5-9d11-6b9220378f89</reportId>
  </error>
</creditCheck>

Popis elementů error

element name	datatype	mandatory	poznámka
errorId	GUID as string	yes	Id for matching our error db inside
message	string	yes	Short information about error.
description	string	no	Doplňující popis chyby. Nemusí být vyplněný.
reportId	GUID as string	yes	id reportu, který chybu generoval.

Seznam chybových zpráv.

error number	error description		poznámka
		Input validation: XXX	Chyba validace vstupního XML.
		Monitoring is not allowed. Monitoring: XXX	Uživatel který požaduje report nemá povolený typ monitoringu pro který report požaduje.
		Report type is not allowed. Report type: XXX	Uživatel který požaduje report pro specifikovaný typ monitoringu nemá povolený požadovaný typ reportu.
		Obtaining error report.	Chyba generovaná při problému se získáním vygenerovaného reportu ze systému CreditCheck.
		invalid input	Input request is not valid.