Naar hoofdinhoud
KSeF 2.0

Hoe Poland KSeF 2.0 Validator werkt in Odoo: menu's, geplande actie en verloop

Poland KSeF 2.0 Validator voegt aan Odoo een menu KSeF toe met dashboard, migratie, operaties en configuratie, plus een geplande actie, KSeF: session maintenance, die elke 5 minuten draait. Het valideert de FA(3) in FlexigoTech Cloud en bewaart een ondertekend rapport, maar verstuurt niets naar KSeF: het echte versturen doet l10n_pl_edi van Odoo.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 4 november 2026

In het kort

Module
KSeF 2.0
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de module, versie 20.0 · in de bronnen onderaan
Leestijd
5 min

Valideren en voorbereiden; versturen is de taak van l10n_pl_edi

Het eerste wat je helder moet hebben, is de taakverdeling. De module valideert en bereidt voor, en heeft geen HTTP-client richting KSeF. Het echte versturen doet l10n_pl_edi, de Odoo Community-module die naar KSeF verstuurt en bestaat in Odoo 18, 19 en 20 (in Odoo 17 bestaat hij niet).

Daaruit volgt hoe het per versie werkt: in 18 tot 20 valideert de module de FA(3) die l10n_pl_edi genereert of al heeft verstuurd; in 17 wordt de FA(3) kant-en-klaar van buiten Odoo geüpload. De module staat op Odoo Apps voor 17.0, 18.0, 19.0 en 20.0.

De validatie van de FA(3) draait in FlexigoTech Cloud met het abonnement. De Odoo Apps-pagina meldt dat zelf in een aparte sectie, Before you buy: this app uses a paid external service. Twijfel je nog of het bij je past, dan lees je dat apart in of Poland KSeF 2.0 Validator bij je bedrijf past.

De menu's onder KSeF

Na installatie krijg je een hoofdmenu KSeF met deze opbouw:

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

Het dashboard KSeF › Dashboard is een kanbanweergave; op de schermafbeelding zie je de kaart van een bedrijf.

Kanbanweergave van het KSeF Dashboard met de kaart van Wawel Digital sp. z o.o.
De kaart bundelt de golf, de go-livedatum, de gereedheid, geaccepteerd en afgewezen, de offline achterstand en de wachtrij.

De module tegenover l10n_pl_edi, onderdeel voor onderdeel

Deze tabel vergelijkt wat elk volgens de eigen documentatie doet.

Aspectl10n_pl_edi van OdooPoland KSeF 2.0 Validator
Waar het staatOdoo Community 18, 19 en 20; in 17 bestaat het nietOdoo Apps voor 17.0, 18.0, 19.0 en 20.0
Echt versturen naar KSeFDoet hij zelfGeen HTTP-client richting KSeF
FA(3) in Odoo 18 tot 20Genereert en verstuurt hemValideert wat l10n_pl_edi genereert of al verstuurde
FA(3) in Odoo 17De module bestaat nietKant-en-klaar van buiten Odoo geüpload
Validatie van de FA(3)-In FlexigoTech Cloud, met ondertekend rapport
InloggegevensIn Odoo 19 bewaart hij bij het bedrijf een KSeF Certificate en authenticeert daarmeeHeeft een model KSeF Credential (certificate / token)
Geplande actiesIn Odoo 19 vernieuwt een actie de toegangstokens van elk bedrijf met certificaatKSeF: session maintenance, elke 5 minuten

In de praktijk zijn het geen alternatieven; ze vullen elkaar aan. In 18 tot 20 verstuurt l10n_pl_edi, en controleert de validator de FA(3) die die module genereert of al heeft verstuurd. In 17 is er geen l10n_pl_edi, en werkt de validator met de FA(3) die kant-en-klaar van buiten Odoo wordt geüpload.

De inloggegevens van de module staan in een eigen lijst.

Lijst met KSeF-inloggegevens met KSeF-certificaten, een gekwalificeerd zegel en een token
Elke regel toont bedrijf, type, omgeving, geldigheidsdatum, resterende dagen en vervalstatus; twee regels zijn geel gemarkeerd.

Met en zonder actieve dienst

Omdat de validatie van FlexigoTech Cloud afhangt, gedraagt de module zich anders afhankelijk van de status van het abonnement.

