Salta al contingut principal
KSeF 2.0

Com funciona Poland KSeF 2.0 Validator a Odoo: menús, tasca programada i recorregut

Poland KSeF 2.0 Validator afegeix a Odoo un menú KSeF amb tauler, migració, operacions i configuració, i una tasca programada, KSeF: session maintenance, que s'executa cada 5 minuts. Valida el FA(3) a FlexigoTech Cloud i desa un informe signat, però no envia res a KSeF: l'enviament real el fa l10n_pl_edi d'Odoo.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 4 de novembre de 2026

L'essencial

Mòdul
KSeF 2.0
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del mòdul, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

Valida i prepara; l'enviament és cosa de l10n_pl_edi

El primer que convé tenir clar és el repartiment de feina. El mòdul valida i prepara, i no té client HTTP cap a KSeF. L'enviament real el fa l10n_pl_edi, el mòdul d'Odoo Community que envia a KSeF i que existeix a Odoo 18, 19 i 20 (a Odoo 17 no existeix).

D'aquí surt com treballa segons la versió: de la 18 a la 20, el mòdul valida el FA(3) que genera o ja ha enviat l10n_pl_edi; a la 17, el FA(3) es puja fet fora d'Odoo. El mòdul està publicat a Odoo Apps per a 17.0, 18.0, 19.0 i 20.0.

La validació del FA(3) s'executa a FlexigoTech Cloud amb la subscripció. La mateixa fitxa d'Odoo Apps ho avisa en un apartat, Before you buy: this app uses a paid external service. Si encara estàs valorant si et convé, ho tractem a part a si Poland KSeF 2.0 Validator encaixa a la teva empresa.

Els menús que apareixen sota KSeF

En instal·lar-lo, tens un menú arrel KSeF amb aquesta estructura:

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

El tauler KSeF › Dashboard és una vista kanban; a la captura es veu la targeta d'una empresa.

Vista kanban del KSeF Dashboard amb la targeta de Wawel Digital sp. z o.o.
La targeta reuneix l'onada, la data de go-live, la preparació, les acceptades i rebutjades, el backlog offline i la cua.

El mòdul davant de l10n_pl_edi, peça per peça

Aquesta taula compara el que fa cadascun segons la seva documentació.

Aspectel10n_pl_edi d'OdooPoland KSeF 2.0 Validator
On ésOdoo Community 18, 19 i 20; a la 17 no existeixOdoo Apps per a 17.0, 18.0, 19.0 i 20.0
Enviament real a KSeFEl fa ellNo té client HTTP cap a KSeF
FA(3) a Odoo 18 a 20El genera i l'enviaValida el que genera o ja ha enviat l10n_pl_edi
FA(3) a Odoo 17El mòdul no existeixEs puja fet fora d'Odoo
Validació del FA(3)-A FlexigoTech Cloud, amb informe signat
CredencialsA Odoo 19 desa a l'empresa un KSeF Certificate i s'autentica amb ellTé un model KSeF Credential (certificate / token)
Tasques programadesA Odoo 19, una tasca renova els tokens d'accés de cada empresa amb certificatKSeF: session maintenance, cada 5 minuts

La lectura pràctica: no són alternatives, es complementen. De la 18 a la 20, l'enviament el fa l10n_pl_edi, i el validador revisa el FA(3) que aquest mòdul genera o ja ha enviat. A la 17 no hi ha l10n_pl_edi, i el validador treballa amb el FA(3) que es puja fet fora d'Odoo.

Les credencials del mòdul es veuen en una llista pròpia.

Llista de credencials KSeF amb certificats KSeF, un segell qualificat i un token
Cada credencial mostra empresa, tipus, entorn, data de validesa, dies restants i estat de caducitat; dues files surten ressaltades en groc.

Amb el servei actiu i sense

Com que la validació depèn de FlexigoTech Cloud, el mòdul es comporta diferent segons l'estat de la subscripció.

AspecteAmb subscripció activaSense subscripció o amb el servei suspès
Validació del FA(3)S'executa a FlexigoTech Cloud i desa un informe signatS'atura; la factura queda «no validada»
El que dona la subscripcióDisponibleS'atura
Les teves dadesAl teu OdooEs queden al teu Odoo

El mòdul té, a més, un registre de consentiment, Consent to validate FA(3) files in FlexigoTech Cloud. Amb la subscripció, el mòdul per a les versions noves d'Odoo hi va inclòs si el vas comprar a flexigotech.com; a l'Odoo App Store, cada versió d'Odoo es compra allà. El servei local costa 29 €/mes o 290 €/any sense IVA, i el pla Pro, 58 €/mes o 580 €/any sense IVA.

Què recorre una factura dins del mòdul

A Odoo 18 a 20, l10n_pl_edi genera el FA(3) i fa l'enviament real a KSeF; el validador valida a FlexigoTech Cloud el FA(3) que l10n_pl_edi ha generat o ja ha enviat, i desa l'informe signat. Si el servei no està disponible, la factura queda «no validada».

El mòdul defineix registres KSeF Submission Queue Item, i al menú KSeF › Operations › Submission Queue tens la llista de la cua.

Llista Submission Queue amb sis registres de Wawel Digital sp. z o.o.
Columnes de moviment, mode, estat, intents i termini, amb estats com Offline pendiente, Accepted i Ready to upload to KSeF.

En el mode offline, el termini arriba fins al següent dia hàbil polonès, amb un avís diari. El mòdul inclou un assistent anomenat KSeF Offline/Emergency Mark Wizard.

Al voltant d'aquest recorregut, el mòdul defineix altres registres amb aquests noms:

  • KSeF Inbound Invoice, al costat del menú KSeF › Operations › Inbound Invoices
  • KSeF Immutable Audit Log
  • KSeF API Error Code, al costat del 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 i KSeF Validation Issue
  • KSeF Compliance Export Wizard

La tasca programada que s'executa sola

La documentació del mòdul recull la tasca KSeF: session maintenance, activa i amb una freqüència de cada 5 minuts. A la configuració també tens el menú KSeF › Configuration › API Sessions, i el mòdul desa registres KSeF API Session.

No la confonguis amb la tasca de l10n_pl_edi a Odoo 19, que renova els tokens d'accés de cada empresa amb certificat: aquesta és d'Odoo, no del validador.

Si a la teva base veus les dues tasques, cadascuna pertany a un mòdul diferent.

Com t'ajuda FlexigoTech

A FlexigoTech implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors i integracions a mida. Si vols que el validador convisqui amb l10n_pl_edi a la teva versió, o necessites validar a Odoo 17 el FA(3) que generes fora d'Odoo, tens els detalls i la compra a la pàgina del mòdul i a la seva fitxa d'Odoo Apps.

Continua llegint

Poland KSeF 2.0 Validator: què cobreix, què no i si encaixa al teu OdooQuè cobreix i què no Poland KSeF 2.0 Validator segons la seva documentació, què necessites abans d'instal·lar-lo i en quina versió d'Odoo encaixa.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts

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