Jak Creditcheck integrovat
- Pavel Macek
- Martin Janeček
Zde uvádíme doporučovaný způsob implementace propojení podnikových informačních systémů se službou hodnocení kredibility firem CreditCheck. Níže uvedená doporučení byla vytvořena na základě zkušeností s integrací Creditcheckku do desítek podnikových systémů v ČR a SR, které proběhly od roku 2010.
Načítání semaforů CreditCheck do partnerského SW - ZDARMA
V prvním kroku je vhodné začít bezplatnou funkcí, díky které mají uživatelé u každého zákazníka v systému zdarma základní indikátor potenciálníoho rizika. Každé české IČ má v systému Creditcheck přidělen semafor/status 1-3.
1 = zelený semafor
2 = oranžový semafor
3 = červený semafor
Více k semaforu CreditCheck v dokumentaci na stránce Semafor Creditcheck.
Nejčastější použití tohoto statusu je v seznamu obchodních partnerů a na detailní kartě konkrétního obchodního partnera.
Načítání dat probíhá pomocí webové služby. Přihlašovací údaje k této službě jsou pro všechny uživatele jednoho partnerského systému stejné a není třeba je konfigurovat.
Pro automatické načítání dat se semafory do zákaznické databáze doporučujeme používat kombinaci těchto dvou metod webové služby CreditCheckAktualizace:
1) GetCreditChecks (nebo její komprimovaná varianta)
Stažená data obsahují soubor všech IČ, která mají v databázi Creditcheck nastaven status 2 nebo 3.
Všechna IČ nemající status 2 nebo 3 a nejsou zároveň mezi zaniklými subjekty vracenými metodou GetZanikleSubjektyCompressed mohou mít automaticky přidělen status 1 (zelený semafor). Podmínkou je, aby subjekt v zákaznické databázi měl tyto vlastnosti:
a) země je CZ (pro CZ metody) nebo SK (pro SK metody) nebo "neuvedeno"
+
b) hodnota v poli poli IČ odpovídá formátu pro IČ, tj. jde o osmimístné číslo (kratší čísla je možné akceptovat jakoby volné pozice vlevo byly nahrazeny údajem 0).
Doporučujeme aktualizovat automaticky přes noc každých 24 hodin.
2) GetZanikleSubjektyCompressed
Obsahuje výhradně IČ se statusem 3. Jde o subjekty zaniklé před konkrétním datem. Tento datum může být max. 1x ročně změněn. Všechna IČ obsažena v tomto souboru je možné v zákaznické databázi kromě označení červeným semaforem rovněž označit jako “zaniklý subjekt”. Vzhledem k chybám ve zdrojových registrech může v minoritním počtu případů nastat situace, kdy je subjekt označen jako zaniklý a později opět vrácen mezi aktivní firmy se statusem 1.
Doporučujeme aktualizovat automaticky 1-4x ročně + nabídnout administrátorovi uživatele možnost manuálního stažení dat zaniklých subjektů mimo plán běžných aktualizací.
Zobrazení semaforů v partnerském SW
Místo kde budou zobrazeny semafory Creditcheck necháváme na zvážení integračních partnerů. Nejčastě jsou používána tato 3 místa:
- adresář
- karta kontaktu
- alert při konkrétní aktivitě (zakládání objednávky atd.)
Je třeba zajistit, aby byl semafor zobrazován pouze u subjektů ze zemí, pro které Creditcheck poskytuje data - CZ, SK (nebo ke zvážení u subjektů, které nemají zemi vyplněnou). Zároveň však musí být splněna podmínka, že v poli IČ je hodnota odpovídající formátu IČ: 8místný numerický řetězec; pokud je znaků méně doplnit vlevo nuly.
Deaktivace semaforu
Použitelné při využití metod GetCreditChecks, GetCreditCheckCompressed,GetCreditCheckIc.
Všechny semafory pro konkrétní IČ
Doporučujeme umožnit uživateli nebo administrátorovi zablokovat zobrazení semaforu u konkrétního subjektu. S tímto požadavkem je možné se setkat například u firem, které jsou dlužníky ale zároveň chtějí s Creditcheckem pracovat. Pokud mají vlastní firmu v adresáři uvedenou s červeným semaforem, mohou jeho zobrazení vlastním uživatelům zablokovat.
Nejvyšší hodnocení pro konkrétní IČ
V praxi nastává situace, kdy je uživatel seznámen s příčinami rizikového hodnocení (například nedávnou ukončené insolvenční řízení - červený smafor) a nadále nemá potřebu toto hodnocení brát v potaz. Dojde-li ale po čase k výskytu nové skutečnosti s indikací červeného semaforu (například nový dluh) v partnerském řešení nadále zůstává pouze červený semafor a uživatel tuto novou informaci může přehlédnout.
Ke každému IČ proto navíc kromě statusu vždy na první pozici řádku uvádíme ID záznamu. Toto ID se mění vždy s novým “nejvyšším” statusem Creditcheck. Ve výše uvedeném případě by se tedy v denní aktualizační dávce objevil záznam k danému IČ se stejným statusem, ale novým ID.
Doporučujeme tedy na úrovni uživatele umožnit deaktivaci semaforu navázanou na konkrétní ID.
Sledování změn
Kromě celkového statusu může mít každá firma i více dílčích statusů, které jsou na reportu CreditcheckList umístěny v části “výsledky credit risk kontrol”. Má-li například firma v důsledku dlouhodobě probíhajícího insolvenčního řízení červený semafor, může mezitím nabývat dalších dílčích statusů s oranžovým semaforem (například dceřinná firma v likvidaci, zástavní právo na obchodní podíl, zrušena registrace k DPH atd.). Opět zde platí, že uživatel nemusí mít potřebu znovu prověřovat již prověřené, ale probíhající dílčí změny ho zajímají.
Každý tento dílčí status má opět své unikátní ID a objeví se ve výstupním souboru.
Zobrazování reportů CreditcheckList
Je realizováno pomocí URL v okně prohlížeče. URL má vždy stejný formát, pouze se mění IČ. Pro jeden partnerský systém je vždy stejný CID.
URL placeného reportu navíc obsahuje údaj code, který zákazníkovi zasíláme po objednání.
Detailní dokumentace je zde.