Položky (items) sú tovary a služby na doklade, ale aj zľavy, vrátenia, vratné obaly či odpočty záloh. Typ položky
určuje, čo položka znamená, a od neho sa odvíja znamienko ceny, povolené sadzby DPH aj to, či treba uviesť pôvodný
doklad.
Položky uvádzate len pri niektorých typoch dokladov:
| Typ dokladu | Identifikátor | Obsahuje položky |
|---|---|---|
| Pokladničný doklad | CashRegister |
áno |
| Paragón | Paragon |
áno |
| Faktúra | Invoice |
nie |
| Paragón pri úhrade faktúry | InvoiceParagon |
nie |
Pokladničný doklad a paragón musia mať aspoň jednu položku, najviac ich môže byť 500.
Vlastnosti položky
Každá položka sa skladá z týchto vlastností. V .NET knižnici (trieda ReceiptItem) majú rovnaký názov s veľkým
začiatočným písmenom (Type, UnitPrice…).
| Vlastnosť | Povinná | Formát | Význam |
|---|---|---|---|
type |
áno | positive, discount, returned… |
typ položky |
name |
áno | text, najviac 255 znakov | označenie tovaru alebo služby |
price |
áno | -10000000 až 10000000, 2 desatinné miesta |
celková cena |
unitPrice |
áno | -10000000 až 10000000, 6 desatinných miest, znamienko podľa typu |
jednotková cena v EUR |
quantity |
áno | amount a unit |
množstvo tovaru alebo rozsah služby |
referenceReceiptId |
pri returned a correction |
ID dokladu, OKP alebo číslo dokladu z ERP | pôvodný doklad |
vatRate |
podľa typu položky | číslo, 2 desatinné miesta, alebo null |
sadzba DPH |
specialRegulation |
nie | VATReverseCharge, VATExemptionGood… |
dôvod nulovej sadzby |
seller |
nie | id a type |
predávajúci, ak je iný ako podnikateľ pokladnice |
voucherNumber |
pri voucher |
text, 1 až 50 znakov | číslo jednoúčelového poukazu |
description |
nie | text, podporuje tokeny | dodatočný popis na doklade |
Typ položky (type)
Povinný. Položka kladného typu musí mať kladnú jednotkovú cenu, položka záporného typu zápornú.
| Identifikátor | Názov | Cena | Kedy | Podmienky |
|---|---|---|---|---|
positive |
Kladná položka | kladná | predaj tovaru alebo poskytnutie služby | |
returnedContainer |
Vrátené obaly | záporná | vykúpené zálohované obaly; aj vrátenie predaného vratného obalu, napríklad pri vrátení dokladu | |
returned |
Vrátená | záporná | zrušenie evidovanej položky po jej vystavení na pokladničnom doklade pri vrátení tovaru alebo služby, napríklad pri reklamácii | nepoužíva sa pre vratné obaly |
correction |
Opravná | kladná aj záporná | negácia položky už zaevidovaného dokladu v systéme e-kasa v prípade jej opravy, napríklad pri omyle obsluhy | |
discount |
Zľava | záporná | poskytnutá zľava | na doklade musí byť aj kladná položka (positive) v rovnakej sadzbe DPH, ku ktorej sa zľava vzťahuje; súčet zliav nesmie prevyšovať súčet položiek s kladnou cenou v tejto sadzbe DPH |
advance |
Odpočítaná záloha | záporná | suma prijatého preddavku na doklade vystavenom v čase úhrady doplatku ceny za predaný tovar alebo poskytnutú službu, ak bola za tovar už v minulosti obdržaná záloha | na doklade musí byť aj kladná položka (positive), ku ktorej sa odpočet zálohy vzťahuje |
voucher |
Výmena poukazu | záporná | suma jednoúčelového poukazu pri jeho výmene za tovar alebo poskytnutú službu, teda pri uplatnení vopred zakúpeného poukazu | na doklade musí byť aj kladná položka (positive), ku ktorej sa výmena poukazu vzťahuje; okrem poukazov smú byť na doklade len kladné položky (positive) a zľavy (discount) |
Vrátenie dokladu s vratným obalom
Pri vrátení tovaru, napríklad pri vrátení celého dokladu, sa vratný obal z pôvodného dokladu neeviduje ako vrátená
položka (returned), ale ako vrátené obaly (returnedContainer):
Vrátený tovar (returned) |
Vrátený obal (returnedContainer) |
|
|---|---|---|
| sadzba DPH | povinná, sadzba predaja | null (položka nepodlieha DPH) |
| jednotková cena | záporná | záporná |
referenceReceiptId |
povinné | neuvádza sa |
Vrátená položka (returned) musí mať sadzbu DPH, preto ju pre vratný obal použiť nemožno. Registrácia takého dokladu
skončí validačnou chybou Sadzba DPH je povinná pre všetky položky okrem kladnej položky, položky zľavy, vrátenia
vratných obalov alebo opravnej položky.
Pôvodný doklad. Nápoj sa predáva spolu so zálohou na vratný obal. Záloha je kladná položka (positive) so
sadzbou null a na doklade sa vytlačí v časti Vratné obaly ako predaj:

