Fiscal Receipt Integration (Russia)
Fiscal Receipt Integration (Russia)
Section titled “Fiscal Receipt Integration (Russia)”A computer club in Russia that accepts cash or card payments must use a KKT (fiscal cash register) and transmit every payment to an OFD — a certified fiscal data operator. IZI handles this automatically: each payment in the CRM triggers a fiscal receipt through the connected fiscal register (FR). The FN module inside the FR signs the document cryptographically and the OFD receives a copy online. No extra steps for the admin.
Below is how the chain works inside IZI, what you need to configure, and how to resolve discrepancies.
How the Fiscal Chain Works
Section titled “How the Fiscal Chain Works”Payment in IZI CRM → IZI builds receipt data (item name, amount, tax regime, VAT rate) → KkmServer (Windows service on the register PC) → Fiscal Register (FR) → FN module signs the document → OFD receives a copy via internet → Client receives a paper receipt or a link to the electronic oneThe admin does not need to do anything beyond processing the payment. If the OFD connection drops temporarily, the FN stores unsent documents and forwards them once connectivity is restored.
What Gets Fiscalized
Section titled “What Gets Fiscalized”| IZI Operation | Fiscal Document Type |
|---|---|
| Balance top-up (cash or card) | Sale receipt |
| Payment for a tariff or product from balance | Sale receipt |
| Refund to client | Refund receipt |
| Bonus credit | Not fiscalized |
| Payment with bonuses | Not fiscalized |
Configuring the Cash Register in IZI
Section titled “Configuring the Cash Register in IZI”All settings live at the organization level: Settings → Integrations → Cash Register.
Step 1. Select the Adapter and Country
Section titled “Step 1. Select the Adapter and Country”In the Adapter field, choose KKM — this activates fiscal mode via KkmServer. In the Country field, choose Russia — IZI automatically switches to the Russian FFD (fiscal format) protocol.
The Cashier field sets the cashier name printed on every receipt (FFD tag 1021). The Legal Entity field sets the organization name for the receipt header.
Step 2. Tax Regime (STS/OSNO/Patent)
Section titled “Step 2. Tax Regime (STS/OSNO/Patent)”This is the most important section for correct fiscalization. IZI separates the setting into three independent fields:
| IZI Field | Covers |
|---|---|
| Tax Regime for Balance Top-Up | Receipts when a client loads funds onto their balance |
| Tax Regime for Services | Receipts when buying gaming tariffs |
| Tax Regime for Goods | Receipts when purchasing bar or shop items |
All three can be the same if you operate under a single regime, or different — for example, if services and goods fall under different tax objects.
Supported Tax Regimes
Section titled “Supported Tax Regimes”IZI supports the following STS/OSNO/Patent values (FFD tag 1055):
| IZI Code | Regime | VAT on Receipt |
|---|---|---|
PSN | Patent (PSN) | No VAT |
USN_INCOME | Simplified (income) | No VAT |
USN_INCOME_EXPENSE | Simplified (income minus expenses) | No VAT |
AUSN_INCOME | Automated Simplified (income) | No VAT |
AUSN_INCOME_EXPENSE | Automated Simplified (income minus expenses) | No VAT |
OSNO_20 | General (OSNO) | VAT 20% |
OSNO_10 | General (OSNO) | VAT 10% |
OSNO_0 | General (OSNO) | VAT 0% |
OSNO_20_120 | General (OSNO) | VAT 20/120 (calculated rate) |
OSNO_10_110 | General (OSNO) | VAT 10/110 (calculated rate) |
USN_5 / USN_7 | Simplified with VAT | VAT 5% / 7% |
When any Simplified or Patent regime is selected, IZI passes a VAT rate of “No VAT” (tag 1043 = -1) to the FR. For OSNO regimes, the corresponding VAT rate is sent.
How IZI Identifies a Fiscal Receipt
Section titled “How IZI Identifies a Fiscal Receipt”Every printed receipt gets a stable identifier in the format <FN>:<FD>, where:
- FN — the 16-digit serial number of the fiscal storage module (assigned by the tax authority at registration, globally unique)
- FD — the sequential number of the fiscal document on that FN’s tape
IZI attaches this identifier to the transaction and uses it in the reconciliation module. The same identifier is embedded in the QR code on the paper receipt and in the OFD verification URL (fn= and i= parameters).
Receipt Reconciliation: IZI vs. FN Tape
Section titled “Receipt Reconciliation: IZI vs. FN Tape”The Receipt Reconciliation section (in the club menu) is an operational control tool. It compares IZI transactions against fiscal documents on the FN tape for the selected shift.
Row Statuses in the Table
Section titled “Row Statuses in the Table”| Status | Meaning | Action |
|---|---|---|
| Matched | Transaction in IZI and receipt on FN tape | No action needed |
| IZI Only | Transaction in IZI, no receipt on FN tape | Click Issue Receipt |
| FR Only | Receipt on FN tape, no transaction in IZI | Click Add to IZI |
”Issue Receipt” Without a New Charge
Section titled “”Issue Receipt” Without a New Charge”The Issue Receipt button sends a fiscal command for the existing transaction — without creating a new payment or charging the client’s card again. IZI attaches the new receipt identifier to the transaction, and the row moves to “Matched” status.
Open Receipt on OFD
Section titled “Open Receipt on OFD”For rows with a matched receipt, the Open OFD button is available. It opens the verification page on your fiscal data operator’s website. The link is built from the <FN>:<FD> identifier embedded in the fiscal document.
FN Validity and Shift Requirements
Section titled “FN Validity and Shift Requirements”FN validity period. Depends on your tax regime and FN model: 13, 15, or 36 months. IZI displays FN status in the cash register status view. Replace the FN before it expires — once the module fills up, the FR blocks all transactions.
24-hour shift limit. Under 54-FZ, a shift on the FR cannot remain open longer than 24 hours. If it does, the FR locks. IZI shows the error “Cash register shift is not open or has exceeded 24 hours” — close the shift on the FR and open a new one. Keep IZI shift open/close operations synchronized with the FR.
FN storage requirement. Under 54-FZ, a replaced FN must be kept physically for at least 5 years from the date of registration — do not discard it.
Troubleshooting Common Errors
Section titled “Troubleshooting Common Errors”KKT Not Found
Section titled “KKT Not Found”IZI shows “KKT not found” when KkmServer cannot detect the fiscal register. The What to do? button opens a step-by-step guide:
- Check the FR is powered on — indicators or display should be lit
- Open Windows Device Manager → Ports (COM & LPT): unplug the FR cable and reconnect — the device should disappear and reappear
- Right-click the KkmServer tray icon → Exit (not “Restart KKM”)
- Launch KkmServer as Administrator via Windows search
- Retry the operation in IZI CRM
Payment Completed but Receipt Not Printed
Section titled “Payment Completed but Receipt Not Printed”IZI shows the notification “Payment completed, but receipt was not printed” and a Reprint Receipt button. Click it — IZI resends the print command without a new payment. If reprinting fails, find the transaction in the Receipt Reconciliation section and use Issue Receipt from there.
KkmServer Unavailable
Section titled “KkmServer Unavailable”The error “KKM server unavailable” means the CRM cannot connect to KkmServer on the register PC. Verify that KkmServer is running, that the network address is configured correctly, and that the firewall is not blocking the configured port.
Electronic Receipts and Client Data
Section titled “Electronic Receipts and Client Data”If a player’s profile includes a phone number or email address, IZI passes that contact to the FR. The OFD automatically sends the client an electronic receipt, so you do not need to print a paper one if the client prefers digital.
See Also
Section titled “See Also”- Cash Register Integration — technical details for connecting the fiscal register
- Cash Shift Flow — opening and closing shifts in sync with the fiscal register
- Finance Overview — full overview of the finance module in IZI
Frequently asked questions
Does a computer club in Russia need an online cash register?
Yes. Any club accepting cash or card payments from individuals must use a KKT (fiscal cash register) under Federal Law 54-FZ. The only exception is individual entrepreneurs (IP) on a patent for specific activity codes — verify with your accountant for your OKVED.
How does IZI print a fiscal receipt?
When a payment is processed in the CRM, IZI sends the receipt data to KkmServer, a Windows service that drives the physical fiscal register (FR). The FN (fiscal storage module) inside the FR signs the document cryptographically and forwards it to the OFD. The entire chain runs automatically — no manual action from the admin.
What is the FN and how long does it last?
The FN (Fiskalny Nakopitel) is the secure storage module inside the fiscal register. It records and cryptographically signs every fiscal document. Validity period is 13, 15, or 36 months depending on the model and your tax regime. When it expires, replace the FN and re-register the cash register with the tax authority.
What happens if the payment went through but no receipt printed?
IZI shows a notification 'Payment completed, but receipt was not printed' and offers a 'Reprint Receipt' button. Pressing it sends the print command again without creating a new charge — IZI only re-sends the fiscal command for the existing transaction.
How do I configure the tax regime in IZI for receipts?
Go to Organization Settings → Integrations → Cash Register. Set the Adapter field to KKM and the Country to Russia. Then fill in three separate fields: Tax Regime for Balance Top-Up, Tax Regime for Services, and Tax Regime for Goods. Each can be set independently if different activities are taxed under different regimes.
What is receipt reconciliation in IZI?
The Receipt Reconciliation section matches IZI transactions against fiscal documents on the FN tape for a selected shift. Rows with status 'IZI Only' represent payments that have no corresponding fiscal receipt — you can fix them directly from the table using the 'Issue Receipt' button.
Can I open a receipt on the OFD website from IZI?
Yes. For rows with a matched fiscal receipt, the 'Open OFD' button is available. It opens the receipt verification page on your fiscal data operator's website using the URL embedded in the fiscal document.
Why must the fiscal register shift not exceed 24 hours?
54-FZ requires that a shift on the FR cannot stay open longer than 24 hours. If it does, the FR locks and stops accepting transactions. IZI will show the error 'Cash register shift is not open or has exceeded 24 hours' — close the shift on the FR and open a new one.
What should I do if the fiscal register is not found during payment?
IZI shows the error 'KKT not found' along with a 'What to do?' button that opens a step-by-step guide: check that the FR is powered on, open Windows Device Manager and verify it appears under Ports (COM & LPT), restart KkmServer as Administrator.
Do I need a separate contract with an OFD?
Yes. A contract with an OFD (e.g., Platforma OFD, OFD.ru, Perviy OFD) is a separate legal requirement under 54-FZ. IZI sends receipt data to the FR; the FR then forwards the fiscal document to the OFD over the configured channel.
Is a fiscal receipt required for a bonus top-up?
No. A bonus top-up is not a monetary settlement with the client, so no fiscal receipt is required. IZI does not send a command to the FR when crediting bonus funds.