↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect Vchasno.Kasa to Elbuz

    4 min readUpdated

    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

    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.

    1. On kasa.vchasno.com.ua, click “Зареєструватися” (Sign up), enter your email and password, and confirm the email from the message.
    2. Add the company’s KEP key file, enter its password and check the details.
    3. Choose “Тестувати” (Test) to work without the tax office first, or “Почати роботу” (Get started) for real receipts.
    4. 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).
    5. 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:

    1. In your Vchasno.Kasa account, open “Торгові точки та каси” (Outlets and registers) in the left menu.
    2. Select the register and click the gear icon: its settings open.
    3. Scroll to “Токен” (Token), click “Згенерувати токен” (Generate token) and copy the value.
    The token is shown only once. If you lose it, generate a new one: the old one stops working and must be replaced in Elbuz. The service recommends changing a register token only after the shift is closed.

    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.

    The “Vchasno.Kasa connection” form: hint, activity switch, register token, company, VAT payer, receipt on payment by link, nightly shift closing, cash on delivery
    1Where to find the token
    2Register token
    3VAT payer
    4Close the shift every evening
    1. The hint says where in the Vchasno.Kasa account to take the token.
    2. The saved token value is never shown back in the field.
    3. When VAT payer is off, all lines go without VAT.
    4. 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.

    FieldWhat it doesDefault
    ActiveOff — the register is not offered and the receipt button disappears. Receipts already issued stay in the documentsoff
    Register tokenThe register key from the accountempty
    Company“Any” — for all documents; a specific one — only for that company’s documentsAny
    VAT payerOn — the rate is taken from the document line or the product. Off — all lines go without VAToff
    Receipt on payment by linkThe receipt is issued automatically on payment via a payment linkoff
    Close the shift every eveningA cron job produces a Z report at 22:30 or 23:30 Kyiv time, depending on the seasonon
    Cash on deliveryMode for cash-on-delivery parcels, chosen by your accountantReceipt at dispatch
    A VAT payer left the “VAT payer” switch off: receipts go out without VAT. An issued receipt cannot be corrected, so set the switch before the first real receipt. Vchasno.Kasa accepts these rates: 20, 14, 7 and 0%. Any other rate gives the “VAT rate … is not supported” error.

    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.

    1. Enter the test register token and turn on “Active”.
    2. Open a customer order in UAH and click “Fiscal receipt”. Use your own order for the check.
    3. Check the payment method.
    4. Turn off “Send receipt to” if the document has a real customer’s contact.
    5. 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.

    Fiscal receipt result window: sale receipt number, amount and date, marked test, non-fiscal, with an Open receipt link
    1Receipt number
    2Test, non-fiscal mark
    3Open receipt
    1. Receipt number — the number, amount and date are stored in the document.
    2. Test, non-fiscal — such a receipt is not sent to the tax office and does not interfere with a real one.
    3. Open receipt — a link to view and print the receipt.

    How to switch to a live register

    1. Close the test register shift with the “Close shift” button.
    2. Generate the live register token and enter it in the “Register token” field over the old one.
    3. Check “VAT payer”, “Company” and the other switches: they do not depend on the register and stay as they are.
    4. 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

    Connection messages
    What you seeWhyWhat 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

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free