Ucelený a praktický sprievodca implementáciou e-fakturácie u zákazníka.
Cieľ: praktický návod na zabezpečenie technickej a procesnej pripravenosti zákazníka.
Prehľad fáz implementácie:
Fáza 1: Nastavenie prostredia
Fáza 2: Registrácia, balík a aktivácia
Fáza 3: Pripojenie systému a Peppol
Fáza 4: Vyčistenie systému a číselníkov
Fáza 5: Vystavenie e-faktúry a prvé použitie
Fáza 6: Prijatie e-faktúry
| Krok | Čo sa robí | Kto | Hotovo, keď |
|---|---|---|---|
| 1 | Nastavenie prostredia | Zákazník, Konzultant, DBA | Verzia 26.6, DB 19c, QASIDA.API beží, port 5671 otvorený |
| 2 | Registrácia na Finančnej správe (FS) | Zákazník | Zvolený APEX, prišlo potvrdenie FS |
| 3 | Výber a objednanie balíka | Správca portálu | Objednávka dokončená v Asseco Store |
| 4 | Úhrada a aktivácia balíka | Zákazník | Úvodná faktúra uhradená, balík je Aktívny |
| 5 | Pripojenie systému | Správca portálu | Certifikát a QHUB pripojený (alebo API klient) |
| 6 | Aktivácia prístupu do siete Peppol | Správca portálu | Stav Aktívny, firma sa nájde pod 0245:DIČ |
| 7 | Vyčistenie číselníkov a nové evidencie | Zákazník | Číselníky a evidencie doplnené (môže bežať súbežne s krokmi 2 až 6) |
| 8 | Vystavenie prvej e-faktúry | Zákazník | Stav Úspešne odoslaná |
| 9 | Prijatie e-faktúr | Zákazník | Doklad Prenesený do knihy faktúr |
Zákaznícky portál sleduje päť krokov pripravenosti: registrácia na FS, výber balíka, aktivácia balíka, pripojenie systému a prvý doklad cez APEX. Aktivácia Peppol je samostatná karta v Správe.
Čo treba urobiť: Zabezpečiť súlad infraštruktúry s požiadavkami e-faktúry.
Postup
| Oblasť | Požiadavka |
|---|---|
| Verzia systému | QASIDA/SPIN2 26.6, ideálne 26.6.FIX_1 |
| Databáza | 19c (pri QASIDA START výnimočne Express 18 alebo 21) |
| QASIDA.API | Nová verzia (od 26.6) s podporou autoupdate. Pre certifikáty z portálu je potrebná 26.6.5 alebo novšia |
| Odchádzajúca sieť | Otvorený port 5671 smerom do internetu, inak neodídu správy |
| Konektivita | Overiť všetko, čo QASIDA.API potrebuje, vrátane certifikátov |
| Spojenie s APEX | Nastavuje sa na strane APEX Digitálneho poštára, pozri Fázu 3 |
Systémové požiadavky: QASIDA.API – Systémové požiadavky
Inštalátor je pre Windows, pre Linux formou skriptov: QasidaApiInstaller.exe. Používateľská príručka: Qasida API inštalátor.
Prvá inštalácia (systém sa inštaluje nanovo)
Aktualizácia už fungujúceho systému
Ak na zvolenom porte beží QASIDA API pod IIS, inštalátor to zistí sám a ponúkne jej nahradenie službou Windows.
appsettings.json (prihlasovacie údaje, Data Source, mandant).%ProgramData%\Asseco\QasidaApiInstaller\Backup ako ZIP zašifrovaný heslom pre update DB (AES-256; otvoríte ho 7-Zipom alebo WinRARom, Prieskumník Windows ho neprečíta).Obmedzenie: ak je QASIDA API v IIS len aplikáciou pod cudzou stránkou, inštalátor port uvoľniť nedokáže (patrí bindingu tej stránky) a inštaláciu odmietne. Riešením je ručne odstrániť binding na daný port v IIS Manageri, alebo zvoliť pre API iný port.
Automatická aktualizácia
Aby sa databáza a klient Qasida Spin aktualizovali sami, musí API bežať ako služba Windows, nie cez IIS. Klientske nastavenia v appsettings.json zostanú zachované. Pre odosielanie správ o aktualizáciách musí mať klient nastavené aspoň e-maily. Inštalátor si skontroluje, či sú povolené automatické aktualizácie databázy alebo odosielanie štatistík (metrík).
Internetové pripojenie (prepojenie e-faktúry)
Klient musí mať na internetovom pripojení otvorený port 5671 smerom von. Bez toho nebudú odchádzajúce správy fungovať. V prípade problémov kontaktuje zákazník svojho IT správcu. Overenie konektivity: Inštalácia certifikátov na Windows (dolu na stránke).
Na čo si dať pozor: inštaláciu API môže vykonať ktokoľvek s administrátorským prístupom na cieľovom zariadení, aj zákazník. Overte dostupnosť verzie a prípadných fixov (aktuálne 26.6).
V zákazníckom portáli vidí firma cestu k e-faktúre na Dashboarde (panel Pripravenosť na e-faktúru: odpočet do 1. 1. 2027 a päť krokov) a na stránke Nákup. Panel sa firme bez slovenského DIČ a bez balíka neukáže a po dokončení všetkých krokov zmizne. Pri každom kroku je odkaz Prečo a ako?, ktorý otvorí pomoc rovno na kapitole kroku (čo urobiť, prečo, kto, ako zistiť, že je hotovo, kde v portáli).




