Migration to version 7

Integrating via

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:

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

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.

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

{
    "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

{
    "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).
Esc

↑↓ selectEnter openEsc close

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.