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
- CreditCheckHeader
- nazev - Název hledaného subjektu, více informací viz. Logika hledání
Výstupní data
| Anchor |
|---|
| vystupni_data |
|---|
| vystupni_data |
|---|
|
| ID elementu | Název | Popis |
|---|
| nazev | Název | Aktuální název subjektu |
| ic | Ičo | Identifikační číslo obchodníka |
| denVzniku | Den vzniku | Den ke kterému vznikl subjekt. Tzn. den ke kterému byl subjekt zapsán do odpovídajícího registru (Ržp, OR atd..) |
| ulice | Ulice | Ulice |
| cp | Číslo popisné | Číslo popisné |
| mesto | Město | Město |
| psc | PSČ | Poštovní směrovací číslo |
| semafor | Semafor | Status subjektu v systému CreditCheck. Více informací najdete zde |
Logika hledání
| Anchor |
|---|
| Logika_hledani |
|---|
| Logika_hledani |
|---|
|
- 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.
| Warning |
|---|
|
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.
- 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ě.
- Dále může k této situaci docházet např. pokud registr poskytuje nevalidní adresní údaje, nebo dokonce neposkytuje žádné adresní údaje.
- 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
| Code Block |
|---|
|
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> |