POST {server_address}/api/v1/requests/receipts/cash_register
{
"print": {
"printerName": "pdf"
},
"request": {
"data": {
"cashRegisterCode": "88812345678900001",
"items": [
{
"type": "positive",
"name": "Coca Cola",
"quantity": {
"amount": 1.00,
"unit": "ks"
},
"unitPrice": 1.99,
"price": 1.99,
"vatRate": 23.00
},
{
"type": "positive",
"name": "Záloha PET",
"quantity": {
"amount": 1.00,
"unit": "ks"
},
"unitPrice": 0.15,
"price": 0.15,
"vatRate": null
}
],
"payments": [
{
"name": "Karta",
"amount": 2.14
}
]
}
}
}
var items = new ReceiptItems
{
new ReceiptItem(ReceiptItemType.Positive, "Coca Cola", 1.99m, new Quantity(1, "ks"), 23m),
new ReceiptItem(ReceiptItemType.Positive, "Záloha PET", 0.15m, new Quantity(1, "ks"), VatRate.None),
};
Vrátenie tohto dokladu. Nápoj je vrátená položka (returned) s odkazom na pôvodný doklad, záloha sú vrátené
obaly (returnedContainer) bez odkazu:

POST {server_address}/api/v1/requests/receipts/cash_register
{
"print": {
"printerName": "pdf"
},
"request": {
"data": {
"cashRegisterCode": "88812345678900001",
"items": [
{
"type": "returned",
"name": "Coca Cola",
"quantity": {
"amount": 1.00,
"unit": "ks"
},
"unitPrice": -1.99,
"price": -1.99,
"vatRate": 23.00,
"referenceReceiptId": "O-974C23A2520D4E788C23A2520DA-TEST"
},
{
"type": "returnedContainer",
"name": "Záloha PET",
"quantity": {
"amount": 1.00,
"unit": "ks"
},
"unitPrice": -0.15,
"price": -0.15,
"vatRate": null
}
],
"payments": [
{
"name": "Karta",
"amount": -2.14
}
]
}
}
}
var items = new ReceiptItems
{
new ReceiptItem(ReceiptItemType.Returned, "Coca Cola", -1.99m, new Quantity(1, "ks"), 23m,
referenceReceiptId: "O-974C23A2520D4E788C23A2520DA-TEST"),
new ReceiptItem(ReceiptItemType.ReturnedContainer, "Záloha PET", -0.15m, new Quantity(1, "ks"), VatRate.None),
};
Označenie (name)
Povinné. Označenie tovaru alebo služby je neprázdny text s dĺžkou najviac 255 znakov.
Niektoré symboly (najmä netlačiteľné) sú však systémom eKasa zakázané. Viac v článku Kódovanie a špeciálne znaky.
Celková cena (price)
Povinná. Celková cena tovaru alebo služby v rozsahu -10000000 až 10000000, s presnosťou na dve desatinné miesta.
Musí sa rovnať súčinu jednotkovej ceny a množstva zaokrúhlenému na dve desatinné miesta (polovica sa zaokrúhľuje nahor):
price = unitPrice × quantity
Jednotková cena (unitPrice)
Povinná. Jednotková cena tovaru alebo služby v EUR v rozsahu -10000000 až 10000000 s presnosťou na šesť desatinných
miest. Znamienko určuje typ položky:
| Typ položky | Typy | Povolený rozsah |
|---|---|---|
| kladná | positive |
0 až 10000000 |
| záporná | returnedContainer, returned, discount, advance, voucher |
-10000000 až 0 |
| opravná | correction |
plný rozsah -10000000 až 10000000 |
Množstvo (quantity)
Povinné. Množstvo tovaru alebo rozsah služby má dve polia:
| Pole | Povinné | Hodnoty | Predvolená |
|---|---|---|---|
amount |
áno | 0 až 10000000, štyri desatinné miesta |
|
unit |
nie | množstevná jednotka, 1 až 3 znaky | x |
Referenčné číslo dokladu (referenceReceiptId)
Odkaz na pôvodný doklad. Povinné je iba pri položke typu correction alebo returned. Pri ostatných typoch musí byť
null (nesmie byť uvedené). Platí to aj pre položku returnedContainer pri vrátení dokladu, hoci vracia obal
z konkrétneho pôvodného dokladu.
| Pôvodný doklad | Referenčné číslo |
|---|---|
| zaregistrovaný v online režime, má unikátny identifikátor dokladu | tento identifikátor (pole response.data.id) |
| zaregistrovaný v offline režime, nemá unikátny identifikátor dokladu | OKP (pole request.data.okp) |
| vyhotovený elektronickou registračnou pokladnicou (ERP, teda pokladnicou používanou pred súčasnou eKasa legislatívou) | poradové číslo pokladničného dokladu |
Sadzba DPH (vatRate)
Číselná hodnota s presnosťou na dve desatinné miesta, alebo null pre položku nepodliehajúcu DPH.
Platné sadzby podľa časových období
Vývoj sadzieb DPH používaných v SR od začiatku projektu eKasa (1. 4. 2019):
| Sadzba DPH | Do 31. 12. 2024 | Od 1. 1. 2025 |
|---|---|---|
| základná | 20 % | 23 % |
| znížené | 10 % | 19 % a 5 % |
Okrem základnej a znížených sadzieb, ktoré sa v čase môžu meniť, sa používajú fixné hodnoty:
| Hodnota | Použitie | .NET knižnica |
|---|---|---|
0 |
položky oslobodené od DPH, alebo evidencia tržieb podnikateľa, ktorý nie je platiteľom DPH | VatRate.Zero |
null |
položky nepodliehajúce DPH (v súčasnosti návrat a predaj vratných obalov) | VatRate.None |
Povolené hodnoty sadzby DPH
Povolené sadzby závisia od typu položky, zámeru jej využitia a dátumu vyhotovenia dokladu (pri registrácii paragónu
alebo paragónu pri úhrade faktúry je rozhodujúca hodnota issueDate):
| Typ položky | Do 31. 12. 2024 | Od 1. 1. 2025 |
|---|---|---|
positive |
20, 10, 0, null |
23, 20*, 19, 10*, 5, 0, null |
discount |
20, 10, 0, null** |
23, 19, 5, 0, null** |
returnedContainer |
null |
null |
returned |
20, 10, 0 |
23, 20, 19, 10, 5, 0 |
advance |
20, 10, 0 |
23, 20, 19, 10, 5, 0 |
voucher |
20, 10, 0 |
23, 20, 19, 10, 5, 0 |
correction |
20, 10, 0, null |
23, 20, 19, 10, 5, 0, null |
* iba ak sa na doklade nachádza aj položka typu returned (od verzie 7.0.1)
** od verzie 7.0.6
Zľava (discount) sa uplatňuje „v reálnom čase“, musí preto používať aktuálne platné sadzby DPH. Zľavu na
položky nepodliehajúce DPH je možné od verzie 7.0.6 evidovať so sadzbou null.
Kladná položka (positive) sa používa v rôznych situáciách a od každej sa odvíja iná sada povolených sadzieb:
| Kladná položka znamená | Povolené sadzby |
|---|---|
| predaj tovaru alebo služby | predaj sa realizuje „v reálnom čase“, preto iba aktuálne platné sadzby: 20, 10 a 0 pred 1. 1. 2025, resp. 23, 19, 5 a 0 od 1. 1. 2025 |
| predaj vratných obalov | null (položka nepodlieha DPH) |
| vrátenie zľavy | od verzie 7.0.1 okrem aktuálnych aj historické sadzby; na doklade musí byť aspoň jedna ďalšia položka evidujúca návrat (returned) |
Vrátenie zľavy v kladnej položke využijete, ak ste na pôvodnom doklade evidovali k predanému tovaru (positive) aj
zľavu (discount) na samostatnom riadku a teraz evidujete návrat tohto tovaru. Doklad kombinuje vrátenie tovaru
(returned) a vrátenie zľavy ako položku typu positive, pretože vrátenie zľavy sa eviduje v kladnej hodnote a typ
discount umožňuje iba záporné ceny. Že kladná položka eviduje vrátenie zľavy, overuje eKasa tak, že na doklade
vyžaduje aspoň jednu položku returned.
Vratné obaly (predaj positive aj výkup returnedContainer) sa evidujú ako položky nepodliehajúce DPH, vatRate
musí byť null (VatRate.None v .NET knižnici).
Ostatné položky (returned, advance, voucher, correction) môžu mať všetky aktuálne aj historicky platné
sadzby, vždy však sadzbu pôvodnej operácie:
| Typ položky | Sadzba musí byť rovnaká ako pri | 20 % alebo 10 % je povolená aj vtedy, ak |
|---|---|---|
returned |
evidencii predaja | predaj bol pred 1. 1. 2025 |
advance |
evidencii prijatia zálohy | záloha bola prijatá pred 1. 1. 2025 |
voucher |
evidencii predaja jednoúčelového poukazu | predaj poukazu bol zaevidovaný pred 1. 1. 2025 |
correction |
pôvodnej položke | pôvodná položka bola zaevidovaná pred 1. 1. 2025 |
Pri nesprávnej sadzbe DPH vráti eKasa validačnú chybu, napríklad: Sadzba DPH 23,00% nie je platná pre doklad s dátumom vyhotovenia 11. 11. 2024.
Dôvod nulovej sadzby (specialRegulation)
Príznak, ktorý bližšie určuje dôvod priradenia sadzby dane s hodnotou 0, ak takáto bola položke priradená. Je nepovinný, a to aj pri položkách s nulovou sadzbou.
Uviesť ho možno iba pri položke so sadzbou 0 alebo bez DPH (null), ak predstavuje niektorú z týchto možností
(v .NET knižnici enum TaxFreeReason):
| Hodnota | Význam |
|---|---|
VATReverseCharge |
prenesenie daňovej povinnosti |
VATExemptionGood |
oslobodenie položky od dane |
TravelAgency |
osobitná úprava uplatňovania dane pri cestovných kanceláriách |
UsedGood |
osobitná úprava uplatňovania dane pri použitom tovare |
Artwork |
osobitná úprava uplatňovania dane pri umeleckých dielach |
CollectiblesAndAntiques |
osobitná úprava uplatňovania dane pri zberateľských predmetoch a starožitnostiach |
Predávajúci (seller)
Nepovinný. Uvádza sa iba vtedy, ak predávajúci, v ktorého mene bol predaný tovar alebo poskytnutá služba, je iný ako podnikateľský subjekt priradený k on-line registračnej pokladnici.
| Pole | Povinné | Hodnoty |
|---|---|---|
id |
áno | identifikátor predávajúceho, v ktorého mene bol predaný tovar alebo poskytnutá služba |
type |
áno | typ identifikátora, pozri tabuľku nižšie |
type |
Identifikátor | Formát id |
|---|---|---|
DIC |
DIČ | ^[0-9]{10}$, presne 10 číslic |
ICDPH |
IČ DPH | ^SK[0-9]{8,10}$, písmená SK a za nimi 8 až 10 číslic; prijme sa aj samotné 10-miestne DIČ |
Číslo poukazu (voucherNumber)
Číslo jednoúčelového poukazu pri jeho výmene za tovar alebo poskytnutú službu. Text s dĺžkou 1 až 50 znakov.
| Typ položky | voucherNumber |
|---|---|
voucher |
povinné |
correction |
možno uviesť |
| ostatné | musí byť null |
Popis položky (description)
Nepovinný dodatočný popis, ktorý sa vytlačí na doklade hneď za názvom produktu a údajmi o množstve a cenách. Slúži napríklad na dátum spotreby alebo sériové číslo výrobku. Do systému eKasa sa neodosiela.
Popis podporuje tokeny na formátovanie a tlač QR a čiarových kódov, pozri Tokeny a formátovanie textu, napríklad sériové číslo ako čiarový kód.