• Docs
• Nastavenia
• Smart POS
• SmartPOS nastavenia

SmartPOS nastavenia

Smart POS

V tejto sekcii pripojíš a nakonfiguruješ Smart POS terminály (fiskálne tlačiarne s platobným terminálom) pre jednotlivé pokladne. Sem prídeš, keď potrebuješ nastaviť IP adresu, porty, POIID alebo overiť, či sa doklad správne odoslal do fiskálnej jednotky. Používa sa hlavne pri inštalácii nového zariadenia alebo pri riešení problémov s fiskalizáciou.

Kde to nájdeš

Otvor ľavé menu a klikni na Nastavenia → Smart POS. Adresa v prehliadači bude /manager/settings/smartpos/.

Po výbere konkrétnej pokladne sa zobrazia tri vnútorné záložky:

• Výber pokladne – základná obrazovka pre výber zariadenia
• Overiť doklad – kontrola odoslaného dokladu podľa identifikátora
• Nastavnia – konfigurácia IP, portov a ďalších parametrov

Čo tu môžeš robiť

• Vybrať pokladňu – z rozbaľovacieho zoznamu zvolíš, ktorú pokladňu chceš konfigurovať. Po výbere sa automaticky načítajú jej nastavenia.
• Overiť doklad – zadáš identifikátor dokladu (ExternalId alebo id_ek) a systém ti zobrazí JSON odpoveď z fiskálnej jednotky. Používaš to, keď chceš skontrolovať, či sa účtenka správne zaregistrovala.
• Nastaviť IP a porty – vyplníš IP adresu Smart POS zariadenia, POIID, port pre fiskálnu časť a port pre platobný terminál. Po kliknutí na Uložiť sa konfigurácia zapíše do databázy.
• Otestovať pripojenie – pri poli „Port FISCAL" klikneš na Test a systém overí, či je zariadenie dostupné na zadanej IP a porte.
• Nastaviť cloudové pripojenie – ak používaš cloudový POS systém (OnePos, PC3000, Ignition), zaškrtneš „Cloud", vyplníš Cloud POS ID a Cloud Token a vybereš endpoint.
• Povoliť POS bez platobnej aplikácie – zaškrtneš „POS bez platobnej aplikácie", ak chceš uzatvárať účtenky bez použitia platobného terminálu.
• Povoliť výber uzavretia – zaškrtneš „Výber uzavretia s platbou aj bez", aby si pri uzatváraní mohol zvoliť, či použiješ platobný terminál alebo nie.
• Nastaviť externú tlačiareň – do poľa „External printer ip:port" zadáš adresu a port externej tlačiarne, ak ju používaš.
• Aktivovať Besteron – zaškrtneš „Besteron", ak tvoje zariadenie používa tento protokol.

Postup krok za krokom

Ako nastaviť novú Smart POS pokladňu

1. Otvor Nastavenia → Smart POS v ľavom menu.
2. V rozbaľovacom zozname Pokladňa vyber pokladňu, ktorú chceš konfigurovať. Ak je zoznam prázdny alebo chýba tvoja pokladňa, najprv ju pridaj v sekcii Nastavenia → Pokladne.
3. Klikni na záložku Nastavnia (v hornej časti obrazovky).
4. Vyplň pole IP – zadaj IP adresu Smart POS zariadenia (napr. 192.168.1.100).
5. Vyplň pole POIID – identifikátor platobného terminálu, ktorý ti poskytol dodávateľ.
6. Vyplň pole Port FISCAL – port pre komunikáciu s fiskálnou jednotkou (zvyčajne 3010 alebo 8080).
7. Klikni na Test vedľa poľa „Port FISCAL", aby si overil, či je zariadenie dostupné. Ak sa zobrazí chybová hláška, skontroluj IP adresu a port.
8. Vyplň pole Port POS – port pre komunikáciu s platobným terminálom (zvyčajne 3011 alebo 8081).
9. Ak používaš externú tlačiareň, vyplň pole External printer ip:port (napr. 192.168.1.101:9100).
10. Ak chceš povoliť uzatváranie účteniek bez platobného terminálu, zaškrtni POS bez platobnej aplikácie.
11. Ak chceš, aby si pri uzatváraní mohol vybrať, či použiješ platobný terminál, zaškrtni Výber uzavretia s platbou aj bez.
12. Ak tvoje zariadenie používa protokol Besteron, zaškrtni Besteron.
13. Klikni na tlačidlo Uložiť v spodnej časti formulára. Zobrazí sa hláška „Nastavenia boli uložené."
14. Otestuj nastavenie vytvorením testovacej účtenky v POS module.

