Pokyny na pripojenie Android terminálu PAX A930 k programu Torgsoft prostredníctvom protokolu JSON cez Wi-Fi. Terminál PAX A930 môže s Torgsoftom pracovať v dvoch rôznych režimoch:
1.
priamo cez JSON (COM/TCP) — ide o odporúčanú a stabilnejšiu možnosť;
2.
cez WebSocket a aplikáciu «Pokladničná integrácia» — ide o starší a menej stabilný spôsob.
Pred nastavením si určite overte, ktorý režim banka skutočne aktivovala.
Tento návod predpokladá zmenu nastavení bankového terminálu, siete a integračných parametrov v programe Torgsoft, preto ho treba vykonávať pozorne. Ak si pomýlite režim pripojenia, IP adresu, port alebo typ protokolu, terminál môže úplne prestať prijímať príkazy z pokladne a platby sa môžu začať končiť časovými limitmi alebo chybou DeviceBusy. Pred vykonaním zmien sa uistite, že vám banka už oznámila, v akom režime má terminál pracovať — priamy JSON alebo WebSocket cez aplikáciu «Pokladničná integrácia». Ak nemáte prístup k sieťovým nastaveniam alebo parametrom terminálu, obráťte sa na technickú podporu banky alebo na systémového administrátora.
Kedy je potrebné pripojiť alebo prekonfigurovať PAX A930
•
Pri pripojení cez Wi-Fi alebo Ethernet: po zmene routera, poskytovateľa internetu alebo nastavení lokálnej siete (keď sa zmení IP adresa).
•
Pri pripojení cez USB: po zmene COM portu. Stáva sa to pri výmene počítača, použití iného USB adaptéra alebo ak bol kábel terminálu jednoducho zapojený do iného USB portu a už si nikto nepamätá, kde bol pripojený predtým.
•
Ak sa objavia chyby komunikácie («Zariadenie je zaneprázdnené», časové limity).
Podľa skúseností technickej podpory sa pri káblovom (USB) pripojení číslo COM portu často automaticky zmení operačným systémom Windows, ak je kábel zapojený do iného konektora alebo sa použije nový adaptér. Program Torgsoft v takom prípade terminál «stratí», preto je potrebné nastavenia aktualizovať. Zmeny pre Wi-Fi/Ethernet sa týkajú výlučne sieťových parametrov (IP, router, porty).
Ako zistiť, že terminál je nastavený nesprávne
•
Chyba DeviceBusy («Zariadenie je zaneprázdnené») pri pokuse o platbu.
•
Hlásenie «Čas čakania na odpoveď vypršal» (peniaze boli stiahnuté, ale doklad sa nevytlačil).
•
Terminál sa «neprebudí» po stlačení tlačidla «Zaplatiť» v pokladni.
Prečo PAX A930 stráca spojenie s Torgsoftom
•
Zmena IP adresy terminálu (DHCP) po reštarte routera.
•
Na termináli nie je spustená (alebo je minimalizovaná) aplikácia «Pokladničná integrácia».
•
Porty 3000/2000 sú blokované antivírusom alebo firewallom.
•
Príliš krátky časový limit čakania v nastaveniach Torgsoftu.
Ako nastaviť PAX A930 pre prácu s Torgsoftom
1. Ako pripraviť sieť pre fungovanie terminálu
•
Pripojte PAX A930 k tej istej Wi-Fi sieti ako počítač s programom Torgsoft.
•
Povinné: nastavte na termináli statickú IP adresu alebo ju rezervujte v routeri podľa MAC adresy.
•
Riziko: bez rezervácie sa môže IP adresa terminálu po reštarte routera alebo po vypršaní DHCP prenájmu zmeniť a spojenie s Torgsoftom sa stratí.
2. Ktorý spôsob pripojenia použiť
Spôsob 1: Ako funguje priame pripojenie JSON (COM/TCP)
Ide o moderný a spoľahlivejší spôsob integrácie. Umožňuje programu Torgsoft komunikovať s terminálom priamo, bez potreby inštalovať a neustále udržiavať spustené ďalšie sprostredkovateľské programy (napríklad WebSocket servery) na počítači pokladníka.
•
Čo je potrebné urobiť: kontaktujte technickú podporu vašej banky a požiadajte ju, aby nastavila terminál PAX A930 na prácu práve cez protokol JSON (TCP/COM) cez Wi-Fi.
•
Sieť: nezabudnite rezervovať IP adresu terminálu v nastaveniach routera, aby sa po reštarte nemenila.
•
V Torgsofte: v nastaveniach bankového terminálu v programe Torgsoft stačí zvoliť protokol JSON (COM/TCP) a zadať IP adresu a port.
•
Výhody: tento spôsob funguje stabilnejšie, umožňuje programu viesť podrobný záznam operácií na termináli a výrazne znižuje riziko chýb a straty spojenia.
Spôsob 2: Kedy sa používa WebSocket cez «Pokladničnú integráciu»
Táto metóda sa stále používa, ale technická podpora ju považuje za zastaranú a menej stabilnú, pretože vyžaduje spustený WebSocket server na PC.
•
Na hlavnej obrazovke Androidu vášho terminálu otvorte aplikáciu «Pokladničná integrácia».
•
Vyberte typ: «WIFI PRIPOJENIE».
•
Skontrolujte stav: na obrazovke má blikať zelený indikátor pripojenia.
•
Kriticky dôležité (riziká): terminál musí v tomto režime vždy zostať s otvorenou aplikáciou. Ak pokladník prejde do hlavnej ponuky Androidu, omylom aplikáciu minimalizuje alebo sa na termináli spustí nejaká iná operácia na pozadí, pokus o odoslanie sumy z programu Torgsoft povedie k chybe «Zariadenie je zaneprázdnené» (DeviceBusy) a program bude dlho čakať na odpoveď.
Ďalší tip. Ak sa momentálne stretávate s neustálym zamŕzaním alebo chybami typu «DeviceBusy», odborníci technickej podpory Torgsoft dôrazne odporúčajú prekonfigurovať váš terminál PAX A930 zo starého protokolu JSON (WebSocket) na priamy JSON (COM/TCP).
3. Ako nastaviť terminál v programe Torgsoft
Ponuka: Nastavenia → Parametre → Dodatočné funkcie → Bankový terminál.
Ďalšie nastavenia závisia od toho, aký typ pripojenia vám nastavila banka:
Spôsob 1: Nastavenia pre priame pripojenie JSON (TCP/COM) — Odporúčané
Tento spôsob sa používa vtedy, keď terminál komunikuje s Torgsoftom priamo po sieti.
•
Typ protokolu: zvoľte JSON (COM/TCP).
•
IP adresa: zadajte statickú IP adresu samotného bankového terminálu, ktorú ste mu predtým priradili alebo rezervovali v nastaveniach routera.
•
Port: zvyčajne sa používa port 2000 (alebo 2001, 2100 atď. — presný port musí pri nastavovaní poskytnúť technická podpora banky).
•
Merchant: nechajte prázdne alebo zadajte 0. V prípade terminálu PAX A930 sa výber merchantu (ak máte viacero FOP/obchodných účtov) často vykonáva priamo na obrazovke samotného terminálu počas platby.
Spôsob 2: Nastavenia cez WebSocket/JSON (zastaraný spôsob)
Tento spôsob sa používa vtedy, ak musí byť na počítači pokladníka na komunikáciu s terminálom nevyhnutne spustený program na pozadí od banky (WebSocket server, napríklad genericDriverJson alebo POSsvc.exe).
•
Typ protokolu: zvoľte WebSocket/JSON.
•
IP adresa hostiteľa: tu sa zadáva IP adresa počítača, na ktorom je spustený WebSocket server (ak je program-ovládač spustený na tom istom počítači ako Torgsoft, zadáva sa lokálna adresa, napríklad localhost alebo 127.0.0.1).
•
Port: vždy 3000 (to je štandardný port pre službu WebSocket).
•
Merchant: nechajte prázdne alebo zadajte 0.
Je kriticky dôležité nezamieňať si IP adresy: pri priamom pripojení (Spôsob 1) sa uvádza IP terminálu, zatiaľ čo pri práci cez WebSocket (Spôsob 2) sa uvádza IP počítača, na ktorom beží ovládač.
4. Aký časový limit je potrebné nastaviť
•
Nastavte parameter «Časový limit odpovede» na minimálne 180 sekúnd.
•
Prečo: Torgsoft dostane signál o úspechu až po vytlačení dokladu na termináli. Ak je časový limit príliš krátky (60 s), program preruší spojenie a zruší doklad v databáze, hoci peniaze klientovi už budú stiahnuté.
5. Čo zohľadniť pri vrátení tovaru
•
Zapnite možnosť: «Použiť službu».
•
Na vrátenie je potrebný kód RRN (autorizačný kód) z papierového dokladu o predaji.
•
Tento kód zadáva pokladník ručne na klávesnici terminálu, keď si ho zariadenie vyžiada.
Ako overiť, že terminál funguje správne
1.
Uistite sa, že je na termináli aktívny zelený indikátor.
2.
Vykonajte testovací predaj za 1,00 UAH.
3.
Terminál musí aktivovať čítačku kariet.
4.
Po platbe sa má doklad v programe Torgsoft automaticky uzavrieť.
Ako predísť poruchám pri prevádzke PAX A930
•
Nedovoľte personálu hrať hry alebo pozerať YouTube na termináli (je to Android zariadenie, ale musí zostať v pokladničnom režime).
•
Sledujte stav batérie: pri menej než 15 % môže Wi-Fi modul pracovať nestabilne.
Čo je dôležité si zapamätať
Ak terminál neodpovedá — najprv skontrolujte, či je spustená aplikácia «Pokladničná integrácia» a či sa nezmenila IP adresa.
Vráťte sa na predchádzajúci krok