Paloma365

English

Русский

English

Русский

Appearance

Fiscalization in Kazakhstan (Webkassa and ReKassa) — Paloma POS 2 ​

This article is about Paloma POS 2 — the new Paloma cash register app (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 means sending a paid receipt to a cloud cash register (KKM) and to the fiscal data operator (OFD). In Kazakhstan, Paloma POS 2 works with the cloud registers Webkassa and ReKassa: the app connects to your register with the operator and fiscalizes every closed order automatically.

Overview ​

How it works in Paloma POS 2:

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

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

Step 1. Connect a Webkassa or ReKassa register ​

  1. Open «Settings» → «Hardware» → «Fiscal Devices» and tap «Add fiscal device».
  2. Pick a provider — «WebKassa» or «ReKassa».
  3. Fill in the connection details (below) and turn on «Set as default fiscal» — then the register fiscalizes every closed order for this workplace. In the list the device gets a «Default fiscal» badge.

For Webkassa:

  • Enter the cashier login and password, then tap «Connect to WebKassa».
  • The register shows the account's cashboxes — pick one in «Choose cashbox». If it isn't listed, tap to enter the serial number manually and provide the register serial (the SWK number on the device sticker).

For ReKassa:

  • Enter the register serial number and the partner API password, then tap «Verify ReKassa connection».
  • The fastest way is «Scan QR code»: point the scanner at the register's QR code (shown when the register is created in the Paloma365 dashboard) or paste its contents. The register confirms: «Serial and password filled from the QR code.»
  • The register PIN field is optional — it is only needed to close the fiscal shift (Z/X report) and is not part of the QR code.

If your build has no fiscal modules, the devices screen says so — install the Kazakhstan build to set up Webkassa or ReKassa.

Step 2. Check the payment-type mapping ​

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

Step 3. Automatic fiscalization on payment ​

Once the register is connected and set as default, there is nothing extra to do:

  1. Take and pay the order as usual (see «Paying an order»).
  2. During checkout the register shows «Fiscalizing receipt (OFD)...». If it takes longer than usual, the register keeps going in the background and warns about it.
  3. On success the order carries the «Fiscalized» status and an OFD fiscal receipt number. A QR code and a verification link print on the receipt — governed by the «Print QR code on receipt» setting.

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 fiscalization after a failure ​

If a receipt closed but didn't reach the OFD, it needs to be resent. Finding these is easy:

  1. Open the order list, go to the «Closed» tab, and in «Filters» under «Fiscalization» pick «Not fiscalized». Such a receipt shows a «Not fiscalized» mark in its row.
  2. Resend in 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, which opens the «Fiscalization retry» dialog.

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

  • «Fiscalize all» — sends every unfiscalized receipt at once; the register shows progress.
  • Each receipt has a per-row retry button. A successful row gets the «Fiscalized» status; on error it shows an error.
  • «Skip remaining» — close the dialog and leave the rest as they are.

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

Step 5. IIN/NTIN and email on the receipt ​

  • NTIN (goods code). If an item is marked or needs a national-catalog code, its card has an «NTIN / NKT code» field. This code goes into the fiscal receipt per line — it is filled in the goods catalog, not entered at the register during a sale.
  • BIN/IIN. The organization's details («BIN/IIN», OFD, control sum) print on the fiscal Z-report at shift close if the «Print fiscal Z-report on shift close» setting is on.
  • Receipt by email. To send the buyer a receipt link, use the «Send the receipt link by email» button on the payment screen; it opens a dialog where the address is entered.

Common problems ​

  • "Не удалось получить отчёт" / "Ошибка печати: {reason}" — the fiscal report was not built or not printed; the reason follows.
  • "Не удалось определить период смены — сверка с журналом недоступна" — the POS could not take the shift bounds, so the journal reconciliation cannot be built. Close the shift and retry.
  • "ККМ недоступна. Продолжить без фискализации?" — on a cash in/out: the POS does not see the fiscal device. Continue only deliberately — the operation will have no fiscal receipt.
  • «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 Webkassa or ReKassa and turn on «Set as default fiscal».
  • «Could not fiscalize the order.» — the send failed. Check the connection and retry via «Fiscalize checks»; if the error persists, verify the register login/password 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 mapping section and choose «Cash» or «Card».
  • «Fiscal receipt failed to send — saved for retry» — the receipt is saved and will go out when the connection returns; resend manually from the order list if needed.
  • Unfiscalized receipts block shift close — open «Fiscalization retry» and tap «Fiscalize all» to clear the shift's debt.
  • A receipt didn't reach the OFD — on the «Closed» tab enable the «Fiscalization» → «Not fiscalized» filter, find such receipts, and resend them.

FAQ ​

How does Webkassa differ from ReKassa in the register? ​

For the cashier — almost nothing: both fiscalize receipts automatically. The difference is in connecting. For Webkassa you enter the cashier login and password and pick a cashbox from a list. For ReKassa — the register serial and the partner API password, most easily filled with «Scan QR code».

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 may not always succeed — the close wizard requires you to clear 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 on the checks step during close — and tap «Fiscalize all», or resend receipts per row. More in «Closing the shift and the Z-report».

How do I find receipts that didn't reach the OFD? ​

In the order list, on the «Closed» tab open «Filters» → «Fiscalization» → «Not fiscalized». Their rows carry a «Not fiscalized» mark.

The fiscal QR code prints when «Print QR code on receipt» is on. Even with the QR off, the text verification link keeps printing. More about receipt printing in «Printing the receipt and bill».

Is the receipt emailed to the buyer? ​

Yes. On the payment screen tap «Send the receipt link by email» and enter the address — the buyer gets a link to the electronic receipt.