Položky dokladu

Integrujem cez

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:

Doklad s predajom nápoja Coca Cola a zálohy na PET fľašu, záloha v časti Vratné obaly ako predaj; zvýraznené sú záloha a časť Vratné obaly

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:

Vrátenie dokladu: Coca Cola ako vrátená položka s identifikátorom pôvodného dokladu, záloha ako návrat v časti Vratné obaly; zvýraznené sú záloha a časť Vratné obaly

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.

Kam ďalej

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.