Flaem

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.

FA(3)

schema of every invoice, correction and advance invoice

60 s

is how often the queue checks what is waiting to be sent

12

send attempts before the queue calls a human

3

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)

01Who and when

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.

20262027
JanFebMarAprMayJunJulAugSepOctNovDecJanFebMar
Receiving invoices
Every businessfrom 1 February 2026
Issuing invoices
Sales above PLN 200 million incl. VAT in 2024from 1 February 2026
Every other businessfrom 1 April 2026
Up to PLN 10,000 gross a month on invoices KSeF coversoutside KSeF while the monthly total stays under the limitfrom 1 January 2027
Invoices to consumers
Sales to private persons, such as playersoptional in KSeF, before 1 February 2026 and after
Penalties for KSeF mistakes
Every businessno penalties in 2026from 1 January 2027
RequiredExemption or transitionOptional

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.

02Invoice path

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.

1

Payment

The client pays through a gateway, a saved card or the wallet. The same transaction writes the invoice and a KSeF queue entry.

2

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.

3

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.

4

KSeF

Flaem authenticates with a KSeF token in the seller's tax ID context and uploads the file, which KSeF checks against the schema.

5

Number or rejection

The KSeF number is stored with the invoice. A rejected document stops, and your staff get a notification with the reason.

KSeF number on the invoiceRejection 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.
Invoices and corrections in the operator panel with each document's path to KSeF, from issue to the UPO receipt
03When KSeF is down

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.

First hourFollowing hours
1234567891011121 min5 min15 min30 minevery hour
Twelve attempts: gaps of 1, 5, 15 and 30 minutes, then hourly.Staff notification
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.

04Offline modes

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.

ModeWhen it appliesDeadline for sending to KSeF
Offline24The 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 unavailabilityMaintenance announced by the Ministry of Finance.By the next business day after the unavailability ends.
KSeF failureA failure announced in the Ministry of Finance public bulletin (BIP) and in the interface software.Within 7 business days after the failure ends.
Total failureAnnounced 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

Wed23issued
Thu24holiday
Fri25holiday
Sat26holiday
Sun27Sunday
Mon28deadline

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.

05Corrections and advances

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.

VAT invoiceVAT
Seller and buyer
Lines and VAT rates
KSeF number
points to the KSeF number
Corrective invoiceKOR
Reason for the correction
Corrected invoice details
Lines after the correction

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.
06Reseller KSeF

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.

Operator
Operator seller detailsToken in the KSeF integrationOperator queue
Reseller
Reseller seller detailsReseller tokenReseller queue
KSeF
Operator tax ID context
Reseller tax ID context
  • 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.
07Comparison

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.

SystemHow KSeF worksCorrective invoicesCost of KSeF
WHMCSPaid 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-onKSeF Integrator USD 139.99, PUQ KSeF Integrator from USD 23 with an active licence
HostBillThe eInvoices KSeF plugin, added on 27 February 2026.The vendor states the module does not support corrective invoicesIn the All Inclusive edition or USD 199 one-time
Blesta, PaymenterWe found no KSeF add-on.Not applicableNot applicable
FlaemBuilt into billing: queue, retries, offline deadlines and reseller KSeFYes, KOR naming the corrected invoiceIn every licence

Prices before tax, from the vendors' pages: hostbillapp.com, marketplace.whmcs.com and whmcs.com.

08Questions

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.

09Sources

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.