Zum Hauptinhalt springen
KSeF 2.0

So funktioniert Poland KSeF 2.0 Validator in Odoo: Menüs, geplante Aktion und Ablauf

Poland KSeF 2.0 Validator ergänzt Odoo um ein Menü KSeF mit Dashboard, Migration, Operations und Konfiguration sowie um eine geplante Aktion, KSeF: session maintenance, die alle 5 Minuten läuft. Er validiert die FA(3) in FlexigoTech Cloud und speichert einen signierten Bericht, sendet aber nichts an KSeF: Den eigentlichen Versand übernimmt l10n_pl_edi von Odoo.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 4. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Moduls, Version 20.0 · in den Quellen am Ende
Lesezeit
5 Min.

Validieren und vorbereiten; der Versand ist Sache von l10n_pl_edi

Zuerst sollte die Arbeitsteilung klar sein. Das Modul validiert und bereitet vor, es hat keinen HTTP-Client zu KSeF. Den eigentlichen Versand übernimmt l10n_pl_edi, das Odoo-Community-Modul, das an KSeF sendet und in Odoo 18, 19 und 20 existiert (in Odoo 17 gibt es es nicht).

Daraus ergibt sich die Arbeitsweise je Version: In 18 bis 20 validiert das Modul die FA(3), die l10n_pl_edi erzeugt oder bereits gesendet hat; in 17 wird die FA(3) fertig von außerhalb von Odoo hochgeladen. Das Modul ist in Odoo Apps für 17.0, 18.0, 19.0 und 20.0 veröffentlicht.

Die Validierung der FA(3) läuft mit dem Abonnement in FlexigoTech Cloud. Der Eintrag in Odoo Apps weist selbst in einem eigenen Abschnitt darauf hin: Before you buy: this app uses a paid external service. Wenn Sie noch abwägen, ob es zu Ihnen passt, behandeln wir das separat unter ob Poland KSeF 2.0 Validator zu Ihrem Unternehmen passt.

Die Menüs unter KSeF

Nach der Installation erhalten Sie ein Hauptmenü KSeF mit dieser Struktur:

  • KSeF › Dashboard
  • KSeF › Migration
  • KSeF › Operations, mit KSeF › Operations › Submission Queue und KSeF › Operations › Inbound Invoices
  • KSeF › Configuration, mit KSeF › Configuration › Compliance Profile, KSeF › Configuration › FA(3) Fields, KSeF › Configuration › Error Codes und KSeF › Configuration › API Sessions

Das Dashboard KSeF › Dashboard ist eine Kanban-Ansicht; im Screenshot sehen Sie die Karte eines Unternehmens.

Kanban-Ansicht des KSeF Dashboard mit der Karte von Wawel Digital sp. z o.o.
Die Karte bündelt Welle, Go-live-Datum, Bereitschaft, akzeptierte und abgelehnte Rechnungen, den Offline-Rückstand und die Warteschlange.

Das Modul und l10n_pl_edi im Vergleich

Diese Tabelle vergleicht, was beide laut ihrer Dokumentation leisten.

Aspektl10n_pl_edi von OdooPoland KSeF 2.0 Validator
VerfügbarkeitOdoo Community 18, 19 und 20; in 17 nicht vorhandenOdoo Apps für 17.0, 18.0, 19.0 und 20.0
Eigentlicher Versand an KSeFÜbernimmt es selbstKein HTTP-Client zu KSeF
FA(3) in Odoo 18 bis 20Erzeugt und sendet sieValidiert die von l10n_pl_edi erzeugte oder bereits gesendete
FA(3) in Odoo 17Das Modul existiert nichtWird fertig von außerhalb von Odoo hochgeladen
Validierung der FA(3)-In FlexigoTech Cloud, mit signiertem Bericht
ZugangsdatenIn Odoo 19 speichert es am Unternehmen ein KSeF Certificate und authentifiziert sich damitHat ein Modell KSeF Credential (certificate / token)
Geplante AktionenIn Odoo 19 erneuert eine Aktion die Zugriffstoken jedes Unternehmens mit ZertifikatKSeF: session maintenance, alle 5 Minuten

Praktisch heißt das: Es sind keine Alternativen, sie ergänzen sich. In 18 bis 20 sendet l10n_pl_edi, und der Validator prüft die FA(3), die dieses Modul erzeugt oder bereits gesendet hat. In 17 gibt es kein l10n_pl_edi, und der Validator arbeitet mit der FA(3), die fertig von außerhalb von Odoo hochgeladen wird.

Die Zugangsdaten des Moduls haben eine eigene Liste.

Liste der KSeF-Zugangsdaten mit KSeF-Zertifikaten, einem qualifizierten Siegel und einem Token
Jeder Eintrag zeigt Unternehmen, Typ, Umgebung, Gültigkeitsdatum, verbleibende Tage und Ablaufstatus; zwei Zeilen sind gelb hervorgehoben.

Mit aktivem Dienst und ohne

Da die Validierung von FlexigoTech Cloud abhängt, verhält sich das Modul je nach Abonnementstatus unterschiedlich.

