gePOS APK pre Android

je aplikácia pre mobilné zariadenia, predovšetkým pre Sunmi P2-EU a Ingenico DX8000, ale aj pre príbuzné zariadenia (T2, V2s, ...)

Začíname s gePOS APK pre Android

Po vybalení zariadenia prekontrolujte jeho stav, teda neporušenosť a ak je zariadenie mobilné, tak jeho nabitie. Prípadné nezrovnalosti vyriešte. Pre postup uvedenia do prevádzky využite pribalený leták ak existuje.


Začíname s gePOS APK pre Android

Platobný terminál ingenico AXIUM DX8000 a SUNMI P2-EU

Tieto zariadenia patria do kategórie mobilných zariadení so zameraním na mobilný predaj. Umožňujú vytváranie dokladov predaja a realizáciu bezhotovostnej platby. V plnej konfigurácii teda majú funkcie All-in-one: registračná pokladnica eKasa + bezhotovostné platby + internet + web číselníky, operácie a vyhodnotenia.

Dodávame ich s nainštalovanou aplikáciou gePOS, ktorá umožňuje samostatné fungovanie, alebo online prepojenie s web systémom:

Zariadenia v sebe obsahujú platobné funkcie sprostredkovateľa Besteron. V súčastnosti už distribujeme novšie modely ingenico AXIUM DX8000, terminál ktorý má novší operačný systém Android, ako pôvodné zariadenie SUNMI P2. Funkcie sú však obdobné a aplikácia je identická.

Zariadenia sú certifikované pre náš trh a sú programovo zabezpečené proti narušeniu (kreknutiu). Ich prvotnú distribúciu, vloženie CHDU, aktiváciu platobnej brány a potrebné prvotné úkony i následný servis a hotline zabezpečuje spoločnosť Besteron online formou. Spoločnosť Besteron taktiež združene faktúruje všetky služby a moduly. Z našej strany sa staráme o naše aplikácie (gePOS) a nepožadujeme odpaltu za naše základné služby.

Začíname s gePOS APK pre Android

Besteron APK - nastavenia a práca

Tento popis je redundantný, keďže spoločnosť Besteron dodáva letáky a má portál pre platobnú aplikáciu, kde je poradňa. Avšak pre úplnosť tu uvedieme bežné praktiky.

ico_besteron_a.png Samostatnú platbu mimo aplikáciu pre predaj, plus nastavenia platobného terminálu zrealizujete klikom na ikonu Besteron.

Nastavenia

klikom na ikonu menu sa toto rozbalí a kliknite na Nastavenia, kde zadáte heslo 360063

Uzávierka

klikom na ikonu menu sa toto rozbalí a kliknite na Uzávierka. Zobrazené detaily o financiách môžete vytlačiť tlačidlom MEDZISÚČET, alebo vytlačiť a vynulovať tlačidlom UZÁVIERKA.

Sprepitné mimo gePOS

ak ste povolili sprepitné, potom pri manálnom zadaní platenej sumy je postup taký, že kliknete na Predaj a zadáte sumu z dokladu a stalčíte POTVRDIŤ. Potom zadáte koncovú čiastku aj so sprepitným a stalčíte POTVRDIŤ. Ďalej už realizujete platbu požadovaným spôsobom.

Sprepitné cez gePOS

ak ste povolili sprepitné, potom pri manálnom zadaní platenej sumy je postup taký, že kliknete v gePOS APK na Platba kartou a vyvolá sa intent Besteron - platobný terminál, kde je pod zadávanou sumou zobrazená suma z dokladu. Potom zadáte koncovú čiastku aj so sprepitným a stalčíte POTVRDIŤ. Ďalej už realizujete platbu požadovaným spôsobom.

Začíname s gePOS APK pre Android

gePOS APK - inštalácia

gePOS ingenico AXIUM DX8000 & SUNMI P2-EU
logo_c.png
Ak ste obdržali platobný terminál priamo od nás, potom na úvodnej ploche nájdete ikonu gePOS. Zároveň je APK už zaregistrovaná u nás a taktiež už máte vytvorenú web inštanciu geCommerce. Táto aplikácia sa aktualizuje sama. Termín aktualizácie po zverejnení novej verzie ovplyvňuje portál Besteron, ktorý aplikáciu preberá zo SUNMI App Store a následne po validácii ju uvoľňuje pre všetky platobné zariadenia.

inštalácia SUNMI: V2s, L2s PRO, T2s, Kiosk, ...
ico_sunmi_app_store_a.png

Ak vaše zariadenie SUNMI nemá nainštalovanú našu aplikáciu gePOS, potom ju získate v App Store.

Postup:

  • kliknite na ikonu App Store
  • kliknite na Category
  • kliknite na Retail
  • kliknite na ikonu vyhľadávania
  • napíšte gePOS
  • zvoľte inštaláciu
  • registrujte sa, aby APK bola plne funkčná

Táto aplikácia sa aktualizuje sama zo SUNMI App Store.

Katalóg - Kategória a Produkty

Pre kategórie a produkty tu používame výraz katalóg.

Katalóg - Kategória a Produkty

Popis fragmentov katalógu

image.png

Klikom na skupinu (oranžový stĺpec) prebehne selekcia produktov (žltý stĺpec). Klikom na produkt sa zobrazí info o ňom na spodku fragmentu. Tlačidlo Všetky zruší filter a zobrazí všetky produkty. Tlačítko Vybrať ukončí formulár a vykoná akciu v nadradenom fragmente (ak existuje). Tlačítko Odísť obdobne ukončí formulár bez odozvy. Pre optimálne využitie v aplikácii sú pre produkty určené tlačidlá Upraviť a Nový.

Poznámka: zmeny sa neprenášajú na geCommerce a pri zapnutej synchronizácii sa prepíšu z webu

Katalóg je vhodné vytvoriť obdobne, ako váš ponukový list, teda najskôr kategórie (čísla mategórie môžu mať rezervné miesta na subkategórie). Potom vytvorte produkty a prideľte im kategóriu, tak bude zabezpečené filtrovanie pre rýchlejší prístup k nim.

