• Docs
• Nastavenia
• Portos
• Portos nastavenia

Portos nastavenia

Portos nastavenia

Obrazovka Portos slúži na správu a diagnostiku pokladničných zariadení Portos, ktoré komunikujú s fiškálnym modulom. Sem prídeš, keď potrebuješ overiť stav pokladne, skontrolovať registráciu dokladov podľa UID, nastaviť server URL pre komunikáciu s Portos API alebo diagnostikovať pripojenie a certifikáty. Používaš ju pri riešení problémov s fiškalizáciou alebo pri overovaní, či sa doklad správne zaregistroval.

Kde to nájdeš

Otvor ľavé menu a klikni na Nastavenia → Portos. Adresa v prehliadači bude /manager/settings/portos/. Po otvorení uvidíš vnútorné záložky v hornej časti obrazovky:

• Výber pokladne – hlavná obrazovka na výber a nastavenie konkrétnej pokladne
• Hľadať podľa UID – vyhľadávanie dokladov podľa jedinečného identifikátora
• RFID – prehľad a kontrola RFID čítačiek pripojených k systému

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

• Overiť doklad – overenie registrácie dokladu v Portos
• Diagnostika – technický prehľad stavu tlačiarne, pripojenia, úložiska a certifikátov
• Nastavnia – konfigurácia server URL pre komunikáciu s Portos API

Čo tu môžeš robiť

• Vybrať pokladňu – z rozbaľovacieho zoznamu vyber konkrétnu pokladňu, ktorú chceš spravovať. Po výbere sa stránka automaticky obnoví a zobrazí nastavenia pre vybratú pokladňu.
• Nastaviť Server URL – zadaj alebo uprav URL adresu servera Portos, ktorý zabezpečuje komunikáciu s fiškálnym modulom. Po uložení sa nastavenie zapíše do systému.
• Hľadať doklad podľa UID – zadaj jedinečný identifikátor dokladu (UID) a vyhľadaj všetky záznamy o jeho registrácii. Zobrazí sa tabuľka s dátumom, pokladňou, typom dokladu, sumou a ďalšími údajmi.
• Skontrolovať RFID čítačky – otvor záložku RFID a zobraz zoznam všetkých RFID čítačiek s ich URL adresami a stavom pripojenia. Systém automaticky overí, či sú čítačky dostupné.
• Overiť doklad – po výbere pokladne prejdi do záložky Overiť doklad, zadaj identifikátor dokladu (External ID) a skontroluj jeho registráciu v Portos systéme.
• Spustiť diagnostiku – otvor záložku Diagnostika a zobraz technické informace o stave tlačiarne, pripojení k serveru, kapacite úložiska, poslednom dokladovom čísle a platnosti certifikátov.
• Zobraziť detail dokladu – v tabuľke výsledkov vyhľadávania klikni na ID dokladu alebo External ID a otvor detail dokladu v novej záložke prehliadača.

Postup krok za krokom

Ako vyhľadať doklad podľa UID

1. Otvor záložku Hľadať podľa UID v hornej časti obrazovky.
2. Do poľa UID zadaj jedinečný identifikátor dokladu, ktorý hľadáš (napríklad z chybovej hlášky alebo z logu).
3. Klikni na tlačidlo Vyhľadať.
4. Systém zobrazí tabuľku so všetkými záznamami, ktoré obsahujú zadaný UID. V tabuľke uvidíš dátum, pokladňu, External ID, druh dokladu (Faktúra alebo Doklad), ID dokladu, sumu, poznámku a používateľa.
5. Ak chceš otvoriť detail dokladu, klikni na číslo v stĺpci ID dokladu alebo External ID. Detail sa otvorí v novej záložke.
6. Ak sa nič nenašlo, skontroluj, či si zadal správny UID a či doklad bol skutočne zaregistrovaný v Portos systéme.

Ako nastaviť Server URL pre pokladňu

