Skip to Content

KSeF in Odoo: how the integration works. FA(3), UPO, statuses and offline24 mode

The KSeF integration in Odoo: the FA(3) schema, UPO, invoice statuses, and offline24 mode before the 2026 deadlines.
July 21, 2026 by
HADRON FOR BUSINESS SP Z O O, Tomasz Leppich
| No comments yet

The deadline is arriving faster than the rollout. Most manufacturing companies that employ 10 to 50 people still issue and receive invoices the way they always have: as a PDF over email, sometimes on paper, with manual bookkeeping after the fact. From 1 February 2026, the obligation to receive invoices through the National e-Invoicing System (KSeF) applies to every VAT taxpayer, and from 1 April 2026 the obligation to issue them covers practically all B2B trade. If you are looking for an answer to how the Odoo KSeF integration actually works, you probably already know that the phrase "the system supports KSeF" says very little about what will really happen to your invoices on go-live day. Most competitor pages stop at that phrase. In this article we show what the KSeF module in Odoo really does: how it sends invoices in line with the FA(3) schema, how it retrieves the UPO, how it tracks statuses, and what happens when the National e-Invoicing System stops responding.

Deadlines a manufacturing company cannot miss

Before we get into the technical side, a quick reminder of the schedule. It determines when the integration has to be up and running, not just entering testing.

DateObligationWho it applies to
1 February 2026Receiving invoices in KSeFAll VAT taxpayers
1 February 2026Issuing invoices in KSeFTaxpayers with sales above 200 million PLN for 2024
1 April 2026Issuing invoices in KSeFPractically all B2B trade
1 January 2027Issuing invoices in KSeFThe smallest taxpayers, gross sales up to 10,000 PLN per month

For a typical manufacturing company in that size range this means, specifically: from February 2026 you have to be able to receive purchase invoices from KSeF, and from April 2026 every sales invoice must reach the system before it gets to your business partner. Two months of difference is not much time if the integration is not working yet and accounting and sales are still running on old habits.

What the KSeF integration in Odoo really does

The Odoo KSeF module is not a single "turn on e-invoicing" switch. It is a set of four mechanisms that have to work together: sending according to the correct schema, confirmation of receipt, status tracking, and receiving incoming invoices. Below is each of them separately, because each one has different operational consequences.

Sending invoices in line with the FA(3) schema

Every invoice issued in Odoo and intended for KSeF has to be converted into an XML format that conforms to the FA(3) schema, the mandatory structure of the e-invoice. This is more than generating a file: invoice lines, business partner data, VAT rates, and the payment method have to be mapped to specific fields of the schema, otherwise the Ministry of Finance system will reject the document. The integration does this automatically in the background, at the moment an invoice is confirmed in Odoo, with no manual export and no pasting of data into a separate portal.

Retrieving the UPO, the proof that an invoice arrived

Once KSeF accepts an invoice, the system generates the Official Acknowledgement of Receipt, known as the UPO. This is a document that legally confirms the moment an invoice was delivered and is the basis for settlements and for any disputes with a business partner. The integration retrieves the UPO automatically and attaches it to the invoice in Odoo, so you do not have to log in to the KSeF system separately to check whether the document arrived at all. The UPO stays with the invoice the same way a PDF used to stay with it.

Invoice statuses in real time

An invoice sent to KSeF goes through several stages: sent, processing, accepted, or rejected with an error code. Without the integration, someone in the company would have to check these statuses manually in a separate system, for each invoice individually. The KSeF module in Odoo updates the status directly on the invoice document, so the sales team and accounting see it in the same place where they issued the invoice, without switching between systems.

Receiving purchase invoices

This is the element people most often forget, and from 1 February 2026 it applies to everyone. The integration retrieves from KSeF the invoices issued by suppliers to your company and turns them into purchase documents in Odoo, ready to be confirmed and posted. Without this mechanism, the accounting team would have to search the KSeF system manually for new purchase invoices, which, with several dozen suppliers a month, is practically impossible to do without errors and delays.

The offline24 mode: what happens when KSeF does not respond

The National e-Invoicing System, like any government system, is sometimes unavailable: planned maintenance, an outage on the Ministry of Finance side, or a connection problem. The offline24 mode lets you issue an invoice outside the system at the moment of an outage and send it to KSeF within 24 hours after the cause of the unavailability ends. Until then the invoice is valid and can be handed to the business partner, but the obligation to send it to KSeF does not disappear, it is simply moved forward in time.