Katalóg - Kategória a Produkty

Tlačidlo Menu

Pre detailné ovládanie katalógu (kategórie a produkty) stlačte “⋮”, ktoré aktivuje riadok v hlavičke formulára. Pre bežné využitie postačujú submenu Kategórie a Produkty. V kategóriach ich čísla sú voliteľné, teda ni je to nemenné ID. Logiku číslovania si volí používateľ. Pokiaľ sa zmení číslo kategórie, produkty nebudú presunuté.

Rodičovské kategórie nie sú zatiaľ zapracované.

Produkty majú menu členitejšie, nakoľko editácia veľa riadkov znižuje prehľadnosť, teda cena, DPH, typ zápornej položky, špecifikácia nulovej DPH, zmena kategórie a pridanie slip printers sa špecifikuje ako subeditácia.

Ikona Info na konci riadku s produktom volá formuár pre pridanie poznámky k produktu. Dlhšie stlačenie volá formuár s JSON o produkte.

SQLite funkcie slúžia pre servisné účely. Nesprávne použitie poškodí lokálne dáta.

Importuje zoznamy z zdresy URL sa používa pri prechode z nášho staršieho systémy MyECR a pri dočasnom suplovaní web geCommerce, ako aj pri paralelnej existencii oboch systémov, kedy komodity z MyECR sú master pre gePOS.apk

Predaj a popis jeho vnorených fragmentov

V otvorenom doklade sa fragment predaja delí na ďalšie menšie ragmenty, v ktorých sú tlačítka a zoznamy. Navzájom všetky fragmenty predaja spolupracujú a akcie v nich vyvolávajú reakcie v iných. Celý fragment predaja môže byť nahradzovaný v kontajeneri iným fragmentom, napríklad fragmentom Produkty, alebo fragmentom Doklady predaja. Toto ovplyvňujú akcie tlačidiel.

Poznámka: Reklamácia (Storno dokladu) celého dokladu je vysvetlená v NumPad a položkovitá v AddFunctions.

Predaj a popis jeho vnorených fragmentov

Základné zobrazenie predaja a platby

Ak je v aplikácii aktuálne otvorený doklad predaja, potom tento obsahuje fragmenty, ktoré zabezpečujú jednotlivé funkcie. Na obrázkoch sú názvy fragmentov uvedené oranžovo. Popis podľa názvu je tu uvedený na ďalších stránkach.

image.png

image.png

Predaj a popis jeho vnorených fragmentov

NumPad fragment

Numerická klávesnica vykoná akciu podľa toho, či sa na tlačidlo klikne krátko, alebo dlhšie. Následujúci popis je pre dlhšie stlačenie:

moveDnInList_a.pngmoveUpInList_a.png Klávesy 8 a 5 - Pohyb po jednom riadku hore a dole. Aktuálna položka (produkt) sa zobrazuje v treťom riadku subfragmentu Informácie o doklade. Ak sa dosiahne okraj zoznamu, kurzor preskočí na jeho opačnú stranu.

itemIncrement_a.png itemDecrement_a.png Klávesy 7 a 4 - Inkrement a Dekrement množstva aktuálnej položky, teda zvyšovanie a znižovanie množstva po 1*. Ak sa pri - - má dosiahnúť množstvo menšie či rovno nule, tak sa akcia nevykoná a zobrazí sa upozornenie.

itemAddition_a.png Klávesa 1 - Pripočíta k aktuálnemu množstvu vybranej položky množstvo nastavené v žltom tlačidle QTY. Po akcii sa tlačidlo QTY nevynuluje samo, kvôli predpokladu že aj iné položky sa zvýšia stejne. Je možné vynulovať či zmeniť QTY novým zadaním hodnoty.

starUnstar_a.png Klávesa 9 - Je ekvivalent star/unstar, kedy sa aktuálna položka označí, čo je indikované jej modrým textom.
starsUnstars_a.png Klávesa 6 - Je ekvivalent stars/unstars. Označenie invertuje (otočí) stav všetkých položiek na stav označené, alebo neoznačené. Zmena závisí na stave prvej položky zoznamu.
deleteItems_a.png Klávesa 0 - Výmaz všetkých označených položiek, bez potvrdenia.

Klávesa . - Zmena názvu položky (produktu). Pre špeciálne účely je možné zmeniť názov produktu. Táta funkcia nieje bežne potrebná.

stack.png Klávesa 3 - Prenos označených položiek do zásobníka a zo zásobníka. Prenáša sa celý riadok. Po prenose kláves 3 zmení farbu na červenú a v jej spodnom riadku popisu je množstvo položiek v zásobníku. Pre vykonanie úhrady položiek v zásobníku, je potrebné otvoriť nový doklad, teda následne dlhšie stlačiť žltú klávesu Doklady, stlačiť tlačidlo Predaj pre vytvorenie nového (prázdneho) dokladu a znova použiť dlhšie stlačenie klávesu 3 pre vybratie položiek zo zásobníka do nového dokladu, kedy sa objaví Snackbar s potvrdením akcie, na čo odpoveď sa očakáva ÁNO. Výber do zásobníka je možné kombinovať s klávesou 2.

stackVariable.png Klávesa 2 - Prenos označených položiek do zásobníka. Prenáša sa zvolené množstvo aktuálnej položky. To sa navolí vo formulári aktivovanom touto klávesou 2. Formulár prenosu sa obsluje intuitívne jeho vlastnými klávesami + + a - - , alebo manuálnym zadaním. Akcia sa prejaví zmenou v tlačidle 3 (viz 3).

Klávesa +/- - Bežné využitie pri vystavení daňového dokladu je nepraktické. Predpoklad je využiť ju pre dodací list. Dlhšie stlačenie slúži pre vrátenie celého vybraného dokladu. Klasický postup je taký, že najprv pred predajom sa použije tlačidlo Doklady predaja a v zozname predajov sa klikne na doklad s príznakom “completed”. Následne sa stlačí Vybrať. Potom sa stlačí Predaj a v novom doklade je tak automaticky vložená kópia vybraného dokladu. Klávesa +/- teda dlhším stlačením volá “snackbar” s otázkou “Invertovať množstvá ?”. Po odpovedi ÁNO sa všetky položky invertujú na záporné. Servisná poznámka: v pozadí sa dosadí ku každej položke do príznaku “refId” kód dokladu z ktorého vrátenie je skopírované. Zároveň príznaky “itemTypeSK” sa nastavia na “V” a “itemType” na “REFUND”.

