# Časté otázky

> Odpovede na časté otázky integrátorov: čo implementovať, testovanie bez hardvéru, fronta, uzávierky, zákaznícky displej, faktúry a výnimky z evidencie.

Zdroj: https://ekasa.ninedigit.sk/docs/faq

## Začíname

**Čo potrebujem na začiatok?**

Na vývoj stačí táto dokumentácia a eKasa: služba s HTTP API alebo .NET knižnica. Hardvér netreba, úložisko
In-Memory má integračný inicializačný balík už vložený a doklady „tlačí“ do PDF. Pozri
[Príprava prostredia](https://ekasa.ninedigit.sk/docs/environment-setup).

Skutočné úložisko a tlačiareň potrebujete až na test pred nasadením. Ak ich nemáte,
[napíšte nám](https://ekasa.ninedigit.sk/#kontakt).

**Ako zapojiť úložisko a tlačiareň?**

Úložisko CHDU Lite pripojíte k počítaču alebo tabletu USB káblom, tlačiareň k úložisku sériovým káblom a peňažnú
zásuvku do tlačiarne. Platobný terminál má úložisko SwissBit aj tlačiareň vstavané. Pozri
[Úložisko a zostavy](https://ekasa.ninedigit.sk/docs/storage-and-hardware).

**Čo musím implementovať?**

Základom je [registrácia dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration). Čo pridať ďalej, popisuje
[Rozsah integrácie](https://ekasa.ninedigit.sk/docs/integration-scope): kontrolu stavu, evidenciu paragónov, registráciu polohy a voliteľné
funkcie, napríklad úhradu faktúry alebo doklad e-mailom.

Nastavenia eKasy ani vloženie inicializačného balíka implementovať nemusíte. Podnikateľ alebo servisný technik ich
urobí vo webovom rozhraní eKasy, pri .NET knižnici v aplikácii Portos eKasa Servis.

**Ako vložím inicializačný balík?**

**HTTP API:**

Vo webovom rozhraní služby na adrese `http://localhost:3010`, prípadne z vášho softvéru cez API
(`POST /api/v1/identities` a `POST /api/v1/certificates`).

**.NET knižnica:**

V aplikácii Portos eKasa Servis (Windows), prípadne z vášho softvéru metódami klienta.

Čo balík obsahuje a ako ho podnikateľ získa, popisuje [Príprava prostredia](https://ekasa.ninedigit.sk/docs/environment-setup#inicializa%C4%8Dn%C3%BD-bal%C3%ADk).

**Potrebujem pri HTTP API aplikáciu Portos eKasa Servis?**

Nie. Všetko nastavíte vo webovom rozhraní služby. Aplikácia Portos eKasa Servis je určená pre .NET knižnicu.

Ak predsa používate obe na jednom počítači, pred spustením aplikácie Portos eKasa Servis zastavte službu eKasa
(a naopak). Používajú rovnaké súbory a úložisko smie naraz používať len jeden proces.

## Prevádzka

**Musím frontu neodoslaných správ spúšťať ručne?**

Nie. eKasa sama sleduje spojenie so systémom eKasa a neodoslané dátové správy odošle, hneď ako je to možné.
Podnikateľ však musí zabezpečiť, aby sa odoslali do 96 hodín od prvého pokusu o odoslanie
([§ 3 ods. 1 zákona č. 384/2025 Z. z.](https://www.slov-lex.sk/ezbierky-fe/pravne-predpisy/SK/ZZ/2025/384/20260101#paragraf-3.odsek-1)), preto stav fronty sledujte v
[kontrole stavu](https://ekasa.ninedigit.sk/docs/status).

**Čo znamená chyba „Chyba v podpise dátovej správy“?**

Systém eKasa odmietol doklad, lebo prišiel do iného prostredia, než pre ktoré je inicializačný balík: integračný balík
do produkčného prostredia alebo naopak. Rovnakú príčinu má aj hlásenie `Error during certificate path validation:
No trusted certs found`.

Od verzie 8 eKasa určuje prostredie automaticky podľa kódu pokladnice, takže chyba vzniká, len keď je prostredie
nastavené ručne. Nastavte ho na automatické: vo webovom rozhraní v nastaveniach v záložke **eKasa klient** pole
**Prostredie** na **(automaticky určené)**, pri .NET knižnici nechajte `Environment` v `EKasaClientConfiguration`
prázdne (`null`, predvolená hodnota).

**Ako vytlačím dennú uzávierku?**

Zákon uzávierky z pokladnice nevyžaduje. Uzávierky a štatistiky tlačí váš softvér ako
[nefiškálny doklad](https://ekasa.ninedigit.sk/docs/nonfiscal-receipt).

**Ako vytlačím mincovku?**

Ako [nefiškálny doklad](https://ekasa.ninedigit.sk/docs/nonfiscal-receipt).

**Ako zaintegrujem zákaznícky displej?**

Zákaznícky displej zákon nevyžaduje. Ak ho chcete, ovláda ho priamo váš softvér, eKasa s ním nepracuje.

## Doklady a legislatíva

**Ako zapracujem 400 eurový limit pre vystavenie zjednodušenej faktúry?**

Od 1. 1. 2025 nesmie kupujúci podnikateľ použiť doklad z eKasy ako zjednodušenú faktúru, ak suma presiahne 400 €,
bez ohľadu na spôsob platby. eKasa plnohodnotnú faktúru nevystavuje. Máte tieto možnosti:

1. faktúru vystavíte mimo eKasy, napríklad na formáte A4, a v eKase zaevidujete len jej
   [úhradu](https://ekasa.ninedigit.sk/docs/receipt-registration/receipt-types#%C3%BAhrada-fakt%C3%BAry),
2. faktúru vytlačíte ako [nefiškálny doklad](https://ekasa.ninedigit.sk/docs/nonfiscal-receipt),
3. zaevidujete úhradu faktúry a povinné údaje faktúry uvediete v texte hlavičky (`headerText`).

**Ako mám evidovať vyplatenie výhry zo stieracích žrebov?**

Predaj stieracích žrebov ani vyplatenie výhry nepodlieha povinnosti evidovať tržby. Ak je pre vás jednoduchšie
evidovať ich v eKase, použite položku so zápornou cenou a ako identifikátor pôvodného dokladu uveďte vhodný text,
napríklad „vyplata zrebu“.

**Ako mám evidovať výkup zlata?**

Výkup zlata nepodlieha povinnosti evidovať tržby, v eKase ho evidovať nemusíte.

Pri nejasnostiach, či sa niektorá tržba eviduje, sa obráťte na finančnú správu.

## Nenašli ste odpoveď?

- [Riešenie problémov](https://ekasa.ninedigit.sk/docs/troubleshooting): Známe chyby a ich riešenie.
- [Chybové kódy](https://ekasa.ninedigit.sk/docs/rest-api/error-codes): Význam kódov v chybových odpovediach.
- [Kontakt](https://ekasa.ninedigit.sk/#kontakt): Napíšte nám, radi pomôžeme.
