Komunikace s veřejnou databází firem (SK)
V této kapitole naleznete:
Pojmem Veřejná databáze firem budeme označovat obecnou databázi provozovanou výrobcem systému ABRA Gen na vlastních serverech a obsahující nějaký registr se seznamem firem, z něhož lze čerpat údaje při editaci firmy v Adresáři firem (např. název, IČO aj.). Databáze je kopií seznamu firem registrovaných v Registru účetních závěrek vedeného ministerstvem financí SR. Aktualizace databáze stahováním z RÚZ probíhá automaticky v hodinových intervalech.
K datu 1.1.2017: Register účtovných závierok (RÚZ) - http://www.registeruz.sk/.
Databáze je umístěna na serveru firmsk.abra.eu pod správou Zákaznického centra
Pro systém ABRA Gen je využívána pro dohledání podnikatelských subjektů (firem) a zjištění základních údajů o nich (např. název, IČO aj.). ABRA Gen s touto databází komunikuje přes své Web API.
Z RÚZ se přebírají následující údaje:
- název firmy,
- IČO, IČD
- adresa sídla (město, ulice, PSČ, země).
Nezbytnou podmínkou provozu komunikace s touto veřejnou databází je funkční internetové připojení. Pro zprovoznění komunikace je třeba provést základní nastavení v konfiguračním souboru nexus.cfg, viz dále.
Databáze je umístěna na serveru firmsk.abra.eu pod správou Zákaznického centra výrobce systému ABRA Gen.
Jiné než výchozí parametry připojení je možné nastavit v agendě Firemní údaje, na záložce Obecné, subzáložce Připojení na externí služby.
V minulosti se parametry připojení konfigurovaly v souboru nexus.cfg.
Čtení údajů z veřejné databáze se volá tlačítkem Import z veřejné databáze v detailu firmy v agendě Adresář firem, které je přístupné pouze v editaci, tedy v rámci opravy údajů firmy, kopírování firmy nebo při zadávání nové firmy.
Pro dotazování do veřejné databáze musí být v údajích firmy zadáno:
- název firmy nebo jeho část (vyžadují se minimálně 3 znaky)
- IČO firmy
Je-li zadáno obojí, upřednostňuje se hledání podle IČO.
Postup je tedy následující:
- Identifikace příslušné firmy:
Pokud není zadáno IČO, provádí se dotaz podle názvu firmy. V tomto případě se do databáze vysílá dotaz na nalezení všech vyhovujících firem a odpovědí je seznam firem obsahující zadanou část názvu. Pokud není nalezeno nic, zobrazí se o tom informační hlášení. Pokud je nalezeno více firem než jedna, zobrazí se seznam všech nalezených firem se základními identifikačními údaji. Z tohoto seznamu může uživatel vybrat (dvojklik myší v seznamu nebo tlačítkem OK). Pokud databáze vrátí jedinou firmu, dialog s výběrem firem je přeskočen a tato jediná firma se považuje za vybranou. Po výběru firmy následuje dotaz na detailní údaje o firmě na základě získaného IČO (viz dále).
Příklad zobrazení okna se seznamem nalezených firem vyhovujících zadanému názvu nebo jeho části
- Pokud je zadáno IČO, považuje se za jednoznačnou identifikaci firmy a provádí se rovnou dotaz na detailní údaje o firmě podle tohoto IČO.
- Je-li identifikována vybraná firma, provádí se do databáze podle tohoto IČO a uživateli je zobrazeno v modálním dialogovém okně porovnání získaných údajů z databáze (v levé části) s aktuálními údaji v systéme ABRA Gen (v pravé části).
Z databáze lze přebírat do evidence v systému ABRA Gen následující údaje:
- název firmy
- IČO
- IČD
ulice, město, PSČ, země a kód země sídla firmy
Databáze RÚZ neposkytuje položku DIČ. Tudíž ani ve veřejné databázi firem provozované výrobcem tato položka není vyplněná a po importu tedy zůstane prázdná. Tuto položku si uživatel po importu musí doplnit sám.
U údajů, které se liší (mezi veřejnou databází firem a aktuálním stavem v systému ABRA Gen), se zobrazí na pravé straně zatržítko "Převzít". Jeho zatržením můžete ovlivnit, zda chcete údaje z veřejné databáze firem převzít do systému ABRA Gen či nikoliv. U údajů, které jsou shodné, je namísto zatržítka pouze zobrazen text "shoduje se".
Příklad zobrazení okna s porovnáním dat importovaných z veřejné databáze firem (v levé části okna) vůči datům systému ABRA Gen a s možností nastavit, která data převzít (v pravé části okna)
Po potvrzení tlačítkem OK se požadované nové údaje z veřejné databáze přenesou do rozeditovaného záznamu o firmě v agendě Adresář firem a neprodleně se zobrazí.
V případě dočasné nedostupnosti databáze se po uplynutí intervalu 30 s zobrazí informační okno s chybovou hláškou.