Reklamácia dokladu

  1. stlačiť tlačidlo "Doklady predaja"
  2. v zozname predajov kliknúť na doklad pre reklamáciu (má mať príznak “completed”)
  3. stlačiť "Vybrať"
  4. vôjsť do predaja - stlačiť "Predaj" a v novom doklade je tak automaticky vložená kópia vybraného dokladu
  5. dlhšie stlačenie klávesy "+/-" zobrazí otázkou: “Invertovať množstvá ?”
  6. po odpovedi ÁNO sa všetky položky invertujú na záporné
  7. vykonať platbu hotovosťou

Predaj a popis jeho vnorených fragmentov

Info fragment

Informácie o doklade sú vo vrchnej časti fragmetnu uvedené bielym textom na sivom podklade a obsahujú 3 riadky:

Krátke kliknutie na fragment vyvolá formulár na vstup poznámky pre doklad (napríklad text a číslo). Dlšie stlačenie zobrazí servisný formulár s dokladom v JSON.

Predaj a popis jeho vnorených fragmentov

List fragment

Zoznam položiek dokladu - produkty je skrolovateľný zoznam. Po kliknutí na riadok s položkou sa táto stáva aktuálnou, o čom sa zobrazí vo fragmente Info údaj v treťom riadku.

Dlhšie stlačenie zmení príznak označenia. Toto sa využije pri hromadných akciách ako výmaz položiek (klávesa 0), prenos do zásobníka (klávesa 3), prípadne iné.

V zozname je pohyb možný aj klávesami 8 a 5, avšak to je nepraktické.

Kliknutie na obrázok Info zobrazí formulár na zadanie poznámky k položke pre prípadnú tlač objednávky na slip tlačiarňach. Poznámky sa pridávajú do poľa a nieje možné ich editovať. Pozadie obrázka po akcii ostane ofarbené na žlto do opustenia dokladu.

Dlhšie stlačenie na obrázok Info zobrazí servisný formulár s JSON pre položku.

Predaj a popis jeho vnorených fragmentov

Universal fragment

Stručné zobrazenie vstupujúcich reťazcov z numerickej klávesnice slúži pre ich vizuálnu kontrolu. Editácia týchto údajov nie je možná, okrem výmazu.

Zmazať vstupjúce údaje indikované v tomto fragmente je možné klávesou C z frgamentu Functions.

Napravo od fragmentu Universal je textové pole s krátkymi informáciami o poslednej akcii. Kliknutím naň sa fragment List zväčší, alebo zmenší.

Predaj a popis jeho vnorených fragmentov

Inputs fragment

Vstupy dôležitých informácii zabezpečú 3 klávesy:

ID

Vyhľadanie produktu. Pred jej použitím je potrebné na numerickej klávesnici zadať reťazec ktorý sa zobrazí vo fragmente Universal.

Stlačenie ID sa pokúsi vyhľadať produkt podľa stĺpca “code” (short id code). Vstupujúce znaky teoreticky môžu byť zmiešaný reťazec znakov a čísel, avšak je to nepraktické a program nemá vstup pre nečíselné znaky (zatiaľ…).

Dlhšie stlačenie ID sa pokúsi vyhľadať produkt podľa stĺpca “id” (unique id). Jedná sa o číslo (int) ktoré DB stroj automaticky priradzuje pri vytvorení produktu.

Ak produkt bol nájdený, pridá sa do zoznamu položiek a ozve sa potvrdzovací tón (Confirm).

V prípade že produkt nebol nájdený, zobrazí sa Snackbar s informáciou a ozve sa obsadzovací tón (Busy).

QTY

Vstup množstva pre univerzálne použitie. Pred jej použitím je potrebné na numerickej klávesnici zadať reťazec ktorý sa zobrazí vo fragmente Universal.

Stlačenie QTY sa pokúsi vložiť zadaný reťazec do svojej hodnoty indikovanej v prvom riadku popisu. Ak bol zadaný očakávaný reťazec, potom sa nastaví na novú hodnotu. V opačnom prípade sa zobrazí Snackbar s informáciou o neočakávanom vstupe. Vynulovanie je možné opätovným stlačením QTY ak je Universal fragment prázdny. Hodnota v tomto tlačidle sa nuluje v závislosti od použitej následujúcej funkcie.

Ak má byť množstvo pridávaného produktu iné ako 1, potom použijeme túto klávesu pred hľadaním produktu. Ak je potreba zmeniť množstvo produktu v zozname, tak v rôznom poradí zvolíme nový stav QTY a kliknutie na produkt. Potom stalčíme žltú klávesu Nové Množ. z frgamentu Functions.

Ak sa má pripočítať nové množstvo k existujúcemu, potom zadáme nové množstv a klikneme na produkt. Pre pripočítanie dlhšie stlačíme klávesu 1.

PRC

Vstup ceny pre univerzálne použitie. Pred jej použitím je potrebné na numerickej klávesnici zadať reťazec ktorý sa zobrazí vo fragmente Universal.

Stlačenie PRC sa pokúsi vložiť zadaný reťazec do svojej hodnoty indikovanej v prvom riadku popisu. Ak bol zadaný očakávaný reťazec, potom sa nastaví na novú hodnotu. V opačnom prípade sa zobrazí Snackbar s informáciou o neočakávanom vstupe. Vynulovanie je možné opätovným stlačením PRC ak je Universal fragment prázdny. Hodnota v tomto tlačidle sa nuluje v závislosti od použitej následujúcej funkcie.

