A Checkbox cash register connects to Elbuz with the cashier's details and the register licence key; then you issue fiscal receipts from the order card. The register, cashier and signature are set up in your my.checkbox.ua account; Elbuz opens the shift itself.
When you need this:
- No register yet: the account files the tax office forms itself, and the free DepositSign key needs no file.
- Want to try it first: a test register and cashier appear right after sign-up, no tax office needed.
- Register already running: enter its details, and receipts go through it.
Where to start: take the test cashier's details and enter them in the Elbuz Checkbox form.
What the Checkbox connection can do
- Two ways for the cashier to sign in: login and password, or just a PIN.
- Register settings: company, VAT, automatic receipt, shift closing, cash on delivery.
- Test mode: the real receipt path without the tax office.
- Clear failure reasons: signature, VAT rate, licence key.
How to register a cash register and cashier in Checkbox
You register in the Checkbox account, and it files the forms with the tax office itself. The steps below follow the Checkbox help as of 06.11.2026: getting started, cash registers, cashiers.
- Account. Sign up at my.checkbox.ua and add your company details from the tax office: you'll need the director's key.
- Point of sale. Points already registered with the tax office are pulled in on sync. A new one is registered with form 20-OPP from the account.
- Cash register. «Каси» (Cash registers) → «Додати касу» (Add register), pick the point of sale from the list, PRRO type «Інтернет-торгівля» (Online trade). The request is signed with a key file, Diia.Signature or SmartID. The status «На реєстрації» (Registering) changes to «Активна» (Active) in about 5–10 minutes.
- Cashier and key. «Касири» (Cashiers) → «Додати касира» (Add cashier), then «Створити ключ DepositSign» (Create a DepositSign key) or «Через ключ ЕЦП» (Using an EDS key). Make up a login and password and sign the request.
- Checkbox.Pidpys. With a key file: in the cashier's row, three dots → «Запустити Checkbox.Підпис на захищеному хмарному сервісі» (Run Checkbox.Pidpys on a secure cloud service), certificate authority, file, password, «Запустити» (Run). Within 3–5 minutes the cashier shows the status «Агент підпису працює» (Signing agent is running).
- Rates. By default the account has only «Без ПДВ» (No VAT). A VAT payer adds their own rates: you can change them only while the shift is closed, and changes apply from the next shift.
A cashier works with only one register at a time. A sole proprietor can register the cashier on their own key; for an LLC the help requires a separate seal for each register.
What details Elbuz needs and where to find them
| Field in Elbuz | What to enter | Where to find it |
|---|---|---|
| Cashier login | The cashier's login. Leave it empty if you sign in with a PIN | you made it up when adding the cashier, «Касири» (Cashiers) section |
| Cashier password or PIN | The cashier's password or, if the login is empty, the PIN | you made it up when adding the cashier; the password can't be recovered, only replaced: «Касири» → «Дії» → «Редагувати» → «Новий пароль» (Cashiers → Actions → Edit → New password) |
| Register licence key | The key of the register your receipts go through | my.checkbox.ua account, «Каси» (Cash registers) section |
| Integration key (optional) | Leave it empty unless Checkbox support issued one to you | Checkbox support |
A cashier login is unique across all of Checkbox. The published help doesn't show exactly where the licence key and PIN are on screen. If you can't find them in the account, ask Checkbox customer care.
How to set up the cash register in Elbuz
Where: Account → System settings → “Other settings” → the “External services and integrations” tile → the “Fiscal receipts” group → the “Checkbox” row, pencil icon.
1
Cashier login2
Cashier password or PIN3
Register licence key4
Integration key (optional)- Cashier login — leave it empty to sign in with a PIN only, entered in the password field next to it.
- Cashier password or PIN — the saved value is never shown again.
- Register licence key — a separate key for each cash register.
- Integration key — fill it in only if Checkbox support issued one.
The form saves itself: “Saved” appears at the bottom. A saved password and licence key aren't shown in the fields. New values reset the cashier's session, and the next request signs in with them.
| Field | What it does | Default |
|---|---|---|
| Active | Off: the register isn't offered and the receipt button disappears. Receipts already issued stay in the documents | off |
| Company | “Any”: for all documents; a specific company: 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 the Z report at 22:30 or 23:30 Kyiv time. Also, when a shift opens, Checkbox gets an auto-close time of 23:30 | on |
| Cash on delivery | Mode for cash-on-delivery parcels, chosen by your accountant | Receipt at dispatch |
The “Shift” block below the form shows “Shift open” or “Shift closed”. If it shows an error message, the cashier's details or the licence key are wrong. This is the first check, and it needs no receipt.
How to issue your first receipt in test mode
A test register and cashier appear in the «Каси» (Cash registers) and «Касири» (Cashiers) sections right after sign-up, and they need no KEP. The limit is 100 test receipts per month. Don't give a test receipt to a customer: it isn't a settlement document.
- Enter the test cashier's details and the test register's licence key in the Checkbox form, and turn on “Active”.
- Open a customer order in hryvnias 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 details.
- Click “Issue receipt” and wait. The first receipt of a shift takes longer, because Elbuz opens the shift first.
Result: the number, amount, date, the “test, non-fiscal” mark and the “Open receipt” link. The same receipt, marked «Тестовий чек» (Test receipt), is in the account under «Архів чеків» (Receipt archive). It doesn't prevent you from issuing a real receipt for this document.
1
Receipt number2
Test, non-fiscal3
Open receipt- Receipt number — the number, amount and date are saved in the document.
- “test, non-fiscal” — this is a test register: the receipt does not go to the tax office.
- Open receipt — a link to the issued receipt.
To switch to the real register, close the test shift, replace the cashier's details and licence key in the form, and make sure the “Shift” block shows no error.
Scenarios
A sole proprietor sells through their own website
What to do. Register a cash register of type «Інтернет-торгівля» (Online trade), a cashier on your own key, run Checkbox.Pidpys and enter the details in Elbuz.
Result. Receipts are signed automatically; you don't need to keep a computer with the key switched on.
The cashier doesn't want to share the account password
What to do. Leave “Cashier login” empty and enter the PIN in “Cashier password or PIN”.
Result. Elbuz signs in with the “licence key + PIN” pair. The Checkbox help calls this method the recommended one.
The register already works in the Checkbox app
What to do. Close the shift and connect the same cashier in Elbuz, or a second one on a second register: a cashier works with only one register at a time.
Result. Receipts from orders are visible both in Elbuz and in the account. Elbuz doesn't see receipts issued earlier in the app, and Checkbox doesn't accept such a receipt's data from Elbuz. How to handle a return for one is described in the section on a receipt from another program.
What to do when the cash register doesn't 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 password or licence key isn't entered, or the register's company doesn't match the document | Check the register form (settings) |
| “Checkbox: sign in HTTP …” | Checkbox didn't accept the login, password, PIN or licence key | Re-enter the details (where to find them). For a PIN, leave the login empty |
| “Checkbox: shift was not opened, check the signing key in the Checkbox account” | The service refused to open the shift, usually because of the signing key | Check the «Агент підпису працює» (Signing agent is running) status and the key's expiry date in the account (registration) |
| “Checkbox: VAT rate … is not set up in the Checkbox account” | The Checkbox account has no such rate | Add the rate while the shift is closed and click “Issue receipt” again |
| “Receipt not confirmed: Checkbox: receipt is still being fiscalized. Click again: a retry will not create a second receipt.” | The service didn't process the receipt within the waiting time | Wait a few minutes and click “Issue receipt” again: Elbuz will find the same receipt |
Messages about the receipt itself in a document are covered in the article on receipts.
FAQ
What is the “Integration key” and where do I get it?
It's an optional key issued by Checkbox support. If you weren't given one, leave the field empty: the register works without it.
Who sends the receipt to the customer?
Checkbox itself, to the email and phone number Elbuz passed from the document. Only a Ukrainian phone number in the +380 format is passed.
Do I need to open a shift before issuing a receipt?
No. If the shift is closed, Elbuz opens it before the receipt and waits for the service to confirm.
My KEP key has expired. What changes in Elbuz?
You don't need to change anything in Elbuz. Replace the key in the Checkbox account while the shift is closed. Until the key is replaced, the shift may not open.
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 form data stays. Turning it back on restores everything as it was.
Where it is and who has access
- Menu
- Account → System settings → “Other settings” → “External services and integrations” → the “Fiscal receipts” group → Checkbox
- Access rights
- the “API & access tokens” window in “Group permissions”
- Prepare
- a my.checkbox.ua account; for a real register, the qualified e-signature key (KEP/EDS) of the director or sole proprietor (FOP)
Related topics
- If you need the big picture and a reference on when a receipt is required: PRRO cash registers: fiscal receipts from Elbuz.
- If the register is connected and it's time to issue receipts: How to issue a fiscal receipt and what to do with returns.
- If you're choosing a service and considering the other option: How to connect Vchasno.Kasa.
