Jak Creditcheck integrovat

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

V prvním kroku je vhodné začít funkcí, díky které mají uživatelé u každého zákazníka v systému 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 individuální pro každého zákazníka Creditcheck služeb a typicky se zadávají někde v Administraci podnikového systému.


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. 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 1x týdně.

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.

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.