1. V rozbaľovacom zozname Pokladňa vyber pokladňu, pre ktorú chceš nastaviť server URL. Po výbere sa stránka automaticky obnoví.
2. V pravej časti obrazovky uvidíš formulár s poľom Server URL.
3. Do poľa zadaj úplnú URL adresu Portos servera (napríklad http://192.168.1.100:3010).
4. Klikni na tlačidlo Uložiť.
5. Ak sa nastavenie úspešne uložilo, zobrazí sa zelená hláška Nastavenia boli uložené.
6. Po uložení server URL sa automaticky aktivujú ďalšie funkcie ako diagnostika a overovanie dokladov.

Ako spustiť diagnostiku pokladne

1. Vyber pokladňu z rozbaľovacieho zoznamu Pokladňa.
2. Uisti sa, že je nastavená Server URL (ak nie, nastav ju podľa predchádzajúceho postupu).
3. Klikni na záložku Diagnostika v hornej časti obrazovky.
4. Systém automaticky načíta a zobrazí šesť diagnostických tabuliek:
   • Printer – stav tlačiarne (Ready alebo chybový stav)
   • Connectivity – stav pripojenia k serveru, platnosť od a do
   • Storage – informácie o úložisku (výrobca, verzia, sériové číslo, kapacita)
   • Last Item – posledné číslo dokladu pre danú pokladňu
   • Certificates – zoznam certifikátov s dátumom vydania, expirácie a stavom platnosti
   • Identities – identifikačné údaje pokladne (DIČ a ďalšie)
5. Skontroluj, či sú všetky stavy zelené (Ready, Up, False pri Is Expired). Ak vidíš červený stav, riešiť problém podľa zobrazenej chyby.

Ako skontrolovať RFID čítačky

1. Klikni na záložku RFID v hornej časti obrazovky.
2. Systém automaticky načíta zoznam všetkých nakonfigurovaných RFID čítačiek.
3. V tabuľke uvidíš stĺpce Názov, Url, Kontrola Url a RFID Bridge.
4. V stĺpci Kontrola Url sa zobrazí OK, ak je čítačka dostupná, alebo FAIL, ak nie je dostupná.
5. V stĺpci RFID Bridge sa zobrazí stav Healthy, ak je čítačka funkčná, alebo chybová hláška, ak nie je.
6. Ak vidíš FAIL alebo chybový stav, skontroluj sieťové pripojenie čítačky a jej konfiguráciu.

Polia, stĺpce a nastavenia

• Pokladňa (rozbaľovací zoznam) – zoznam všetkých pokladní nakonfigurovaných v systéme. Vyber pokladňu, ktorú chceš spravovať. Po výbere sa stránka automaticky obnoví a zobrazí nastavenia pre vybratú pokladňu. Ak nevidíš žiadnu pokladňu, znamená to, že ešte nie sú nakonfigurované v systéme.
• Server URL – URL adresa Portos servera, ktorý zabezpečuje komunikáciu s fiškálnym modulom. Musíš zadať úplnú adresu vrátane protokolu a portu (napríklad http://192.168.1.100:3010). Bez nastavenej Server URL nebudú fungovať diagnostika ani overovanie dokladov.
• UID (pole na vyhľadávanie) – jedinečný identifikátor dokladu, ktorý bol zaregistrovaný v Portos systéme. UID získaš z logu, chybovej hlášky alebo z detailu dokladu. Po zadaní UID a kliknutí na Vyhľadať sa zobrazia všetky záznamy o registrácii tohto dokladu.
• Dátum (stĺpec v tabuľke) – dátum a čas registrácie dokladu v Portos systéme. Formát je DD.MM.YYYY HH:MM:SS. Tento údaj ti pomôže identifikovať, kedy bol doklad zaregistrovaný a či sa časové údaje zhodujú s očakávaním.
• Pokladňa (stĺpec v tabuľke) – názov pokladne, na ktorej bol doklad zaregistrovaný. Tento údaj je dôležitý, ak máš viacero pokladní a potrebuješ vedieť, ktorá z nich doklad spracovala.
• External ID (stĺpec v tabuľke) – externý identifikátor dokladu, ktorý sa používa na prepojenie medzi Ellipse Cloud a Portos systémom. Kliknutím na External ID otvoríš detail overenia dokladu v Portos. Tento identifikátor je unikátny pre každý doklad.
• Druh dokladu (stĺpec v tabuľke) – typ dokladu, ktorý bol zaregistrovaný. Môže byť Faktúra alebo Doklad. Tento údaj ti pomôže rýchlo identifikovať, o aký typ dokladu ide.
• ID dokladu (stĺpec v tabuľke) – interné ID dokladu v systéme Ellipse Cloud. Kliknutím na ID dokladu otvoríš detail dokladu v novej záložke. Tento odkaz ťa presmeruje priamo na doklad v module Pokladňa alebo Faktúry.
• Suma (stĺpec v tabuľke) – celková suma dokladu, ktorá bola zaregistrovaná v Portos systéme. Tento údaj by sa mal zhodovať so sumou v detaile dokladu v Ellipse Cloud.
• Poznámka (stĺpec v tabuľke) – dodatočná poznámka k registrácii dokladu. Môže obsahovať informácie o chybe, stave registrácie alebo iné technické údaje.
• Používateľ (stĺpec v tabuľke) – meno používateľa, ktorý doklad vytvoril a zaregistroval. Tento údaj ti pomôže identifikovať, kto bol zodpovedný za vytvorenie dokladu.
• Názov (stĺpec v tabuľke RFID) – názov RFID čítačky nakonfigurovanej v systéme. Tento názov je definovaný v konfigurácii a pomáha identifikovať konkrétnu čítačku.
• Url (stĺpec v tabuľke RFID) – URL adresa RFID čítačky. Táto adresa sa používa na komunikáciu so čítačkou a overenie jej dostupnosti.
• Kontrola Url (stĺpec v tabuľke RFID) – výsledok kontroly dostupnosti RFID čítačky. Zobrazí sa OK, ak je čítačka dostupná, alebo FAIL, ak nie je. Systém automaticky vykoná HTTP požiadavku na URL čítačky a overí odpoveď.
• RFID Bridge (stĺpec v tabuľke RFID) – stav RFID Bridge služby. Zobrazí sa Healthy, ak je služba funkčná, alebo chybová hláška, ak nie je. Tento údaj je dôležitý pre diagnostiku problémov s RFID čítačkami.
• State (diagnostika Printer) – aktuálny stav tlačiarne. Zobrazí sa Ready (zelene), ak je tlačiareň pripravená, alebo chybový stav (červene), ak nie je. Tento údaj ti pomôže rýchlo identifikovať, či je tlačiareň funkčná.
• Valid From / Valid To (diagnostika Connectivity) – dátum platnosti pripojenia k Portos serveru. Skontroluj, či je aktuálny dátum v rozmedzí týchto dátumov. Ak nie, pripojenie môže byť neplatné a je potrebné obnoviť certifikát alebo konfiguráciu.
• State (diagnostika Connectivity) – stav pripojenia k Portos serveru. Zobrazí sa Up (zelene), ak je pripojenie aktívne, alebo chybový stav (červene), ak nie je. Tento údaj je kľúčový pre diagnostiku problémov s komunikáciou.
• Capacity Total / Used (diagnostika Storage) – celková a použitá kapacita úložiska Portos zariadenia. Skontroluj, či nie je úložisko plné. Ak je použitá kapacita blízko celkovej, môže to spôsobiť problémy s registráciou dokladov.
• Receipt Number (diagnostika Last Item) – posledné číslo dokladu zaregistrované v Portos systéme pre danú pokladňu. Tento údaj ti pomôže overiť, či sa doklady registrujú v správnom poradí.
• Is Expired (diagnostika Certificates) – stav platnosti certifikátu. Zobrazí sa False (zelene), ak je certifikát platný, alebo True (červene), ak vypršal. Ak certifikát vypršal, je potrebné ho obnoviť, inak nebude možné registrovať doklady.

Tipy a časté chyby

• Server URL nie je nastavená – ak po výbere pokladne nevidíš záložky Diagnostika a Overiť doklad, znamená to, že nie je nastavená Server URL. Najprv zadaj Server URL v pravom formulári a klikni na Uložiť. Až potom sa aktivujú ďalšie funkcie.
• Vyhľadávanie podľa UID nič nenašlo – skontroluj, či si zadal správny UID (bez medzier a špeciálnych znakov). Ak je UID správne a stále sa nič nenašlo, znamená to, že doklad nebol zaregistrovaný v Portos systéme. Skontroluj, či bola pokladňa v čase vytvorenia dokladu online a či nebola chyba pri registrácii.
• RFID čítačka zobrazuje FAIL – ak vidíš FAIL v stĺpci Kontrola Url, znamená to, že čítačka nie je dostupná na zadanej URL adrese. Skontroluj, či je čítačka zapnutá, pripojená k sieti a či je URL adresa správna. Skús otvoriť URL adresu v prehliadači a overiť, či čítačka odpovedá.
• Certifikát vypršal (Is Expired = True) – ak vidíš červený stav True pri Is Expired v diagnostike Certificates, znamená to, že certifikát pokladne vypršal a nie je možné registrovať nové doklady. Kontaktuj technickú podporu alebo dodávateľa Portos zariadenia a požiadaj o obnovenie certifikátu.
• Stav tlačiarne nie je Ready – ak vidíš červený stav v diagnostike Printer, znamená to, že tlačiareň nie je pripravená na tlač. Skontroluj, či je tlačiareň zapnutá, či má papier a či nie je zaseknutý papier. Reštartuj tlačiareň a znova spusti diagnostiku.
• Pripojenie k serveru je Down – ak vidíš červený stav Down v diagnostike Connectivity, znamená to, že pokladňa nemá pripojenie k Portos serveru. Skontroluj sieťové pripojenie, firewall a či je Server URL správne nastavená. Skús pingnúť server z počítača, na ktorom beží pokladňa.
• Úložisko je takmer plné – ak vidíš, že Capacity Used je blízko Capacity Total, je potrebné vymazať staré doklady z úložiska alebo rozšíriť kapacitu. Kontaktuj technickú podporu Portos a požiadaj o návod na vymazanie starých dát.
• External ID nefunguje ako odkaz – ak klikneš na External ID a nič sa nestane, skontroluj, či je Server URL správne nastavená a či je pokladňa online. Odkaz funguje len vtedy, ak je možné komunikovať s Portos serverom.
• Diagnostika sa nenačíta – ak sa po kliknutí na záložku Diagnostika nič nezobrazí alebo sa zobrazí chyba, znamená to, že Server URL nie je dostupná alebo je nesprávna. Skontroluj, či je server zapnutý a či je URL adresa správna. Skús otvoriť URL adresu v prehliadači a overiť, či server odpovedá.
• Pokladňa sa nezobrazuje v zozname – ak nevidíš žiadnu pokladňu v rozbaľovacom zozname, znamená to, že ešte nie sú nakonfigurované pokladne v systéme. Prejdi do modulu Nastavenia → Pokladne a pridaj aspoň jednu pokladňu s typom Portos.