↑↓ selectEnter openEsc close

    1. Elbuz
    2. Sales and documents
    3. Cash registers (PRRO)

    How to connect the eparagony.pl cash register to Elbuz

    4 min readUpdated

    eparagony.pl is a register for stores in Poland. Elbuz sends the sale to eparagony, it prints the receipt on your fiscal printer, and the customer gets an e-paragon by link. In Elbuz you enter three values from the eparagony email: client_id, client_secret and posId.

    When you need this:

    • You sell from Elbuz in Poland — the printer prints the receipt itself, no manual entry.
    • You want to try first — with eparagony test keys a receipt goes the whole way without a printer.
    • Your register is in Ukraine — see Vchasno.Kasa or Checkbox instead.

    Where to start: sign a contract with eparagony.pl and wait for the credentials email.

    What the eparagony.pl register can do

    The “PRRO cash registers” section covers Ukrainian registers. eparagony.pl sits in the same “Fiscal receipts” group but follows Polish rules: the receipt is printed by a fiscal printer, not by a software register (PRRO).

    What to prepare in eparagony.pl

    1. Contract. The store signs it directly with eparagony.pl; Elbuz is not a party to the contract. Pricing is on eparagony.pl.
    2. Email with credentials. After registration eparagony sends client_id, client_secret and posId — your store identifier.
    3. Printer. The fiscal printer connects to eparagony through their eDPS program, following the eparagony documentation. Elbuz never talks to the printer directly.
    4. VAT rates on the printer. The letters must follow the standard: A 23%, B 8%, C 5%, D 0%, E — exempt. Elbuz sends exactly these letters.

    How to set up the register in Elbuz

    Where: Account → System settings → “Other settings” → the “External services and integrations” tile → the “Fiscal receipts” group → the “eparagony.pl” row, pencil icon.

    The eparagony.pl connection form: credentials, store ID, company and the sandbox switch
    1client_id
    2client_secret
    3posId
    4Test environment (sandbox)
    1. client_id from the eparagony email.
    2. A saved value is shown as dots.
    3. Store identifier from the same email.
    4. For eparagony test keys.
    FieldWhat to enter or choose
    ActiveTurn it on once all three values are entered. An inactive register isn't offered in documents
    client_id, client_secretFrom the eparagony email. A saved client_secret is shown as dots in the field
    posIdThe store identifier from the same email
    Company“Any” or the company whose documents go through this register
    VAT payerOn — the rate is taken from the document line or the product. Off — all lines go with rate E
    Receipt on payment by linkThe receipt is printed automatically when the customer has paid in full by link
    Test environment (sandbox)Turn on for eparagony test keys. Turn off for live keys
    Cash on deliverySame as for other registers: “Receipt at dispatch” or “Do not issue”

    The form saves itself: “Saved” appears at the bottom. A new client_id or client_secret resets the saved sign-in, and the next receipt signs in with the new values. There's no shift-closing switch here: the printer keeps the shift and the daily report (raport dobowy).

    How to test it in the test environment

    1. Enter the eparagony test keys and turn on “Test environment (sandbox)” and “Active”.
    2. Open one of your orders in zloty and click “Fiscal receipt”.
    3. Choose the payment method and click “Issue receipt”. Elbuz waits up to 25 seconds for confirmation.

    Result: the receipt number, amount, date, the “test, non-fiscal” mark and the “Open receipt” link to the e-paragon. In the test environment the eparagony emulator works instead of a printer. So the opened e-paragon always shows a catering service for 460 PLN dated 2022 — that's how eparagony works, not an Elbuz error.

    Result window after issuing a test receipt through eparagony.pl
    1Receipt number
    2Test, non-fiscal
    3Open receipt
    1. The number, the amount in zloty and the date are saved in the document.
    2. Test environment: the receipt has no legal force.
    3. A link to the e-paragon.

    To switch to the live register, replace the keys with live ones and turn off “Test environment (sandbox)”. A test receipt doesn't prevent printing a real one for the same document.

    What goes on the receipt

    The receipt is issued the same way as with other registers: with the “Fiscal receipt” button in the document, from the “POS” window, or automatically on payment by link. How the receipt dialog works — see the article on receipts.

    In ElbuzOn the eparagony receipt
    “VAT payer” on, rate 23 / 8 / 5 / 0%A / B / C / D
    “VAT payer” switch offE — exempt, for all lines
    CashGotówka
    CardKarta
    Transfer to current account, card transferPrzelew
    Other methods: online acquiring, QR, cashless and so onMobilna
    Document discounta separate “Rabat” line

    A receipt is issued only for a document in zloty and only as a sale receipt for the full amount: eparagony.pl doesn't print advance or return receipts. The product name on the receipt is cut to 42 characters — the printer's limit. After confirmation the document keeps the receipt number and the e-paragon link.

    Scenarios

    A store in Poland sells online with payment by link

    What to do. Connect the register and turn on “Receipt on payment by link”.

    What you get. Once the customer has paid the order in full, the receipt is printed automatically, and the e-paragon link appears in the document. If it fails, administrators get a notification, and Elbuz retries every hour.

    An in-store sale from the “POS” window

    What to do. Connect eparagony.pl and sell from the “POS” as usual.

    What you get. Every sale is printed on the fiscal printer; the cashier doesn't enter the receipt on the printer a second time.

    You have a company in Ukraine and a company in Poland

    What to do. Connect both registers and link each one to its company in the “Company” field.

    What you get. A Polish company's document in zloty goes to eparagony.pl, a Ukrainian company's document in hryvnia goes to Checkbox or Vchasno.Kasa.

    What to do when the receipt fails

    eparagony.pl register messages
    What you seeWhyWhat to do
    “Cash register is not connected. Turn it on and enter the key in “External services and integrations” → “Fiscal receipts”.” The register is off, one of the three fields is empty, or the register's company doesn't match the document Check the register form (setup)
    “This register issues receipts in PLN only: this document uses another currency.” The document isn't in zloty Change the document currency to PLN
    “Receipt not issued: eparagony: auth HTTP …” eparagony didn't accept the client_id or client_secret, or test keys were entered without the “Test environment (sandbox)” switch (or the other way round) Re-enter the keys from the email and check the switch
    “Receipt not issued: eparagony: VAT rate 20 is not a Polish rate (23, 8, 5, 0)” The document line or the product has a non-Polish rate Give the products Polish rates (how to set a rate) and issue the receipt again
    “The eparagony.pl register issues sale receipts only: a return or advance receipt cannot be created here.” The receipt dialog has “Advance (partial payment)” selected, or a gift card was sold in the “POS” Wait for full payment and issue a “Full receipt with items”
    “Receipt not issued: eparagony: payment … is not supported” Part of the sale was paid with a gift card or an applied advance Such a sale can't go through eparagony.pl; your accountant decides how to record it
    “Receipt not confirmed: eparagony: the fiscal printer has not confirmed the receipt yet (…). Click again: a retry will not create a second receipt.” The printer didn't confirm the receipt within 25 seconds: for example, it's off or eDPS isn't running Check the printer and click “Issue receipt” again: Elbuz finds the same document in eparagony
    “Receipt not issued: eparagony: fiscal printer error …” The printer refused to print; the reason is in the text after the colon Fix the cause on the printer or in eDPS and issue the receipt again

    FAQ

    How does the customer get the e-paragon?

    The e-paragon link is saved in the document as “Open receipt”. Elbuz doesn't pass the customer's email or phone to eparagony, so send the link to the customer yourself.

    The customer returned a product. What do I do in Elbuz?

    Create the return document as usual. There's no return receipt: in Poland returns are recorded in the seller's returns register, so Elbuz doesn't offer the eparagony.pl register for a return.

    The customer paid part of the order by link. Is there a receipt?

    No: eparagony.pl doesn't print advance receipts, so Elbuz issues no receipt for a partial payment. When the customer pays the rest by link, the receipt for the full amount is printed automatically. If the rest is paid another way, close it with the “Fiscal receipt” button.

    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 keys stay in the form.

    Do I need to open a shift in Elbuz?

    No. The printer keeps the shift and the daily report; Elbuz only sends the sales.

    Where it is and who has access

    Menu
    Account → System settings → “Other settings” → “External services and integrations” → the “Fiscal receipts” group → eparagony.pl
    Issuing a receipt
    customer order or invoice card → “Fiscal receipt”; the “POS” window
    Access rights
    the “API and access tokens” window in “Group permissions”
    Prepare
    a contract with eparagony.pl, the email with client_id, client_secret and posId, a fiscal printer with eDPS

    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