Komunikácia s verejnou databázou firiem (SK)

V tejto kapitole nájdete:

Pojmom Verejná databáza firiem budeme označovať všeobecnú databázu prevádzkovanú výrobcom systému ABRA Gen na vlastných serveroch a obsahujúcu nejaký register so zoznamom firiem, z ktorého je možné čerpať údaje pri editácii firmy v Adresári firiem (napr. názov, IČO a i.). Databáze je kopií seznamu firem registrovaných v databázi subjektů registrovaných pro daň z příjmu a databáze subjektů registrovaných k DPH. Aktualizácia databázy sťahovaním z RÚZ prebieha automaticky v hodinových intervaloch.

Databáza je umiestnená na serveri firmsk.abra.eu pod správou Zákazníckeho centra

Pre systém ABRA Gen je využívaná na dohľadanie podnikateľských subjektov (firiem) a zistenie základných údajov o nich (napr. názov, IČO a i.). ABRA Gen s touto databázou komunikuje cez svoje Web API.

Z RÚZ sa preberajú nasledujúce údaje:

  • názov firmy,
  • IČO, DIČ
  • adresa sídla (mesto, ulica, PSČ, krajina).

Nevyhnutnou podmienkou prevádzky komunikácie s touto verejnou databázou je funkčné internetové pripojenie. Pre sprevádzkovanie komunikácie je potrebné vykonať základné nastavenie v konfiguračnom súbore nexus.cfg, viď ďalej.

Databáza je umiestnená na serveri firmsk.abra.eu pod správou Zákazníckeho centra výrobcu systému ABRA Gen.

Do verze ABRA Gen 25.0 a starších bylo možné nastavit jiné než výchozí parametry v agendě Firemné údaje, na záložce Obecné, subzáložce Připojení na externí služby.

Čítanie údajov z verejnej databázy sa volá tlačidlom Import z verejnej databázy v detaile firmy v agende Adresár firiem, ktoré je prístupné len v editácii, teda v rámci opravy údajov firmy, kopírovaní firmy alebo pri zadávaní novej firmy.

Pre dopytovanie do verejnej databázy musí byť v údajoch firmy zadané:

  • názov firmy alebo jeho časť (vyžadujú sa minimálne 3 znaky)
  • IČO firmy

Ak sú zadané obe, uprednostňuje sa hľadanie podľa IČO.

Postup je teda nasledujúci:

  • Identifikácia príslušnej firmy:

    • Pokiaľ nie je zadané IČO, vykoná sa dopyt podľa názvu firmy. V tomto prípade sa do databázy vysiela dopyt na nájdenie všetkých vyhovujúcich firiem a odpoveďou je zoznam firiem obsahujúci zadanú časť názvu. Pokiaľ nie je nájdené nič, zobrazí sa o tom informačné hlásenie. Pokiaľ je nájdených viac firiem ako jedna, zobrazí sa zoznam všetkých nájdených firiem so základnými identifikačnými údajmi. Z tohto zoznamu môže užívateľ vybrať (dvojklik myšou v zozname alebo tlačidlom OK). Pokiaľ databáza vráti jedinú firmu, dialóg s výberom firiem sa preskočí a táto jediná firma sa považuje za vybranú. Po výbere firmy nasleduje otázka na detailné údaje o firme na základe získaného IČO (viď ďalej).

      Príklad zobrazenia okna so zoznamom nájdených firiem vyhovujúcich zadanému názvu alebo jeho časti

    • Pokiaľ je zadané IČO, považuje sa za jednoznačnú identifikáciu firmy a nasleduje rovno otázka na detailné údaje o firme podľa tohto IČO.
  • Ak je identifikovaná vybraná firma, vykonáva sa do databázy podľa tohto IČO a užívateľovi je zobrazené v modálnom dialógovom okne porovnanie získaných údajov z databázy (v ľavej časti) s aktuálnymi údajmi v systéme ABRA Gen (v pravej časti).

    Z databázy je možné preberať do evidencie v systéme ABRA Gen nasledujúce údaje:

    • názov firmy
    • IČO
    • DIČ

    • ulica, mesto, PSČ, krajina a kód krajiny sídla firmy

      Databáza RÚZ neposkytuje položku IČ DPH. Tým pádom ani vo verejnej databáze firiem prevádzkovanej výrobcom táto položka nie je vyplnená a po importe teda zostane prázdna. Túto položku si užívateľ po importe musí doplniť sám.

Pri údajoch, ktoré sa líšia (medzi verejnou databázou firiem a aktuálnym stavom v systéme ABRA Gen), sa zobrazí na pravej strane začiarkavacie tlačidlo "Prevziať". Jeho začiarknutím môžete ovplyvniť, či chcete údaje z verejnej databázy firiem prevziať do systému ABRA Gen či nie. Pri údajoch, ktoré sú zhodné, je namiesto začiarkavacieho tlačidla len zobrazený text "zhoduje sa".

Príklad zobrazenia okna s porovnaním dát importovaných z verejnej databázy firiem (v ľavej časti okna) voči dátam systému ABRA Gen a s možnosťou nastaviť, ktoré dáta prevziať (v pravej časti okna)

Po potvrdení tlačidlom OK sa požadované nové údaje z verejnej databázy prenesú do rozeditovaného záznamu o firme v agende Adresár firiem a bezodkladne sa zobrazí.

V prípade dočasnej nedostupnosti databázy sa po uplynutí intervalu 30 s zobrazí informačné okno s chybovou hláškou.