GetCreditCheckBatch - CZ

Tato webová metoda Webové služby CreditCheckAktualizace je poskytována zdarma.

Tato webová metoda vrací seznam subjektů a jejich hodnocení. Jsou vybrány veškeré záznamy subjektů, které mají id záznamu z databáze vyšší, než hodnota, vložená v parametru webové metody a subjekt není zaniklý před specifickým datumem. Záznamy nejsou unikátní podle identifikátoru subjektu a jeden subjekt může mít více záznamů s různým hodnocením.


Příklad rozdílů ve výstupu mezi kompletními a batch metodami: Saleza, a.s., ič 47116307

Pro vysvětlení uvádíme na příkladu společnosti Sazka princip fungování jednotlivých metod.


GetCreditChecksBatch, GetCreditChecksBatchCompressed, GetCreditChecksBatchIc
Batch metoda vrátí k přehled všech dosud známých dílčích hodnocení:
5651737;47116307;2 (slovní komentář na CCL Full: Dceřiná firma v likvidaci)
5861748;47116307;3 (slovní komentář na CCL Full: Probíhá insolvenční řízení - před rozhodnutím o úpadku.)
6256713;47116307;2 (slovní komentář na CCL Full: Méně závažné omezení vlastnického práva k nemovitosti.)


Výše uvedený příklad dokládá, že z výstupů batch metod není možné ve 100% případů odvodit aktuální celkové hodnocení. Tyto metody je vhodné využít pro sledování vývoje rizikových hodnocení v čase. Při výhradním používání batch metod je zároveň při každé nové instalaci Creditchecku načíst data od id 0, což mohou být v budoucích letech velké objemy dat. 


GetCreditChecks, GetCreditChecksCompressed, GetCreditCheckIc
Jednorázová metoda vrátí aktuální celkové hodnocení:
5861748;47116307;3 (slovní komentář na CCL Full: Probíhá insolvenční řízení - před rozhodnutím o úpadku.)


ID hodnocení (5861748) je vždy jedním z ID vráceným i některou z batch metod.


Pro spolehlivou informaci o výsledných statusech je třeba využít pouze některou z těchto kompletních metod. Pokud chcete uchovávat historii všech dílčích hodnocení a zároveň zobrazovat uživatelům aktuální celkové hodnocení, je třeba kombinovat kompletní i batch metody.


-----------------------------------------


Webová metoda má jeden vstupní parametr lastBatchIndex . Tento parametr je hodnota posledního staženého záznamu CreditChecku klientem. Webová metoda vyžaduje použít SOAP header, který obsahuje parametry přihlášení k webové metodě.


SOAP header 

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

 

 


Popis elementů 

NázevPopis
Loginuživatelské jméno
Passworduživatelské heslo


Tyto údaje jsou stejné pro všechny uživatele jednoho partnerského systému a standardně budou neměnné. Proto doporučujeme je nastavit pro všechny napevno.


Vstupní parametry

Název parametruDatový typPoznámka
lastBatchIndexintId posledního staženého záznamu klientem. Pokud ještě nebylo provedeno žádné stažení, vkládá se hodnota 0.



Výstupní data

Výstupní data webové metody obsahují řetězec (string), který reprezentuje Xml formát s výstupními daty. (Zobrazený příklad je pro vstupní parametr lastBatchIndex = 6778

<creditCheck>
  <webMethod>GetCreditChecksBatch</webMethod>
  <version>0.0.0.6</version>
  <time>15.2.2010 8:12:35</time>
  <count>14</count>
  <data>
    <![CDATA[<![CDATA[6779;67199941;3
      6780;25365398;3
      6781;11484462;3
      6782;25515845;3
      6783;48399191;3
      6784;60345829;3
      6785;45999562;3
      6786;48591408;3
      6787;40931382;3
      6788;19009755;3
      6789;61680125;3
      6790;10577572;3
    ]]>
    ]]>
  </data>
</creditCheck>



 


Popis elementů 

NázevPopis
webMethodnázev webové metody, která vrátila data
versionverze webové služby
timeserverový čas vygenerování souboru
countpočet záznamů subjektů, které obsahuje sekce data
datadata subjektů zabalená do CDATA


Popis formátu dat v elementu 

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: id záznamu z databáze
  • druhá pozice: identifikátor subjektu, zde ičo subjektu
  • třetí pozice: hodnocení – CreditCheck


Příklad: 2;63493551;3 kde 2 = id záznamu, 63493551 = ičo subjektu, 3 = hodnocení - CreditCheck 

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