# Slovník pojmov

> Skratky a pojmy eKasy a zákona o evidencii tržieb na jednom mieste: CHDÚ, PPEKK, UID, OKP, PKP, NOP, JÚP, paragón, offline režim a ďalšie.

Zdroj: https://ekasa.ninedigit.sk/docs/glossary

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

### <span id="orp" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/environment-setup#k%C3%B3dy-pokladn%C3%ADc-integra%C4%8Dn%C3%A9ho-prostredia)).

### <span id="sorp" class="anchor"></span>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.

### <span id="ppekk" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/how-it-works).

### <span id="chdu" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/storage-and-hardware).

### <span id="in-memory" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/environment-setup#r%C3%BDchly-%C5%A1tart-bez-hardv%C3%A9ru)).

### <span id="tabulka-indexov" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/receipt-registration/external-id)).

### <span id="prenosna-pokladnica" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/location-registration)).

## Údaje podnikateľa

### <span id="identifikacne-udaje" class="anchor"></span>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.

### <span id="autentifikacne-udaje" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/status#bl%C3%AD%C5%BEiaca-sa-exspir%C3%A1cia-certifik%C3%A1tu)).

### <span id="inicializacny-balik" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/environment-setup#inicializa%C4%8Dn%C3%BD-bal%C3%ADk)).

## Doklad

### <span id="datova-sprava" class="anchor"></span>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.

### <span id="system-ekasa" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/environment-setup#integra%C4%8Dn%C3%A9-a-produk%C4%8Dn%C3%A9-prostredie)).

### <span id="uid" class="anchor"></span>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`.

### <span id="okp" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/receipt-registration/result)).

### <span id="pkp" class="anchor"></span>PKP

Podpisový kód podnikateľa, elektronický podpis dátovej správy. Tlačí sa na offline doklade.

### <span id="offline-rezim" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/how-it-works#ke%C4%8F-nie-je-internet)).

### <span id="fronta" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/status#kontrola-obsahu-fronty-neodoslan%C3%BDch-spr%C3%A1v)).

### <span id="paragon" class="anchor"></span>Paragón

Doklad vystavený ručne počas poruchy pokladnice, ktorý sa do systému eKasa zaeviduje dodatočne
([Typy dokladov](https://ekasa.ninedigit.sk/docs/receipt-registration/receipt-types)).

### <span id="nefiskalny-doklad" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/nonfiscal-receipt)).

### <span id="jup" class="anchor"></span>JÚP

Jednoúčelový poukaz, napríklad darčeková poukážka na konkrétny tovar. Na doklade je položka typu `voucher`
([Poukazy](https://ekasa.ninedigit.sk/docs/receipt-registration/vouchers)).

### <span id="externalid" class="anchor"></span>externalId

Váš vlastný identifikátor dokladu, napríklad číslo objednávky. Chráni pred dvojitou evidenciou, keď sa stratí
odpoveď ([Ochrana pred duplicitou](https://ekasa.ninedigit.sk/docs/receipt-registration/external-id)).

## Integrácia

### <span id="nadradena-aplikacia" class="anchor"></span>Nadradená aplikácia

Váš softvér (pokladničný systém, e-shop, aplikácia), ktorý posiela eKase údaje o predaji.

### <span id="nop" class="anchor"></span>NOP

Notifikátor okamžitých platieb finančnej správy. Oznámi pokladnici prijatie QR platby
([QR platby](https://ekasa.ninedigit.sk/docs/qr-payments)).

### <span id="token" class="anchor"></span>Token

Riadiaca značka v texte dokladu, ktorou naformátujete text alebo vytlačíte QR či čiarový kód
([Tokeny a formátovanie textu](https://ekasa.ninedigit.sk/docs/token-syntax)).

### <span id="kodova-stranka" class="anchor"></span>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](https://ekasa.ninedigit.sk/docs/encoding)).

### <span id="expose" class="anchor"></span>Expose

Šifrované spojenie, cez ktoré sa softvér z cloudu pripojí k eKase na predajnom mieste
([Pripojenie a zabezpečenie](https://ekasa.ninedigit.sk/docs/security#expose)).