Ostrý účet v APEX zakladá webhook FS (tenant podľa IČO), nie portál. Ručne založený účet potvrdenie FS nepošle. Firma registrovaná dávnejšie má krok hotový aj bez viditeľného potvrdenia, ak už má účet v APEX.
Postu vyberu a objednania digitalneho postara
Používateľská príručka FS: príručka PDS. Interný návod na registráciu v APEX Sandbox: Internal Asseco Solutions Wiki.


Poznámky: Starter vyžaduje povinný Invoice Manager (účtuje sa za používateľa). Druhý balík sa nekupuje, mení sa existujúci. Do 31. 12. 2026 beží úvodná akcia, potom bežná cena. Sumy na snímkach v zdrojovej príručke sú testovacie, aktuálne ceny overte v Asseco Store.
Postup výberu a objednania: wiki.

Nikdy ručne: licenciu neaktivujte ručne, APEX by ju nevidel. Ak je zaplatené, FS potvrdila a balík stále čaká, pozrite sekciu Podpora.
Nastavuje správca portálu v E-faktúra → Správa → Pripojenie systému. Sandbox a Produkcia majú každé vlastné pripojenie; ráta sa len Produkcia.

| Systém | Čo je potrebné | Hotovo, keď |
|---|---|---|
| SPIN, QASIDA ERP | QASIDA.API 26.6.5 alebo novšia, certifikát a pripojenie cez QHUB | Platný certifikát v produkcii a QHUB Pripojené (samotný certifikát nestačí) |
| HELIOS iNuvio | Prístup cez API a APEX Agent na serveri zákazníka | Aktívny API klient v produkčnom APEX |
| Iný systém | Len prístup cez API | Aktívny API klient v produkčnom APEX |
SPIN a QASIDA ERP: certifikát a potom QHUB




Bez QHUB sa QASIDA.API do APEX neprihlási. Prehľad v portáli si pamätá certifikáty 5 minút a APEX 60 sekúnd, nový certifikát sa teda ukáže do 5 minút, kľúč z QASIDA ERP do minúty. Ak sa pripojenie nedá overiť, krok platí ako hotový, ak už cez APEX prešiel doklad.
https://wiki.assecosolutions.sk/sk/home/public/asseco-peppol/Pripojenie-digitálneho-poštára-Asseco
Karta Prístup do siete Peppol v Správe (vidí ju a ovláda iba správca, platí len pre produkciu; sandbox nie je pripojený do siete Peppol).
Podmienky aktivácie: registrácia na FS, aktívny balík a aspoň jeden funkčný prístup. Krížik pri podmienke vypne tlačidlo; pomlčka znamená „nedá sa overiť“ (zdroj neodpovedal) a tlačidlo nevypne.

Po aktivácii partneri nájdu firmu pod Peppol ID 0245:DIČ a zmena sa zapíše do Histórie zmien. Po chybe (štítok Chyba) stačí aktivovať znova.

Pozor: Deaktivovať prístup nič nevypína. Začne presun Peppol ID k inému poskytovateľovi a vydá kód na presun, ktorý je v karte počas celého presunu. Presun sa dá zrušiť (Zrušiť presun).
Prepojenie v Qaside je nutné aktivovať cez Administrácia - Synchronizácia s Cloud ERP

