Getting started
What do I need to get started?
For development, this documentation and eKasa are enough: the service with the HTTP API, or the .NET library. You do not need hardware; the In-Memory storage already has an integration initialization package loaded and “prints” receipts to PDF. See Environment setup.
You need a real storage and printer only for the test before going live. If you do not have them, write to us.
How do I connect the storage and printer?
Connect the CHDU Lite storage to a computer or tablet with a USB cable, the printer to the storage with a serial cable and the cash drawer to the printer. A payment terminal has both the SwissBit storage and the printer built in. See Storage and setups.
What do I have to implement?
The foundation is receipt registration. What to add next is described in Integration scope: status checks, recording paragons (receipts written by hand when the cash register is out of order), location registration and optional features such as invoice payment or receipts by email.
You do not have to implement the eKasa settings or loading the initialization package. The business or a service technician does that in the eKasa web interface or, with the .NET library, in the Portos eKasa Servis application.
How do I load the initialization package?
In the service’s web interface at http://localhost:3010, or from your software through the API
(POST /api/v1/identities and POST /api/v1/certificates).
In the Portos eKasa Servis application (Windows), or from your software with the client’s methods.
What the package contains and how the business obtains it is described in Environment setup.
Do I need the Portos eKasa Servis application with the HTTP API?
No. You set everything up in the service’s web interface. The Portos eKasa Servis application is meant for the .NET library.
If you do use both on one computer, stop the eKasa service before starting Portos eKasa Servis (and vice versa). They use the same files, and only one process may use the storage at a time.
Operation
Do I have to run the queue of unsent messages manually?
No. eKasa monitors the connection to the eKasa system itself and sends unsent data messages as soon as possible. However, the business must make sure they are sent within 96 hours of the first attempt (§ 3(1) of Act No. 384/2025, in Slovak), so watch the queue state in the status check.
How do I print a daily closing report?
The law does not require closing reports from the cash register. Your software prints closing reports and statistics as a non-fiscal receipt.
How do I print a cash count?
As a non-fiscal receipt.
How do I integrate a customer display?
The law does not require a customer display. If you want one, your software controls it directly; eKasa does not work with it.
Receipts and legislation
How do I handle the 400 euro limit for a simplified invoice?
From 1 January 2025, a buyer who is a business may not use a receipt from eKasa as a simplified invoice if the amount exceeds €400, regardless of the payment method. eKasa does not issue full invoices. You have these options:
- issue the invoice outside eKasa, for example on A4, and record only its payment in eKasa,
- print the invoice as a non-fiscal receipt,
- record the invoice payment and put the mandatory invoice details in the header text (
headerText).
How should I record paying out a scratch card win?
Neither the sale of scratch cards nor paying out a win is subject to the obligation to record sales. If it is easier for you to record them in eKasa, use an item with a negative price and give a suitable text as the original receipt identifier, for example “vyplata zrebu”.
How should I record buying gold?
Buying gold is not subject to the obligation to record sales; you do not have to record it in eKasa.
If you are unsure whether a particular sale must be recorded, contact the Financial Administration.