# Migration to version 7

> What changes when moving to version 7: VAT rates from 1 January 2025, null VAT rate for returnable packaging and new item rules.

Source: https://ekasa.ninedigit.sk/en/docs/migration/v7

**TL;DR**

- `vatRate` property can have a value of `null`
- The value `null` for `vatRate` property can only be specified for items where the `type` property is either `positive`, `returnedContainer`, or `correction`.
- Starting from January 1st, 2025, the `vatRate` property can also take values of `23`, `19`, and `5`.  After Janury 1st, 2025, values `20` and `10` are allowed only for items of type `returned`, `advance`, `voucher` or `correction`. Items of type `positive` and `discount` must be associated with new VAT rates.
- An item of type `voucher` can only be included in a receipt that contains exactly two items with the same VAT rate: one item of type `positive` and one item of type `voucher`.
- An item of type `advance` must only be present in a receipt that also includes a item with `positive` type.

## 1. Sale and return of returnable packaging

When selling returnable packaging, if the item type is `positive`, the `vatRate` property must be set to `null`, indicating that the item is not subject to VAT.
Similarly, when returining returnable packaging with an item type of `returnedContainer`, the `vatRate` property must also be set to `null`.

A new property, `nonTaxableAmount`, has been added to the return type provided after registering a receipt. This property represents the total amount of items that are not subject to VAT.

### 1.1 Changes in print output

Items not subject to VAT do not have an alphanumeric indication of the VAT rate (letters A, B, C, ...) on the receipt, nor are they part of the VAT recapitulation.

Visual appearance of items without alphanumeric assignment to VAT rate:

```text
------------ Množstvo -- J.cena ----- Suma
Výkup vratného obalu 
                 -1ks      1,00    -1,00 
Predaj vratného obalu 
                  2ks      1,00     2,00 
Predaj tovaru     1ks     20,00    20,00 A
Predaj tovaru     1ks     10,00    10,00 B
````

Below the VAT recapitulation, a new section _Returnable packaging_ has been added in which the total value of sales and returns of returnable packaging is quantified.

Visual representation of the VAT recapitulation and the recapitulation of the returnable packaging items:

```text
Sadzba ----- Základ ---- Daň ------- Obrat
A 20,00%      16,67     3,33         20,00
B 10,00%       9,09     0,91         10,00
Spolu:        25,76     4,24         30,00
-- Vratné obaly --------------------------
Predaj:                               2,00
Návrat:                              -1,00
Spolu:                                1,00
-- Platidlá ------------------------------
Hotovosť                              31,0
```

## 2. New VAT rates

In addition to the value `null`, the `vatRate` property can also accept the new VAT rates, which will be valid from January 1st, 2025, namely `23`, `19`, and `5`.

Until December 31st, 2024, the `vatRate` property can only have the values `20`, `10`, `0`, or `null`. If the values `23`, `19`, or `5` (valid from 2025) are entered while registering a receipt in 2024, a validation error will be triggered.

## 3. New rules for the registration of single-purpose vouchers

If the receipt contains an item of type  `voucher`, only items of type `voucher`, `positive` or `discount` are permitted to be included in the receipt.

### 3.1 Changes in print output

If the value of the single-purpose voucher is equal to or less than the value of the positive item, neither the positive item nor the exchange of the single-purpose voucher includes an alphanumeric indication of the VAT rate, and the receipt does not display a VAT recapitulation section for this voucher.

However, if the value of the single-purpose voucher is higher than the value of the positive item, both items will have an alphanumeric indication of the VAT rate, and the VAT recapitulation will be included in the receipt.

## 4. New rules for recording the deduction of advance payments

The deduction of an advance received (item of type `advance`) must be recorded in the receipt only if there is a positive item (item of type `positive`) on the same receipt to which the advance deduction applies.

## 5. New format of VAT identification number

On the basis of the amendment to Act No. 289/2008 Coll. effective from January 1st, 2025, it will be possible to include the `DIC` in the identification data section of the `ICDPH`.

**.NET library:**

## 6. Changes in the .NET library

If you use eKasa as a .NET library, also update the following:

- The `VatRate` class:
    - it holds a `decimal?`, so a rate can have no value,
    - the static property `Zero` is renamed to `Free`,
    - the static properties `TenPercent`, `TwentyPercent`, `Basic` and `Reduced` are removed,
    - the new static property `None` is used for non-taxable items.
- The `ReceiptRegistrationRequest.CreateRegistrationRequest` method is `internal`.
- `ReceiptRegistrationRequestReceipt` has new properties `SecondReducedVatAmount` and `TaxBaseSecondReduced`.
- The `OpenDrawer` property moved from `PosPrintingOptions` to the base class `PrintingOptions`.

## How to Test Rates for 2025 in 2024?

The procedure requires the use of Portos eKasa API version 7.0.4 or newer.

Do not adjust system date if you are using a physical Protected Data Storage (CHDU). This could result in it being locked.

### 1. Disable Internet Connection

If you are using the Windows 11 operating system, in the control panel, select the section **Network & Internet** and click on the item **Advanced network settings**.

For the available network adapters, press the **Disable** button to disable the respective network adapter.

In the **Network & Internet** section, verify that the computer has no internet access.

### 2. Change System Date and Time

In the control panel, select the section **Time & language** and click on the item **Date & Time**. Disable the option **Set time automatically**. This will allow manual adjustment of the date and time. Select a date and time in 2025.

### 3. Restart the Windows Service `NineDigit

