New France e-invoicing mandate goes live September 2026 — our implementation is ready. See all mandates →
🇵🇱 Odoo 17 · Poland KSeF Mandatory

Odoo Poland E-Invoicing —
KSeF FA(3) Supported

Submit FA(3) invoices from Odoo 17 directly to KSeF — Poland's national e-invoicing system. Clearvo handles submission, stores the KSeF number, and updates the invoice status automatically.

Install free from Odoo Apps Create Clearvo account →

Free module · API from €0.10/invoice · KSeF number stored automatically · Odoo 17

✓ KSeF FA(3) 2025 schema
✓ KSeF number stored on invoice
✓ Real KSeF API (not mock)
✓ Sandbox test mode included
Home› Integrations› Odoo› Poland
← Back to Odoo integration
KSeF mandate

KSeF — Poland's mandatory national e-invoicing system

Poland's KSeF is one of the most complete e-invoicing mandates in Europe. Here's what it requires and how Clearvo handles it in Odoo.

KSeF is mandatory for all VAT-registered Polish businesses. Invoices issued outside KSeF are not considered legally valid for VAT deduction purposes. The system uses the FA(3) XML schema (2025 version), published by the Polish Ministry of Finance (Ministerstwo Finansów). Every accepted invoice receives a unique KSeF number that must be communicated to your buyer.

FA(3) schema — 2025

The FA(3) schema is the current Polish e-invoice standard. Clearvo generates valid FA(3) XML from your Odoo invoice data, including all required Polish-specific fields: NIP (VAT number), document type, payment terms, and seller/buyer identification.

🔢

KSeF number returned

Once KSeF accepts an invoice, the Ministry of Finance returns a unique KSeF reference number. This number is the official record that the invoice exists. Clearvo captures it and writes it back to the Odoo invoice record immediately.

Real API — not mock

Clearvo connects to the live KSeF API (not a simulation). Your invoices are submitted to the real Ministry of Finance system. A sandbox mode using a csk_test_ API key lets you test the full flow before going live.

KSeF number

The KSeF number — automatically stored

The KSeF number is the single most important output of the submission. Clearvo captures it so you never have to copy it manually.

What is the KSeF number?

When KSeF accepts your invoice, it assigns a unique reference — the KSeF number. Your buyer needs it to claim input VAT; you need it for your own records. Clearvo writes it directly to the Odoo invoice record.

KSeF: 1234567890-20250619-ABCD1234EF56
What Clearvo does

Automated from Odoo to KSeF — nothing manual

Setup in 3 steps

Ready in under 2 minutes

No FA(3) schema knowledge required. No KSeF API integration to build. Install, connect, and post.

01

Install from Odoo Apps

Search for Clearvo in the Odoo Apps store and click Install. The module adds a Clearvo panel to every customer invoice and activates KSeF submission for Polish invoices automatically.

Odoo Apps store
02

Paste your API key

Sign up at clearvo.io, generate an API key from the dashboard, then go to Accounting → Configuration → Clearvo E-Invoicing and paste it in. Use a csk_test_ key to test first.

60 seconds
03

Post invoices as normal

Every Polish customer invoice you post is automatically submitted to KSeF. The KSeF number and status appear on the invoice form within seconds — no portal login, no manual XML upload.

Fully automated
FAQ

Poland KSeF questions

Is KSeF mandatory in Poland?
Yes — KSeF is mandatory for all VAT-registered Polish businesses. The Krajowy System e-Faktur (KSeF) is Poland's national e-invoicing platform, operated by the Ministry of Finance. Invoices issued outside KSeF are not considered legally valid for VAT purposes. Clearvo submits directly to the live KSeF API so your invoices are always compliant.
What is the KSeF number?
The KSeF number is a unique identifier assigned by the Ministry of Finance when your invoice is accepted into the KSeF repository. It is the official proof that the invoice exists in the national system. Your buyer needs the KSeF number to claim input VAT deduction. Clearvo captures it automatically from the KSeF API response and stores it on the Odoo invoice record — you do not need to copy it from a portal.
Does the module store the KSeF number on the Odoo invoice?
Yes. When KSeF accepts the invoice, Clearvo writes the KSeF reference number directly to the invoice record in Odoo. It is visible in the Clearvo status panel on the invoice form and is also available via the Clearvo API for export to downstream systems. The submission timestamp and acceptance status are stored alongside it for audit purposes.

Start submitting to KSeF from Odoo today

Install the free module, connect Clearvo, and your next Polish invoice is submitted to KSeF automatically — KSeF number included.

Install free from Odoo Apps Create Clearvo account →