Pro využívání Creditcheck webové služby našimi zákazníky doporučujeme určitá pravidla a limitace pro přístup k jednotlivým metodám. Důvodem pro tyto doporučení je snaha o optimalizaci běhu této služby pro všechny naše zákazníky.
Doporučení se týkají hlavně frekvence dotazování a optimálního časového "okna" pro využití WS metod. Před implementací si prosím více podrobností přečtěte zde.
WS CreditCheckAktualizace
| Verze systému | Root adresa | WSDL | Verze webové služby | Poznámka |
|---|---|---|---|---|
| LIVE | https://creditwebservices.creditcheck.sk/CreditCheckAktualizace.asmx | wsdl | - |
Webové metody služby CreditCheckAktualizace
| Název metody | Dokumentace | Popis | Země | |
|---|---|---|---|---|
| GetCreditChecks | dokumentace | Webová metoda vrátí seznam subjektů a CreditCheck status ke každému subjektu se statusem vyšším než 1 a subjekt není zaniklý před specifickým datumem. | SK | |
| GetCreditChecksCompressed | dokumentace | Webová metoda vrátí seznam subjektů a CreditCheck status ke každému subjektu se statusem vyšším než 1 a subjekt není zaniklý před specifickým datumem. Seznam subjektů je v zazipované formě. | SK | |
| GetCreditCheckIc | dokumentace | Webová metoda vrátí seznam CreditCheck statusů k vybranému subjektu se statusem vyšším než 1. Limit 200 dotazů den pro jednu IP adresu. | SK | |
| GetZanikleSubjektyCompressed | dokumentace | Webová metoda vrátí seznam zaniklých subjektů k specifickému datumu. Seznam subjektů je v zazipované formě. | SK | |
| GetZanikleSubjekty | dokumentace | Webová metoda vrátí seznam zaniklých subjektů k specifickému datumu. | SK | |
| GetSubjectFullReport (GSFR) | dokumnetace | Webová metoda vrátí Xml report, který je verzí reportu CreditcheckList z webového rozhraní na adrese www.creditcheck.sk . | SK | |
| GetSubjectBasicReport (GSBR) | dokumentace | Webová metoda vrátí výsledky prověření kredibility fyzické osoby ve veřejně dostupných zdrojích ve formátu XML. | SK | |
| SearchingServicesType01 | dokumentace | Webová metoda je vyhledávací služba Typu 01, která naším zákazníkům nabízí možnost vyhledávat subjekty v naší databázi na základě několika kritérií. | SK | |
| GetSubjectsBasicInfoByName | dokumentace | Metoda vrací základní informace pro všechny subjekty s hledaným názvem. | SK | |
| GetCreditChecksIcs | dokumentace | Vrací stejná data jako metoda GetCreditChecks, pouze filtruje výstupní množinu subjektů dle vstupní kolekce v parametru listOfIcs. | SK |
Přehled metod pro Česko najdete zde WS CreditCheckAktualizace - CZ.
Semafor/status CreditCheck
Součástí výstupu z většiny metod webové služby je status, jehož popisu je věnována samostatná stránka Semafor Creditcheck.
Příklady
Příklad kódu propojení s Creditcheckem v PHP je zde.
Chyby webových metod
Pokud se vyskytne chyba na straně webové služby, která byla vygenerovaná v průběhu zpracování požadavku, webové metody vrátí výjimku SOAPException. Tato výjimka obsahuje message typu string, na základě kterého lze identifikovat vzniklý problém jak na straně klienta, tak na straně podpory CreditCheck s.r.o.
Message obsahuje data v několika blocích. Tyto bloky dat jsou oddělené středníkem. Příklad výjimky, která byla vygenerovaná webovou metodou je na následujících řádcích.
Uid:6b475c95-b86e-426e-8ee0-96faab6001f4;ErrNumber:101;Mess:Došlo k pokusu o provedení neautorizované operace.
Tato data lze rozdělit do následujících bloků:
- Uid:6b475c95-b86e-426e-8ee0-96faab6001f4;
- ErrNumber:101;
- Mess:Došlo k pokusu o provedení neautorizované operace.
Popis bloků
- Uid: jednoznačný identifikátor chyby. Guid. Podle této hodnoty lze dohledat chybu v logu chyb CreditChecku. Tento identifikátor slouží primárně k identifikaci problému a párování problému s klientským požadavkem na řešení chyby.
- ErrNumber: číselný kód typu chyby.
- Mess: Zpráva s popisem chyby.
Číselník chyb
| 100 | Nespecifikovaná chyba | Chybu lze identifikovat podle bloku Mess: Tato chyba je generovaná pro všechny nerozlišované problémy. |
| 101 | Chyba je generovaná v případě autorizačních problémů | Ověřit a znovu zadat login a password do SOAP headru požadavku. V případě opakované chyby ověřit u podpory CreditCheck s.r.o. správnost dat. |
Chyba | Popis | Řešení |
|---|
Interní dokumentace
Neveřejná část, /wiki/spaces/CREDS/pages/656511.