KSeF e-invoicing for hosting companies, straight from the payment
Since 1 April 2026, invoices to businesses in Poland have to be issued in KSeF, the national e-invoicing system, and the largest companies have done so since 1 February 2026. Flaem issues the invoice the moment the client pays, builds the FA(3) file, sends it to KSeF in the background, retries when KSeF does not answer and tracks the statutory deadlines, including for corrections and advance invoices.
schema of every invoice, correction and advance invoice
is how often the queue checks what is waiting to be sent
send attempts before the queue calls a human
KSeF environments to choose from: test, pre-production and production
Dates and rules as published by the Polish Ministry of Finance: ksef.podatki.gov.pl (in Polish)
Who has to use KSeF, and from when
The obligation came in stages. Every Polish business has received its invoices through KSeF since 1 February 2026, while the date from which it must also issue them there depends on its sales. 2026 is a transition year without penalties for KSeF mistakes.
The PLN 10,000 limit
Once the invoices KSeF covers pass PLN 10,000 gross in a month, KSeF applies from the invoice that crossed the limit, and there is no going back to the old rules.
An invoice in KSeF is final
An invoice accepted by KSeF cannot be changed. A mistake is fixed with a corrective invoice.
Sent the same day
An invoice issued online has to reach KSeF the same day. Sent later, it legally becomes an offline24 invoice.
How an invoice gets from a payment into KSeF
A purchase never waits for KSeF. The invoice is created in the same moment as the payment, and a background queue does the sending, so a KSeF outage blocks no sale and no renewal.
Payment
The client pays through a gateway, a saved card or the wallet. The same transaction writes the invoice and a KSeF queue entry.
FA(3) file
Flaem builds the FA(3) XML from the same record as the client's PDF, so the amounts in both always match.
Background queue
A background process checks the queue every 60 seconds and sends documents one at a time. A document goes to KSeF once, even with two control planes on one database.
KSeF
Flaem authenticates with a KSeF token in the seller's tax ID context and uploads the file, which KSeF checks against the schema.
Number or rejection
The KSeF number is stored with the invoice. A rejected document stops, and your staff get a notification with the reason.
Before an invoice joins the queue
- VIES
- An EU business VAT number is checked at the sale, and a reverse charge needs a confirmation no older than 30 days.
- NBP
- A foreign-currency invoice carries the average NBP table A rate from the last business day before the tax point, together with the table number.
- OSS
- Sales to consumers in other EU countries are counted in euro, and from the sale that passes EUR 10,000 the invoice carries the client's country rate.
- WP
- A wallet top-up gets a payment confirmation in its own WP series and stays out of KSeF, because it is not a sale. The invoice comes with the service the balance pays for.

