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.

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

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

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.

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.

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ší.

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.

 

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.

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í:

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.

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