# Receipt items

> Receipt item properties: type, name, price, quantity, VAT rate, reason for a zero rate, seller and description.

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

Items (`items`) are the goods and services on a receipt, but also discounts, returns, returnable containers and
advance deductions. **The item type determines what the item means**, and it drives the sign of the price, the
allowed VAT rates and whether the original receipt must be referenced.

Items can only be stated on some receipt types:

| Receipt type | Identifier | Contains items |
|---|---|:---:|
| Cash register receipt | `CashRegister` | yes |
| Paragon | `Paragon` | yes |
| Invoice | `Invoice` | no |
| Invoice payment paragon | `InvoiceParagon` | no |

A cash register receipt and a paragon must have at least one item and at most 500.

- [Item properties](#item-properties): All fields at a glance, whether required and their format.
- [Item types](#item-type-type): Sale, discount, return, returnable containers, advance, voucher, correction.
- [Returnable containers](#returning-a-receipt-with-a-returnable-container): A sale with a container deposit and its return.
- [VAT rates](#vat-rate-vatrate): Valid rates by period and by item type.

## Item properties

Each item consists of these properties. In the .NET library (class `ReceiptItem`) they have the same name starting
with a capital letter (`Type`, `UnitPrice`…).

| Property | Required | Format | Meaning |
|---|---|---|---|
| [`type`](#item-type-type) | yes | `positive`, `discount`, `returned`… | item type |
| [`name`](#name-name) | yes | text, at most 255 characters | name of the goods or service |
| [`price`](#total-price-price) | yes | `-10000000` to `10000000`, 2 decimal places | total price |
| [`unitPrice`](#unit-price-unitprice) | yes | `-10000000` to `10000000`, 6 decimal places, sign by type | unit price in EUR |
| [`quantity`](#quantity-quantity) | yes | `amount` and `unit` | quantity of goods or extent of service |
| [`referenceReceiptId`](#reference-receipt-number-referencereceiptid) | for `returned` and `correction` | receipt ID, OKP or ERP receipt number | original receipt |
| [`vatRate`](#vat-rate-vatrate) | by [item type](#allowed-vat-rate-values) | number, 2 decimal places, or `null` | VAT rate |
| [`specialRegulation`](#reason-for-a-zero-rate-specialregulation) | no | `VATReverseCharge`, `VATExemptionGood`… | reason for a zero rate |
| [`seller`](#seller-seller) | no | `id` and `type` | seller, if different from the cash register's business |
| [`voucherNumber`](#voucher-number-vouchernumber) | for `voucher` | text, 1 to 50 characters | single-purpose voucher number |
| [`description`](#item-description-description) | no | text, supports [tokens](https://ekasa.ninedigit.sk/en/docs/token-syntax) | additional description on the receipt |

## Item type (`type`)

Required. An item of a positive type must have a positive unit price, an item of a negative type a negative one.

| Identifier | Name | Price | When | Conditions |
|---|---|---|---|---|
| `positive` | Positive item | positive | sale of goods or provision of a service | |
| `returnedContainer` | Returned containers | negative | bought-back deposit containers; also the return of a sold returnable container, for example when a receipt is returned | |
| `returned` | Returned | negative | cancellation of a recorded item after it was issued on a cash register receipt, when goods or a service are returned, for example on a complaint | not used for returnable containers |
| `correction` | Correction | positive or negative | negation of an item of a receipt already recorded in the eKasa system when it is corrected, for example after an operator mistake | |
| `discount` | [Discount](https://ekasa.ninedigit.sk/en/docs/receipt-registration/discounts) | negative | a discount given | the receipt must also contain a positive item (`positive`) at the same VAT rate that the discount relates to; the total of discounts must not exceed the total of the items with a positive price at that VAT rate |
| `advance` | [Deducted advance](https://ekasa.ninedigit.sk/en/docs/receipt-registration/advances) | negative | the amount of an advance payment stated on the receipt issued when the remaining price for the sold goods or provided service is paid, if an advance has already been received for the goods | the receipt must also contain a positive item (`positive`) the advance deduction relates to |
| `voucher` | [Voucher exchange](https://ekasa.ninedigit.sk/en/docs/receipt-registration/vouchers) | negative | the amount of a single-purpose voucher when it is exchanged for goods or a service, that is when a voucher bought in advance is redeemed | the receipt must also contain a positive item (`positive`) the voucher exchange relates to; apart from vouchers, the receipt may contain only positive items (`positive`) and discounts (`discount`) |

### Returning a receipt with a returnable container

When goods are returned, for example when a whole receipt is returned, a returnable container from the original
receipt is not recorded as a returned item (`returned`) but as returned containers (`returnedContainer`):

| | Returned goods (`returned`) | Returned container (`returnedContainer`) |
|---|---|---|
| VAT rate | required, the rate of the sale | `null` (the item is not subject to VAT) |
| unit price | negative | negative |
| `referenceReceiptId` | required | not stated |

A returned item (`returned`) must have a VAT rate, so it cannot be used for a returnable container. Registering such a
receipt ends with the validation error _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._ (the VAT rate is required for all items except a positive item, a
discount item, returned containers or a correction item).

**Original receipt.** A drink is sold together with a deposit on a returnable container. The deposit is a positive
item (`positive`) with the rate `null` and is printed in the **Vratné obaly** (returnable containers) section as a
sale:

[Image: Receipt selling a Coca Cola and a PET bottle deposit, the deposit shown as a sale in the returnable containers section; deposit and the returnable containers section highlighted]

**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 library:**

```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),
};
```

**Return of this receipt.** The drink is a returned item (`returned`) with a reference to the original receipt, the
deposit is returned containers (`returnedContainer`) without a reference:

[Image: Return receipt: Coca Cola as a returned item with the original receipt identifier, the deposit as a return in the returnable containers section; deposit and the returnable containers section highlighted]

**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 library:**

```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),
};
```

## Name (`name`)

Required. The name of the goods or service is a non-empty text of at most 255 characters.

Some symbols (mainly non-printable ones) are, however, forbidden by the eKasa system. More in
[Encoding and special characters](https://ekasa.ninedigit.sk/en/docs/encoding).

## Total price (`price`)

Required. The total price of the goods or service in the range `-10000000` to `10000000`, to two decimal places.

It must equal the unit price multiplied by the quantity, rounded to two decimal places (halves round up):

```
price = unitPrice × quantity
```

## Unit price (`unitPrice`)

Required. The unit price of the goods or service in EUR in the range `-10000000` to `10000000`, to six decimal
places. The sign depends on the item type:

| Item kind | Types | Allowed range |
|---|---|---|
| positive | `positive` | `0` to `10000000` |
| negative | `returnedContainer`, `returned`, `discount`, `advance`, `voucher` | `-10000000` to `0` |
| correction | `correction` | full range `-10000000` to `10000000` |

## Quantity (`quantity`)

Required. The quantity of goods or extent of service has two fields:

| Field | Required | Values | Default |
|---|:---:|---|---|
| `amount` | yes | `0` to `10000000`, four decimal places | |
| `unit` | no | unit of quantity, 1 to 3 characters | `x` |

## Reference receipt number (`referenceReceiptId`)

A reference to the original receipt. Required only for items of type `correction` or `returned`. For other types it
must be `null` (it must not be stated). This also applies to a `returnedContainer` item when a receipt is returned,
even though it returns a container from a specific original receipt.

| Original receipt | Reference number |
|---|---|
| registered in online mode, has a unique receipt identifier | this identifier (the `response.data.id` field) |
| registered in offline mode, has no unique receipt identifier | the OKP (the `request.data.okp` field) |
| issued by an electronic cash register (ERP, the kind of cash register used before the current eKasa legislation) | the sequence number of the cash register receipt |

## VAT rate (`vatRate`)

A number to two decimal places, or `null` for an item not subject to VAT.

### Valid rates by period

VAT rates used in Slovakia since the start of the eKasa project (1 April 2019):

| VAT rate | Until 31 Dec 2024 | From 1 Jan 2025 |
|---|---|---|
| standard | 20% | 23% |
| reduced | 10% | 19% and 5% |

Besides the standard and reduced rates, which can change over time, fixed values are used:

| Value | Use | .NET library |
|---|---|---|
| `0` | items exempt from VAT, or recording sales of a business that is not a VAT payer | `VatRate.Zero` |
| `null` | items not subject to VAT (currently the return and sale of returnable containers) | `VatRate.None` |

### Allowed VAT rate values

The allowed rates depend on the item type, its purpose and the date the receipt is issued (for a paragon or an
invoice payment paragon, the `issueDate` value applies):

| Item type | Until 31 Dec 2024 | From 1 Jan 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` |

\* only if the receipt also contains an item of type `returned` (from version `7.0.1`)<br>
\*\* from version `7.0.6`

**A discount (`discount`)** is applied "in real time", so it must use the currently valid VAT rates. From version
`7.0.6`, a discount on items not subject to VAT can be recorded with the rate `null`.

**A positive item (`positive`)** is used in various situations, each with a different set of allowed rates:

| The positive item is | Allowed rates |
|---|---|
| a sale of goods or a service | the sale happens "in real time", so only the currently valid rates: `20`, `10` and `0` before 1 January 2025, or `23`, `19`, `5` and `0` from 1 January 2025 |
| a sale of returnable containers | `null` (the item is not subject to VAT) |
| a discount refund | from version `7.0.1`, historical rates in addition to the current ones; the receipt must contain at least one other item that records a return (`returned`) |

Use a discount refund in a positive item if the original receipt recorded a discount (`discount`) on a separate line
for the sold goods (`positive`) and you are now recording the return of these goods. The receipt combines the goods
return (`returned`) and the discount refund as an item of type `positive`, because the discount refund is recorded
as a positive value and the `discount` type allows only negative prices. eKasa verifies that the positive item
records a discount refund by requiring at least one `returned` item on the receipt.

**Returnable containers** (sale `positive` and buy-back `returnedContainer`) are recorded as items not subject to
VAT, so `vatRate` must be `null` (`VatRate.None` in the .NET library).

**The other items** (`returned`, `advance`, `voucher`, `correction`) can have all current and historical rates, but
always the rate of the original operation:

| Item type | Rate must be the same as for | 20% or 10% is also allowed if |
|---|---|---|
| `returned` | the recorded sale | the sale was before 1 January 2025 |
| `advance` | the recorded receipt of the advance | the advance was received before 1 January 2025 |
| `voucher` | the recorded sale of the single-purpose voucher | the voucher sale was recorded before 1 January 2025 |
| `correction` | the original item | the original item was recorded before 1 January 2025 |

If the VAT rate is incorrect, eKasa returns a validation error, for example: _Sadzba DPH 23,00% nie je platná pre
doklad s dátumom vyhotovenia 11. 11. 2024_ (the VAT rate 23.00% is not valid for a receipt issued on 11 November
2024).

## Reason for a zero rate (`specialRegulation`)

A flag that specifies the reason for assigning a zero tax rate, if the item was assigned one. It is optional, even
for items with a zero rate.

It can only be stated for an item with the rate `0` or not subject to VAT (`null`), when it represents one of these
options (in the .NET library the `TaxFreeReason` enum):

| Value | Meaning |
|---|---|
| `VATReverseCharge` | reverse charge |
| `VATExemptionGood` | item exempt from tax |
| `TravelAgency` | special tax scheme for travel agencies |
| `UsedGood` | special tax scheme for second-hand goods |
| `Artwork` | special tax scheme for works of art |
| `CollectiblesAndAntiques` | special tax scheme for collectors' items and antiques |

## Seller (`seller`)

Optional. Stated only if the seller on whose behalf the goods were sold or the service provided is different from
the business assigned to the online cash register.

| Field | Required | Values |
|---|:---:|---|
| `id` | yes | identifier of the seller on whose behalf the goods were sold or the service provided |
| `type` | yes | type of the identifier, see the table below |

| `type` | Identifier | Format of `id` |
|---|---|---|
| `DIC` | DIČ (tax identification number) | `^[0-9]{10}$`, exactly 10 digits |
| `ICDPH` | IČ DPH (VAT identification number) | `^SK[0-9]{8,10}$`, the letters SK followed by 8 to 10 digits; a bare 10-digit DIČ is also accepted |

## Voucher number (`voucherNumber`)

The number of a single-purpose voucher when it is exchanged for goods or a service. Text 1 to 50 characters long.

| Item type | `voucherNumber` |
|---|---|
| `voucher` | required |
| `correction` | may be stated |
| others | must be `null` |

## Item description (`description`)

An optional additional description printed on the receipt right after the product name and the quantity and price
information. Use it, for example, for the expiry date or the product serial number. It is not sent to the eKasa
system of the Financial Administration.

The description supports tokens for formatting and printing QR codes and barcodes, see
[Tokens and text formatting](https://ekasa.ninedigit.sk/en/docs/token-syntax), for example
[a serial number as a barcode](https://ekasa.ninedigit.sk/en/docs/token-syntax#product-serial-number-in-the-item-description).

## Where next

- [Discounts](https://ekasa.ninedigit.sk/en/docs/receipt-registration/discounts): Item discount and whole-receipt discount.
- [Cancellations and returns](https://ekasa.ninedigit.sk/en/docs/receipt-registration/corrections): Receipt correction, returned goods and invoice payment refunds.
- [Payments and rounding](https://ekasa.ninedigit.sk/en/docs/receipt-registration/payments): Means of payment and cash rounding.