This step is necessary to apply the adjusted system date and time.

### 4. Open the eKasa API Interface

On the homepage of the web interface (`localhost:3010`), a warning about the interrupted connection to the financial administration server is displayed. Ignore this warning and navigate to the **Nastavenia** (settings) section.

In the **Úložisko** (storage) tab, change the option **Model úložiska** (Storage Model) to **In memory**.

In the **eKasa klient** (eKasa Client) tab, change the **Prostredie** (environment) option to **Integračné** (integration).

Save the settings by pressing the **ULOŽIŤ** (save) button.

### 5. Issue a Receipt

A receipt containing the new VAT rates (23%, 19%, and 5%) can be issued directly via the parent application you are developing, or using applications like Postman, which allow sending HTTP requests.

#### Request Example

```json
{
    "request":
    {
        "data":
        {
            "cashRegisterCode": "88812345678900001",
            "items":
            [
                {
                    "type": "positive",
                    "name": "Predaj tovaru - základna sadzba DPH",
                    "quantity":
                    {
                        "amount": 1,
                        "unit": "ks"
                    },
                    "unitPrice": 10,
                    "price": 10,
                    "vatRate": 23
                },
                {
                    "type": "positive",
                    "name": "Predaj tovaru - znížená sadzba DPH",
                    "quantity":
                    {
                        "amount": 1,
                        "unit": "ks"
                    },
                    "unitPrice": 2,
                    "price": 2,
                    "vatRate": 19
                },
                {
                    "type": "positive",
                    "name": "Predaj tovaru - druhá znížená sadzba DPH",
                    "quantity":
                    {
                        "amount": 1,
                        "unit": "ks"
                    },
                    "unitPrice": 2,
                    "price": 2,
                    "vatRate": 5
                },
                {
                    "type": "positive",
                    "name": "Predaj tovaru - nulová sadzba DPH",
                    "quantity":
                    {
                        "amount": 1,
                        "unit": "ks"
                    },
                    "unitPrice": 1,
                    "price": 1,
                    "vatRate": 0
                },
                {
                    "type": "returned",
                    "name": "Vrátenie tovaru",
                    "quantity":
                    {
                        "amount": 1,
                        "unit": "ks"
                    },
                    "unitPrice": -5,
                    "price": -5,
                    "vatRate": 20,
                    "referenceReceiptId": "dummy-receipt-id"
                },
                {
                    "type": "advance",
                    "name": "Odpočet zálohy",
                    "quantity":
                    {
                        "amount": 1,
                        "unit": "ks"
                    },
                    "unitPrice": -5,
                    "price": -5,
                    "vatRate": 10
                }
            ],
            "payments":
            [
                {
                    "name": "Hotovosť",
                    "amount": 5
                }
            ]
        }
    }
}
```

#### Response Example

