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

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.
• 29.9.2020 přidána pro CZ data limitace adresních údajů podle právní formy subjektu. Tzn. že ve výstupu se již nadále nebude stejný subjekt (název) vyskytovat vícekrát s různými adresními údaji. Tento problém byl způsoben nekonzistencí dat mezi veřejnými registry. Pro SK data tento problém zatím nebyl registrován, proto ani pro SK data toto omezení zatím nebylo přidáno.

Definice pro volání metody

POST /CreditCheckAktualizace.asmx HTTP/1.1
Host: creditwebservices.creditcheck.cz
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://creditcheck.cz/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.cz/">
      <Login>string</Login>
      <Password>string</Password>
    </CreditCheckHeader>
  </soap:Header>
  <soap:Body>
    <GetSubjectsBasicInfoByName xmlns="http://creditcheck.cz/">
      <nazev>string</nazev>
    </GetSubjectsBasicInfoByName>
  </soap:Body>
</soap:Envelope>