Ako overiť, či sa doklad správne odoslal

1. Otvor Nastavenia → Smart POS a vyber pokladňu z rozbaľovacieho zoznamu.
2. Klikni na záložku Overiť doklad.
3. Do poľa Identifikátor dokladu zadaj ExternalId alebo id_ek dokladu, ktorý chceš skontrolovať. Tento identifikátor nájdeš v detaile účtenky alebo v logu transakcií.
4. Klikni na tlačidlo Overiť.
5. Systém vyhľadá doklad v databáze a zobrazí JSON odpoveď z fiskálnej jednotky. Ak sa doklad nenájde, skontroluj, či si zadal správny identifikátor.
6. V JSON odpovedi skontroluj pole status – ak je hodnota success alebo registered, doklad bol úspešne odoslaný. Ak je hodnota error, prečítaj si pole message s popisom chyby.

Ako nastaviť cloudové pripojenie

1. Otvor Nastavenia → Smart POS, vyber pokladňu a klikni na záložku Nastavnia.
2. Zaškrtni políčko Cloud.
3. Vyplň pole Cloud POS ID – identifikátor, ktorý ti poskytol cloudový poskytovateľ (napr. OnePos, PC3000).
4. Vyplň pole Cloud Token – autentifikačný token pre API komunikáciu. Tento token nájdeš v administrácii cloudového POS systému.
5. V rozbaľovacom zozname Endpoint vyber správny server:
   • Demo PC3000 – testovací server PC3000 (https://emsystem-dev.pc3000.sk/api/pos/)
   • OnePos Cloud – produkčný server OnePos (https://cloud.onepos.eu/api/pos/)
   • Produkcia PC3000 – produkčný server PC3000 (https://emsystem.pc3000.sk/api/pos/)
   • Ignition – server Ignition (https://cloud.ignition.sk/api/pos/)
6. Klikni na Uložiť.
7. Otestuj pripojenie vytvorením testovacej účtenky.

Polia, stĺpce a nastavenia

• Pokladňa – rozbaľovací zoznam všetkých pokladní definovaných v systéme. Po výbere sa načítajú nastavenia pre danú pokladňu. Ak tu nevidíš svoju pokladňu, pridaj ju najprv v sekcii Nastavenia → Pokladne.
• Identifikátor dokladu – pole pre zadanie ExternalId alebo id_ek dokladu, ktorý chceš overiť. ExternalId je interný identifikátor Ellipse, id_ek je identifikátor z fiskálnej jednotky. Oba nájdeš v detaile účtenky alebo v logu transakcií.
• IP – IP adresa Smart POS zariadenia v lokálnej sieti (napr. 192.168.1.100). Táto adresa musí byť statická (nie DHCP), aby sa zariadenie vždy nachádzalo na rovnakej adrese. Ak nevieš IP adresu, skontroluj ju v administrácii zariadenia alebo v nastaveniach routera.
• POIID – identifikátor platobného terminálu (Point of Interaction ID). Tento identifikátor ti poskytne dodávateľ platobného terminálu pri inštalácii. Používa sa na párovanie terminálu s fiskálnou jednotkou.
• Port FISCAL – port pre komunikáciu s fiskálnou časťou Smart POS zariadenia. Štandardne je to 3010 alebo 8080, ale môže sa líšiť podľa výrobcu. Vedľa tohto poľa je tlačidlo Test, ktorým overíš, či je zariadenie dostupné na zadanej IP a porte.
• Port POS – port pre komunikáciu s platobným terminálom. Štandardne je to 3011 alebo 8081. Tento port sa používa pri odosielaní platobných príkazov na terminál.
• External printer ip:port – IP adresa a port externej tlačiarne, ak ju používaš na tlač účteniek (napr. 192.168.1.101:9100). Toto pole vyplň len vtedy, ak chceš tlačiť účtenky na samostatnú tlačiareň namiesto zabudovanej tlačiarne v Smart POS zariadení.
• POS bez platobnej aplikácie – zaškrtnutím tohto políčka povolíš uzatváranie účteniek bez použitia platobného terminálu. Používaj to, ak tvoje zariadenie nemá platobný terminál alebo ak chceš prijímať len hotovostné platby. Pri uzatváraní účtenky sa neodošle príkaz na platobný terminál.
• Výber uzavretia s platbou aj bez – zaškrtnutím tohto políčka povolíš, aby si pri uzatváraní účtenky mohol vybrať, či chceš použiť platobný terminál alebo nie. Systém sa ťa pri každom uzatváraní opýta, či chceš platbu spracovať cez terminál. Toto nastavenie je užitočné, ak niekedy prijímaš hotovosť a inokedy karty.
• Besteron – zaškrtni toto políčko, ak tvoje Smart POS zariadenie používa komunikačný protokol Besteron. Tento protokol používajú niektoré modely fiskálnych tlačiarní. Ak nevieš, či ho používaš, skontroluj dokumentáciu zariadenia alebo sa opýtaj dodávateľa.
• Cloud – zaškrtnutím tohto políčka aktivuješ cloudové pripojenie k externému POS systému (OnePos, PC3000, Ignition). Po zaškrtnutí sa zobrazia ďalšie polia pre Cloud POS ID, Cloud Token a Endpoint. Používaj to, ak tvoje zariadenie komunikuje s cloudovým serverom namiesto lokálnej fiskálnej jednotky.
• Cloud POS ID – identifikátor tvojho POS zariadenia v cloudovom systéme. Tento identifikátor ti poskytne cloudový poskytovateľ pri registrácii zariadenia. Používa sa na autentifikáciu a párovanie zariadenia so serverom.
• Cloud Token – autentifikačný token pre API komunikáciu s cloudovým serverom. Token nájdeš v administrácii cloudového POS systému (napr. v sekcii „API Keys" alebo „Zariadenia"). Token je dlhý reťazec znakov, ktorý musíš skopírovať presne tak, ako je uvedený.
• Endpoint – rozbaľovací zoznam cloudových serverov. Vyber server, ktorý používaš:
  • Demo PC3000 – testovací server pre PC3000, používaj len na testovanie
  • OnePos Cloud – produkčný server OnePos
  • Produkcia PC3000 – produkčný server PC3000
  • Ignition – server Ignition
  Ak si nie si istý, ktorý server používaš, opýtaj sa svojho dodávateľa alebo IT administrátora.
• Uložiť – tlačidlo v spodnej časti formulára. Po kliknutí sa všetky vyplnené údaje zapíšu do databázy a zobrazí sa hláška „Nastavenia boli uložené." Ak sa hláška nezobrazí, skontroluj, či si vyplnil všetky povinné polia (IP, POIID, Port FISCAL, Port POS).
• Overiť – tlačidlo v sekcii „Overiť doklad". Po kliknutí systém vyhľadá doklad podľa zadaného identifikátora a zobrazí JSON odpoveď z fiskálnej jednotky. Ak sa doklad nenájde, zobrazí sa prázdna obrazovka.
• Test – odkaz vedľa poľa „Port FISCAL". Po kliknutí systém odošle testovací príkaz na zadanú IP adresu a port. Ak je zariadenie dostupné, zobrazí sa informácia o verzii softvéru alebo stave zariadenia. Ak je zariadenie nedostupné, zobrazí sa chybová hláška (napr. „Connection timeout" alebo „Connection refused").

Tipy a časté chyby

• Zariadenie nereaguje na testovací príkaz – najčastejšou príčinou je nesprávna IP adresa alebo port. Skontroluj, či je zariadenie zapnuté a pripojené do siete. Skús pingnúť IP adresu z príkazového riadku (ping 192.168.1.100). Ak ping nefunguje, skontroluj sieťové nastavenia zariadenia alebo firewall.
• Doklad sa nenašiel pri overení – uisti sa, že si zadal správny identifikátor. ExternalId nájdeš v detaile účtenky v Ellipse (zvyčajne je to číslo začínajúce na EXT-). Id_ek nájdeš v odpovedi z fiskálnej jednotky alebo v logu transakcií. Ak si zadal správny identifikátor a doklad sa stále nenašiel, účtenka sa pravdepodobne neodoslala do fiskálnej jednotky – skontroluj nastavenia IP a portov.
• Po uložení nastavení sa účtenky stále neposielajú – po zmene nastavení reštartuj POS aplikáciu alebo obnovuj stránku v prehliadači (Ctrl+F5). Niektoré zmeny sa prejavia až po reštarte. Ak problém pretrváva, skontroluj logy v sekcii Nastavenia → Systémové logy a hľadaj chybové hlášky súvisiace s fiskalizáciou.
• Cloudové pripojenie nefunguje – skontroluj, či si správne vyplnil Cloud POS ID a Cloud Token. Token musí byť skopírovaný presne tak, ako je uvedený v cloudovom systéme (vrátane veľkých a malých písmen). Skontroluj aj, či si vybral správny Endpoint – ak používaš produkčný server, nevyberaj demo server.
• Externá tlačiareň netlačí – uisti sa, že si zadal správnu IP adresu a port tlačiarne. Skontroluj, či je tlačiareň zapnutá a pripojená do siete. Väčšina sieťových tlačiarní používa port 9100, ale niektoré modely môžu používať iný port (napr. 515 alebo 631). Skontroluj dokumentáciu tlačiarne.
• Platobný terminál nereaguje – skontroluj, či je Port POS správne nastavený. Niektoré terminály vyžadujú špeciálnu inicializáciu pred prvým použitím – skontroluj dokumentáciu terminálu. Ak terminál nereaguje ani po správnom nastavení, skús ho reštartovať.
• Nastavenia sa neuložili – ak po kliknutí na Uložiť nevidíš hlášku „Nastavenia boli uložené", skontroluj, či máš oprávnenie na úpravu nastavení. Ak si bežný recepčný, možno nemáš práva na zmenu konfigurácie – požiadaj manažéra alebo administrátora.
• Nevidím svoju pokladňu v zozname – pokladňa musí byť najprv vytvorená v sekcii Nastavenia → Pokladne. Po vytvorení pokladne sa automaticky objaví v rozbaľovacom zozname v Smart POS nastaveniach.
• Besteron protokol nefunguje – uisti sa, že si zaškrtol políčko „Besteron" a že tvoje zariadenie skutočne podporuje tento protokol. Nie všetky Smart POS zariadenia používajú Besteron – skontroluj dokumentáciu zariadenia alebo sa opýtaj dodávateľa.
• JSON odpoveď pri overení dokladu je nečitateľná – JSON odpoveď je formátovaná pre programátorov, ale aj tak môžeš nájsť užitočné informácie. Hľadaj pole status (stav dokladu), message (chybová hláška) a receiptNumber (číslo účtenky). Ak nerozumieš odpovedi, skopíruj ju a pošli IT podpore.