↑↓ selectEnter openEsc close

    1. Elbuz

    How to connect a Checkbox cash register to Elbuz

    4 min readUpdated

    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

    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.

    1. Account. Sign up at my.checkbox.ua and add your company details from the tax office: you'll need the director's key.
    2. 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.
    3. 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.
    4. 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.
    5. 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).
    6. 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.
    With DepositSign, don't skip the last step in the account: after accepting the terms, click the black status button «Відправити в ДПС» (Send to the tax office). Until the cashier is registered, the shift won't open and no receipt goes out. Details are in the help on cashiers.

    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 ElbuzWhat to enterWhere to find it
    Cashier loginThe cashier's login. Leave it empty if you sign in with a PINyou made it up when adding the cashier, «Касири» (Cashiers) section
    Cashier password or PINThe cashier's password or, if the login is empty, the PINyou made it up when adding the cashier; the password can't be recovered, only replaced: «Касири» → «Дії» → «Редагувати» → «Новий пароль» (Cashiers → Actions → Edit → New password)
    Register licence keyThe key of the register your receipts go throughmy.checkbox.ua account, «Каси» (Cash registers) section
    Integration key (optional)Leave it empty unless Checkbox support issued one to youCheckbox 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.

    The “Checkbox connection” form: activity switch, cashier login, password or PIN, register licence key, integration key, company and the option switches
    1Cashier login
    2Cashier password or PIN
    3Register licence key
    4Integration key (optional)
    1. Cashier login — leave it empty to sign in with a PIN only, entered in the password field next to it.
    2. Cashier password or PIN — the saved value is never shown again.
    3. Register licence key — a separate key for each cash register.
    4. 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.

    FieldWhat it doesDefault
    ActiveOff: the register isn't offered and the receipt button disappears. Receipts already issued stay in the documentsoff
    Company“Any”: for all documents; a specific company: 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 the Z report at 22:30 or 23:30 Kyiv time. Also, when a shift opens, Checkbox gets an auto-close time of 23:30on
    Cash on deliveryMode for cash-on-delivery parcels, chosen by your accountantReceipt at dispatch
    A VAT payer turned the switch on, but the Checkbox account still has only «Без ПДВ» (No VAT). The receipt stops with the error “VAT rate … is not set up”. Add the rate in the account while the shift is closed: Elbuz looks there for exactly the same rate as in the line.

    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.

    1. Enter the test cashier's details and the test register's licence key in the Checkbox form, and turn on “Active”.
    2. Open a customer order in hryvnias 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 details.
    5. 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.

    Fiscal receipt result: sale receipt number, amount and date, marked as test and non-fiscal, with an Open receipt link
    1Receipt number
    2Test, non-fiscal
    3Open receipt
    1. Receipt number — the number, amount and date are saved in the document.
    2. “test, non-fiscal” — this is a test register: the receipt does not go to the tax office.
    3. 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

    Messages when connecting
    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 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

    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