Ak má byť predajná cena pridávaného produktu iné ako z katalógu, potom použijeme túto klávesu pred hľadaním produktu. Ak je potreba zmeniť cenu produktu v zozname, tak v rôznom poradí zvolíme nový stav PRC a kliknutie na produkt. Potom stalčíme žltú klávesu Nová cena z frgamentu Functions.

 

Predaj a popis jeho vnorených fragmentov

Functions fragment

Tlačidlá zabezpečujú najčastejšie používané funkcie:

Používateľ

Funkcia nie je pripojená.

Fragment Users nahradí po stlačení tohoto tlačidla v hlavnom kontajneri predaja fragment POS. Najprv sa uloží rozpracovaný doklad, potom sa otvorí fragment používateľov a následne po výbere potrebného je k dispozícii tlačidlo Predaj.

C

Odstráni reťazec z fragmentu Universal.

Nové Množ.

Použije sa nakonci sekvencie úkonov pre zmenu množstva aktuálnej položky. Viz fragmety NumPad klávesa 1 a fragment Inputs klávesa QTY.

Nová cena

Použije sa nakonci sekvencie úkonov pre zmenu ceny aktuálnej položky. Viz fragment Inputs klávesa PRC.

% Zľava

Funkcia nie je pripojená.

Otvorí formulár pre typ a výšku zľavy. Zľava sa aplikuje na vybrané položky (viz fragment NumPad). Zľava jednotlivých položiek je posúdená podľa možnosti zakázať zľavu, či nekumulovať zľavy.

Doklady

Stlačením sa uloží rozpracovaný doklad, potom sa otvorí fragment Doklady predaja a následne po výbere potrebného sa tento prenesie do aktuálneho dokladu.

Dlhšie stlačenie uloží rozpracovaný doklad, potom ostane v menu.

Nájdi

Funkcia nie je pripojená.

Otvorí formulár so vstupom reťazca pre vyhľadávanie a voľbu stĺpcov ktoré sa do prehľadávania majú zahrnúť. V názve sa vyhľadáva aj podreťazec.

Katalóg

Fragment Doklady predaja nahradí po stlačení tohoto tlačidla v hlavnom kontajneri predaja fragment POS. Otvorí fragment s katalógom, kde sú kategórie a produkty. Následne po výbere potrebného produktu sa tento pridá do aktuálneho dokladu.

Scanner

Volá Sunmi Intent pre obsluhu scannera. Ten navráti kamerou nasnímaný kód. Hľadanie prebehne v stĺpci “barcode”. V prípade úspechu sa produkt pridá do zoznamu položiek dokladu.

Dlhšie stlačenie zobrazí formulár na manuálny, alebo trigger vstup kódu. (trigger je na novších Sunmi, napríkladV2s). Po potvrdení OK prebehne hľadanie.

Platiť

Zamení fragmenty v kontejneroch Universal a Functions, tak aby bolo možné zadať hradenú čiastku, zrealizovať platbu, či vytlačiť info o doklade, alebo výdajku, prípadne zahodiť aktuálny doklad.

Predaj a popis jeho vnorených fragmentov

AddFunctions fragment

RF

Reklamuje jeden produkt tak, že najprv s kladným množstvom produkt vložíme do položiek dokladu. Kliknutím na produkt ho vyberieme. Klikneme na RF čím sa zavolá Sunmi Intenet pre scanner. Načítame QR kód z dokladu, z ktorého reklamáciu uplatňujeme. Položka tak invertuje na zápornú. Servisná poznámka: v pozadí sa dosadí ku položke do príznaku “refId” kód dokladu z ktorého vrátenie je zosnímané. Zároveň príznaky “itemTypeSK” sa nastavia na “V” a “itemType” na “REFUND”.

Dlhšie stlačenie zobrazí formulár na manuálny, alebo trigger vstup kódu. (trigger je na novších Sunmi, napríkladV2s).

Fc

Zobrazí formulár s ponukou rôznych funkcií:

Predaj a popis jeho vnorených fragmentov

Input payments - platba dokladu

Vstupy súm platby zabezpečú 3 klávesy:

Cash

Vstup sumy pre hotovosť. Pred jej použitím je potrebné na numerickej klávesnici zadať reťazec ktorý sa zobrazí vo fragmente Universal.

Stlačenie Cash sa pokúsi vložiť zadaný reťazec do svojej hodnoty indikovanej v prvom riadku popisu. Ak bol zadaný očakávaný reťazec, potom sa nastaví na novú hodnotu. V opačnom prípade sa zobrazí Snackbar s informáciou o neočakávanom vstupe. Vynulovanie je možné opätovným stlačením Cash ak je Universal fragment prázdny.

V prípade že je zadaná suma vyššia ako suma dokladu, potom bude vypočítaný rozdiel pre vrátenie - výdavok.

Card

Vstup sumy pre platobný termiál (POI). Pred jej použitím je potrebné na numerickej klávesnici zadať reťazec ktorý sa zobrazí vo fragmente Universal.

Stlačenie Card sa pokúsi vložiť zadaný reťazec do svojej hodnoty indikovanej v prvom riadku popisu. Ak bol zadaný očakávaný reťazec, potom sa nastaví na novú hodnotu. V opačnom prípade sa zobrazí Snackbar s informáciou o neočakávanom vstupe. Vynulovanie je možné opätovným stlačením Card ak je Universal fragment prázdny.

V prípade že je zadaná suma vyššia ako suma dokladu, potom bude vypočítaný rozdiel uvedený po úspešnej úhrade na POI ako tips (tringelt) priamo na doklade platobnej brány.

Vou

V rámci platidiel je možné zadať aj výmenný poukaz (Voucher). Princíp je obdobný ako pri klávese Cash.

Predaj a popis jeho vnorených fragmentov

Functions fragment - platba dokladu

Platba

btn_pay_cash_a.png

Po stlačení tlačidla sa zobrazí Snackbar s potvrdením že skutočne má prebehnúť hotovostná platba. Po odpovedi ÁNO prebehne platba tak, že aplikácia zašle pomocou ExecutorService Nexo protokol cez HTTP na localhost. Ak je doklad uložený do CHDU, teda kladne spracovaný, tak sa vytlačí na vstavanej tlačiarni. Samotný spôsob tlače či odoslania na mail ovplyvňujú nastavenia aplikácie. Ak gePOS je spustený na inom zariadení než Sunmi P2, namiesto localhost sa komunikuje cez IP nastavenú v nastaveniach aplikácie.

