Skip to content

Cash Register Integration in IZI

Published: · Updated: (3 days ago)· IZI Team

IZI automatically generates a receipt for every payment — top-up, direct session charge, or bar sale — and sends it to the connected fiscal printer without any manual action from the admin. The printer issues the fiscal document and forwards a copy to the designated tax authority or fiscal data operator.

This means cashiers never handle receipts manually: open a payment in IZI, confirm it, and the fiscal document is issued in the background.

Payment in IZI → IZI builds the receipt data → KKM-Server → fiscal register prints the receipt → fiscal data operator gets a copy

The administrator does nothing extra — the receipt is created automatically for every cash or card payment.

OperationReceipt
Client balance top-upSale
Product or combo saleSale, as a product line
Refund to a clientSale refund
Cash collectionCash withdrawal on the register
Payment with bonusesNot fiscalized (no money moves)

When a payment goes through an acquiring terminal, IZI records it only after the register confirms the receipt and returns its fiscal number. Without confirmation, CRM reports that the register did not confirm the fiscal document and the operation was not recorded: check the receipt on the register and repeat the payment.

In a club with a fiscal register, products and combos are paid with money only at the register, as a receipt line: cash or card. They cannot be paid from the game balance — CRM shows “Balance payment is unavailable: goods must be paid at the club’s cashier”. Bonuses apply to such items within the bonus limit.

Tariffs in the same order can be paid with bonuses and from the game balance. The payment window combines everything into one register operation: the products plus the part of the tariffs that bonuses and balance do not cover; a hint shows the split — bonuses, from balance, at the register.

A combo whose parts carry different VAT rates (for example, a service and a product) is printed as lines of its parts with their own rates.

A refund receipt repeats the lines of the sale receipt: the refund amount is spread over the lines of the printed top-up receipt — the refunded order items first — and the register prints those lines instead of a generic top-up refund line. A line cannot be refunded twice.

By default the receipt shows the cashier name from the Cashier field of the cash register provider. With Print administrator’s name in receipts on, the logged-in employee’s name is printed and the Cashier field is hidden. In that mode the employee must have a name in their account — otherwise CRM blocks the register operation and asks them to set it.

  • Out of paper. If the register or the acquiring terminal has no paper, CRM blocks the payment: “The receipt paper has run out. Replace the paper roll and try again.”
  • Outdated KkmServer. CRM compares the KkmServer version with the current one and warns once that it should be updated on the cash PC. The warning never appears during a payment.
  • No connection. If KkmServer is unreachable, payments with a receipt do not go through.

In a club with a connected register, the menu has Money → KKM reconciliation. Pick a shift: the quick check compares IZI totals with the register counters for sales and refunds, cash and card. Detailed reconciliation lists operations as Matched, Missing on KKM or Missing in izi. Rows offer Add to izi, Print receipt copy and Open in OFD, and Download report exports the result. The same check runs when the shift closes.

Printer-based cash register outside Russia

Section titled “Printer-based cash register outside Russia”

In the UAE, Saudi Arabia, Morocco, Oman, Bahrain, Kuwait and Qatar, no hardware fiscal register is required: the receipt is printed by a printer. This kind of register is connected as a cash register provider with the “Printer” adapter — see Payment and cash register providers.

If KKM-Server refuses an operation because of its license, the register stops issuing receipts. CRM warns the club 30 days before the license ends, and shows the “KkmServer has no license” error once it has expired. Contact IZI support to arrange renewal in advance.

After renewal has been paid for, the local KkmServer may still need to retrieve the license. On the PC running KkmServer, open http://localhost:5893/License/ (or its configured address), select Лицензия (License), and click Получить лицензии (Get licenses) directly below the table. For a standard license tied to the cash register’s tax ID (INN), leave the sublicensing email and password fields empty. The INN used for payment must match the INN registered in the cash register.

Wait for KkmServer to restart and return to the license page. Do not start a payment during this restart. Confirm that the row for the correct INN shows + and the renewed expiry date, then check that the register is available. Verify receipt printing with the next real sale; do not create a fictitious sale to activate the license. If renewal does not appear, send support the INN, payment confirmation, and a screenshot of the license page.

This procedure was verified with KkmServer 2.3.17.23. See the detailed Russian guide and verified renewal example and the vendor’s license instructions.

KkmServer 2.1.18.10 license page: the License menu is circled as step 1 and the Get license button as step 3

In this official vendor screenshot, 1 marks Лицензия (License) and 3 marks Получить лицензию (Get license). The screenshot shows the older 2.1.18.10 interface. In 2.3.17.23, the button is labelled Получить лицензии (Get licenses) and sits directly below the ИНН ККТ / Лицензия / До даты table (tax ID / license / expiry date). Leave the email and password fields marked 2 empty when using a standard license tied to the register’s INN.

The register connects through KKM-Server: KKM-Server is installed on the cash PC, the fiscal register and the acquiring terminal are connected to it, and in CRM a cash register provider is created (Money → Payment methods → Providers) and linked to the club (Money → Payment methods → Payments). The step-by-step guide is available in Russian: cash register setup (KKM).

Before setup you need:

  • A fiscal register registered with the tax authority
  • A valid fiscal storage module
  • A contract with a fiscal data operator
  • A KKM-Server license

Once set up, every cash or card payment is fiscalized automatically.

When a club has a register connected, closing the shift in IZI also closes the shift on the register, which prints the Z-report. Before closing, IZI reconciles its totals with the register counters: the Register total (cash and cards) should match the Z-report. A gap means some payments bypassed the register. Details: Shift Z-report.

Frequently asked questions

Do all clubs need a fiscal receipt printer connected to IZI?

Only if local law requires it. IZI works without a connected receipt printer — payments are recorded in the system regardless. The printer is needed when regulations mandate issuing a fiscal document for each transaction.

What happens if the printer is offline during a payment?

A payment with a receipt does not go through: IZI records the payment only after the register confirms the receipt. If the register does not answer or is out of paper, CRM shows an error and blocks the payment — fix the cause and try again.

Do I need a separate contract with a fiscal data operator?

Yes, where required by law. IZI sends receipt data to the printer; the printer forwards it to the fiscal data operator via a separately configured channel. The contract with the operator is arranged outside of IZI.

Is bonus payment fiscalized?

No. Bonus point redemptions do not involve a cash flow, so no fiscal receipt is generated for them.

Do I need to reconcile the printer's Z-report with IZI's shift report?

IZI does it for you: when a club has a register connected, closing the shift reconciles IZI totals with the register counters and warns about a mismatch. The Register total (cash and cards) should match the Z-report.

Can products be paid from the game balance in a club with a register?

No. In a club with a fiscal register, money for products and combos is taken only at the register as a receipt line — cash or card. Bonuses apply within the limit. Tariffs in the same order can be paid with bonuses and from the balance.

About IZI