GetSubjectsBasicInfoByName - SK

Webová metoda vrací základní informace o subjektech, jejichž aktuální název odpovídá hledanému řetězci (vstupní parametr metody). Metoda není volně přístupná a pro její využívání je nutné kontaktovat naši podporu.


Vstupní parametry

  1. CreditCheckHeader
  2. nazev - Název hledaného subjektu, více informací viz. Logika hledání




Výstupní data


ID elementuNázevPopis
nazevNázevAktuální název subjektu
icIčoIdentifikační číslo obchodníka
denVznikuDen vznikuDen ke kterému vznikl subjekt. Tzn. den ke kterému byl subjekt zapsán do odpovídajícího registru (Ržp, OR atd..)
uliceUliceUlice
cpČíslo popisnéČíslo popisné
mestoMěstoMěsto
pscPSČPoštovní směrovací číslo
semaforSemaforStatus subjektu v systému CreditCheck. Více informací najdete zde


Logika hledání

  • Subjekty jsou v databázi prohledávány na základě částečné shody zleva se vstupním parametrem nazev.
    • Částečná shoda zleva úspěšně vrací všechny subjekty s přesnou shodou názvu a subjekty jejichž název začíná hledaným řetězcem.
    • Tzn. pokud zvolíme hledaný řetězec např. "Elekt", potom dohledaná množina subjektů může obsahovat např. 
      • Elekt
      • Elekt a.s.
      • Elektra spol.
      • Elektro s.r.o.


Limitace metody

  • Metoda vrací vždy množinu o maximálním počtu 100 subjektů.
    • Výsledná množina je seřazena podle počtu znaků v názvů, aby bylo zajištěno, že do limitu budou prioritně zařazeny subjekty které nejblíže odpovídají hledanému řetězci.
  • Pro zajištění vysoké responsivnosti (krátké odezvy), metoda pracuje s kešovanou množinou dat, která je aktualizována 1x denně. Tzn. může se stát, že informace které metoda vrátí na výstupu nemusí být již aktuálně platné. Nicméně vzhledem k datům, která metoda vrací viz. Výstupní data, by tato situace měla nastávat velmi zřídka.
  • Vyhledávání probíhá pouze na základě aktuálních názvů subjektů (tzn. historické názvy subjektů nejsou brány v potaz).
  • Zřídka se může stát, že pro subjekt metoda vrátí více než 1 záznam. To v případě, že u daného subjektu evidujeme více než 1 aktuální adresu sídla. Může jít např. o dočasný rozpor v datech mezi registry apod. tento typ problémů bývá v krátkém časovém horizontu automaticky vyřešen.
  • Metoda pracuje pouze s množinou subjektů, které mají IČO, tzn. nevrací informace o "čistě" fyzických osobách.
  • Metoda není volně přístupná a pro její využívání je nutné kontaktovat naši podporu.



Definice pro volání metody

POST /CreditCheckAktualizace.asmx HTTP/1.1
Host: creditwebservices.creditcheck.sk
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://creditcheck.sk/GetSubjectsBasicInfoByName"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <CreditCheckHeader xmlns="http://creditcheck.sk/">
      <Login>string</Login>
      <Password>string</Password>
    </CreditCheckHeader>
  </soap:Header>
  <soap:Body>
    <GetSubjectsBasicInfoByName xmlns="http://creditcheck.sk/">
      <nazev>string</nazev>
    </GetSubjectsBasicInfoByName>
  </soap:Body>
</soap:Envelope>