GetCreditCheckIc - SK
Tato webová metoda Webové služby CreditCheckAktualizace je poskytována zdarma.
Tato webová metoda vrací seznam hodnocení vybraného subjektu. Jsou vybrány pouze záznamy, které splňují podmínku hodnocení CreditChecku vyšší než 1. Webová metoda vrací datový string, který je však reprezentací jednoduchého Xml formátu. 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.sk/"> <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 |
---|---|---|
ic | string | IČO subjektu, jehož stavy požadujeme. |
Omezení
Tato metoda povoluje jednomu unikátnímu uživateli maximálně 200 dotazů za 24 hodin.
Výstupní data
<creditCheck> <webMethod>GetCreditCheckIc</webMethod> <country>SK</country> <time>28.7.2010 6:12:38</time> <count>1</count> <data> <![CDATA[23585;25865366;3]]> </data> </creditCheck>
Popis elementů
Název | Popis |
---|---|
webMethod | název webové metody, která vrátila data |
country | země zdrojových dat |
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: 23585;25865366;3 kde 23585 = id záznamu, 25865366 = ičo subjektu, 3 = hodnocení - CreditCheck
Poznámky:
Formát a oddělovače dat můžou být na základě klientského požadavku změněné. Záznamy jsou unikátní podle identifikátoru subjektu a jeden subjekt nemůže mít více záznamů s různým hodnocením.
Tato metoda vrací kromě statusů 2,3 i status 4. Tomuto statusu odpovídá v grafické sekci dokumentace semafor „Žádné nebo chybné IČ“. Tato odpověď bude vrácena v případě chybně zadaného IČ, nebo IČ, které nemá Creditcheck v DB (tento případ by ale teoreticky neměl nastat).