Platba kartou

btn_pay_card_a.png

Úhrada pomocou POI prebehne tak, že aplikácia sa rozhodne podľa toho na akom zariadení je spustená. Ak ide o zariadenie P2, potom sa volá Intent platobnej brány Besteron. Ak aplikácia je spustená na inom zariadení než Sunmi P2, namiesto Intent sa komunikuje cez IP nastavenú v nastaveniach aplikácie tak, že zašle pomocou ExecutorService request cez HTTP a čaká na response.

Pri zrealizovaní platby pokračuje aplikácia samostatne na zaevidovanie dokladu obdobne, ako pri tlačidle Platba.

C

Odstráni reťazec z fragmentu Universal.

Späť

Vráti sa k zadávaniu produktov, teda zamení fragmenty v kontejneroch Universal a Functions.

Zahodiť

btn_trash_a.png

Info

Výdajka

Hotovostné operácie

Za účelom udržiavania aktuálneho stavu platidiel a možnosti uhrádzať vyšlé faktúry je možnosť zvoliť potrebný úkon.

Vklad

Prepínač nastavíme do polohy Vklad a klikneme na VYKONAŤ. Zobrazí sa formulár pre vstup numerických hodnôt pre hotovosť, kartu a voucher. Po zadaní hodnôt klikneme na OK.

Výber

Prepínač nastavíme do polohy Výber a klikneme na VYKONAŤ. Zobrazí sa formulár pre vstup numerických hodnôt pre hotovosť, kartu a voucher. Po zadaní hodnôt klikneme na OK.

Úhrada faktúry

Prepínač nastavíme do polohy Úhrada faktúry a klikneme na VYKONAŤ. Zobrazí sa formulár pre vstup hodnôt. Odporúčame vyplniť Id pre variabilný symbol, Hotovosť alebo Karta a prípadne External ID. Zákaznikove ID a Typ zákazníka je vypĺňanie nepraktické. Po zadaní hodnôt klikneme na OK.

Poznámka: driver pre CHDU distribuovaný cez Besteron nepodporuje sledovanie evidencie aktuálneho stavu platidiel. Pri kooperácii viac APK na využití CHDU tak dôjde k nezistiteľnej diferencii. Ten istý stav môže spôsoniť aj abort aplikácií bez zápisu ukončenej operácie. Túto vlastnosť riešime s výrobcom a veríme že driver bude doplnený o štandardný komfort.

Uzávierky

Výpočty stavov pre prehľad o tržbe čerpajú údaje z dokladov predaja. Nakoľko v SK zákon 289/2008Zz neukladá povinnosť vytvárať uzávierky (od 2018), ani samotné CHDU v Sunmi P2 tieto funkcie zapracované nemá. Vyhodnotenie teda vychádza z príznaku jednotlivých dokladov v zozname.

Príznaky (status) môžu nadobúdať hodnoty: “open”, “completed”, “canceled”, “isNew”, “inPayment”, “issue” (viac info vo fragment Doklady predaja).

Typy prehľadov a uzávierok v aplikácii

Aktuálny stav (X)

vyberie všetky doklady typu “PD” a zároveň neobsahujú dátum Z uzávierky a zároveň s príznakom iným ako “canceled”, teda aj “open”

Denná uzávierka (Z)

spracuje všetky typy dokladov, ktoré neobsahujú dátum Z uzávierky a zároveň majú príznak “completed” alebo “canceled” alebo “issue”. Teda typy dokladov: “PD”, “UF”, “ND”, “VY”, “VK”.

Ak sú pri Z uzávierke nájdené doklady, potom všetky budú označené dátumom a časom vykonania uzávierky. Spracovaným dokladom pribudne aj GT, ktoré sa inkrementuje od nuly pri prvom nájdenom doklade, až po posledný, okrem stavu “canceled”.

Pre stornované doklady

vyberie všetky doklady typu “PD” a zároveň neobsahujú dátum Z uzávierky a zároveň s príznakom “canceled”

Offline dokumenty

Vytlačí zoznam neodoslaných dokladov (na server Finančnej správy). Zobrazí servisný formulár s odpoveďou z PPEKK CHDU.

Odoslať Offline dokumenty

Odošle všetky neodoslané doklady na server Finančnej správy. Zobrazí servisný formulár s odpoveďou z PPEKK CHDU.

Prevziať posledný doklad (ev. Get last)

PPEKK vytlačí z CHDU posledný zaevidovaný doklad. Návratové info nie je. Vytlačený doklad neobsahuje QR kód pre overenie. Tento doklad neslúži ako daňová kópia dokladu.

Poloha

V prípade že používaná pokladnica je na Finančnej správe evidovaná ako prenosná, je povinnosť pri zmene lokácie tohto zariadenia oznámiť polohu novú. Viac informácií je možné nájsť na portáli Finančnej správy, alebo na ich portáli s podporou.

Po zadaní adresy je na konci servisnej správy možné skontrolovať zmenu (veľa skrolovať dole…)

Vlastný popis

Zobrazí formulár s riadkom pre vstup vlastného popisu aktuálneho miesta predaja. Po zadaní sa zobrazí servisný formulár s odpoveďou.

Momentálne neodporúčame túto možnosť zadávania využívať. // problem with input structure for location with other specifications

GPS súradnice

Zobrazí formulár s dvoma riadkami pre vstup GPS súradníc X a Y. Postačuje zadať 6 mist za bodkou.

Skutočná adresa

Zobrazí formulár pre kompletné zadanie adresy miesta pradaja.

Do poľa Štát postačuje napísať “SK”, alebo čokoľvek (nesmie ostať prázdne) a bude to nahradené reťazcom “SK”

