Príkazy v rámci dokladu
Príkazy, ktoré musia byť ohraničené príkazmi paragonBegin na začiatku a paragonEnd na konci
Číslovanie riadkov je riadené ako MOD10
paragonBegin
príkaz pre začiatok bločku, pre eKasa doklad musí byť ako prvý
paragonBegin:[0];[1];[2];[3];[4];[5]
[0] - číslo riadku
[1] - typ predaja
0 = maloobchod (ceny sú zadávané s DPH)
1 = veľkoobchod (ceny sú zadávané bez DPH)
2 = interný doklad (bez orezu)
3 = interný doklad (bin)
4 = tréningový bloček, maloobchod - v každom treťom riadku sa tlačí text "NEPLATNÝ DOKLAD", doklad je komunikovaný na SFS
5 = VKLAD/VÝBER - tlačí sa "VKLAD" na začiatku dokladu
6 = interný doklad
9 = úhrada pohľadávky
[2] - typ prenosu
0 - riadkový
1 - blokový
[3] - typ bločku
0 - kladný bloček
[4] - typ rekapitulácie DPH
0 - skrátena
1 - McD
[5] - grafická hlavička
0 - bez grafickej hlavičky
1-6 - číslo grafickej hlavičky z NV pamäte tlačiarne
paragonEnd
príkaz pre koniec bločku, pre eKasa doklad musí byť ako poslendý
paragonEnd:[0];[1]
[0] - číslo riadku
[1] - grafická pätička
0 - bez grafickej pätičky
1-6 - číslo grafickej pätičky z NV pamäte tlačiarne
itemSale
itemSale:[0];[1];[2];[3];[4];[5];[6]
[0] - číslo riadku
[1] - Názov tovaru - pri prekročení počtu znakov vyhlási chybu parametra v príkaze
[2] - cena CELKOM za položku - max 999999.99 (max dve desatinné miesta, ostatné sa orežú)
[3] - DPH hladina
[4] - množstvo - max 99999.999
[5] - jednotková cena - max. 8 znakov (999999.99 alebo 9999.9999,...)
[6] - množstevná jednotka - max 3 znaky
správnosť prepočtu Cena Celkom = Množstvo * JCena sa nekontroluje, do lokálnych registrov sa akumuluje hodnota Cena Celkom
itemReturn
itemReturn:[0];[1];[2];[3];[4];[5];[6];[7]
[0] - číslo riadku
[1] - Názov tovaru - pri prekročení počtu znakov vyhlási chybu parametra v príkaze
[2] - cena CELKOM za položku - max 999999.99 (max dve desatinné miesta, ostatné sa orežú)
[3] - DPH hladina
[4] - množstvo - max 99999.999
[5] - jednotková cena - max. 8 znakov (999999.99 alebo 9999.9999,...)
[6] - množstevná jednotka - max 3 znaky
[7] - číslo protidokladu - max 44 znakov *
obmedzenia tejto operácie vyplývajúce zo znenia Z 289/2008 zabezpečuje vlastný program registračnej pokladnice, nie eKasa
* CisloProtidokladu: 44 znakov - overovaci kod podnikatela (OKP) / 34 znakov - unikatny identifikator dokladu (UID) / V prípade dokladu vystaveného na ERP podľa zákona platného do 1.4.2019 sa uvedie poradové číslo pokladničného dokladu.
Doporučenie k implementácii: - operáciu VRÁTENIE možno použiť iba na tovary nablokované na predchádzajucich uzavretých účtenkách. Zjednodušene je možné implementovať túto funkciu tak, že operáciu VRÁTENIE je možné použiť iba na položky, ktoré nie sú nablokované v aktuálne otvorenej účtenke
itemVoid
itemVoid:[0];[1];[2];[3];[4];[5];[6];[7]
[0] - číslo riadku
[1] - Názov tovaru - pri prekročení počtu znakov vyhlási chybu parametra v príkaze
[2] - cena CELKOM za položku - max 999999.99 (max dve desatinné miesta, ostatné sa orežú)
[3] - DPH hladina
[4] - množstvo - max 99999.999
[5] - jednotková cena - max. 8 znakov (999999.99 alebo 9999.9999,...)
[6] - množstevná jednotka - max 3 znaky
[7] - číslo protidokladu - max 44 znakov *
obmedzenia tejto operácie vyplývajúce zo znenia Z 289/2008 zabezpečuje vlastný program registračnej pokladnice, nie eKasa
* CisloProtidokladu: 44 znakov - overovaci kod podnikatela (OKP) / 34 znakov - unikatny identifikator dokladu (UID) / V prípade dokladu vystaveného na ERP podľa zákona platného do 1.4.2019 sa uvedie poradové číslo pokladničného dokladu.
Doporučenie k implementácii: - operáciu STORNO možno použiť iba na tovary nablokované na predchádzajucich uzavretých účtenkách. Zjednodušene je možné implementovať túto funkciu tak, že operáciu VRÁTENIE je možné použiť iba na položky, ktoré nie sú nablokované v aktuálne otvorenej účtenke
itemNegative
itemNegative:[0];[1];[2];[3];[4];[5];[6]
[0] - číslo riadku
[1] - Názov tovaru - pri prekročení počtu znakov vyhlási chybu parametra v príkaze
[2] - cena CELKOM za položku - max 999999.99 (max dve desatinné miesta, ostatné sa orežú)
[3] - DPH hladina - možné použiť iba hladinu "OSLOBODENÉ", iné hladiny vyhlásia chybu parametra v príkaze
[4] - množstvo - max 99999.999
[5] - jednotková cena - max. 8 znakov (999999.99 alebo 9999.9999,...)
[6] - množstevná jednotka - max 3 znaky
správnosť prepočtu Cena Celkom = Množstvo * JCena sa nekontroluje, do lokálnych registrov sa akumuluje hodnota Cena Celkom
sumár vrátených obalov sa tlačí mimo evidencie DPH, pod rozpisom - označenie "VO"
itemDiscount
itemDiscount:[0];[1];[2];[3];[4]
[0] - číslo riadku
[1] - popis operácie - max 18 znakov
[2] - typ operácie - 0-3
0 - hodnotová zľava
1 - hodnotová prirážka
2 - % zľava
3 - % prirážka
[3] - hodnota zľavy - pre TypOperácie 0,1 je formát 9999999.99, pre TypOperácie 2,3 je formát 99.99; hondota zľavy nemôže byť vyššia ako je hodnota nablokovanej položky
[4] - DPH hladina
subtotalDiscount
subTotalDiscount:[0];[1];[2];[3];[4]
[0] - číslo riadku
[1] - popis operácie - max 18 znakov
[2] - typ operácie - 0-1
0 - hodnotová zľava
1 - hodnotová prirážka
[3] - hodnota zľavy - pre TypOperácie 0,1 je formát 9999999.99
[4] - DPH hladina
DPH musí byť zadané, zľava je obmedzená na obrat na danej daňovej kategórií v rámci dokladu
subtotal
subTotal:[0];[1];[2]
[0] - číslo riadku
[1] - popis - max 20 znakov
[2] - príznak - 0-1
0 - vytlač medzisúčet s DPH
1 - vytlač medzisúčet bez DPH
v prípade sumy bez DPH je označená “*” napr. 125.60*
payment
payment:[0];[1];[2];[3];[4];[5]
[0] - číslo riadku
[1] - číslo platidla - 1-8,16; poradie možné meniť, zákonné zaokrúhľovanie hotovostneho platidla je nastavené na platidle 16
default nastavenia platidiel:
1 - Karta
2 - Šek
3 - Str. lístok
4 - Zahr. mena
5 - PLATIDLO 5
6 - PLATIDLO 6
7 - PLATIDLO 7
8 - PLATIDLO 8
16 - Hotovosť
[2] - celkom - max. 9999999.99, v prípade použitia "0" sa použije celá zostávajúca neuhradená suma
[3] - ponúknutá suma - max. 9999999.99, v prípade použitia "0" sa použije celá zostávajúca neuhradená suma
[4] - kurz - 0= nie je zahraničná mena alebo Kurz = xx.xxxx pre prepočet.
[5] - popis - max 10 znakov
pri nastavení každého platidla sa zadáva aj zaokrúhlenie na minimálne platidlo
depositeInDrawer
depositeInDrawer:[0];[1];[2];[3];[4]
[0] - číslo riadku
[1] - opis operácie - max 20 znakov
[2] - typ operácie - 0-1
0 - VKLAD
1 - VÝBER
[3] - suma celkom
[4] - číslo platidla
printAnnouncement
printAnnouncement:[0];[1]
[0] - číslo riadku
[1] - text - počet znakov variabilný na základe driveru typu tlačiarne/F41/
Dvojnásobná šírka je vyjadrená znakom "~1F" pred aktívnym znakom; je možné vložiť aj ESC sekvencie zo zoznamu povolených, vo forme ~1B~xx~xx
V daňovej účtenke sa vytlačí v sekcii pod rekapituláciou zadaný reťazec (riadok). Je možné vytlačiť ľubovolný počet týchto oznamov pred príkazom Koniec Bločku
V Internom doklade je možné použiť iba tento príkaz ľubovolný počet krát medzi príkazmi Začiatok Bločku a Koniec Bločku
printAnnouncementNF
printAnnouncement:[0];[1]
[0] - číslo riadku
[1] - text - počet znakov variabilný na základe driveru typu tlačiarne/F41/
Dvojnásobná šírka je vyjadrená znakom "~1F" pred aktívnym znakom; je možné vložiť aj ESC sekvencie zo zoznamu povolených, vo forme ~1B~xx~xx
V daňovej účtenke sa vytlačí v sekcii S2 pre zadávanie položiek. Primárne je určený na zadávanie seriovvých čísiel. Generuje špecialny znak “#“ na konci riadku (40-tej pozícii), pre odlíšenie od “fiškálnych údajov”.
Je možné vytlačiť ľubovolný počet týchto oznamov pred prvým príkazom Celkom
itemDiscount2
itemDiscount2:[0];[1];[2];[3];[4];[5]
[0] - číslo riadku
[1] - popis operácie - max 18 znakov
[2] - typ operácie - 0-3
0 - hodnotová zľava
1 - hodnotová prirážka
2 - % zľava
3 - % prirážka
[3] - hodnota zľavy - pre TypOperácie 0,1 je formát 9999999.99, pre TypOperácie 2,3 je formát 99.99; hondota zľavy nemôže byť vyššia ako je hodnota nablokovanej položky
[4] - DPH hladina
[5] - CelkomZ - pre Typ2 príkazov sa hodnota CelkomZ ignoruje a používa sa výška z parametra HodnotaZľavy
subtotalDiscount2
subTotalDiscount:[0];[1];[2];[3];[4];[5]
[0] - číslo riadku
[1] - popis operácie - max 18 znakov
[2] - typ operácie - 0-1
0 - hodnotová zľava
1 - hodnotová prirážka
[3] - hodnota zľavy - pre TypOperácie 0,1 je formát 9999999.99
[4] - celkomZ - pre Typ2 príkazov je do výpočtu obratov vždy použitá hodnota CelkomZ, zvyšné polia sú použité iba pre vytvorenie výpisu na účtenke
[5] - DPH hladina
DPH musí byť zadané, zľava je obmedzená na obrat na danej daňovej kategórií v rámci dokladu
popis0Dph
popis0Dph:[0]
[0] - typ - 0-5
0 - PDP (prenesenie daňovej povinnosti)
1 - OOD (oslobodene od dane)
2 - CK (cestovné kancelárie)
3 - PT (použitý tovar)
4 - UD (umelecké dielo)
5 - ZPS (zberateľské dielo a starožitnosti)
Popis je viazaný k predchádzajúcej položke (itemSale, itemReturn,...).
V prípade, že nie je v 0% DPH je zamietnutý.
Dodatočný popis dôvodu je nevyhnutné vytvoriť pomocou voľného textu (printAnnouncementNF).
setTransactionId
setTransactionID:[0]
[0] - interný kód pokladničnej aplikácie - Nastavenie ID interneho kodu nadradenej app (jedinecnost riesi aplikacia)
setTransactionId2
setTransactionID2:[0]
[0] - interný kód pokladničnej aplikácie - Nastavenie ID interneho kodu nadradenej app (jedinecnost riesi aplikacia)
odpocitanaZaloha
odpocitanaZaloha:[0];[1];[2];[3]
[0] - názov - počet znakov variabilný na základe driveru typu tlačiarne/F41/
[1] - množstvo - max 999999.99
[2] - DPH - musí byť rovnaká ako predávaná položka
[3] - cena - môže byť vyššia ako hodnota položky, doklad prejde do záporných čísel
cena sa automaticky odpočítava - je záporná vždy
vymenaPoukazu
vymenaPoukazu:[0];[1];[2];[3];[4]
[0] - Názov poukazu - počet znakov variabilný na základe driveru typu tlačiarne/F41/
[1] - množstvo - max 999999.99
[2] - daňová hladina - musí byť rovnaká ako predávaná položka inak sa neuplatní na sumu položiek
[3] - cena - max 999999.99
[4] - číslo poukazu -
cena sa automaticky odpočítava - je záporná vždy
Príkazom výmena poukazu sa prepne do stavu S43, v ktorom sú umožnené iba príkazy vymenaPoukazu (t.j. je možné zaplatiť za doklad viac ako jedným výmenným poukazom) a payment.
Vymenným poukazom nie je možné preplatiť účet (nie je možné vracať peniaze za výmenný poukaz)t.j. je ho možné použiť iba v prípade, keď suma celkom za doklad je väčšia ako 0. Aj v prípade, ak je výmenným poukazom doklad zaplatený úplne (prípadne preplatený) na ukončenie dokladu treba použiť príkaz payment.
printDisplay
printDisplay:[0];[1]
[0] - typ displeja - 0-1
0 - interný
1 - externý
[1] - text - max 40 znakov
ESC: zadávať vo formáte 1Bxx~xx
clearDisplay
clearDisplay:[0]
[0] - 0-1
0 - interný
1 - externý
printDisplay2
printDisplay2:[0];[1]
[0] - typ displeja - 0-1
0 - interný
1 - externý
[1] - text - max 120 znakov
ESC: zadávať vo formáte 1Bxx~xx
setInvoiceNumber
setInvoiceNumber:[0]
[0] - číslo faktúry - max 50 znakov
printIssuedParagon
printIssuedParagon:[0];[1]
[0] - poradové čislo paragónu - max 9999999999
[1] - dátum a čas vystavenia paragónu - DDMMRRRRhhmmss
printBC
printBC:[0];[1]
[0] - typ kódu - 0-6, 65-72
[1] - dáta - max 40 znakov
informácie o podporovaných typoch a dĺžkach kódov nájdete v dokumentácii k jednotlivým typom tlačiarní v príkaze GS k (1DH 68H)
setSellerID
setSellerID:[0];[1]
[0] - číslo - 1-12 znakov
[1] - typ - 0-1
0 - DIČ
1 - IČ DPH
Príkaz je viazaný k predchádzajúcej položke (itemSale, itemReturn,...)
printQRCode
printQRCode:[0]
[0] - text - max 350 znakov
setPreline
setPreline:[0]
[0] - text - počet znakov variabilný na základe driveru typu tlačiarne/F41/
Vytlačí sa pred položkou nablokovanou príkazmi predaja :PredajPoložky, Zlava/Prirazka, Storno položky,... Po aplikovaní sa zresetuje. ALPHA 1-40. Dvojnásobná šírka je vyjadrená znakom "~1F" pred aktívnym znakom
setPostline
setPostline:[0]
[0] - text - počet znakov variabilný na základe driveru typu tlačiarne/F41/
Vytlačí sa za položkou nablokovanou príkazmi predaja :PredajPoložky, Zlava/Prirazka, Storno položky,... Po aplikovaní sa zresetuje. ALPHA 1-40. Dvojnásobná šírka je vyjadrená znakom "~1F" pred aktívnym znakom
Last modified: 23 februára 2026