# FAQ

> Answers to common integrator questions: what to implement, testing without hardware, the queue, closing reports, customer display, invoices and exemptions.

Source: https://ekasa.ninedigit.sk/en/docs/faq

## 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](https://ekasa.ninedigit.sk/en/docs/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](https://ekasa.ninedigit.sk/#kontakt).

**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](https://ekasa.ninedigit.sk/en/docs/storage-and-hardware).

**What do I have to implement?**

The foundation is [receipt registration](https://ekasa.ninedigit.sk/en/docs/receipt-registration). What to add next is described in
[Integration scope](https://ekasa.ninedigit.sk/en/docs/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?**

**HTTP API:**

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`).

**.NET library:**

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](https://ekasa.ninedigit.sk/en/docs/environment-setup#initialization-package).

**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](https://www.slov-lex.sk/ezbierky-fe/pravne-predpisy/SK/ZZ/2025/384/20260101#paragraf-3.odsek-1), in Slovak), so watch the queue state in the
[status check](https://ekasa.ninedigit.sk/en/docs/status).

**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](https://ekasa.ninedigit.sk/en/docs/nonfiscal-receipt).

**How do I print a cash count?**

As a [non-fiscal receipt](https://ekasa.ninedigit.sk/en/docs/nonfiscal-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:

1. issue the invoice outside eKasa, for example on A4, and record only its
   [payment](https://ekasa.ninedigit.sk/en/docs/receipt-registration/receipt-types#invoice-payment) in eKasa,
2. print the invoice as a [non-fiscal receipt](https://ekasa.ninedigit.sk/en/docs/nonfiscal-receipt),
3. 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.

## Did not find an answer?

- [Troubleshooting](https://ekasa.ninedigit.sk/en/docs/troubleshooting): Known errors and how to fix them.
- [Error codes](https://ekasa.ninedigit.sk/en/docs/rest-api/error-codes): What the codes in error responses mean.
- [Contact](https://ekasa.ninedigit.sk/#kontakt): Write to us, we are happy to help.
