03 — Pokladničný predaj (pokladnica v prehliadači + eKasa)

Stav: návrh na diskusiu, revízia 30. 10. 2026. Legislatíva: zákon č. 384/2025 Z. z. o evidencii tržieb (účinný od 1. 1. 2026, nahradil zákon č. 289/2008 Z. z.). Body (overiť) potvrdiť s Finančnou správou, daňovým poradcom alebo dodávateľom.

1. Čo hovorí zákon (to podstatné pre návrh)

Zákon pozná tri druhy pokladníc:

Ďalšie pravidlá:

• Od 1. 5. 2026 povinná bezhotovostná platba pri predaji nad 1 €. Splní ju aj QR kód s platobnými údajmi na doklade — terminál nie je zákonne nutný.
• Výpadok internetu alebo cloudu SORP → vystavujú sa paragóny v dvoch vyhotoveniach (originál zákazníkovi, kópia ostáva) a do pokladnice sa zaevidujú do 10 dní po obnovení prevádzky.
• Porucha pokladnice → obnoviť do 96 hodín od konca dňa vzniku, inak prejsť na inú pokladnicu. Výpadok internetu sa za poruchu nepovažuje.

Dôsledok: „žiadny offline“ je v poriadku — SORP offline režim ani nemá. Pri výpadku sa predáva na paragóny a pokladník ich neskôr dopíše cez obrazovku „Dopísať paragóny“ v našej pokladnici.

2. Evidencia tržieb — finálne riešenie

✅ Rozhodnuté 30. 10. 2026: - Hlavné riešenie: LLARIK — cloudový SORP cez API, pre predajňu, e-shop aj vodiča. Na predajni len bežná tlačiareň, žiadne CHDÚ. - Záloha: SuperKasa (SORP) — ak LLARIK nesplní podmienky nižšie, alebo pri dlhodobých problémoch s prevádzkou. - Porovnanie a zdôvodnenie: 05-porovnanie-ekasa.md.

Podmienky pred podpisom zmluvy s LLARIK

1. Číslo a dátum certifikátu FS podľa § 6 zákona č. 384/2025 Z. z. (overiť aj priamo na FS, nielen od dodávateľa).
2. Sandbox a dokumentácia API — otestovať všetky doklady: predaj, vrátenie, neplatný, vklad, výber, úhrada faktúry, poukazy, dopísanie paragónov.
3. Výstup na tlač (ESC/POS, obrázok alebo PDF) a e-mailový doklad.
4. Cenník pre 1 predajňu + e-shop + vodiča; SLA 99,95 % v zmluve; export dát a archívu pri ukončení.

Ak niektorá podmienka neprejde → rovnaký test so SuperKasou.

Čo o LLARIK vieme (web, 30. 10. 2026)

Záloha — čo o SuperKase vieme (web, 30. 10. 2026)

Dopady na návrh

• eKasa adaptér — LLARIK je prvá implementácia, SuperKasa druhá (záloha); prepnutie bez zmeny pokladnice.
• Tlač (SuperKasa): SuperKasa vracia PDF. Pre pokladničnú tlačiareň (CloudPRNT) ho na serveri prevedieme na obrázok 80 mm, alebo zákazníkovi doklad pošleme e-mailom / ukážeme QR na displeji.
• E-shop: pri platbe kartou cez Comgate SuperKasa sama uvádza, že povinnosť dokladu „závisí od modelu platobnej brány a zmluvných vzťahov“ — overiť s daňovým poradcom. Platba pri osobnom odbere a pri rozvoze naším autom doklad vyžaduje; dobierka cez kuriéra spravidla nie.
• Vodič: inkaso pri rozvoze cez ten istý cloudový SORP — bez ďalšieho zariadenia.

Pôvodné porovnanie dodávateľov

Náš server na Vercel pošle doklad cez API do certifikovanej SORP, tá ho podpíše, zaeviduje v eKasa a vráti UID, číslo dokladu, QR kód a PDF. Na predajni nie je nič okrem tlačiarne.

