Vai al contenuto principale
KSeF 2.0

Come funziona Poland KSeF 2.0 Validator in Odoo: menu, azione pianificata e percorso

Poland KSeF 2.0 Validator aggiunge a Odoo un menu KSeF con dashboard, migrazione, operazioni e configurazione, più un'azione pianificata, KSeF: session maintenance, che gira ogni 5 minuti. Valida l'FA(3) in FlexigoTech Cloud e conserva un report firmato, ma non invia nulla a KSeF: l'invio vero e proprio lo fa l10n_pl_edi di Odoo.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 4 novembre 2026

In breve

Modulo
KSeF 2.0
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del modulo, versione 20.0 · nelle fonti collegate in fondo
Lettura
5 min

Valida e prepara; l'invio è compito di l10n_pl_edi

La prima cosa da avere chiara è la divisione dei compiti. Il modulo valida e prepara, e non ha un client HTTP verso KSeF. L'invio vero e proprio lo fa l10n_pl_edi, il modulo di Odoo Community che invia a KSeF e che esiste in Odoo 18, 19 e 20 (in Odoo 17 non esiste).

Da qui dipende come lavora in base alla versione: dalla 18 alla 20, il modulo valida l'FA(3) che l10n_pl_edi genera o ha già inviato; nella 17, l'FA(3) viene caricato già pronto da fuori Odoo. Il modulo è pubblicato su Odoo Apps per 17.0, 18.0, 19.0 e 20.0.

La validazione dell'FA(3) gira in FlexigoTech Cloud con l'abbonamento. La scheda di Odoo Apps lo segnala in una sezione apposita, Before you buy: this app uses a paid external service. Se stai ancora valutando se fa al caso tuo, ne parliamo a parte in se Poland KSeF 2.0 Validator è adatto alla tua azienda.

I menu che compaiono sotto KSeF

Dopo l'installazione trovi un menu principale KSeF con questa struttura:

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

La dashboard KSeF › Dashboard è una vista kanban; nello screenshot si vede la scheda di un'azienda.

Vista kanban della KSeF Dashboard con la scheda di Wawel Digital sp. z o.o.
La scheda riunisce l'ondata, la data di go-live, il grado di preparazione, le fatture accettate e rifiutate, il backlog offline e la coda.

Il modulo a confronto con l10n_pl_edi, punto per punto

Questa tabella confronta cosa fa ciascuno secondo la propria documentazione.

Aspettol10n_pl_edi di OdooPoland KSeF 2.0 Validator
Dove si trovaOdoo Community 18, 19 e 20; nella 17 non esisteOdoo Apps per 17.0, 18.0, 19.0 e 20.0
Invio reale a KSeFLo fa luiNon ha un client HTTP verso KSeF
FA(3) in Odoo da 18 a 20Lo genera e lo inviaValida quello che l10n_pl_edi genera o ha già inviato
FA(3) in Odoo 17Il modulo non esisteViene caricato già pronto da fuori Odoo
Validazione dell'FA(3)-In FlexigoTech Cloud, con report firmato
CredenzialiIn Odoo 19 salva nell'azienda un KSeF Certificate e si autentica con essoHa un modello KSeF Credential (certificate / token)
Azioni pianificateIn Odoo 19, un'azione rinnova i token di accesso di ogni azienda con certificatoKSeF: session maintenance, ogni 5 minuti

In pratica non sono alternative, si completano. Dalla 18 alla 20, l'invio lo fa l10n_pl_edi e il validatore controlla l'FA(3) che quel modulo genera o ha già inviato. Nella 17 non c'è l10n_pl_edi e il validatore lavora con l'FA(3) caricato già pronto da fuori Odoo.

Le credenziali del modulo hanno un elenco dedicato.

Elenco delle credenziali KSeF con certificati KSeF, un sigillo qualificato e un token
Ogni credenziale mostra azienda, tipo, ambiente, data di validità, giorni rimanenti e stato di scadenza; due righe sono evidenziate in giallo.

Con il servizio attivo e senza

Poiché la validazione dipende da FlexigoTech Cloud, il modulo si comporta in modo diverso a seconda dello stato dell'abbonamento.

AspettoCon abbonamento attivoSenza abbonamento o con servizio sospeso
Validazione dell'FA(3)Gira in FlexigoTech Cloud e conserva un report firmatoSi ferma; la fattura resta «non validata»
Cosa offre l'abbonamentoDisponibileSi ferma
I tuoi datiNel tuo OdooRestano nel tuo Odoo

Il modulo ha anche un record di consenso, Consent to validate FA(3) files in FlexigoTech Cloud. Con l'abbonamento, il modulo per le nuove versioni di Odoo è incluso se l'hai acquistato su flexigotech.com; sull'Odoo App Store, ogni versione di Odoo si acquista lì. Il servizio locale costa 29 €/mese o 290 €/anno IVA esclusa, e il piano Pro 58 €/mese o 580 €/anno IVA esclusa.

Il percorso di una fattura dentro il modulo

In Odoo dalla 18 alla 20, l10n_pl_edi genera l'FA(3) e fa l'invio reale a KSeF; il validatore valida in FlexigoTech Cloud l'FA(3) che l10n_pl_edi ha generato o già inviato, e conserva il report firmato. Se il servizio non è disponibile, la fattura resta «non validata».

Il modulo definisce record KSeF Submission Queue Item, e nel menu KSeF › Operations › Submission Queue trovi l'elenco della coda.

Elenco Submission Queue con sei record di Wawel Digital sp. z o.o.
Colonne per movimento, modalità, stato, tentativi e scadenza, con stati come Offline pendiente, Accepted e Ready to upload to KSeF.

In modalità offline, la scadenza arriva fino al giorno lavorativo polacco successivo, con un promemoria giornaliero. Il modulo include una procedura guidata chiamata KSeF Offline/Emergency Mark Wizard.

Attorno a questo percorso, il modulo definisce altri record con questi nomi:

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

L'azione pianificata che gira da sola

La documentazione del modulo riporta l'azione KSeF: session maintenance, attiva e impostata per girare ogni 5 minuti. Nella configurazione hai anche il menu KSeF › Configuration › API Sessions, e il modulo salva record KSeF API Session.

Non confonderla con l'azione di l10n_pl_edi in Odoo 19, che rinnova i token di accesso di ogni azienda con certificato: quella è di Odoo, non del validatore.

Se nel tuo database vedi entrambe le azioni, ognuna appartiene a un modulo diverso.

Come ti aiuta FlexigoTech

In FlexigoTech implementiamo Odoo 17, 18, 19 e 20 e sviluppiamo connettori e integrazioni su misura. Se vuoi che il validatore lavori insieme a l10n_pl_edi nella tua versione, o devi validare in Odoo 17 l'FA(3) che generi fuori da Odoo, trovi i dettagli e l'acquisto nella pagina del modulo e nella sua scheda di Odoo Apps.

Continua a leggere

Poland KSeF 2.0 Validator: cosa copre, cosa no e se fa per il tuo OdooCosa copre e cosa no Poland KSeF 2.0 Validator secondo la sua documentazione, cosa ti serve prima di installarlo e con quale versione di Odoo funziona.
Verificato nel codice del modulo (versione 20.0) e nelle fonti collegate

Fonti

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