ARES – IČO

Administrativní registr ekonomických subjektů je informační systém Ministerstva financí, který umožňuje vyhledávání veřejných informací o ekonomických subjektech registrovaných v České republice. Zprostředkovává zobrazení údajů vedených v jednotlivých informačních systémů státní správy, ze kterých čerpá data (tzv. zdrojové registry).Nejedná se tedy o primární zdroj informací.

Ekonomické subjekty, které z jakéhokoli důvodu nemají uvedené IČO a nelze je jednoznačně identifikovat, nemusí být zobrazené (nalezené).

Identifikační číslo osoby (IČO) je v České republice unikátní osmimístné identifikační číslo právnické osoby, podnikající fyzické osoby nebo organizační složky státu.

Pro větší efektivitu práce je vhodné vlastnit také prerekvizitu Addin CEO.

Subjekt

Subjekt je daná osoba nebo firma s IČO, vyskytující se v registru.

Stavy subjektu

Import – Byly nalezeny výsledky, provést import

Negative – Nenalezeny žádné výsledky

Error – Nastala chyba

Done – Subjekt již byl úspěšně naimportován

InvalidICO – Nevalidní IČO

ValidICO – Platné IČO

InvalidAdres – Adresa se neshoduje

Skip – Nepovedlo se připojit na stránky, subjekt je přeskočen

Import

Výsledky importu závisí na informacích dodaných addinu ke zpracování, také může záviset na stavu subjektu.

Beze změny – addinem není provedena žádná nová změna

Změna – addin provedl změnu dat nebo je změnu nutno provést ručně

Error – vyskytla se obecná chyba, např.chybí data, při které se obvykle vytvoří úkon „Úkol pro“

Pozitivní – lustrace proběhla úspěšně, byl stažen soubor s odpovědí

Negativní – lustrovaný subjekt není veden v cizí databázi, nelze tedy o něm získat informace

Fáze druhá a třetí

U subjektu addin v databázi kontroluje stav, jestliže je stav jiný než Import, Negative, Error, Done, InvalidICO, ValidICO, InvalidAdres nebo Skip automaticky je subjekt přeskočen.  Nemá-li vyplněno datum narození subject.Born=null, stav subjektu bude Negative s oznámením „Subjekt nemá uvedeno datum narození!. Nemůžeme dohledat a ztotožnit IČO.“ a je přeskočen. Totéž platí u trvalé adresy, pokud v databázi nejsou nalezeny hodnoty, addin nahlásí  „Subjekt nemá trvalou adresu! Nemůžeme dohledat a ztotožnit IČO.“, Výsledkem je stav subjektu Negative a následuje lustrace dalšího subjektu.

Pokud všechny předchozí kontroly proběhnou úspěšně, jsou addinem hodnoty Jméno, Příjmení a Datum narození zadány do vyhledávače na stránce https://www.rzp.cz/cgi-bin/aps_cacheWEB.sh?VSS_SERV=ZVWSBJFND

K nedohledání subjektu může dojít pokud nejsou zadána všechna kritéria správně, nebo vyhledávání žádný subjekt neodpovídá „Subjekt nebyl nalezen na rzp.cz“. Následně se kontroluje IČO v databázi viz. níže. Další možností je Chyba 403. Tato chyba se vyskytuje pokud jsou příliš rychle požadovány informace ze stánky Rzp, tvoří ochranu webu vůči opakovaným requestům. Při této chybě se bude opakovat požadavek 10- krát, přičemž se bude prodleva mezi požadavky zvětšovat, addin zobrazí „Počkám {counter*1000} sekundy a zkusím znovu“. Pokud stále chyba přetrvává, nastaví se poté stav subjektu na Skip.

