WS CreditCheckAktualizace - CZ
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.
Adresy webové služby
| Verze systému | Root adresa | WSDL | Poznámka |
|---|---|---|---|
| LIVE | https://creditwebservices.creditcheck.cz/CreditCheckAktualizace.asmx | wsdl | doporučujeme používat https |
| LIVE |
Webové metody služby CreditCheckAktualizace
| Číslo | Název metody | Dokumentace | Cena | Popis | Země |
|---|---|---|---|---|---|
| 1. | GetCreditChecks | dokumentace | po dohodě zdarma | 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. | CZ |
| 2. | GetCreditChecksCompressed | dokumentace | po dohodě zdarma | 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ě. | CZ |
| 3. | GetCreditChecksBatch | dokumentace | po dohodě zdarma | Webová metoda vrátí seznam subjektů a CreditCheck status ke každému subjektu podle indexu požadované dávky a subjekt není zaniklý před specifickým datumem. | CZ |
| 4. | GetCreditChecksBatchCompressed | dokumentace | po dohodě zdarma | Webová metoda vrátí seznam subjektů a CreditCheck status ke každému subjektu podle indexu požadované dávky a subjekt není zaniklý před specifickým datumem.Seznam subjektů je v zazipované formě. | CZ |
| 5. | GetCreditCheckIc | dokumentace | po dohodě zdarma | Webová metoda vrátí seznam CreditCheck statusů k vybranému subjektu se statusem vyšším než 1. | CZ |
| 6. | GetCreditChecksBatchIc | dokumentace | po dohodě zdarma | Webová metoda vrátí seznam CreditCheck statusů k vybranému subjektu podle indexu požadované dávky. | CZ |
| 7. | GetZanikleSubjektyCompressed | dokumentace | po dohodě zdarma | Webová metoda vrátí seznam zaniklých subjektů k specifickému datumu. Seznam subjektů je v zazipované formě. | CZ |
| 8. | GetZanikleSubjekty | dokumentace | po dohodě zdarma | Webová metoda vrátí seznam zaniklých subjektů k specifickému datumu. | CZ |
| 9. | GetSubjectFullReport (GSFR) | dokumentace | individuálně | Webová metoda vrátí Xml report, který je verzí reportu Fullreport z webového rozhraní na adrese www.creditcheck.cz . | CZ |
| 10. | GetSubjectBasicReport (GSBR) | dokumentace | individuálně | Webová metoda vrátí výsledky prověření kredibility fyzické osoby ve veřejně dostupných zdrojích ve formátu XML. | CZ |
| 11. | 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í. | CZ | |
| 12. | GetDataPackage01 | individuálně | Vrátí kompletní přehled IČ se záznamem v insolvenčním rejstříku ISIR. Kromě IČ je obsažena i informace o spisové značce a posledním známém stavu. Verze GetDatapackage01_v01 řeší minoritní problém chybného stavu u některých subjektů s více spisovými značkami. | CZ | |
| 13. | GetNespolehlivyPlatce | individuálně | Webová metoda vrátí seznam všech nespolehlivých plátců DPH. | CZ | |
| 14. | GetStatusPlatceDaneIc | individuálně | Webová metoda vrátí status nespolehlivého plátce DPH a přehled registrovaných bankovních účtů. | CZ | |
| 15. | GetStatusPlatcuDaneIc | dokumentace | individuálně | Webová metoda vrátí seznam stavů plátce daně a zveřejněné aktivní účty subjektů, jejichž ic jsou vložena na vstup metody. Maximální počet ic na vstupu je 1000. | CZ |
| 16. | GetFZScore | dokumentace | individuálně | Vrátí poslední dostupné kreditní skóre ke všem subjektům u kterých je skóre k dispozici. To pro data od roku 2012 včetně. | CZ |
| 17. | GetFinanciUkazateleEurelHermes | dokumentace | individuálně | Vrátí seznam subjektů a jejich hodnocení podle ukazatele EUREL HERMES. | CZ |
| 18. | ImportMonitoringPersonal | dokumentace | individuálně | Webová metoda umožní naimportovat seznam hodnot typu Personal do systému CreditCheck pro monitorování v příslušném typu monitoringu. | CZ |
| 19. | ExportMonitoringGetLatestReportTime | dokumentace | individuálně | Poskytuje informaci o čase posledně vygenerovaného reportu na základě vstupních parametrů. | CZ |
| 20. | ExportMonitoringGetLatestReport | dokumentace | individuálně | Poskytuje data posledního reportu monitoringu na základě vstupních parametrů. | CZ |
| 21. | GetIsirFo | individuálně | Metoda vrátí kompletní přehled subjektů fyzických osob se záznamem v insolvenčním rejstříku ISIR. Kromě Rč je obsažena i informace o spisové značce, čase vydání posledního záznamu a posledním známém stavu. | CZ | |
| 22. | GetIsirFOJPDn | individuálně | Metoda vrátí kompletní přehled subjektů fyzických osob se záznamem v insolvenčním rejstříku ISIR. Kromě datumu narození fyzické osoby je ve výstupu obsažena i informace o jménu a příjmení subjektu, spisové značce, čase vydání posledního záznamu a posledním známém stavu. | CZ | |
| 23. | ImportMonitoring | dokumentace | po dohodě zdarma | Metoda která umožňuje manipulovat s množinami dat pro definice monitoringů jejichž vstupem je IČ. | |
| 24. | GetZanikleSubjektyByParam | dokumentace | individuálně | Metoda vrací zaniklé a zanikající subjekty k vybranému datu. | |
| 25. | GetSubjectsBasicInfoByName | dokumentace | individuálně | Metoda vrací základní informace (název, ič, adresa, semafor) pro všechny subjekty s hledaným názvem. | |
| 26. | GetCreditChecksIcs | dokumentace | po dohodě zdarma | Vrací stejná data jako metoda GetCreditChecks, pouze filtruje výstupní množinu subjektů dle vstupní kolekce v parametru listOfIcs. | CZ |
| 27. | individuálně | Vrací SubjectFullReport v PDF formátu. |
Přehled metod pro Slovensko najdete zde WS CreditCheckAktualizace - SK.
Semafor 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
| Chyba | Popis | Řešení |
|---|---|---|
| 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. |
Testovací nástroje ke stažení
PŘIPRAVUJEME
Interní dokumentace
Neveřejná část, /wiki/spaces/CREDS/pages/656511.