Pojmy, s ktorými sa pri integrácii eKasy stretnete najčastejšie. Pri každom je odkaz na článok, ktorý ho vysvetľuje podrobnejšie.
Pokladnica a úložisko
ORP, kód pokladnice
On-line registračná pokladnica. Každá má kód pokladnice (17 číslic, napríklad 88812345678900001), ktorý jej
pridelí finančná správa. V API je to vlastnosť cashRegisterCode. Kódy začínajúce 888123456 patria integračnému
prostrediu (Príprava a test).
SORP
Softvérová on-line registračná pokladnica podľa zákona č. 384/2025 Z. z. Na rozdiel od ORP s úložiskom CHDÚ nemá offline režim. eKasa od Nine Digit je ORP.
PPEKK, .NET knižnica
Pokladničný program e-kasa klienta, teda certifikovaný program, ktorý doklady zapisuje, podpisuje a odosiela.
V eKase je to .NET knižnica NineDigit.eKasa, ktorú používa služba aj aplikácia pre Android. Pozri
Ako funguje eKasa.
CHDÚ
Chránené dátové úložisko. Uchováva identifikačné a autentifikačné údaje pokladnice a záznam každej dátovej správy. Modely CHDU Lite, CHDU-SK a SwissBit opisuje Úložisko a zostavy.
In-Memory úložisko
Úložisko v pamäti na vývoj a testovanie bez hardvéru. Doklady tlačí do PDF a po reštarte služby ich zabudne. V ostrej prevádzke sa nepoužíva (Príprava a test).
Tabuľka indexov
Pomocný register v úložisku, podľa ktorého eKasa rýchlo nájde doklad (napríklad podľa externalId) a stráži
jedinečnosť externalId (Ochrana pred duplicitou).
Prenosná pokladnica
Pokladnica, ktorá sa používa na rôznych miestach, napríklad na trhoch alebo v taxíku. Pred začiatkom predaja musí mať zaregistrovanú polohu (Registrácia polohy).
Údaje podnikateľa
Identifikačné údaje
Údaje podnikateľa a pokladnice (názov, DIČ, IČO, adresa, kód pokladnice), ktoré sa tlačia v hlavičke dokladu. Podnikateľ ich stiahne z portálu finančnej správy.
Autentifikačné údaje, certifikát
Certifikát a súkromný kľúč, ktorými eKasa podpisuje dátové správy. Platia 2 roky a 30 dní pred koncom platnosti na to pokladnica upozorní (Kontrola stavu systému).
Inicializačný balík
Identifikačné a autentifikačné údaje spolu, ktoré sa pri uvedení pokladnice do prevádzky vložia do úložiska (Príprava a test).
Doklad
Dátová správa
Doklad alebo registrácia polohy v podobe, v akej ich eKasa podpíše, zapíše do CHDÚ a odošle do systému eKasa.
Systém eKasa
Systém finančnej správy, ktorý prijíma dátové správy z pokladníc a dokladom prideľuje unikátny identifikátor. Má integračné a produkčné prostredie (Príprava a test).
UID
Unikátny identifikátor dokladu, ktorý pridelí systém eKasa pri online registrácii (napríklad
O-7DBCDA8A56EE426DBCDA8A56EE426D1A). Je na doklade a v API vo vlastnosti response.data.id.
OKP
Overovací kód podnikateľa. eKasa ho vypočíta pred odoslaním dokladu. Pri offline doklade nahrádza UID, je z neho QR kód na doklade a používa sa ako odkaz na doklad pri vrátení tovaru (Výsledok registrácie).
PKP
Podpisový kód podnikateľa, elektronický podpis dátovej správy. Tlačí sa na offline doklade.
Offline režim
Doklad, ktorý systém eKasa nestihol prijať (bez pripojenia alebo bez odpovede). eKasa ho vytlačí s označením OFF-LINE DOKLAD, dátovú správu uloží do fronty a odošle ju neskôr (Ako funguje eKasa).
Fronta neodoslaných správ
Dátové správy, ktoré čakajú na odoslanie do systému eKasa. Podnikateľ musí každú odoslať do 96 hodín (Kontrola stavu systému).
Paragón
Doklad vystavený ručne počas poruchy pokladnice, ktorý sa do systému eKasa zaeviduje dodatočne (Typy dokladov).
Nefiškálny doklad
Text vytlačený na tlačiarni pokladnice, ktorý nie je pokladničným dokladom, napríklad objednávka pre kuchyňu (Nefiškálny doklad).
JÚP
Jednoúčelový poukaz, napríklad darčeková poukážka na konkrétny tovar. Na doklade je položka typu voucher
(Poukazy).
externalId
Váš vlastný identifikátor dokladu, napríklad číslo objednávky. Chráni pred dvojitou evidenciou, keď sa stratí odpoveď (Ochrana pred duplicitou).
Integrácia
Nadradená aplikácia
Váš softvér (pokladničný systém, e-shop, aplikácia), ktorý posiela eKase údaje o predaji.
NOP
Notifikátor okamžitých platieb finančnej správy. Oznámi pokladnici prijatie QR platby (QR platby).
Token
Riadiaca značka v texte dokladu, ktorou naformátujete text alebo vytlačíte QR či čiarový kód (Tokeny a formátovanie textu).
Kódová stránka
Kódovanie znakov tlačiarne, väčšinou ibm852 alebo windows-1250. eKasa doň prevedie text pred tlačou
(Kódovanie a špeciálne znaky).
Expose
Šifrované spojenie, cez ktoré sa softvér z cloudu pripojí k eKase na predajnom mieste (Pripojenie a zabezpečenie).