Výber podmieniť: (1) je na zozname certifikovaných programov FS, (2) má zdokumentované API pre všetky typy dokladov (predaj, vrátenie, vklad, výber, úhrada faktúry, poukazy), (3) testovacie prostredie, (4) cena za pokladnicu / doklad, (5) SLA a kde beží cloud (EÚ).

Záloha: ORP s CHDÚ ovládaná cez cloud — Nine Digit (Portos eKasa)

Overený, dlho používaný dodávateľ. CHDÚ (CHDU-SK / CHDU Lite) s tlačiarňou je fyzicky na predajni, ale Nine Digit má eKasa Cloud: náš server pošle príkaz do ich cloudu a ten ho doručí zariadeniu na predajni. Nevýhoda: zariadenie na predajni a pri výpadku internetu ho cloud nedosiahne (aj tak by sme išli na paragóny). (overiť, aký počítač/zariadenie musí bežať pri CHDÚ)

Návrh postupu: osloviť LLARIK, SuperKasa a Nine Digit s rovnakým zoznamom otázok (príloha nižšie), rozhodnúť podľa certifikátu a kvality API. Naša aplikácia bude mať vlastné rozhranie (adaptér) na eKasu, aby sa dodávateľ dal vymeniť bez zmeny pokladnice.

3. Schéma komunikácie

flowchart LR
  subgraph SHOP["Predajňa — žiadny server"]
    POS["Pokladnica<br/>prehliadač na tablete / PC"]
    SCAN["Skener EAN / QR<br/>(ako klávesnica)"]
    PRN["Sieťová tlačiareň 80 mm<br/>CloudPRNT + zásuvka"]
    TERM["Platobný terminál"]
    DISP["Displej pre zákazníka<br/>(druhé okno prehliadača)"]
  end

  subgraph VERCEL["Jadro — Vercel"]
    API["API pokladnice<br/>predaj, smeny, ceny"]
    ADP["eKasa adaptér"]
    PQ["Tlačová fronta"]
    DB[("MongoDB Atlas")]
  end

  subgraph EXT["Externé"]
    SORP["SORP — certifikovaná<br/>softvérová pokladnica"]
    EKASA["eKasa FS SR"]
    TCLOUD["Cloud terminálu<br/>*(overiť)*"]
  end

  SCAN --> POS
  POS <-->|"HTTPS"| API
  POS -.-> DISP
  API --> DB
  API --> ADP
  ADP <-->|"REST API: doklad → UID, QR, PDF"| SORP
  SORP <--> EKASA
  API --> PQ
  PRN -->|"HTTPS polling každých pár sekúnd"| PQ
  API <-->|"suma, výsledok platby"| TCLOUD
  TCLOUD <--> TERM

Tlač bez lokálneho počítača

Prehliadač nevie priamo ovládať pokladničnú tlačiareň, preto použijeme tlačiareň s cloudovou tlačou: Star Micronics (CloudPRNT) alebo Epson TM-m30 (Server Direct Print). Tlačiareň sa sama každých pár sekúnd pýta nášho servera na Vercel, či má niečo vytlačiť. Funguje cez bežný internet na predajni, bez nastavovania siete. Zásuvka sa pripája k tlačiarni a otvára ju príkaz z tlače.

Platobný terminál v cloudovom režime

Prehliadač ani Vercel sa nevedia pripojiť na terminál VÚB v lokálnej sieti (protokol ECR). Možnosti:

Návrh: a) ako cieľ (najprv sa opýtať Comgate, keďže s nimi bude e-shop), b) + c) na prechodné obdobie.

4. Priebeh predaja

