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 :Sazka, a.s.
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.)
na CCL Full to pak vypadá takto:
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> <CreditCheckHeader xmlns="http://creditcheck.cz/"> <Login>string</Login> <Password>string</Password> </CreditCheckHeader> </soap:Header>
Popis elementů
Název | Popis |
---|---|
Login | uživatelské jméno |
Password | už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 parametru | Datový typ | Poznámka |
---|---|---|
lastBatchIndex | int | Id 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ázev | Popis |
---|---|
webMethod | název webové metody, která vrátila data |
version | verze webové služby |
time | serverový čas vygenerování souboru |
count | počet záznamů subjektů, které obsahuje sekce data |
data | data 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é.