AspektMit aktivem AbonnementOhne Abonnement oder bei ausgesetztem Dienst
Validierung der FA(3)Läuft in FlexigoTech Cloud und speichert einen signierten BerichtStoppt; die Rechnung bleibt „nicht validiert“
Leistungen des AbonnementsVerfügbarStoppen
Ihre DatenIn Ihrem OdooBleiben in Ihrem Odoo

Das Modul hat außerdem einen Einwilligungsdatensatz, Consent to validate FA(3) files in FlexigoTech Cloud. Mit dem Abonnement ist das Modul für neue Odoo-Versionen inklusive, wenn Sie es auf flexigotech.com gekauft haben; im Odoo App Store wird jede Odoo-Version dort gekauft. Der lokale Dienst kostet 29 €/Monat oder 290 €/Jahr zzgl. MwSt., der Pro-Plan 58 €/Monat oder 580 €/Jahr zzgl. MwSt.

Welchen Weg eine Rechnung im Modul durchläuft

In Odoo 18 bis 20 erzeugt l10n_pl_edi die FA(3) und übernimmt den eigentlichen Versand an KSeF; der Validator validiert in FlexigoTech Cloud die FA(3), die l10n_pl_edi erzeugt oder bereits gesendet hat, und speichert den signierten Bericht. Ist der Dienst nicht verfügbar, bleibt die Rechnung „nicht validiert“.

Das Modul definiert Datensätze KSeF Submission Queue Item, und im Menü KSeF › Operations › Submission Queue finden Sie die Liste der Warteschlange.

Liste Submission Queue mit sechs Datensätzen von Wawel Digital sp. z o.o.
Spalten für Buchung, Modus, Status, Versuche und Frist, mit Status wie Offline pendiente, Accepted und Ready to upload to KSeF.

Im Offline-Modus läuft die Frist bis zum nächsten polnischen Werktag, mit einer täglichen Erinnerung. Das Modul enthält einen Assistenten namens KSeF Offline/Emergency Mark Wizard.

Rund um diesen Ablauf definiert das Modul weitere Datensätze mit diesen Namen:

  • KSeF Inbound Invoice, zusammen mit dem Menü KSeF › Operations › Inbound Invoices
  • KSeF Immutable Audit Log
  • KSeF API Error Code, zusammen mit dem Menü KSeF › Configuration › Error Codes
  • FA(3) Mandatory Field Reference
  • KSeF Compliance Profile
  • KSeF Authorization / Delegation
  • KSeF Migration Validator Wizard, KSeF Migration Validation Run, KSeF Validation Result und KSeF Validation Issue
  • KSeF Compliance Export Wizard

Die geplante Aktion, die selbstständig läuft

Die Dokumentation des Moduls nennt die Aktion KSeF: session maintenance, aktiv und mit einer Frequenz von alle 5 Minuten. In der Konfiguration gibt es zudem das Menü KSeF › Configuration › API Sessions, und das Modul speichert Datensätze KSeF API Session.

Verwechseln Sie sie nicht mit der Aktion von l10n_pl_edi in Odoo 19, die die Zugriffstoken jedes Unternehmens mit Zertifikat erneuert: Diese gehört zu Odoo, nicht zum Validator.

Wenn Sie in Ihrer Datenbank beide Aktionen sehen, gehört jede zu einem anderen Modul.

Wie FlexigoTech Sie unterstützt

Bei FlexigoTech implementieren wir Odoo 17, 18, 19 und 20 und entwickeln individuelle Konnektoren und Integrationen. Wenn der Validator in Ihrer Version mit l10n_pl_edi zusammenarbeiten soll oder Sie in Odoo 17 die außerhalb von Odoo erzeugte FA(3) validieren möchten, finden Sie Details und Kaufoptionen auf der Modulseite und im Eintrag in Odoo Apps.

Weiterlesen

Poland KSeF 2.0 Validator: was er abdeckt, was nicht und ob er zu Ihrem Odoo passtWas Poland KSeF 2.0 Validator laut Dokumentation abdeckt und was nicht, was Sie vor der Installation brauchen und zu welcher Odoo-Version er passt.
Geprüft im Quellcode des Moduls (Version 20.0) und in den verlinkten Quellen

Quellen

  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): views/ksef_menus.xml
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): data/ksef_cron.xml
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): static/description/index.html
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_api_session.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_audit_log.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_authorization.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_cloud.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_compliance_profile.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_credential.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_error_code.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_fa3_field.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_inbound_invoice.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_queue_item.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_session.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_validation.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): wizard/ksef_cloud_consent.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): wizard/ksef_export_wizard.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): wizard/ksef_migration_wizard.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): wizard/ksef_offline_mark_wizard.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): wizards/ksef_migration_validator.py
  • apps.odoo.com/apps/modules/20.0/flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati
  • github.com/odoo/odoo/tree/18.0/addons/l10n_pl_edi
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati (cbca26e): models/account_move.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati (cbca26e): models/ksef_session.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati (cbca26e): models/ksef_tools.py
  • Quellcode des Moduls: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati (cbca26e): models/ksef_cloud.py
  • github.com/odoo/odoo/blob/19.0/addons/l10n_pl_edi/models/res_company.py
  • flexigotech.com/en/services.html
  • flexigotech.com/precios.html