When KSeF does not answer
The queue does not flood a system that has just announced an outage. Attempts come further and further apart, and after the twelfth failure the queue stops and tells your staff.
- A notification with the reason
- After the twelfth failed attempt, or a rejection by KSeF, every administrator gets a notification with the invoice number and the reason. The document does not go back on the queue without a human decision.
- Retry from the queue screen
- Once you fix the seller details or replace the token, you resend the document with one button. Wrong invoice content is fixed with a correction, not a resend.
- Overdue documents first
- The queue screen lists everything that has not reached KSeF yet: overdue documents first, then by deadline and age.
- No duplicates in the register
- If the connection drops after KSeF has taken the file, the next attempt sends the same bytes and KSeF answers with the number it assigned the first time.
The attempts end within a day, while the deadline for sending the invoice only passes at the end of the next business day, which leaves time to act.
Deadlines for offline invoices
An invoice that reaches KSeF later than the day it was issued is legally an offline invoice. For every invoice in the queue, Flaem works out the deadline by mode and by the Polish business-day calendar.
| Mode | When it applies | Deadline for sending to KSeF |
|---|---|---|
| Offline24 | The issuer uses it at will, with no announcement and no proof of a lost connection. | By the next business day after the issue date. |
| KSeF unavailability | Maintenance announced by the Ministry of Finance. | By the next business day after the unavailability ends. |
| KSeF failure | A failure announced in the Ministry of Finance public bulletin (BIP) and in the interface software. | Within 7 business days after the failure ends. |
| Total failure | Announced on radio, television or the internet when KSeF is down for systemic reasons. | No obligation to send. Invoices from that period stay outside KSeF. |
Modes and deadlines as described by the Polish Ministry of Finance on ksef.podatki.gov.pl (articles 106nda, 106nh and 106nf of the Polish VAT Act).
Example: an offline24 invoice dated 23 December 2026
If an invoice dated 23 December does not reach KSeF that day, the deadline is 28 December: 24 December is Christmas Eve, a public holiday in Poland since 2025, 25 and 26 December are Christmas, and 27 December is a Sunday.
Ministry announcements in the panel
You record an announced unavailability or failure with its dates and a link to the announcement. The deadlines of the invoices it affects move by themselves, and while it lasts, no deadline runs.
The Polish business-day calendar
Flaem counts business days with Polish public holidays, including the ones that move with Easter, and with Christmas Eve, a holiday since 2025.
Corrections and advance invoices in KSeF
An invoice accepted by KSeF cannot be edited, so every mistake and every refund is documented with a corrective invoice. Flaem issues it from the panel and sends it through the same queue as an FA(3) file of the KOR kind.
A correction from the panel
- The correction names the corrected invoice together with its KSeF number and states the reason, because an accountant will not accept one without it.
- By default it reverses the whole invoice, and when needed it corrects selected lines by the amounts you enter.
- It takes the rates and the tax treatment from the original invoice, not from today's rate table, so it always cancels what it corrects to the cent.
- It waits on the queue until the original has a KSeF number, without spending any send attempts on the wait.
- It does not move money. Refunding the client's wallet is a separate action with its own approval.
Advance invoice or wallet top-up
- Advance invoice ZAL
- Documents a payment for a specific, identified service before it is supplied. VAT arises on payment, and the document goes to KSeF.
- Payment confirmation WP
- A wallet top-up identifies no service, so it stays out of KSeF. The invoice is issued when the balance pays for a service.
KSeF rules worth remembering
- One invoice can have any number of corrections.
- An invoice with the wrong buyer tax ID needs a correction to zero and a new invoice with the right one.
- Buyers no longer issue correction notes. The seller issues the correction.
A reseller's KSeF under the reseller's own tax ID
A reseller sells under its own brand and issues invoices in its own name, so its invoices reach KSeF in its own tax ID context and with its own token, not through the operator's account.
- A reseller token only works in the tax ID context of the reseller's seller details. Flaem refuses a token for another tax ID, because the FA(3) file names the reseller as the seller.
- The reseller checks the connection with a test that authenticates to KSeF and sends nothing.
- It has its own queue screen, retries its own documents, issues its own corrections and is notified about its own rejections.
- It picks the test, pre-production or production environment with the token. Changing the environment needs a new token, because a token only works where it was issued.
KSeF in other hosting billing systems
Several hosting billing systems handle KSeF today, to a different extent and at a different cost. The comparison follows the vendors' own pages.
| System | How KSeF works | Corrective invoices | Cost of KSeF |
|---|---|---|---|
| WHMCS | Paid third-party add-ons from the WHMCS Marketplace: KSeF Integrator and PUQ KSeF Integrator. WHMCS's built-in e-invoicing sends over the PEPPOL network to Belgium. | Depends on the add-on | KSeF Integrator USD 139.99, PUQ KSeF Integrator from USD 23 with an active licence |
| HostBill | The eInvoices KSeF plugin, added on 27 February 2026. | The vendor states the module does not support corrective invoices | In the All Inclusive edition or USD 199 one-time |
| Blesta, Paymenter | We found no KSeF add-on. | Not applicable | Not applicable |
| Flaem | Built into billing: queue, retries, offline deadlines and reseller KSeF | Yes, KOR naming the corrected invoice | In every licence |
Prices before tax, from the vendors' pages: hostbillapp.com, marketplace.whmcs.com and whmcs.com.
Questions about KSeF for hosting companies
Answers to what operators ask most often, under the rules currently in force.
Companies with sales above PLN 200 million including VAT in 2024 since 1 February 2026, everyone else since 1 April 2026. Until the end of 2026, invoices may stay outside KSeF while the invoices it covers stay under PLN 10,000 gross a month. From 1 January 2027, KSeF covers everyone.
No. Issuing consumer invoices in KSeF is optional, and they do not count towards the PLN 10,000 limit. Once KSeF is connected, Flaem sends every domestic sales invoice to it, consumer invoices included, and the client can also download each invoice as a PDF in the panel.
No. Purchases, renewals and invoicing never call KSeF. A background queue does the sending, so a KSeF outage stops no payment.
The invoice waits on the queue, with attempts after 1, 5, 15 and 30 minutes, then hourly. You record an announced unavailability or failure in the panel, and the deadlines move as the law says.
With a corrective invoice issued in the panel. It names the original's KSeF number and the reason, and goes to KSeF through the same queue.
With a KSeF token issued for the seller's tax ID, for example in the Ministry of Finance's free KSeF taxpayer app. You enter it in the KSeF integration, and the panel never shows it again, only that it is set.
No. The Ministry of Finance decided that tokens stay in KSeF 2.0 with no end date, and an issued token works until you revoke it.
Yes. You choose the test, pre-production or production environment with the token, and the connection test authenticates to KSeF without sending anything.
According to the Ministry of Finance, 2026 is a transition year without penalties for mistakes in using KSeF. Penalties apply from 1 January 2027.
No. A top-up identifies no specific service, so Flaem issues a payment confirmation in its own WP series, outside KSeF. The invoice comes with the service the client pays for from the balance.
Yes. A reseller has its own seller details, numbering series, corrections and a KSeF token for its own tax ID.
Sources
Dates and rules come from the Polish Ministry of Finance, and the details about other systems from their vendors' pages.
- When do invoices have to be issued in KSeF? (in Polish)Ministry of Finance, updated 30.04.2026
- KSeF 2.0 rollout stages (in Polish)Ministry of Finance, updated 29.05.2026
- KSeF 2.0 questions and answers (in Polish)Ministry of Finance, updated 11.09.2026
- Before the second KSeF stage (in Polish)Ministry of Finance, 31.03.2026
- Under PLN 10,000: questions and answers (in Polish)Ministry of Finance, updated 20.11.2025
- Consumers and private persons (in Polish)Ministry of Finance, updated 30.10.2025
- Christmas Eve as a public holiday: Journal of Laws 2024 item 1965 (in Polish)in force since 01.02.2025
- HostBill: eInvoices KSeFhostbillapp.com
- WHMCS Marketplace: results for KSeFmarketplace.whmcs.com
- WHMCS: e-invoicingwhmcs.com
See the invoice, the queue and a correction at work
In the demo we show an invoice created from a payment, the KSeF queue and a correction. Tell us what you invoice with today and whether you sell through resellers.