Fiscalization in Uzbekistan (UzKassa) — Paloma POS 2

This article is about Paloma POS 2 — the new Paloma cash-register app (a touch interface on a tablet, POS terminal, or Windows device). If you are not sure which product you have, start with «How to tell you have Paloma POS 2». Fiscalization is sending a paid receipt to a cloud fiscal cash register (OFD). In Uzbekistan, Paloma POS 2 works with the cloud kassa UzKassa: the register connects to your account with the operator and fiscalizes every closed order automatically.

Overview

How it works in Paloma POS 2:

• One fiscal device per workplace. You connect UzKassa once and make it the default. After that, every paid receipt is fiscalized on its own.
• Auto-fiscalization on payment. During checkout the register shows «Fiscalizing receipt (OFD)...», and on success the order gets the status «Fiscalized».
• Retry on failure. If a receipt closes without being sent (no connection, kassa error), it shows as «Not fiscalized» and can be resent — per row or all at once.
• A shift won't close with a debt. The close-shift wizard won't let you close the day while there are paid but unfiscalized receipts.

Where to go: Register menu screen → «Settings» → «Hardware» → «Fiscal Devices».

Step 1. Connect the UzKassa register

1. Open «Settings» → «Hardware» → «Fiscal Devices» and tap «Add fiscal device».
2. Choose the provider «UzKassa».
3. In the «UzKassa settings» section fill in the connection fields:
   • «Cloud URL» — the address of your UzKassa cloud register.
   • «Cashier phone» — the cashier login in UzKassa (phone number).
   • «Password» — the cashier password.
   • «Cash register serial» — the serial number of your register with the operator.
4. Turn on «Set as default fiscal» — then the register fiscalizes every closed order at this workplace. In the list the device gets the «Default fiscal» badge.
5. Save the device.

If your build has no fiscal modules, the register says so in the devices section — install the Uzbekistan build to set up UzKassa.

Step 2. Check the payment-type mapping

So the register knows how to process each payment type, the device card has a «Fiscal payment mapping» section. For every payment type the workplace accepts, pick «Cash», «Card», or «Don't» (do not fiscalize). Unmapped payment types are excluded from the fiscal call — those receipts stay unfiscalized until you set up the mapping.

Step 3. Automatic fiscalization on payment

When the register is connected and set as default, you don't need to do anything extra:

1. Take and pay for an order as usual.
2. During checkout the register shows «Fiscalizing receipt (OFD)...». If it takes longer than usual, the register continues in the background and warns you.
3. On success the order gets the «Fiscalized» status and a fiscal receipt number. If an item has a marking code, it is sent with that line in the fiscal receipt — the code is filled in the item card in the dashboard; there is no separate entry at the register during the sale.

If no fiscal device is set as default, the payment screen shows a «Fiscal device not configured» banner with a hint to open settings. Until then, payment goes through without fiscalization.

Step 4. Retry on failure

If a receipt closed but did not go to fiscalization, resend it. Finding such receipts is easy:

1. Open the order list, go to the «Closed» tab, and in «Filters» under «Fiscalization» pick «Not fiscalized». Such a receipt row shows a «Not fiscalized» mark.
2. You can resend two ways:
   • From the order card — open the unfiscalized receipt and fiscalize it there.
   • In bulk — the «Fiscalize checks» button in the order-list header. It opens the «Fiscalization retry» dialog.

In the «Fiscalization retry» dialog (hint: «These orders closed without firing the fiscal kassa. Retry per row, or skip remaining to finish closing the shift.»):

• «Fiscalize all» — sends all unfiscalized receipts at once; the register shows progress.
• Each receipt has a «Retry» button for a per-row send. A successful row gets «Fiscalized», an error gets «Failed».
• «Skip remaining» — close the dialog and leave the rest as is.

When everything is sent, the register says «All today's orders are fiscalized.» The dialog shows only the current shift's debt. The same dialog opens at the checks step when closing the shift — a shift cannot close while there are unfiscalized receipts.

Common problems

• «Fiscal device not configured» («Tap to go to Settings → Hardware → Fiscal Devices and pick a default kassa. Payment will continue without fiscalization until then.») — the register isn't connected or isn't set as default. Connect UzKassa and turn on «Set as default fiscal».
• «Could not fiscalize the order.» — the send failed. Check the connection and retry via «Fiscalize checks» → «Retry»; on a persistent error, verify the cashier phone, password, and register serial with the operator.
• «This payment type isn't mapped for fiscalization. Open the fiscal device settings and set it to Cash or Card.» — the payment type isn't mapped. Open the device card → «Fiscal payment mapping» and pick «Cash» or «Card».
• «Fiscal receipt failed to send — saved for retry» — the receipt is saved and will go out when the connection is back; resend it manually from the order list if needed.
• «Resolve open or unfiscalized checks before closing the shift.» — the shift still has unfiscalized receipts. Open «Fiscalization retry» and tap «Fiscalize all».
• The receipt didn't reach the OFD — on the «Closed» tab turn on the «Fiscalization» → «Not fiscalized» filter, find such receipts, and resend them.

FAQ

What do I need to connect UzKassa?

Your register details with the operator: «Cloud URL», «Cashier phone», «Password», and «Cash register serial». Enter them in the «UzKassa settings» section and turn on «Set as default fiscal» — after that the register fiscalizes every closed order automatically.

Can I work without fiscalization?

Yes, but every paid receipt stays «Not fiscalized», and the register keeps reminding you with the «Fiscal device not configured» banner. Closing the shift won't always work — the close wizard requires resolving unfiscalized receipts.

What do I do with unfiscalized receipts before closing the shift?

Open the «Fiscalization retry» dialog — via «Fiscalize checks» in the order list or right at the checks step when closing — and tap «Fiscalize all», or send receipts per row with «Retry». See «Closing the shift and Z-report».

My register is in Kazakhstan, not Uzbekistan.

Kazakhstan uses different cloud registers — Webkassa and ReKassa. See «Fiscalization in Kazakhstan (Webkassa and ReKassa)».