Slovník pojmov

Integrujem cez

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).

Esc

↑↓ výberEnter otvoriťEsc zavrieť

Chýba vám niečo v dokumentácii?

Napíšte nám, s čím potrebujete pomôcť. Ozveme sa do pár hodín.

Údaje použijeme len na odpoveď. Viac v ochrane osobných údajov.