Pozn.: do Číslo nehnuteľnosti ak neviete aké je, napíšte 1. V budúcnosti ak tu zostane nula, potom key zo štruktúry odstránime (nedostatočný popis v nám dostupných materiáloch…)

Správna štruktúra (s náhradou “1”):

   "physicalAddress": {
        "buildingNumber": "20",
        "country": "Slovenská republika",
        "municipality": "Košice",
        "postalCode": "04001",
        "propertyRegistrationNumber": "1",
        "street": "Pri prachárni"
    }

Doklady predaja

Jedná sa o zoznam dokladov predaja.

Doklady predaja

Popis fragmentov pre Doklady predaja

image.png

Zoznam zaevidovaných dokladov má chronologický rad. Zárovaň obsahuje aj nemenné ID. Kliknutie na hlavičku dokladu zobrazí položky dokladu (ak existujú). V tomto zozname sa evidujú všetky typy dokladov (PD, UF, VK, VY, ND). Stejný zoznam dokladov sa zobrazuje aj v predaji, po kliknutí na Doklady, avšak tam môže byť nastavené veľké písmo pre lepšiu čitateľnosť a taktiež je filter permanentne nastavený na typ dokladu “PD” a status “open”. Pre reklamáciu celého dokladu viz Predaj → NumPad, kláves +/-.

Tlačidlo Všetky zruší filter a zobrazí všetky doklady. Tlačítko Vybrať ukončí formulár a vykoná akciu v nadradenom fragmente (ak existuje). Tlačítko Odísť obdobne ukončí formulár bez odozvy.

Doklady predaja

Tlačidlo menu

Pre detailné ovládanie dokladov predaja (kategórie a produkty) stlačte “⋮”, ktoré aktivuje riadok v hlavičke formulára.

Dokument

Filter

Hromadné operácie

Nastavenia

Zmena nastavení má vplyv na správne fungovanie celej aplikácie. Pred zmenami nastavení je nutné sa oboznámiť s jednotlivými funkciami, ktorých sa nastavenie bude týkať.

Poznámka: táto kapitola je v rekonštrukcii...

Nastavenia

Hlavné nastavenia

Hlavné nastavenia ovládajú kľúčové vlastnosti APK.

Spustiť Hlavné nastavenia

runSettings.png

Aktivácia prijímania katalógu

setCatAndProd.png

Aktivácia prijímania zoznamu partnerov a skladov

setPartAndStor.png

Ukončiť Hlavné nastavenia

Poznámky

MyECR - projekt ukončený

Náš pôvodný projekt z roku 2004 už nie je aktualizovaný. Dôvodom je zastaralosť programovacieho nástroja v ktorom je vytvorený, ale i znížená stabilita a kompatibilita pod Windows. V roku 2022 sme pripravili nový projekt, ktorý je synchronizovaný s web back office geSys. Nástrojom pre jeho vytvorenie je JavaFX. Funkčnosť je pod všetkými OS a obsluhuje CHDU Kaso, Varos a FiskalPro. Čas a potreby však i tento projekt ukončili a v súčasnosti je aktuálny projekt gePOS Android a web geCommerce.

MyECR - projekt ukončený

RustDesk

