Aller au contenu principal
KSeF 2.0

Comment fonctionne Poland KSeF 2.0 Validator dans Odoo : menus, action planifiée et parcours

Poland KSeF 2.0 Validator ajoute à Odoo un menu KSeF avec tableau de bord, migration, opérations et configuration, ainsi qu'une action planifiée, KSeF: session maintenance, exécutée toutes les 5 minutes. Il valide le FA(3) dans FlexigoTech Cloud et conserve un rapport signé, mais n'envoie rien à KSeF : l'envoi réel est assuré par l10n_pl_edi d'Odoo.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 4 novembre 2026

L'essentiel

Module
KSeF 2.0
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du module, version 20.0 · dans les sources citées à la fin
Lecture
5 min

Il valide et prépare ; l'envoi, c'est le rôle de l10n_pl_edi

La première chose à bien comprendre, c'est la répartition des rôles. Le module valide et prépare, et il n'a pas de client HTTP vers KSeF. L'envoi réel est assuré par l10n_pl_edi, le module d'Odoo Community qui envoie à KSeF et qui existe dans Odoo 18, 19 et 20 (il n'existe pas dans Odoo 17).

Cela détermine son fonctionnement selon la version : de 18 à 20, le module valide le FA(3) que l10n_pl_edi génère ou a déjà envoyé ; en 17, le FA(3) est importé déjà produit en dehors d'Odoo. Le module est publié sur Odoo Apps pour 17.0, 18.0, 19.0 et 20.0.

La validation du FA(3) s'exécute dans FlexigoTech Cloud avec l'abonnement. La fiche Odoo Apps le signale elle-même dans une section, Before you buy: this app uses a paid external service. Si vous vous demandez encore s'il vous convient, nous en parlons à part dans Poland KSeF 2.0 Validator est-il adapté à votre entreprise.

Les menus qui apparaissent sous KSeF

Une fois installé, vous disposez d'un menu racine KSeF organisé ainsi :

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

Le tableau de bord KSeF › Dashboard est une vue kanban ; la capture montre la carte d'une société.

Vue kanban du KSeF Dashboard avec la carte de Wawel Digital sp. z o.o.
La carte regroupe la vague, la date de go-live, le niveau de préparation, les factures acceptées et rejetées, le backlog offline et la file d'attente.

Le module face à l10n_pl_edi, point par point

Ce tableau compare ce que fait chacun d'après sa documentation.

Aspectl10n_pl_edi d'OdooPoland KSeF 2.0 Validator
Où il se trouveOdoo Community 18, 19 et 20 ; absent en 17Odoo Apps pour 17.0, 18.0, 19.0 et 20.0
Envoi réel à KSeFC'est lui qui le faitPas de client HTTP vers KSeF
FA(3) sous Odoo 18 à 20Il le génère et l'envoieValide celui que l10n_pl_edi génère ou a déjà envoyé
FA(3) sous Odoo 17Le module n'existe pasImporté déjà produit en dehors d'Odoo
Validation du FA(3)-Dans FlexigoTech Cloud, avec rapport signé
IdentifiantsSous Odoo 19, stocke sur la société un KSeF Certificate et s'authentifie avecDispose d'un modèle KSeF Credential (certificate / token)
Actions planifiéesSous Odoo 19, une action renouvelle les jetons d'accès de chaque société disposant d'un certificatKSeF: session maintenance, toutes les 5 minutes

En pratique, ce ne sont pas des alternatives : ils se complètent. De 18 à 20, l'envoi est assuré par l10n_pl_edi, et le validateur contrôle le FA(3) que ce module génère ou a déjà envoyé. En 17, il n'y a pas de l10n_pl_edi, et le validateur travaille avec le FA(3) importé déjà produit en dehors d'Odoo.

Les identifiants du module disposent de leur propre liste.

Liste des identifiants KSeF avec des certificats KSeF, un cachet qualifié et un jeton
Chaque identifiant affiche la société, le type, l'environnement, la date de validité, les jours restants et l'état d'expiration ; deux lignes sont surlignées en jaune.

Avec ou sans service actif

Comme la validation dépend de FlexigoTech Cloud, le module se comporte différemment selon l'état de l'abonnement.

AspectAvec abonnement actifSans abonnement ou service suspendu
Validation du FA(3)S'exécute dans FlexigoTech Cloud et conserve un rapport signéS'arrête ; la facture reste « non validée »
Ce qu'apporte l'abonnementDisponibleS'arrête
Vos donnéesDans votre OdooRestent dans votre Odoo

Le module comporte aussi un enregistrement de consentement, Consent to validate FA(3) files in FlexigoTech Cloud. Avec l'abonnement, le module pour les nouvelles versions d'Odoo est inclus si vous l'avez acheté sur flexigotech.com ; sur l'Odoo App Store, chaque version d'Odoo s'achète là-bas. Le service local coûte 29 €/mois ou 290 €/an HT, et le plan Pro 58 €/mois ou 580 €/an HT.

Le parcours d'une facture dans le module

Sous Odoo 18 à 20, l10n_pl_edi génère le FA(3) et effectue l'envoi réel à KSeF ; le validateur valide dans FlexigoTech Cloud le FA(3) que l10n_pl_edi a généré ou déjà envoyé, et conserve le rapport signé. Si le service n'est pas disponible, la facture reste « non validée ».

Le module définit des enregistrements KSeF Submission Queue Item, et le menu KSeF › Operations › Submission Queue vous donne la liste de la file.

Liste Submission Queue avec six enregistrements de Wawel Digital sp. z o.o.
Colonnes pièce, mode, statut, tentatives et délai, avec des statuts comme Offline pendiente, Accepted et Ready to upload to KSeF.

En mode offline, le délai court jusqu'au jour ouvré polonais suivant, avec un rappel quotidien. Le module inclut un assistant nommé KSeF Offline/Emergency Mark Wizard.

Autour de ce parcours, le module définit d'autres enregistrements portant ces noms :

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

L'action planifiée qui tourne toute seule

La documentation du module mentionne l'action KSeF: session maintenance, active et exécutée toutes les 5 minutes. Dans la configuration, vous avez aussi le menu KSeF › Configuration › API Sessions, et le module enregistre des KSeF API Session.

Ne la confondez pas avec l'action de l10n_pl_edi sous Odoo 19, qui renouvelle les jetons d'accès de chaque société disposant d'un certificat : celle-là appartient à Odoo, pas au validateur.

Si vous voyez les deux actions dans votre base, chacune appartient à un module différent.

Comment FlexigoTech vous accompagne

Chez FlexigoTech, nous déployons Odoo 17, 18, 19 et 20 et développons des connecteurs et intégrations sur mesure. Si vous souhaitez faire cohabiter le validateur avec l10n_pl_edi dans votre version, ou valider sous Odoo 17 le FA(3) que vous produisez en dehors d'Odoo, vous trouverez les détails et l'achat sur la page du module et sur sa fiche Odoo Apps.

À lire aussi

Poland KSeF 2.0 Validator : ce qu'il couvre, ce qu'il ne couvre pas et s'il convient à votre OdooCe que couvre et ne couvre pas Poland KSeF 2.0 Validator selon sa documentation, les prérequis avant installation et les versions d'Odoo compatibles.
Vérifié dans le code du module (version 20.0) et dans les sources citées

Sources

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