sequenceDiagram
  autonumber
  actor P as Pokladník
  participant POS as Pokladnica (prehliadač)
  participant C as Jadro (Vercel)
  participant T as Terminál (cloud)
  participant K as SORP → eKasa
  participant PR as Tlačiareň
  P->>POS: skenuje tovar / načíta QR objednávky
  POS->>C: cena, akcia, zákaznícka zľava, zásoba
  P->>POS: zákazník: QR vernosti / IČO firmy
  POS->>C: zaplatiť 459,00 € kartou
  C->>T: suma 459,00 €
  T-->>C: schválené, autorizačný kód
  C->>K: doklad (položky, DPH, platba)
  K-->>C: UID, číslo dokladu, QR, PDF
  C->>C: odpis zásoby, body lojality, CRM
  PR->>C: je niečo na tlač?
  C-->>PR: doklad (+ otvoriť zásuvku pri hotovosti)
  C-->>POS: hotovo (+ e-mail dokladu, záruka)

5. Potrebné časti

5.1 Hardvér (na 1 pokladničné miesto)

Žiadny CHDÚ (pri SORP), žiadny lokálny server.

5.2 Funkcie pokladnice

Predaj

• predaj skenom / vyhľadaním (rovnaké parametrické vyhľadávanie ako e-shop)
• zásoba na predajni / v sklade / „na ceste“
• výdaj Click & Collect cez QR alebo kód objednávky
• zákazník na pokladni: QR vernosti z mobilu, B2B podľa IČO → správny cenník
• akcie, kupóny, vouchery, lojalitné zľavy — počíta jadro, nie pokladnica
• zaznamenanie sériového čísla spotrebiča (záruka, reklamácie)
• predaj služieb: doprava, vynáška, zapojenie, predĺžená záruka
• spätný odber starého spotrebiča pri predaji nového (overiť rozsah povinnosti)
• doplnkový predaj: ponuka súvisiaceho tovaru

Platby

• hotovosť, karta, QR platba, kombinovaná platba
• úhrada faktúry v hotovosti (doklad „úhrada faktúry“)
• predaj a uplatnenie poukazov (jednoúčelový vs. viacúčelový — rozdielne DPH (overiť s účtovníčkou))
• záloha za objednaný tovar

Doklady eKasa (cez SORP API)

• pokladničný doklad, neplatný doklad, vrátenie tovaru
• vklad a výber hotovosti
• kópia dokladu, doklad e-mailom (so súhlasom zákazníka)
• dopísanie paragónov po výpadku (do 10 dní)

Smena a hotovosť

• prihlásenie pokladníka (PIN, prípadne passkey), práva podľa role
• otvorenie smeny, počiatočný stav, priebežný a záverečný prehľad, rozdiel v hotovosti
• denný súhrn pre účtovníctvo (Money)

Sklad z pokladne

• príjem tovaru skenom, presun predajňa ↔ sklad, inventúra po regáloch
• tlač cenoviek pri zmene ceny

5.3 Softvér, ktorý vyvinieme

6. Migrácia z MOPWIN / KASAWIN

1. Export kmeňových dát z MOPWIN (tovar, EAN, ceny, zásoby, odberatelia) (overiť formát u Ventus).
2. Registrácia novej pokladnice (SORP) na portáli FS, nové identifikačné údaje; starú ORP ukončiť podľa postupu FS vrátane uchovania dát z pôvodného CHDÚ.
3. Inventúra k dátumu prechodu → počiatočné stavy v novom sklade.
4. Skúšobná prevádzka v testovacom prostredí dodávateľa SORP → ostrý štart.

Príloha — otázky pre dodávateľov SORP / ORP

1. Ste na zozname certifikovaných programov FS? Číslo a dátum certifikátu.
2. Dokumentácia REST API, testovacie prostredie, autentifikácia.
3. Podporované doklady: predaj, neplatný, vrátenie, vklad, výber, úhrada faktúry, poukazy, dopísanie paragónov.
4. Čo vrátite po doklade (UID, OKP, QR, PDF, ESC/POS dáta na tlač)?
5. Viac pokladníc pod jedným DIČ, mobilná pokladnica pre vodiča?
6. Cena: zriadenie, mesačne za pokladnicu, za doklad.
7. Dostupnosť (SLA), kde beží cloud, export dát pri ukončení zmluvy.