E-faktúra vyžaduje prísnu dátovú štruktúru podľa normy EN 16931. Táto fáza je nezávislá a môže bežať súbežne s fázami 2 a 3.
Čo treba urobiť: doplniť informácie do kľúčových číselníkov. Ak kódy, prípadne popisy pre e-faktúru chýbajú na faktúre, doklad neprejde validáciou.
| Číselník | Čo urobila aktualizácia | Čo musí doplniť konzultant |
|---|---|---|
| Merné jednotky | Skriptami doplnený kód pre e-faktúru pri identifikovaných jednotkách | Chýbajúce kódy ručne podľa UN/ECE Rec 20 (napr. C62 = kus) |
| Štáty, mestá, kraje | Doplnený kód pri identifikovaných štátoch | Chýbajúce kódy podľa ISO 3166-1 |
| Druhy dokladov | Nastavenie Použitie v e-faktúre rozšírené; predvolene Export aj Import | Pri potrebe obmedziť na len Import, len Export alebo vôbec; robí sa pre každého mandanta samostatne |
| Položky daňových dokladov | Doplnený kód pre e-faktúru | Pri nedaňovej položke doplniť Kód dôvodu a Popis dôvodu oslobodenia od DPH podľa VATEX |
Duplicity v číselníkoch je možné zlúčiť akciou Zlúčenie označených riadkov. V číselníkoch Merné jednotky, Štáty a Položky daňových dokladov pribudol príznak Používané, ktorým si klient vyselektuje len to, čo reálne využíva.
Dokumentácia: Merná jednotka, Štát, mesto, kraj, Druh dokladu.
Merné jednotky
Kód pre e-faktúru

Zlúčenie duplicít

Štáty, mestá, kraje
Kód pre e-faktúru

Zlúčenie duplicít

Druhy dokladov
Použitie v e-faktúre

Položky daňových dokladov
Kód pre e-faktúru, Kód dôvodu oslobodenia, Popis dôvodu oslobodenia

Pravidlá pre kód kategórie DPH a VATEX


Na čo si dať pozor – kvalita dát partnerov: skontrolujte IČO, DIČ a IČ DPH. Nekvalitné dáta znamenajú riziko nedoručenia faktúry. Pre smerovanie v sieti Peppol sa v SR používa schéma 0245 + DIČ číslo.
Podrobný návod: Odberateľská faktúra
Kde sa používateľ nachádza: Modul Fakturácia → Odberateľská faktúra.













Na čo si dať pozor: proforma faktúra sa cez Peppol neposiela. Faktúra k prijatej platbe (DD1) sa posiela; ak neobsahuje MJ a Označenie dodávky, treba ich doplniť ručne.


Faktúry od dodávateľov už neprichádzajú ako PDF e-mailom, ale v štruktúrovanom XML formáte priamo do spracovateľského okna.
Kde to nájdete: Modul Fakturácia → Import / Export → E-faktúra import.









Dokumentácia: E -faktúra Import, Dodávateľská faktúra.
| Správca portálu (rola ADMIN v CUSTOMERPORTAL) | Bežný používateľ | |
|---|---|---|
| Balík | Objednáva, mení balík a viazanosť | Nič neobjedná ani nezmení |
| Sumy | Vidí sumy, VS a najbližšiu platbu | Nevidí ich |
| Správa | Má záložku Správa: certifikáty, QHUB, prístup cez API, sandbox | Záložku nemá |
| Peppol | Aktivuje a deaktivuje prístup | Nemôže |
| Pomoc | Vidí aj Ako na to | Vidí stav krokov a Ako na to; v Kto čo smie uvidí „Nie ste správca portálu“ |
Rozdiel je zámer, nie chyba. Ak správca nevidí Správu alebo akcie zlyhávajú (HTTP 401), token nemá ADMIN v CUSTOMERPORTAL: overte autority v IAM, odhláste a znova prihláste.
Keď zdroj neodpovie, portál to hlási (polia „—“, pomlčky pri podmienkach). Nikdy to neznamená, že zákazník balík alebo registráciu nemá.
| Príznak | Príčina | Riešenie |
|---|---|---|
| „Prehľad e-faktúry sa nepodarilo načítať.“ | Zlyhalo celé volanie backendu portálu | Skúsiť znova; ak trvá, logy backendu a DevOps portálu |
| „Údaje o balíku, registrácii a spotrebe sa teraz nepodarilo získať…“ | Store neodpovedal do 15 s, alebo nedosiahol ALIS | Skúsiť o chvíľu; pri dlhšom výpadku Store |
| „Či je systém už pripojený, sa teraz nedá overiť.“ | APEX (5 s), Cert Provider (10 s) alebo ALIS (10 s) neodpovedal | Podľa logov: tím APEX, správca Cert Providera, tím Store |
| Peppol ID „Zatiaľ neznáme“ / „Vo firemných údajoch chýba slovenské DIČ…“ | ALIS nedal DIČ, alebo ho firma nemá | Doplniť DIČ v ALIS |
| Po oprave Prehľad ukazuje starý stav | Cache: APEX 60 s, certifikáty 5 min | Počkať a obnoviť |

Zmena balíka a viazanosti (testovacie údaje)