RustDesk je plnohodnotná alternatíva diaľkového ovládania s otvoreným zdrojom pre vlastné hosťovanie a zabezpečenie s minimálnou konfiguráciou. (https://rustdesk.com)

Stiahnutie programu a spustenie

Ilustračné obrázky

* spustený rustdesk

image.png


MyECR - projekt ukončený

Chrome Remote Desktop

Doplnok prehliadača Google Chrome umožňuje vzdialený prístup k PC, obdobne ako AnyDesk, či TeamViewer. Nakoľko už nie je možné zdarma použiť posledné dva produkty, využite možnosť od Google. Má síce isté obmädzenia správy OS, ale na bežné veci postačuje.

V budúcnosti na naše servery inštalujeme rustdesk (https://rustdesk.com/), o čom Vás budeme informovať.

V prípade že nie je možná vzdialená správa Vášho PC, je možné vykonať zásah len osobne. Ak máte k dispozícii prístup cez VNC Server, potom vieme využiť aj túto možnosť a inštalácia od Chrome nie je nutná.

Inštalácia:


MyECR - projekt ukončený

Zmena DPH 2025

článok sa týka projektu MyECR (pôvodne PAS predaj a sklady), ktorý bude postupne v roku 2025 odstavený a nahradený projektom geCommerce + gePOS pre WEB a Android

Možné varianty zotrvania či zmeny zariadení a programov

Existujúci používatelia Kaso CHDU a MyECR
  1. nové knižnice Kaso (ver.2), AU zostávajú - cena cez cca 100€
  2. nové zariadenie FT5000, AU a IU nové - cena cca 450€ bez tlačiarne, alebo s novou tlačiarňou cca 630€
  3. nové zariadenie Besteron DX8000 Android - cena cca 30€/mesiac (v tom je CHDU(+70€), platobný terminál, apkPredaj, webBackoffice, internet a iné). MIF je podľa dohody do cca 1%
Existujúci používatelia Varos eFT4000B a MyECR
  1. nové Varos CHDU5001 a nový tlačový manažer s PPEKK - cena by mohla byť 250€, avšak toto riešenie neodporúčame a neberieme v prípade realizácie záruku na pôvodné komponenty. Rálne toto riešenie vykonávať nebudeme !
  2. nové zariadenie FT5000, AU a IU nové - cena cca 450€ bez tlačiarne, alebo s novou tlačiarňou cca 630€
  3. nové zariadenie Besteron DX8000 Android - cena cca 30€/mesiac (v tom je CHDU(+70€), platobný terminál, apkPredaj, webBackoffice, internet a iné). MIF je podľa dohody do cca 1%
Nový používatelia našich projektov gecora.solutions.gePos
  1. nové zariadenie Besteron DX8000 Android - cena cca 30€/mesiac (v tom je CHDU(+70€), platobný terminál, apkPredaj, webBackoffice, internet a iné). MIF je podľa dohody do cca 1%
  2. nové zariadenie FT5000, AU a IU nové - cena cca 450€ bez tlačiarne, alebo s novou tlačiarňou cca 630€


Termín aplikácie zmien DPH je 1.1.2025. Dovtedy je potrebné: 

Už vykonané zmeny v MyECR

Naplánované zmeny v MyECR


Postup aplikácie zmien v MyECR pre produkčné nasadenie

Postup sa vykoná až budú splnené naplánované zmeny. Nedostatok času neumožňuje regenerovaný projekt MyECR vetviť podľa dátumu, takže zmeny je možné vykonať manuálne až po poslednom predaji v roku 2024. V prípade že sa nepodarí ich realizovať, je možné využiť náš nový projekt gePOS a geCommerce.

  1. Záloha aktuálnej inštalácie MyECR klasickým vytvorením ZIP celej zložky: c:\myecr
  2. Získanie novej verzie MyECR z našej pôvodnej download stránky a nahradenie pôvodného myECR.exe novým: postup zvládne odborník
  3. Generovanie novej tabuľky DPH v programe pre predaj a sklady: Servis -> Editácia tabuľky DPH -> Nastaviť DEFAULT hodnoty
  4. Kontrola zaokrúhlení v programe pre predaj a sklady: Servis -> Servis Alt+F1 -> Zaokrúhlenia -> [3, 2;   2, 2, 2;   2] [2] [3, 2;   3, 2]
  5. Synchronizácia a prepočet DPH v programe pre predaj a sklady, zvlášť pre každý sklad: Komodity -> Servis (červené tlačítko vpravo hore) -> výber funkcie 3:
    • pre precenenie (tj ponechanie základov): [3, 1, 1] -> Ctrl+W
    • pre nové základy (tj ponechanie cien): [3, nič, nič] -> Ctrl+W
      • poznámka: jedničky či nič v Parametroch 1 a 2 môžu byť kombinované pre DPH 23 a 19
      • poznámka: prepočítané budú aj všetky minirecepty, ktoré majú spárovanú komoditu (nespárované budú vynulované ceny)
  6. Úprava archívu predaja t.j. prepis minút: Predaj -> Servis predaja -> Paragóny moje -> Servis (červený) -> [1, -, -] -> Ctrl+W. Funkcia konvertuje doklady s dátumom <2025
  7. ...
  8. Aktualizácia knižníc, alebo tlačového manažéra pre aktuálnu pokladnicu (Kaso, alebo Varos)
    1. Pre CHDU od Kaso bude pravdepodobne nutné nahradiť aj prídavné utility a tlačové masky.


MyECR - projekt ukončený

Zmena DPH 2025 - zariadenia eKasa

Vzhľadom na potrebné legislatívne zmeny o hladinách DPH, bude nutné vykonať určité úpravy a zmeny. V potaz je treba zobrať potrebu zachovania pôvodných DPH 20% a 10% na vysporiadanie reklámacií, aj vrátenie zálohových platieb a aj jednoúčelové poukazy vystavené do 1.1.2025. Taktiež evidencia vratných obalov doznáva zmeny.

Neplátcovia DPH

Predpoklad že nepláci DPH nepotrebujú akúkoľvek zmenu a môžu pokračovať s eKasa, pokiaľ sa nestanú plácami, nemusí byť reálny, nakoľko dochádza aj k zmenám v komunikačnom protokole so serverom FS a ten môže pôvodnú podobu protokolu odmietnuť. Zatiaľ testovacie verzie PPEKK nie sú k dispozícii, takže nevieme záver...

Plátcovia DPH

Všetky zariadenia v prevádzke budú predmetom zmien. CHDU od výrobcu Kaso Technologies vyžadujú len softwerové zmeny. Zariadenia Varos bude nutné vykonať viacero zmien.

CHDU Kaso

Odporúčame používateľom podľa možnosti prejsť na Varos FT5000, kde Vám zabezpečíme v budúcnosti hladký prechod na náš nový geCommerce.

Zároveň sú odstavené projekty: GeCron.exe, Selling.exe, MEOL.jfx

Varos FT4000B

Dôležité linky


MyECR - projekt ukončený

Predĺženie licencie MyECR

Obrázok s postupom je nižšie...
link: Prechod na rok 2025 so smenou DPH...

Ak vám končí licencia programu pre predaj a sklady, potom pre obnovu licencie prosím postupne kliknite na:

  1. Pridané (ikona + vľavo)
  2. Kladka (ikona zamknutej kladky)
  3. Odstrániť aktuálny licenčný kľúč (POZOR ! nie registráciu)
  4. Potom ukončite program predaj a sklady
  5. Znova program spustite a zobrazí sa nová licencia
  6. Potvrďte OK a malo by to fungovať a zároveň na spodku formu farebne indikuje počet dní)

Prípadne sa pripojíme cez RustDesk alebo Chrome Remote Desktop (už nie AnyDesk) a vykonáme to zdieľaním obrazovky.

Postup inštalácie vzdialenej správy
Ilustračný obrázok

image.png


MyECR - projekt ukončený

Overiť stav CHDU

Zariadenie CHDU od Kaso Technologies* je relatívne spoľahlivý modul, avšak občas sa vyskytne porucha, ktorá ho zablokuje.  Ako prvé odporúčame skontrolovať či je tlačiareň zapnutá a nesvieti na nej Error. Potom prekontrolovať USB kábel na oboch koncoch či je správne zasunutý (PC(skrutkovací konektor RS232) -> tlačiareň(USB)). Vo Windows v zariadeniach pripojených k systému pozrieť či je namapovaný COMn port CHDU. Nakoniec štandardne vypnúť PC aj tlačiareň. Odpojiť PC zo zásuvky (230V), aby USB porty stratili napájanie. Potom štandardne zapnúť tlačiareň i PC. Poznámka: CHDU pri opdpojení a pripojení USB(strana PC) mala by vo Windows vyvolať zvukovú, prípadne Info akciu a samozrejme v zariadeniach zmenu COMn portu.

Zdokumentované poruchy

  1. Zamrznuté CHDU: program predaja čaká 30 sekúnd a pokiaľ nedostane od CHDU odozvu, ponúkne znova čakanie 30 sekúnd. Ak ani po druhom intervale nenastane odozva, nie je potrebné znova čakať. Je vhdné ho otestovať v programe predaja následovne: "Predaj na POS" -> "Servis pokladníc"** -> "Overiť stav CHDU"***. Zároveň prekontrolujte či záložky hore aj rádiový prepínač vpravo je v predposlednej polohe (zväčša s názvom taxisKaso(taxIS CHDU).
  2. Nekomunikuje kontrolér: CHDU sa v zariadeniach pripojených k Windows javí ako pripojené, avšak programy nekomunikujú. Tento prípad znamená zväčša koniec životnosti CHDU. V tom prípade objednáme nové CHDU (licenciu nie je treba hradiť, ale HW áno ak je mimo záruku). Pokúsime sa preniesť kontinuitu údajov zo starého CHDU do nového (trik s chladničkou a zahriatím) a môžete pokračovať v predaji. Ak sa prenos nepodarí, potom registre dokladov v CHDU počítajú od nuly.

Ilustračné obrázky

* CHDU Kaso

chduKaso_ilustracneFoto_a.jpeg

** Servis pokladníc

chduKaso_servisPokladnic.jpeg

*** Overiť stav CHD

chduKaso_overitStav.jpeg


MyECR - projekt ukončený

MyECR - predaj - zľava na položky

Zľava nemá vplyv na produkty v cenníku, teda nie je treba po aplikovaní zliav tam vykonať opravy.

Variabilná zľava

a_select.png

- v doklade predaja označte jednotlivé produkty myšou

b_select.png

- pre hromadné označenie, odzančenie a inverziu môžete použiť tlačidlá

c_buttonPlusMinus.png

- Stlačte tlačodlo "%-/+"

- Na otázku: Skutočne pridať zľavu/prirážku - stlačte Áno

c_rounding.png

- zaokrúhlenie ponechajte na 2 desatinné miesta

- stlačte Ok

d_setDiscount.png

- napíšte číslo vyjadrujúce zľavu

- záporné číslo znamená prirážku (toto zväčša nepoužijete)

- stalčte Exit

- na otázku či aplikovať - potvrďte Áno, čím sa zľava vykoná

Odvolanie zľavy

1a_revertDiscount.png

- na záložke "Prídavné" použite tlačítko "Vrátiť ceny"

- na otázku: skutočne vrátiť ceny na pôvodné - stlačte Áno, čím sa ceny obnovia na pôvodné


MyECR - projekt ukončený

Časté závady v poslednom čase

Postupom času sa častejšie stáva, že Windows 10 ktorý stráca podporu, sa chová menej stabilne. Zároveň i počítače už nie sú tak pružné po množstve updejtov rôznej kvality a sú opotrebené. Aby ste minimalizovali tieto problémy, skúste základné kroky:

Aké závady pozorujeme

Záver

Ak čokoľvek, aj to čo tu nieje uvedené nepomáha, bude nutné prejsť na Windows 11 a mový PC, alebo využiť náš nový projekt gePOS - APK pre Android.

Zároveň upozorňujeme používateľov Windows 7, že nemajú ani zabezpečenie sytému na dostatočnej úrovni. Tam je prechod na nový Windows+PC, či iný systém nutný

Poznámky:

MyECR - projekt ukončený

Záverečné úpravy MyECR

V súvislosti s ukončením tohoto projektu (teraz MyECR, predtým PAS či ASAP), pridávame zjednodušujúce možnosti pre prechod na náš nový komplexný systém - gecora.solutions.gePos, ktorý poháňa web a Android.



Doklad predaja - export

Ak stále používate MyECR a zatiaľ vyhovuje vašim potrebám, môžete realizovať tlač a úhradu dokladu predaja pomocou jednoduchého exportného rozhrania. Proces pozostáva z týchto krokov:

  1. Zostavenie dokladu predaja v programe MyECR a stlačenie tlačítka Platba
  2. Prijatie dokladu v gePOS Android, v predaji - podržanie tlačítka Katalóg
  3. Následné uzatvorenie dokladu v gePOS hotovosťou, alebo kartou (doklad sa zaeviduje aj do eKasa CHDU a FS)
Potrebné úpravy pre export predaja

myecrJsonReceipt_a.png

Aktivácia exportu v MyECR: otvoriť predaj, klik na záložku Servis (1), zapísať aktuálnu cestu a súbor exportu (2) a povoliť samotný export, ktorý sa vykoná vždy po stalčení tlačidla Platba (3).

...


MyECR - projekt ukončený

WampServer - inštalácia

Úvod

Jedná sa webovú vývojovú platformu bez prístupu na internet. Nám pomôže nazdieľať dáta z programu pre predaj. Wamp využijeme v jeho najprimitívnejšej forme, s využitím HTTP komunikácie. Je však možné aj jeho plné využitie ako LAN servera s PHP, MySQL, MariaDB. Tú istú prácu ako WampServer zastane aj XAMPP od BitRock, ba aj o čosi viac možno zvládne. ! Pozor ! tieto lokálne prostredia i keď dokážu komunikovať smerom do WAN, nie sú na to určené z bezpečnostných dôvodov. Na to je treba použiť server, alebo hosting.

Inštalácia WampServer

Ďalej konfigurujte MyECR podľa článku Záverečné úpravy MyECR.


Dočasné rady pre geCommerce

než bude vytvorená komplexná nápoveda pre geCommerce, tu zhrnieme doporučenia a nápady

Dočasné rady pre geCommerce

Produkty

DESCRIPTION - riadiace sekvencie a popis

#slipprns[1];#othertag['a','b'];

momentálne popis nie je využitý, avšak dočasne sa tu zadajú sekvencie, ktoré pri importe do mobilného zariadenia ich premenia na parametre produktu

príklad: #slipprns[1] - vytvorí informáciu pri produkte, ktorá tlačí objednávku na tlačiareň 1. ak je nutné tlačiť napríklad na dvoch tlačiarňach, potom sekvecia bude vyzerať: #slipprns[1,2];