eparagony.pl — e-receipts and KSeF invoices from orders
Noxti sends sales to eparagony.pl, which prints and fiscalizes the receipt on your fiscal printer. The buyer receives an email with a link to the e-receipt, and a KSeF invoice can also be created on request.
What it does
eparagony.pl sits between Noxti and your fiscal printer. When Noxti sends an order, the printer fiscalizes it, and the buyer receives a link to an e-receipt. The same integration can also issue a VAT invoice in KSeF.
Connecting it
- Go to Integrations → catalog → eparagony.pl → add a connection.
- In the security section, enter the details supplied by eparagony.pl: API client ID, API client secret, and point of sale ID (posId). The integrator also receives an Integrator ID.
- Fill in the Fiscal printer VAT rate table (A–G) exactly as programmed in the printer. If an order’s rate is not in the table, the receipt will not be issued. Noxti never silently substitutes 0%. Items without a rate (Allegro does not send one) use the Default VAT rate (23%).
- Set payment methods for prepaid and cash-on-delivery orders.
- Enter the Webhook secret so statuses arrive immediately. Without it, Noxti checks them every 5 minutes.
Issuing documents
- Manually: in the order details, open the Fiscal documents tab and click Issue next to the e-receipt or KSeF invoice.
- Automatically: create a Workflow rule with the Issue fiscal e-receipt action. The rule determines which orders receive a receipt—sales channel, COD, payment status, country, and order status. The action requires the corresponding role permission.
Which orders: example rules
Create a separate rule for each channel and payment method. For example:
| Rule | When | If | Then |
|---|---|---|---|
| Allegro prepaid orders | status changes to “Paid” | Channel = Allegro, NOT Cash on delivery, Paid | Issue fiscal e-receipt |
| Store COD orders | status changes to “Shipped” | Channel = Store, Cash on delivery | Issue fiscal e-receipt |
| Poland only | any time | add condition: Delivery country = Poland | Issue fiscal e-receipt |
Simply leave channels that you do not fiscalize (for example, B2B or a marketplace that provides its own document) out of all rules.
The customer wants an invoice. The action has a When the customer wants an invoice setting:
- Do not issue a receipt (default)—another rule or system, such as wFirma, will issue the invoice.
- Issue a KSeF invoice instead—through the same eparagony.pl connection.
You can also add the Customer wants an invoice condition to any rule.
Before enabling receipts for prepaid orders, check with your accountant whether mail-order sales paid by bank transfer are exempt from fiscal cash register requirements in your case.
Issuing from the order card requires the Orders > Issuing receipts and invoices permission under Team and access → Roles and permissions, as well as add permission in the Orders module. Without it, the tab displays documents but no buttons.
A receipt will not be issued when:
- the order is in a currency other than PLN;
- a prepaid order has not yet been paid;
- the order has been canceled or the buyer’s details have been deleted;
- an invoice has already been issued for the order in another accounting system (such as wFirma)—otherwise the sale would be recorded twice.
Each order can have one receipt or invoice for the receipt, even if you have several eparagony.pl connections. An invoice can be issued only after the receipt has been fiscalized, and it must use the same tax ID. Clicking again or rerunning the rule will not issue a second document. If a connection drops, Noxti first asks eparagony.pl whether the document already exists, then retries with the same key.
Statuses on the order card
| Status | Meaning |
|---|---|
| Sending to eparagony.pl | The document is being sent. |
| Retrying automatically | eparagony.pl did not respond. Noxti will check and retry automatically every few minutes. You can also click Retry; Noxti first checks whether the document has already been created. |
| Waiting for fiscalization | eparagony.pl accepted the document, but the printer has not confirmed it yet. |
| Issued, delivery error | The receipt was printed but did not reach the e-receipt repository. Noxti will not issue another one or continue checking; investigate this in eparagony.pl. |
| Issued | The document has been fiscalized. The link opens the e-receipt; the KSeF invoice displays its KSeF number. |
| Fiscalization failed | The reason appears under the status, for example, a printer error or incorrect VAT rate. Fix the cause and click Retry. |
Email to the buyer
After the receipt is fiscalized, Noxti sends the buyer an email with a link. Disable sending with the Send the buyer an email with a link to the receipt setting. Change the email text in the eparagony_receipt template under notification settings. Use the envelope icon on the order card to resend the email. KSeF invoices are not sent by email.
Allegro
When you enable Attach receipt to Allegro orders, eparagony.pl will pass the receipt to the order on Allegro. This works only for orders received from Allegro.
KSeF invoice
An invoice requires your company’s tax ID in company settings and a buyer address with a Polish postal code in the NN-NNN format. The integration does not issue KSeF invoices for foreign addresses. If eparagony.pl reports the invoice as a KSeF duplicate, Noxti will not retry it automatically; check it in the eparagony.pl panel. If the invoice is not there, click Issue anyway. If a receipt has already been issued for the order, the invoice will be marked as an invoice for a receipt.
What is not supported
- Refund receipts and corrections, because eparagony.pl does not support them.
- Sending KSeF invoices by email.
Want to see this with your orders? We’ll show you NOXTI with your sales channels and warehouse.
Book a demo