Vchasno.Kasa connects to Elbuz with one token, and fiscal receipts are then issued right from the order card. The register, signing key and tax registration stay in your Vchasno.Kasa account.
What you get:
- No cash register yet — the “3в1” (3-in-1) form in the service account registers the outlet, register and cashier key at once.
- Your register is already running — enter its token, and Elbuz receipts go through it.
- You want to test first — a test register runs the full path: the receipt shows in the document but never reaches the tax office.
Where to start: generate a test register token and enter it in Elbuz.
What the Vchasno.Kasa connection does
- Token connection — one key per register, no cashier or password in Elbuz.
- Register settings — company, VAT, automatic receipt, shift closing, cash on delivery.
- Test run — the real receipt path without the tax office.
- Switching to a live register — replace the token; test receipts do not get in the way of real ones.
How to register a cash register in Vchasno.Kasa
You register in the service account, not in Elbuz. The steps below follow the Vchasno.Kasa help center as of 06.11.2026; if the account looks different, use the first steps in the service.
- On kasa.vchasno.com.ua, click “Зареєструватися” (Sign up), enter your email and password, and confirm the email from the message.
- Add the company’s KEP key file, enter its password and check the details.
- Choose “Тестувати” (Test) to work without the tax office first, or “Почати роботу” (Get started) for real receipts.
- For a live register, fill in the “3в1” (3-in-1) form: outlet, register, cashier key. For a website, the register type is “Інтернет-торгівля” (Online trade). Click “Зареєструвати у ДПС” (Register with the State Tax Service).
- Wait for the tax office to respond. The help center gives up to 3 minutes for the initial setup and about 15 minutes for separate requests to the State Tax Service.
Which key to sign with — a sole proprietor’s key, a cashier’s key or a company seal — is covered in the service help on keys. The key must be in the account’s key storage: without it, as the cloud API description says, fiscalization does not work.
If the register is already registered with the tax office, the account offers to import it: select the outlet and register you need. You do not have to register it again.
Set up payment types and tax groups there as well. Elbuz sends the VAT rate from the document, and the register must support it.
Where to get the register token
Each register has its own token, including a test one. According to the service help:
- In your Vchasno.Kasa account, open “Торгові точки та каси” (Outlets and registers) in the left menu.
- Select the register and click the gear icon: its settings open.
- Scroll to “Токен” (Token), click “Згенерувати токен” (Generate token) and copy the value.
How to set up the register in Elbuz
Where: Account → System settings → “Other settings” → “External services and integrations” tile → “Fiscal receipts” group → the “Vchasno.Kasa” row, pencil icon.
1
Where to find the token2
Register token3
VAT payer4
Close the shift every evening- The hint says where in the Vchasno.Kasa account to take the token.
- The saved token value is never shown back in the field.
- When VAT payer is off, all lines go without VAT.
- The Z report is issued automatically; this switch is on by default.
The form saves itself, there is no “Save” button: “Saved” appears at the bottom. A saved token is not shown in the field, you only see dots.
| Field | What it does | Default |
|---|---|---|
| Active | Off — the register is not offered and the receipt button disappears. Receipts already issued stay in the documents | off |
| Register token | The register key from the account | empty |
| Company | “Any” — for all documents; a specific one — only for that company’s documents | Any |
| VAT payer | On — the rate is taken from the document line or the product. Off — all lines go without VAT | off |
| Receipt on payment by link | The receipt is issued automatically on payment via a payment link | off |
| Close the shift every evening | A cron job produces a Z report at 22:30 or 23:30 Kyiv time, depending on the season | on |
| Cash on delivery | Mode for cash-on-delivery parcels, chosen by your accountant | Receipt at dispatch |
The “Shift” block under the form shows the status: “Shift open” or “Shift closed”. If it shows an error message, the token is wrong: check it. This is the first check of the key, and it needs no receipt.
How to issue the first receipt on a test register
A test receipt does not go to the tax office and does not stop you from issuing a real one for the same document. Do not send it to the customer: the service explicitly prohibits issuing test receipts to customers.
- Enter the test register token and turn on “Active”.
- Open a customer order in UAH and click “Fiscal receipt”. Use your own order for the check.
- Check the payment method.
- Turn off “Send receipt to” if the document has a real customer’s contact.
- Click “Issue receipt”.
You see the result in the window and later in the document dialog: number, amount, date, the “test, non-fiscal” mark and the “Open receipt” link. The register’s “Shift” block shows “Shift open”: the first receipt opened it.
1
Receipt number2
Test, non-fiscal mark3
Open receipt- Receipt number — the number, amount and date are stored in the document.
- Test, non-fiscal — such a receipt is not sent to the tax office and does not interfere with a real one.
- Open receipt — a link to view and print the receipt.
How to switch to a live register
- Close the test register shift with the “Close shift” button.
- Generate the live register token and enter it in the “Register token” field over the old one.
- Check “VAT payer”, “Company” and the other switches: they do not depend on the register and stay as they are.
- Make sure the “Shift” block shows no error. The first real receipt opens the shift by itself.
Test receipts stay in the documents with their mark and do not affect a real receipt for the same sale.
Scenarios
No cash register yet
What to do. Sign up in Vchasno.Kasa, choose “Тестувати” (Test), generate a token and check one receipt in Elbuz. Then complete the “3в1” (3-in-1) form and replace the token.
Result. The first real receipt comes only after your managers have seen the whole path.
The register runs in Vchasno, receipts are issued manually
What to do. Close the shift, generate a new token if the old one is lost, and enter it in Elbuz.
Result. A receipt from an order goes to the same register. Elbuz does not see a sale receipt issued earlier in the account: for a return against it there are separate fields.
Payment by link via LiqPay
What to do. Turn on “Receipt on payment by link” and connect a payment service.
Result. A receipt with the “LiqPay” payment method is issued automatically once the payment arrives.
What to do when the register does not work
| What you see | Why | What to do |
|---|---|---|
| “Cash register is not connected. Turn it on and enter the key in “External services” → “Fiscal receipts”.” | The register is off, the token is empty, or the register’s company does not match the document | Check the register form (settings) |
| “Вчасно.Каса: HTTP …” or “Вчасно.Каса: ‹code› ‹text›” in the “Shift” block | The service rejected the request. Most often the token is old or was copied with extra characters | Generate a new token and enter it (where to get it) |
| “Вчасно.Каса: VAT rate … is not supported” | The line rate is not 20, 14, 7 or 0% | Correct the rate in the document line or in the product |
| “Receipt not issued: Вчасно.Каса: …” with a message about the key | The service cannot sign the receipt | Check the key in the account’s key storage (registration) |
The text after the service name comes from Vchasno.Kasa itself. Receipt messages in the document are covered in the article on receipts.
FAQ
Do I need to install Device Manager?
No. Elbuz calls the Vchasno.Kasa cloud API directly, so there is nothing to install on your computer.
I have several registers in Vchasno. How do I connect a second one?
One row is one token, that is, one register. Add the second one with the “Add API” button above the “External services and integrations” list by choosing “Fiscal receipts — Vchasno.Kasa”. A “Cash register” field then appears in the document so you can choose.
Do I need to open a shift every morning?
No. The first receipt opens the shift, and a cron job closes it unless “Close the shift every evening” is turned off.
What happens if I turn off “Active”?
The receipt button disappears from new documents, and automatic receipts stop. Documents with issued receipts keep the button, and the token stays in the form. Turning it back on restores everything as it was.
Do receipts in Elbuz cost anything?
Issuing a receipt charges nothing to your Elbuz balance. The register’s plan is set by Vchasno.Kasa in your contract.
Where it is and who has access
- Menu
- Account → System settings → “Other settings” → “External services and integrations” → “Fiscal receipts” group → Vchasno.Kasa
- Access right
- the “API and access tokens” window in “Group permissions”
- Prepare
- a Vchasno.Kasa account; the company’s qualified electronic signature (KEP) key file for registration
Related topics
- If you need the big picture and a reference on when a receipt is mandatory — PRRO cash registers: fiscal receipts from Elbuz.
- If the register is connected and it is time to work — How to issue a fiscal receipt and what to do with returns.
- If you are choosing a service and looking at the other option — How to connect a Checkbox register.
