Documentation
Changelog

Changelog

5.3.2024

Added documentation for requesting payment reports via API. This feature is still in beta.

22.02.2024

Increased item limit in getMealMenus() method to 5 000.

14.02.2024

Updated PayU testing card

19.12.2023

Added new receipt delivery type

12.12.2023

Upcharge details moved from extenstions to base integration

01.11.2023

Further refinments
Added Upcharge feature

20.06.2023

Removed Czech EET parameters from fiscalInfo data structure

16.06.2023

Overhauled the order of categories
Separated base methods and data structures from extensions

06.03.2023

Added updated testing cards for all supported countries
Added Austrian fiscalization info in FiscalInfo datastructure
Added German fiscalization info in FiscalInfo datastructure

08.08.2022

Added info about BillSubItem in BillItem

13.06.2022

Added info about lock timeout on paymentStart
Added info about mandatory state checking on paymentClosed

10.06.2022

Added the “Loyalty cards” extension
Removed the “Call the waiter” extension
Removed the pairCustomer() method

04.04.2022

Cleared up production Pos-Id assignment process

23.03.2022

Added a section about Qerko functions and use cases

21.03.2022

Fixed a mistake in the Discount structure - the description property should be called name

07.01.2022

Added BKP in Slovakia FiscalInfo

05.01.2022

Added receiptDeliveryType POSTPONED

07.12.2021

Added the Slovakia-specific parameters to FiscalInfo
Added the ReceiptDeliveryType parameter of the Receipt structure

12.10.2021

Fixed dead links
Added the Orders extension doc link

22.06.2021

Improved documentation of Table

11.06.2021

Replaced testing credit card due to payment gateway switch
Improved documentation of Websocket close codes

01.06.2021

Fixed some grammar mistakes and typos

31.12.2020

Updated test credit card

04.11.2019

Changed the magic keyword for switch to development environment to qerko-toggle-test
Added examples
Added headerLines, headerText, footerLines, footerText to FiscalInfo structure

27.06.2019

Added optional Extensions
Corrected a few typos
Corrected a few mistakes in examples

12.06.2019

Added payment diagram
Added optional MethodCallResponse.calledMethod
Added missing info about time limit of method cancelPayment(...)
Added error codes: ACCESS_DENIED, ALREADY_AUTHORIZED, NO_SUCH_METHOD, NOT_FOUND, TIME_LIMIT_EXPIRED

01.06.2019

Changed Error.reason to Error.code
Added list of Error Codes
Removed Bill.roundingMode
Added Bill.additionalData
BillItem.tags are no longer required
BillItem.minQuantity default value is 1
Removed BillDiscountOffer.roundingMode
Renamed BillDiscountOffer.description to BillDiscountOffer.name
Added Payment.additionalData
Renamed Payment.tip to Payment.tipBrutto
Removed Payment.total
Renamed Payment.idUser to Payment.idCustomer
Added Payment.state STARTED
Added PaymentProvider.id
Removed Receipt.additionalData
Added Receipt.receiptInfo and structure ReceiptInfo
Moved Receipt.footerLines to changes in ReceiptInfo.footerLines
Moved Receipt.headerLines to changes in ReceiptInfo.headerLines
Moved Receipt.waiter in ReceiptInfo.waiter
Receipt.items are required now
Added Receipt.fiscalInfo and structure FiscalInfo

24.5.2019

Removed BillItem.splittable
Added BillItem.minQuantity
Added Bill.roundingMode
Added BillDiscountOffer.roundingMode
Added Payment.tipNetto

17.5.2019

Renamed BillItem.amount to BillItem.quantity Added optional property Receipt.items Minor changes in descriptions

13.5.2019

Added locale into Authorization request message

9.5.2019

Payment.paymentProvider was replaced by Payment.parts Added PaymentPart structure Added BillItem.amount Added BillItem.id Added BillItem.splittable Changed BillItem.price

24.4.2019

Added headerLines a footerLines to the Receipt structure Removed lines form the Receipt structure

23.4.2019

Allow to skip nullable properties in data structures Renamed pairUser(...) to pairCustomer(...)

19.4.2019

Added Bill.denyDiscounts This can prevent Qerko from applying a discount

18. 4. 2019

It Is Paid is renamed to Qerko
This document is in English now
Introducing API v2.
Added websocket support.
Added Bill structure.
This brings support for multiple bills on a table.
Added BillDiscountOffer structure.
This brings support for POS discount offers.
Added BillItem structure.
This brings support for additionalData that can be used by POS.
This brings the all new tags set for item categorization or recognition.
Added Discount structure.
Successor of the Sale structure.
Support for various discount sources.
Added endpoint for cancelling the payment.
For the ability to cancel the payment in case of a customer issue.
Added getBill(...) method.
For the ability to get the contents of an exact bill.
Added pairUser(...) method.
For the ability to pair Qerko’s users and POS loyalty DB.
Added TaxInfo structure.
Taxes are completely calculated by POS now.
Added Receipt structure.
Successor of BillInfo.
Many changes due international differences.
Added MethodCallRequest.
Just for convenience. This has introduced no functional changes.
Added MethodCallResponse.
Type of MethodCallResponse.error has changed.
Changed method error(...).
Error is be reported using Error structure, not just string.
Changed method getTableContents(...).
Added idUser argument, so POS can offer discounts.
Changed methods paymentProcessed(...) and paymentClosed(...).
To prevent sending the same data more than once and the validation related with it.
Structure Payment.
Added Payment.paymentProvider
Removed Payment.idTable.
Replaced by Payment.idBill.
Removed Payment.totalItems.
It was confusing and useless.
Removed Payment.timestamp.
It was useless.
Removed BillInfo structure.
Replaced by Receipt.
Removed Sale structure.
Replaced by Discount.
Removed TableContents structure.
Replaced by Bill.
Removed TableItem structure.
Replaced by BillItem.