GetSubjectsBasicInfoByName - CZ

Owned by Former user (Deleted)
Last updated: Sept 29, 2020
2 min read

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.


29.9.2020

Pozor, 29.9.2020 došlo k zásadní změně chování metody pro CZ data. Více informací o této změně se dozvíte zde:

  • pro CZ data přidána 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.
    • Nově zde naopak může vzniknout problém v tom, že pro daný subjekt zatím nemáme adresní údaje z primárního registru.
      1. Typicky např. v situaci, kdy u subjektu došlo k tzv. "přechodu" z jednoho registru do jiného, např. při změně právní formy. Tento problém je automaticky řešen v rámci běžné aktualizace veškerých údajů, ale je potřeba brát v potaz, že zde může docházet k určité prodlevě.
      2. Dále může k této situaci docházet např. pokud registr poskytuje nevalidní adresní údaje, nebo dokonce neposkytuje žádné adresní údaje.
      3. V obou případech pro takovýto subjekt (u kterého v rámci daného primárního subjektu neznáme aktuální adresní informace) nebude metoda vracet žádný záznam (do vyřešení bodů 1. nebo 2.)
  • Pro SK data tento filtr zatím nebyl implementován.




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>