Pokud je subjekt nalezen vrací se kolekce subjektů odpovídajících vstupním parametrům ve kterých addin vyhledává ten správný, dle trvalé adresy s hlášením „Nalezlo se {foundSubjects.Count()} možných subjektů na rzp“, „Kontroluji dle adresy“. Primárně se používá adresní kód získaný z procky GetUIADRForAISEO. Addin dále vrácenou adresu ve formátu HTML zpracovává. Když nastane chyba a odpověď má IsNullOrEmpty, adresa se přeskočí s upozorněním „Nepodařilo se připojit na stránky“. Pokud vrácená adresa přesně odpovídá té v databázi, stav subjektu je změněn na Import s informací „Podařilo se ztotožnit dle adresy“ a uloženy nové hodnoty
Born = Subject.Born,
IdClient = Subject.ClientID,
Name = Subject.Name,
Surname = Subject.Surname,
ICO = ICO.Trim()
Adress = adress
dále uloží serializované IČO do XML souboru. Částečně shodná adresa znamená že se shodují alespoň 3 z 5 hodnot v adrese: Město, Ulice, Číslo domu, PSČ, CE. Poté se změní subjekt stav na InvalidAdres zobrazí se úkon s textem „Adresy se částečně rovnají, proveďte kontrolu ručně! Adresa: {adress}. ICO: {ICO}“. V případě neshodujících se adres dochází ke kontrole IČO. Ještě před tím zkontroluje, zda ve staženém dokumentu není varování. Tehdy by nebylo možné provádět kontrolu IČO.

V databázi by mělo být uvedeno IČO, jestliže není, je stav změněn na Negative s upozorněním „Subjekt nebyl nalezen na rzp.cz“ a lustrace subjektu končí. Když IČO uvedeno je, provede se ověření jeho platnosti. Zobrazí-li se „Subjekt má neplatné IČO {IČO}„ je dané IČO nevalidní, stav subjektu se změní na InvalidICO a lustrace subjektu končí. Pokud se žádné upozornění nezobrazí je IČO platné, tak se zjišťuje zad patří subjektu v databázi. To se provádí pomocí Jména, Příjmení, Data narození a Adresy. Nastane-li shoda stav subjektu se změní na ValidIco a končí činnost. Když shoda není, změní se stav na InvalidICO společně s upozorněním „Uvedené IČO {IČO} nepatří klientovi {Jméno}. Proveďte Kontrolu!“ a zase ukončí činnost druhé fáze u subjektu.

Třetí fáze je sloučena do druhé, neboť pouze kontroluje zda nedošlo u některého subjektu k chybě, která by neumožňovala posun do čtvrté fáze, v tom případě subjekt zůstává v druhé fázi. Ostatní pokračují dále.

Vyhledávání podle osoby

Vyhledávání podle subjektu

Odpověď v HTML

Odpověď v XML

Čtvrtá fáze

Čtvrtá fáze začíná stejně jako druhá u stavu subjektu. Pokud subjekt má stav Done je čtvrtá fáze ukončena a tím i celá činnost addinu. Subjekt má na začátku fáze stav Done nebo Skip automaticky se přeskakuje a fáze končí. Stav Negative značí, že výsledek lustrace bude negativní a stav změněn na Done. Nastane–li InvalidAdres neimportuje se nic. Vytvoří se pozitivní odpověď lustrace s úkolem pro uživatele o provedení kontroly adresy, stav taktéž přejde na Done. InvalidICO mohou způsobit chyby s hlášením: „IČO {IČO} je neplatné. Prověďte kontrolu“ nebo „Uvedené IČO {IČO} nepatří klientovi {jméno}. Proveďte kontrolu!“. Výsledkem lustrace je změna a stav Done, ale IČO není z databáze odstraněno. Předposledním stavem, který může nastat je ValidICO, což znamená že subjekt se nepodařilo dohledat v databázi, ale jeho IČO je platné a patří mu. Lustrace končí s výsledkem Beze změny a stav subjektu je přepnut na Done. Stav Import přejde rovnou k importu XML souboru s jménem lustrovaného subjektu. Pokud addin nenalezne soubor xmlFile=null výsledkem lustrace bude Error s textem „Nepodařilo se najít soubor XML“ v úkonu pro uživatele a stav subjektu Done.

Po načtení XML nastane kontrola IČO v databázi. Jestliže není IČO v databázi, je nutné u klienta vyplnit IČO(client.IČO=Ares.ICO), Upraveno(client.Upraveno=DateTime.Now) a Upravil(client.Upravil=„ES ARES_ICO“). Výsledek lustrace se správným IČO bude Pozitivní s hlášením „Nalezeno IČO: {IČO}“ a stav subjektu Done.
V opačném případě navíc při shodě s IČO v databázi, lustrace zobrazí výsledek Beze změny a stav Done. Pokud shoda nenastane, u lustrace je Změna a u klienta vyplnit IČO(client.IČO = Ares.ICO), Upraveno(client.Upraveno=DateTime.Now) a Upravil(client.Upravil=„ES ARES_ICO“).  „Subjekt měl uvedené špatné IČO. Nastala změna IČO z {IČO_old} na{IČO_new}“ a změna stavu subjektu na Done.