ARES CZ Bridge
Integration between iTop Organizations and the Czech ARES register — search, link and import company data by ICO.
Integrace iTop organizaci s registrem ARES — vyhledavani, napojeni a import firemnich udaju dle ICO.
DescriptionPopis
Integration between iTop Organizations and the Czech ARES (Administrative Register of Economic Subjects) REST API. Enables searching by ICO, linking existing organizations, and creating new ones with imported company data directly from ARES.
Integrace iTop organizaci s registrem ARES (Administrativni registr ekonomickych subjektu). Umoznuje vyhledavani dle ICO, napojeni existujicich organizaci a zakladani novych s importovanymi udaji primo z ARES.
FeaturesFunkce
- Search companies in ARES by ICO (8 digits)Vyhledavani firem v ARES dle ICO (8 cislic)
- "Link to ARES" button in Organization detail menuTlacitko "Napojit na ARES" v detailu organizace
- Banner on Organization create form with ARES lookupBanner ve formulari vytvoreni organizace s vyhledavanim v ARES
- Menu "New Organization from ARES CZ" for creating from ARESMenu "Nova organizace z ARES CZ" pro zalozeni z ARES
- Import: name, ICO, DIC, city, street, postcode, zip, country, countrycodeImport: nazev, ICO, DIC, mesto, ulice, PSC, zeme, kod zeme
- Sync metadata tracking (status, last sync, sync by)Sledovani metadat synchronizace (stav, posledni sync, sync kym)
- KPZ profile field masking for sensitive dataMaskovani poli pro profil KPZ u citlivych dat
- 2-step wizard (search → confirm → import)Dvoustupnovy pruvodce (hledat → potvrdit → importovat)
- EN/CS localizationLokalizace EN/CS
Imported FieldsImportovana pole
| iTop FieldPole v iTop | ARES SourceZdroj ARES |
|---|---|
name | obchodniJmeno |
ico | ico |
dic | dic |
city | sidlo.nazevObce |
street | sidlo.nazevUlice + cisloDomovni/cisloOrientacni |
postcode | sidlo.psc |
zip | sidlo.psc |
country | sidlo.nazevStatu |
countrycode | sidlo.kodStatu |
ConfigurationKonfigurace
Optional configuration in config-itop.php section jpnet-arescz-bridge: base_url (default: ARES public API), timeout (default: 20s). The module uses the public ARES REST API, no authentication required.
Volitelna konfigurace v config-itop.php sekci jpnet-arescz-bridge: base_url (vychozi: verejne API ARES), timeout (vychozi: 20s). Modul pouziva verejne REST API ARES, neni potreba autentizace.
InstallationInstalace
Copy to extensions/, run setup. The Organization menu group and ARES link appear automatically.
Zkopirujte do extensions/, spustte setup. Skupina menu Organizace a odkaz na ARES se objevi automaticky.
Revision HistoryHistorie verzi
| DateDatum | VersionVerze | ChangesZmeny |
|---|---|---|
| 2026-04-08 | 2.1.0 | Migrated from ABRA GEN to ARES REST API, renamed to jpnet-arescz-bridgeMigrace z ABRA GEN na ARES REST API, prejmenovano na jpnet-arescz-bridge |
| 2025-xx-xx | 2.0.0 | Initial ABRA GEN integration (legacy)Puvodni integrace ABRA GEN (legacy) |
LimitationsOmezeni
Currently only ICO search is supported (exact 8-digit match). Full-text search by company name will be added in a future version.
V soucasnosti je podporovano pouze vyhledavani dle ICO (presna 8-mistna shoda). Fulltextove vyhledavani dle nazvu firmy bude doplneno v dalsi verzi.