AspectMet actief abonnementZonder abonnement of met opgeschorte dienst
Validatie van de FA(3)Draait in FlexigoTech Cloud en bewaart een ondertekend rapportStopt; de factuur blijft «niet gevalideerd»
Wat het abonnement levertBeschikbaarStopt
Je gegevensIn je OdooBlijven in je Odoo

De module heeft daarnaast een toestemmingsregistratie, Consent to validate FA(3) files in FlexigoTech Cloud. Met het abonnement is de module voor nieuwe Odoo-versies inbegrepen als je hem op flexigotech.com kocht; in de Odoo App Store koop je elke Odoo-versie daar. De lokale dienst kost € 29 per maand of € 290 per jaar excl. btw, en het Pro-plan € 58 per maand of € 580 per jaar excl. btw.

Wat een factuur binnen de module doorloopt

In Odoo 18 tot 20 genereert l10n_pl_edi de FA(3) en verstuurt hem echt naar KSeF; de validator valideert in FlexigoTech Cloud de FA(3) die l10n_pl_edi heeft gegenereerd of al verstuurd, en bewaart het ondertekende rapport. Is de dienst niet beschikbaar, dan blijft de factuur «niet gevalideerd».

De module definieert records KSeF Submission Queue Item, en in het menu KSeF › Operations › Submission Queue vind je de lijst van de wachtrij.

Lijst Submission Queue met zes records van Wawel Digital sp. z o.o.
Kolommen voor boeking, modus, status, pogingen en termijn, met statussen als Offline pendiente, Accepted en Ready to upload to KSeF.

In offline modus loopt de termijn tot de volgende Poolse werkdag, met een dagelijkse herinnering. De module bevat een wizard met de naam KSeF Offline/Emergency Mark Wizard.

Rond dat verloop definieert de module nog andere records met deze namen:

  • KSeF Inbound Invoice, naast het menu KSeF › Operations › Inbound Invoices
  • KSeF Immutable Audit Log
  • KSeF API Error Code, naast het menu 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 en KSeF Validation Issue
  • KSeF Compliance Export Wizard

De geplande actie die vanzelf draait

De documentatie van de module noemt de actie KSeF: session maintenance, actief en met een frequentie van elke 5 minuten. In de configuratie heb je ook het menu KSeF › Configuration › API Sessions, en de module bewaart records KSeF API Session.

Verwar hem niet met de actie van l10n_pl_edi in Odoo 19, die de toegangstokens van elk bedrijf met certificaat vernieuwt: die hoort bij Odoo, niet bij de validator.

Zie je beide acties in je database, dan hoort elk bij een andere module.

Hoe FlexigoTech je helpt

Bij FlexigoTech implementeren we Odoo 17, 18, 19 en 20 en ontwikkelen we connectoren en integraties op maat. Wil je dat de validator in jouw versie samenwerkt met l10n_pl_edi, of moet je in Odoo 17 de FA(3) valideren die je buiten Odoo maakt, dan vind je de details en de aankoop op de modulepagina en op de Odoo Apps-pagina.

Lees verder

Poland KSeF 2.0 Validator: wat hij dekt, wat niet en of hij bij jouw Odoo pastWat Poland KSeF 2.0 Validator volgens de documentatie wel en niet dekt, wat je nodig hebt voor de installatie en bij welke Odoo-versie hij past.
Gecontroleerd in de broncode van de module (versie 20.0) en in de gelinkte bronnen

Bronnen

  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): views/ksef_menus.xml
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): data/ksef_cron.xml
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): static/description/index.html
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_api_session.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_audit_log.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_authorization.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_cloud.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_compliance_profile.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_credential.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_error_code.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_fa3_field.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_inbound_invoice.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_queue_item.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_session.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): models/ksef_validation.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): wizard/ksef_cloud_consent.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): wizard/ksef_export_wizard.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): wizard/ksef_migration_wizard.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati 20.0 (ba7c60f1): wizard/ksef_offline_mark_wizard.py
  • Broncode van de module: 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
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati (cbca26e): models/account_move.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati (cbca26e): models/ksef_session.py
  • Broncode van de module: flexigo_poland_ksef_2_0_e_invoice_connector_and_migrati (cbca26e): models/ksef_tools.py
  • Broncode van de module: 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