In practice this means the integration has to be able to recognise that KSeF is unavailable, mark the invoice as issued in offline24 mode, and automatically resend it when the system comes back up. A manufacturing company that issues several dozen invoices a day cannot afford an outage of KSeF stopping sales for a whole day. A well built integration does this without manual intervention: sales issues the invoice as usual, and the system takes care of the rest in the background.

Why this is more than a product page with the phrase "we support KSeF"

Many ERP vendor pages in Poland end their description of the KSeF integration with a single marketing sentence. They do not say whether sending happens automatically when an invoice is confirmed or whether it requires a manual export. They do not say what happens to the status of a rejected invoice, or what receiving purchase invoices looks like in the daily practice of an accounting team. They say nothing about the offline24 mode, even though it is precisely this mechanism that decides whether a company can keep selling on the day the government system goes down.

The KSeF integration in Odoo that we implement handles all four mechanisms described above: sending per FA(3), retrieving the UPO, real time statuses, and receiving purchase invoices, for current versions of Odoo. You will find more technical detail, including the scope of the rollout and how it is configured, on the page KSeF integration in Odoo.

What a KSeF integration rollout looks like in your company

Rolling out the Odoo KSeF module is not a project that takes several months, but it does require a few concrete steps carried out in the right order.

  • Review of your current invoicing system. We check where your sales and purchase invoices come from today: from Odoo, from an external accounting program, or from manual templates. This determines the scope of the integration.
  • Configuration of the connection to KSeF. We set up authentication and the connection to the National e-Invoicing System on the Odoo side, in line with the Ministry of Finance requirements.
  • Mapping data to the FA(3) schema. We verify that business partner data, VAT rates, and invoice lines in your Odoo are complete and correctly mapped to the fields the schema requires.
  • Testing of sending, UPO, and statuses. We send test invoices and check UPO retrieval and status updates before we run the integration in production.
  • Go-live of purchase invoice receiving and the offline24 mode. Finally we switch on automatic receiving of supplier invoices and configure how the system behaves if KSeF is unavailable.

If you are only now putting your sales and accounting processes in order before the rollout, it is worth starting with a diagnosis of the whole system, not just the KSeF module. We write more about our approach to ERP rollouts in manufacturing companies on our blog.

Frequently asked questions

Does the KSeF integration in Odoo work automatically, or do you have to do something manually?

Sending invoices to KSeF, retrieving the UPO, and updating statuses happen automatically once an invoice is confirmed in Odoo. Manual work is limited to issuing and posting documents in the standard way, just as before.

What happens if KSeF is unavailable on the day an invoice is issued?

Then the offline24 mode applies: you issue the invoice and hand it to the business partner as usual, and it has to reach the KSeF system within 24 hours after the unavailability ends. The integration takes care of this automatically and resends it when the system comes back up.

Do I have to check manually whether new purchase invoices have arrived from suppliers?

No. The integration retrieves purchase invoices from KSeF and creates documents from them in Odoo, ready to be confirmed. From 1 February 2026 the obligation to receive invoices in KSeF applies to all VAT taxpayers, so this mechanism will be needed regardless of whether your company already issues invoices in KSeF.

From when does my company have to issue invoices in KSeF?

For taxpayers with sales above 200 million PLN for 2024 the obligation to issue starts on 1 February 2026. For practically all remaining B2B trade the start falls on 1 April 2026. The smallest taxpayers, with gross sales up to 10,000 PLN per month, have until 1 January 2027. The obligation to receive invoices applies to everyone from 1 February 2026, regardless of company size.

Do not leave the integration until the last week before the deadline. See exactly how the KSeF integration in Odoo works and book a free consultation: we will check the state of your current invoicing system and prepare a rollout plan matched to the deadlines that are already in force. We have been implementing Odoo systems since 2011, for clients in three countries: Poland, Germany, and Belgium.

HADRON FOR BUSINESS SP Z O O, Tomasz Leppich July 21, 2026
Share this post
Tags
Archive
Sign in to leave a comment
The Digital Maturity Test before Dig.IT: how to do it right and what it tells you about your company
The Dig.IT digital maturity test is not a box to tick, it is the starting point for a digitalization plan.