# Položky dokladu

> Vlastnosti položky dokladu: typ, označenie, cena, množstvo, sadzba DPH, dôvod nulovej sadzby, predávajúci a popis.

Zdroj: https://ekasa.ninedigit.sk/docs/receipt-registration/items

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](#vlastnosti-položky): Prehľad všetkých polí, povinnosť a formát.
- [Typy položiek](#typ-položky-type): Predaj, zľava, vrátenie, vratné obaly, záloha, poukaz, oprava.
- [Vratné obaly](#vrátenie-dokladu-s-vratným-obalom): Predaj so zálohou na obal a jeho vrátenie.
- [Sadzby DPH](#sadzba-dph-vatrate): Platné sadzby podľa obdobia a podľa typu položky.

## 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`](#typ-položky-type) | áno | `positive`, `discount`, `returned`… | typ položky |
| [`name`](#označenie-name) | áno | text, najviac 255 znakov | označenie tovaru alebo služby |
| [`price`](#celková-cena-price) | áno | `-10000000` až `10000000`, 2 desatinné miesta | celková cena |
| [`unitPrice`](#jednotková-cena-unitprice) | áno | `-10000000` až `10000000`, 6 desatinných miest, znamienko podľa typu | jednotková cena v EUR |
| [`quantity`](#množstvo-quantity) | áno | `amount` a `unit` | množstvo tovaru alebo rozsah služby |
| [`referenceReceiptId`](#referenčné-číslo-dokladu-referencereceiptid) | pri `returned` a `correction` | ID dokladu, OKP alebo číslo dokladu z ERP | pôvodný doklad |
| [`vatRate`](#sadzba-dph-vatrate) | podľa [typu položky](#povolené-hodnoty-sadzby-dph) | číslo, 2 desatinné miesta, alebo `null` | sadzba DPH |
| [`specialRegulation`](#dôvod-nulovej-sadzby-specialregulation) | nie | `VATReverseCharge`, `VATExemptionGood`… | dôvod nulovej sadzby |
| [`seller`](#predávajúci-seller) | nie | `id` a `type` | predávajúci, ak je iný ako podnikateľ pokladnice |
| [`voucherNumber`](#číslo-poukazu-vouchernumber) | pri `voucher` | text, 1 až 50 znakov | číslo jednoúčelového poukazu |
| [`description`](#popis-položky-description) | nie | text, podporuje [tokeny](https://ekasa.ninedigit.sk/docs/token-syntax) | 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](https://ekasa.ninedigit.sk/docs/receipt-registration/discounts) | 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](https://ekasa.ninedigit.sk/docs/receipt-registration/advances) | 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](https://ekasa.ninedigit.sk/docs/receipt-registration/vouchers) | 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:

[Obrázok: 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]

**HTTP API:**

```http
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
        }
      ]
    }
  }
}
```

**.NET knižnica:**

```csharp
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:

[Obrázok: 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]

**HTTP API:**

```http
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
        }
      ]
    }
  }
}
```

**.NET knižnica:**

```csharp
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](https://ekasa.ninedigit.sk/docs/encoding).

## 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`)<br>
\*\* 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](https://ekasa.ninedigit.sk/docs/token-syntax), napríklad
[sériové číslo ako čiarový kód](https://ekasa.ninedigit.sk/docs/token-syntax#s%C3%A9riov%C3%A9-%C4%8D%C3%ADslo-v%C3%BDrobku-v-popise-polo%C5%BEky).

## Kam ďalej

- [Zľavy](https://ekasa.ninedigit.sk/docs/receipt-registration/discounts): Zľava na položku a na celý doklad.
- [Storno a vrátenie](https://ekasa.ninedigit.sk/docs/receipt-registration/corrections): Oprava dokladu, vrátenie tovaru a úhrady faktúry.
- [Platby a zaokrúhľovanie](https://ekasa.ninedigit.sk/docs/receipt-registration/payments): Platidlá a zaokrúhlenie hotovosti.
