eKasa integration - commands
Commands for creating a receipt and getting return values within the receipt and after the receipt.
Complete list with detailed descriptions is available at partner.bowa.sk after logging in, in information for integrators section.
Description of states S and transitions between them
Command | Description | Permitted use in states | Transition between states | Note |
|---|---|---|---|---|
paragonBegin | Receipt opening | S0, S1 | S1->S2, S0,S1->S10, S1->S20, S1->S32 | |
paragonEnd | Receipt ending | S4, S10, S20, S34 | S4->S1, S10->S1,S0, S20->S1, S34->S1 | |
itemSale | Item sale | S2, S32 | ||
itemReturn | Item return | S2, S32 | ||
itemVoid | Item cancellation | S2, S32 | ||
itemNegative | Return of packaging | S2 | ||
itemDiscount | Discount / surcharge on item | S2 | ||
subtotalDiscount | Discount / surcharge on subtotal | S2 | ||
subtotal | Subtotal | S2 | ||
depositeInDrawer | Deposit / withdrawal | S20 | ||
payment | Total | S2, S3, S32, S33 | S2->S3, S3->S4, S32->S33, S33->S34 | |
printAnnouncement | Print announcement | S4, S10, S34 | ||
printAnnouncementNF | Print announcement NonFiscal | S2, S3, S4, S10, S20, S32, S33, S34 | ||
itemDiscount2 | Discount / surcharge on item Type2 | S2 | ||
subtotalDiscount2 | Discount / surcharge on subtotal Type2 | S2 | ||
popis0Dph | Description for 0% VAT | S2, S32 | ||
setTransactionId | Setting the parent application internal code ID | S2, S3, S4, S32, S33, S34 | ||
setTransactionId2 | Setting the parent application internal code ID Type2 | S2, S3, S4, S32, S33, S34 | ||
odpocitanaZaloha | Using a pre-received down payment | S2, S32 | ||
vymenaPoukazu | Exchange of a single-purpose voucher | S2, S43 | --> S43 | |
printDisplay | Show on the display | S0, S1, S2, S3, S4, S10, S20, S32, S33, S34 | ||
clearDisplay | Reset the display | S0, S1, S2, S3, S4, S10, S20, S32, S33, S34 | ||
printDisplay2 | Show on the display Type2 | S0, S1, S2, S3, S4, S10, S20, S32, S33, S34 | ||
setInvoiceNumber | Entering an invoice number when paying an invoice | S32, S33, S34 | ||
printIssuedParagon | Additional receipt registration | S2, S3, S4, S32, S33, S34 | ||
printBC | Print barcode | S1, S2, S4, S10, S20, S32, S34 | ||
setSellerID | Setting up a representative seller ID | S2, S32 | ||
repeatParagon | Print a copy of the last receipt | S0, S1 | ||
destroyParagon | Receipt cancellation | S2, S3, S4, S10, S20, S32, S33, S34, S43 | Sx->S1 | Cancels unfinished receipt, which ended with processing error |
printReport | Printing of financial report „X“, „Z“ | S1(Z1,X1) | S1->S0 (Z1) | |
printIntervalFPD | Print interval report from fiscal memory Dfrom/Dto | S0, S1 | D - date | |
printJournalStructD | Print content of ELJ Dfrom/Dto | S0, S1 | D - receipt printing date | |
printJournalStructU | Print content of ELJ Ufrom/Uto | S0, S1 | U - receipt number | |
synchronizationToPPEKK | Protected data storage synchronization to PPEKK | S0, S1 | ||
setLicense | Licence setup for given deviceId | S0, S1 | ||
setAllVats | Bulk setup of VAT rates | S0, S1 | ||
getVariable | Read states (variable) | All | ||
getLastParagon | Read last receipt | S0, S1 | ||
opravaDokladu | Command for receipt correction after receiving error SFS | S0, S1 | ||
getJournalStructU | Download receipt to PC | S0, S1 | ||
getJournalStructD | Download ELJ to PC Dfrom/Dto | S0, S1 | ||
getIntervalFPD | Download interval statement from DB Dfrom/Dto | S0, S1 | D - receipt printing date | |
setSubjectIdData | Retrieving subject identification data | S0 | ||
setAutKey | Authentification data setup | S0 | ||
setV48 | Set an exception for sending within 96 hours | S0, S1 | ||
setSmtp | SMTP setup for sending emails with e-receipt or directory setup for saving these emails | S0, S1 | ||
setEmail | Entering an email address where e-receipt should be sent | S2, S3, S4, S32, S33, S34 | ||
printUnsentSfsPackets | Unsent packets printing to SFS | S0, S1 | ||
getParagonIds | Receipt identifiers return according to the specified parameter | S0, S1 | ||
getParagonIds2 | Receipt identifiers return according to the specified parameter Type2 | S0, S1 | ||
setPrinterType | Set printer type | S0, S1 | Password required | |
setPassword | Set service passwordN | S0, S1, S2, S3, S4, S10, S20, S32, S33, S34 | Password required, we recommend not to change | |
setPaymentType | Set payment method parameters | S0, S1 | ||
setPaymentType2 | Set payment method parameters Type2 | S0, S1 | ||
setHeader | Set header for printReport commands | S0, S1 | Password required | |
setParameter | Set global parameters | S0, S1 | Password required | |
setVat | Set VAT rate | S0, S1 | Password required | |
setAdditionalHeader | Set additional header | S0, S1 | printed on every receipt until erased or overwritten | |
setAdditionalFooter | Set additional footer | S0, S1 | printed on every receipt until erased or overwritten | |
setPreline | Set PreLine - text before item | S2 | ||
setPostline | Set PostLine - text after item | S2 | ||
setEscapeSequence | Set ESC sequence | S0, S1, S2, S3, S4, S10, S20, S32, S33, S34 | ||
getEscapeSequence | Reading data invoked via ECS sequence | S0, S1, S2, S3, S4, S10, S20, S32, S33, S34 | ||
setLocation | Setup GPS/Mobile cash register business address | S0, S1 | ||
setPchdu | Setting communication parameters of protected data storage towards PPeKK | All | ||
loadGhNv | Write a graphic header to NV memory printer | S0, S1 | for supported printer types only | |
setBcParm | Setup parameters for barcode | S0, S1 | ||
setQRparm | Setup parameters for QR | S0, S1 | ||
printQRCode | Print of non-fiscal QR code | S2, S4, S10, S20, S34, | max 350 chars; only for supported printers | |
setPparameter | Setup parameters to FM | S0, S1 | Password required | |
setDispF | Selecting the display type as fiscal | S0 | Password required | |
getJournal | Download ELJ to PC | S0, S1 | ||
setSuperFooter | Set supper footer | S0, S1 | ||
resetStates | Delete the last saved error code FM/SFS (B51) | S0, S1 |
KVERKOM commands - QR payments
Command | Description | Permitted use in states | Transition between states | Note |
|---|---|---|---|---|
qrInit | KVERKOM module init | S0, S1 | ||
qrgetServerStatus | NOP server availability | S0, S1 | ||
qrLink | KVERKOM link generate | S0, S1 | ||
qrGetResultMQTT | NOP notification check | S0, S1 | ||
qrSyncServerData | Manual check for notification | S0, S1 | ||
qrPrintClaim | Claim protokol print | S0, S1 | ||
qrPrintReport | Print KVERKOM transaction report | S0, S1 | ||
qrGetReport | Get KVERKOM transaction report | S0, S1 | ||
qrSetPaymentType | Set pamyent ID for KVERKOM payment - simplified implementation | S0, S1 | ||
qrGetTransactionInfo | Returns data from KVERKOMpayment | S0, S1 | ||
qrSetDisplayType | Set connection for KVERKOM external display | S0, S1 | ||
qrPrintDisplay | Tranfer data to KVERKOM external display | S0, S1 | ||
qrClearDisplay | Delete data from KVERKOM external display | S0, S1 |
In the following breakdown is every command explained separately and when it can/must be used