GetCreditChecksIcs

GetCreditChecksIcs


Tato webová metoda je obdobou metody GetCreditChecks. Stejně jako uvedená metoda vrací seznam subjektů a jejich hodnocení. Jsou vybrány pouze záznamy, které splňují podmínku hodnocení CreditChecku vyšší než 1 a subjekt není zaniklý před specifickým datumem. 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ě.

Výsledek této metody nemusí obsahovat všechny IČO která jste na vstupu zadali. Tzn. tuto metodu nelze použít pro ověřování existence vybraného IČ apod.
Důvody proč se IČO ve výsledku nemusí vyskytovat:

  • Subjekt má zelený semafor (tzn. neevidujeme u něho žádná rizika)

  • Subjekt zanikl před delší dobou (viz. úvodní popis na této stránce)

  • Subjekt v naší databázi zatím neevidujeme (např. velmi čerstvě založený subjekt)

 

 

Oproti metodě GetCreditChecks se liší v tom, že navíc výslednou množinu filtruje podle vstupní kolekce ič získané z parametru ListOfIcs. Tzn. ve výsledku tato metoda vrací pouze subjekty které jsou výsledkem průniku metody GetCreditChecks a Vámi definované vstupní množiny/kolekce subjektů.

 

 

SOAP header

 

Soap Header
<soap:Header> <CreditCheckHeader xmlns="http://creditcheck.cz/"> <Login>string</Login> <Password>string</Password> </CreditCheckHeader> </soap:Header>

 

Popis elementů 

Název

Popis

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

name

type

name

type

listOfICs

string

 

listOfICs - řetězec za sebou jdoucích IČ oddělených pomocí středníku. Např.

Ukázka vstupních parametrů

66554942;12831689;26349680;63281708

Pozor, je důležité uvádět hodnoty (IČO) bez mezer a ve své validní podobě (tzn. včetně 0 na začátku).

Řetězec jako např: 66554942; 831689 není platný a nebude fungovat korektně.

Ukázku výstupních dat a vysvětlivky jednotlivých hodnot najdete v dokumentaci související metody: GetCreditChecks.

 

 

Kompletní POST request

POST /CreditCheckAktualizace.asmx HTTP/1.1

Host: creditwebservices.creditcheck.cz

Content-Type: text/xml;charset=UTF-8

Content-Length: length

SOAPAction: "https://creditwebservices.creditcheck.cz/GetCreditChecksIcs"

 

 

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

    <soap:Header>

        <CreditCheckHeader xmlns="https://creditwebservices.creditcheck.cz/">

            <Login>{login}</Login>

            <Password>{password}</Password>

        </CreditCheckHeader>

    </soap:Header>

    <soap:Body>

        <GetCreditChecksIcs xmlns="https://creditwebservices.creditcheck.cz/" >

            <listOfICs>26840359;45317054;13654875</listOfICs>

        </GetCreditChecksIcs>

    </soap:Body>

</soap:Envelope>