Skip to Content

Fakturownia KSeF Integration

by
Odoo
v 19.0 Third Party 8
Download for v 19.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Invoicing (account)
• Discuss (mail)
Lines of code 933
Technical Name cetmix_fakturownia_ksef
LicenseAGPL-3
Websitehttps://cetmix.com
Versions 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Invoicing (account)
• Discuss (mail)
Lines of code 933
Technical Name cetmix_fakturownia_ksef
LicenseAGPL-3
Websitehttps://cetmix.com
Versions 18.0 19.0

Fakturownia KSeF Integration

Beta License: AGPL-3 cetmix/cetmix-poland

Fakturownia KSeF Integration

This module provides integration between Odoo and Fakturownia for KSeF (Krajowy System e-Faktur - Polish National e-Invoice System) compliance:

  • Export invoices from Odoo to Fakturownia
  • Optionally request immediate KSeF submission through Fakturownia
  • Always tracks KSeF status and number when available from Fakturownia
  • Store official KSeF number and verification link
  • Automatic status polling via scheduled action
  • Bridge KSeF number to Odoo’s native l10n_pl field for compatibility with other modules

Have questions or need assistance? Contact us!

Table of contents

Configuration

Uwaga: Szczegółowa instrukcja konfiguracji w języku polskim jest dostępna pod adresem podanym w opisie modułu: cetmix.com/fkt
Important: for complete instructions check: cetmix.com/fkt

Get the account URL from Fakturownia

  1. Open the “Settings” menu
  2. Click the “Account settings” item
  3. Copy the “Account name” value. It looks like https://<your_company>.fakturownia.pl

Get API key from Fakturownia

  1. Open the “Settings” menu
  2. Click the “API” item
  3. Click the “Show” button on the API page
  4. Copy and save the API key

Configure Odoo

  1. Go to “Invoicing/Accounting > Configuration > Settings”
  2. Scroll down to the “Fakturownia” section
  3. Put your account name in the “Account URL” field
  4. Put your API key in the “API Key” field
  5. Enable “Automatic synchronization” option to send invoices when they are posted
  6. Sync invoices from – Only invoices created on or after this date are synced automatically (cron and auto-sync on post). When you first enable automatic sync, this date is set to “now” to avoid pushing historical invoices. You can change it to include older invoices or set it earlier for a future cutoff.
  7. Select invoice number source. Possible options:
    • Odoo – Invoice number from Odoo will be used as invoice number in Fakturownia
    • Fakturownia – Invoice number from Fakturownia will be stored in Odoo for reference

KSeF Configuration in Fakturownia

In Odoo, the “Send to KSeF immediately” checkbox on each invoice controls whether it is sent to KSeF through Fakturownia at sync time. It is disabled by default (opt-in).

Usage

Uwaga: Szczegółowa instrukcja konfiguracji w języku polskim jest dostępna pod adresem podanym w opisie modułu: cetmix.com/fkt

Important: for complete instructions check: cetmix.com/fkt

In the invoice form, open the Fakturownia tab. The following fields are available:

  • Fakturownia Document ID — External ID of the invoice in Fakturownia (debug mode only)
  • Fakturownia Invoice Number — Invoice number from Fakturownia (when using Fakturownia numbering)
  • Fakturownia Status — Overall sync status:
    • Not Synced — Invoice has not been sent to Fakturownia yet
    • Synced to Fakturownia — Invoice exists in Fakturownia (KSeF not enabled or not applicable)
    • Fakturownia Error — Error occurred during Fakturownia sync
    • Pending in KSeF — Invoice sent to KSeF, awaiting confirmation
    • Accepted by KSeF — Invoice accepted by KSeF with official number assigned
    • KSeF Error — Error occurred during KSeF submission
  • KSeF Number — Official KSeF invoice number (e.g. 5252445767-20260201-ABC123DEF456)
  • KSeF Send Date — Date and time the invoice was sent to KSeF
  • KSeF Verification Link — Link to verify the invoice in KSeF portal (for QR code)
  • Fakturownia Error — Error details (shown only when status is an error state)
  • Send to KSeF immediately — When checked, requests Fakturownia to send to KSeF at sync time (gov_save_and_send). When unchecked, the invoice is synced to Fakturownia only; Fakturownia may still send it to KSeF if automatic sending is configured in Fakturownia settings. KSeF status and number are always tracked when Fakturownia returns them (can only be changed before first sync).
  • Sync now — Button to sync immediately (shown when invoice needs syncing or had an error)

Automatic Status Polling

The scheduled action automatically syncs new invoices and polls KSeF status for pending invoices. Its interval can be configured via the “Configure cron” link in Settings.

Reset to Draft

Invoices with KSeF status Pending in KSeF or Accepted by KSeF cannot be reset to draft, as they have been registered in the government e-invoice system.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Cetmix

Maintainers

Current maintainer:

cetmix

This module is part of the cetmix/cetmix-poland project on GitHub.

You are welcome to contribute.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.