```json
{
    "request": {
        "data": {
            "receiptType": "CashRegister",
            "amount": 5.00,
            "roundingAmount": 0.00,
            "issueDate": "2025-01-01T15:50:38+01:00",
            "receiptNumber": 1,
            "invoiceNumber": null,
            "paragonNumber": null,
            "icdph": "SK1234567890",
            "ico": "76543210",
            "customer": null,
            "basicVatAmount": -0.83,
            "reducedVatAmount": -0.13,
            "secondReducedVatAmount": 0.10,
            "taxFreeAmount": 1.00,
            "nonTaxableAmount": null,
            "taxBaseBasic": -4.17,
            "taxBaseReduced": -2.87,
            "taxBaseSecondReduced": 1.90,
            "items": [
                {
                    "type": "Positive",
                    "name": "Predaj tovaru - základna sadzba DPH",
                    "price": 10.00,
                    "unitPrice": 10.000000,
                    "quantity": {
                        "amount": 1.0000,
                        "unit": "ks"
                    },
                    "referenceReceiptId": null,
                    "vatRate": 23.00,
                    "specialRegulation": null,
                    "voucherNumber": null,
                    "seller": null,
                    "description": null
                },
                {
                    "type": "Positive",
                    "name": "Predaj tovaru - znížená sadzba DPH",
                    "price": 2.00,
                    "unitPrice": 2.000000,
                    "quantity": {
                        "amount": 1.0000,
                        "unit": "ks"
                    },
                    "referenceReceiptId": null,
                    "vatRate": 19.00,
                    "specialRegulation": null,
                    "voucherNumber": null,
                    "seller": null,
                    "description": null
                },
                {
                    "type": "Positive",
                    "name": "Predaj tovaru - druhá znížená sadzba DPH",
                    "price": 2.00,
                    "unitPrice": 2.000000,
                    "quantity": {
                        "amount": 1.0000,
                        "unit": "ks"
                    },
                    "referenceReceiptId": null,
                    "vatRate": 5.00,
                    "specialRegulation": null,
                    "voucherNumber": null,
                    "seller": null,
                    "description": null
                },
                {
                    "type": "Positive",
                    "name": "Predaj tovaru - nulová sadzba DPH",
                    "price": 1.00,
                    "unitPrice": 1.000000,
                    "quantity": {
                        "amount": 1.0000,
                        "unit": "ks"
                    },
                    "referenceReceiptId": null,
                    "vatRate": 0.00,
                    "specialRegulation": null,
                    "voucherNumber": null,
                    "seller": null,
                    "description": null
                },
                {
                    "type": "Returned",
                    "name": "Vrátenie tovaru",
                    "price": -5.00,
                    "unitPrice": -5.000000,
                    "quantity": {
                        "amount": 1.0000,
                        "unit": "ks"
                    },
                    "referenceReceiptId": "dummy-receipt-id",
                    "vatRate": 20.00,
                    "specialRegulation": null,
                    "voucherNumber": null,
                    "seller": null,
                    "description": null
                },
                {
                    "type": "Advance",
                    "name": "Odpočet zálohy",
                    "price": -5.00,
                    "unitPrice": -5.000000,
                    "quantity": {
                        "amount": 1.0000,
                        "unit": "ks"
                    },
                    "referenceReceiptId": null,
                    "vatRate": 10.00,
                    "specialRegulation": null,
                    "voucherNumber": null,
                    "seller": null,
                    "description": null
                }
            ],
            "vatRatesTaxSummary": {
                "totalVatBase": 3.99,
                "totalVatAmout": 1.01,
                "totalTaxableAmount": 5.00,
                "totalNonTaxableAmount": 0.00,
                "totalAmount": 5.00,
                "items": [
                    {
                        "vatRate": 23.00,
                        "vatBase": 8.13,
                        "vatAmount": 1.87,
                        "totalAmount": 10.00
                    },
                    {
                        "vatRate": 19.00,
                        "vatBase": 1.68,
                        "vatAmount": 0.32,
                        "totalAmount": 2.00
                    },
                    {
                        "vatRate": 5.00,
                        "vatBase": 1.90,
                        "vatAmount": 0.10,
                        "totalAmount": 2.00
                    },
                    {
                        "vatRate": 0.00,
                        "vatBase": 1.00,
                        "vatAmount": 0.00,
                        "totalAmount": 1.00
                    },
                    {
                        "vatRate": 20.00,
                        "vatBase": -4.17,
                        "vatAmount": -0.83,
                        "totalAmount": -5.00
                    },
                    {
                        "vatRate": 10.00,
                        "vatBase": -4.55,
                        "vatAmount": -0.45,
                        "totalAmount": -5.00
                    }
                ]
            },
            "okp": "95e458f6-f8f97c57-5426b178-7a64e31e-d7877f79",
            "pkp": "hXOzjhLKtiLW+5cz2VGy2/Y4Pf5Sm9TNevOEXNrgc+1x3JbcRRayTIcVGs/rEmBwvB2+X+wfu3ldhbMYPT7Zt207Lrx/ap/47QO65r4u6lTWvRaYRVvqO+jYLaH3RiMliRmZ9BghwGvnM9IRa5yVZseFCipoaexYRRrq9sR4QjRVRFn3Q+MeYVa7jFLDWDpA1UgqBIbWfHq8xh4akCTezlmKjHoULDmv57y5558RaPm+X3lQSQcU0KZYyy35JC1oEe7czQpy1qqAet0ykL/hDzULq6Sdeh2ts6l9FfHnZKTo3IoTnMRETmPMW7QERcZ7LlD/BM/nOra3Xrvc0/mvng==",
            "payments": [
                {
                    "name": "Hotovosť",
                    "amount": 5.00
                }
            ],
            "headerText": null,
            "footerText": null,
            "createDate": "2025-01-01T15:50:38+01:00",
            "dic": "1234567890",
            "cashRegisterCode": "88812345678900001"
        },
        "id": "72a8ea8e-2e57-40b0-860c-425ffae861df",
        "externalId": null,
        "date": "2025-01-01T15:50:38+01:00",
        "sendingCount": 1
    },
    "response": null,
    "isSuccessful": null,
    "error": null,
    "$type": "Receipt"
}
```

Since the **"In memory"** storage does not support printing paper receipts, the receipt will be created in PDF format.

PDF files are typically generated in the directory `C:/ProgramData/NineDigit/Portos.eKasa/receipts`.

Upon opening the PDF file, the final appearance of the receipt can be viewed.

After completing the testing:

- Enable the internet connection.
- Enable automatic date and time settings.
- Restore the eKasa service settings to the desired configuration (e.g., using a physical CHDÚ device of type CHDU-SK or CHDU Lite).
