Firma eIDAS in Odoo con e-Signature.eu: itsme, Evrotrust e pagamento a firma

e-Signature.eu è una piattaforma europea di firma eIDAS: non vende canoni annuali, vende credito, e ogni firma lo consuma. Il connettore che la collega a Odoo lo abbiamo costruito e lo manteniamo noi, con una versione per ogni serie (17, 18 e 19) (scheda del modulo). Questo articolo parla di ciò che quasi nessuno ti racconta prima di acquistare: quale livello ti serve davvero, cosa deve fare la controparte per firmare e come cambia il conto quando paghi a firma invece che a anno.

I tre livelli di eIDAS, raccontati per ciò che cambiano nel tuo processo

Il Regolamento (UE) 910/2014 definisce tre livelli e la differenza giuridica sta nel testo stesso (articoli 3, 25 e 26). Ciò che non c'è nel regolamento è la differenza operativa: ogni livello chiede qualcosa di diverso al firmatario, e più chiedi, più persone si perdono per strada.

Questi quattro metodi sono l'intero catalogo del connettore, e non è modificabile: nessuno può etichettare come «qualificata» una firma che non lo è.

Quando serve davvero la QES?

La maggior parte delle aziende che chiedono della firma qualificata la vuole per documenti che non ne hanno bisogno. Il criterio utile non è «quanto vale il contratto», ma «c'è qualcuno che me la esigerà per iscritto»:

• Pratiche presso un'amministrazione che la richiede. In Francia, e-Signature.eu documenta che da gennaio 2023 l'INPI richiede la firma qualificata per le formalità di modifica e cessazione d'impresa del Guichet unique. Qui non c'è discussione: o è QES o la pratica non viene accettata.
• Controparti che lo prevedono nella loro politica acquisti. Grandi clienti, compagnie assicurative e alcune banche la chiedono di default.
• Documenti che ti aspetti vengano contestati. Se il contenzioso è uno scenario realistico, la QES mette l'onere della prova a tuo favore.

Tutto il resto (conferme, ricevute di ritorno, allegati interni) vive in SES; i contratti B2B standard, in AES. E una precisazione onesta: la QES non sostituisce gli atti che la legge obbliga a stipulare per atto pubblico davanti a un notaio. L'errore più costoso non è restare corti: è impostare la QES di default e poi chiedersi perché le persone impiegano quattro giorni a firmare un documento di trasporto.

itsme, Evrotrust, Veriff e OTP: cosa chiede ciascuno al firmatario

itsme® è l'identità digitale belga. In Belgio la registrazione classica richiede l'eID con lettore di carte o la carta di una banca belga; fuori dal Belgio basta, secondo e-Signature.eu, il passaporto, la carta d'identità o il permesso di soggiorno, ma la copertura dipende dall'elenco dei paesi di itsme®: verificalo prima di promettere una QES a qualcuno. Evrotrust è un prestatore di servizi fiduciari qualificato (QTSP) bulgaro iscritto nell'elenco di fiducia dell'UE; è anche un'app mobile, la sua copertura è più ampia ed è il metodo che l'INPI francese ammette dal 2026, secondo e-Signature.eu.

Veriff non è un QTSP: è verifica d'identità, documento più selfie, e ne esce una AES. OTP è un codice via e-mail o SMS, e ne esce una SES. Qui c'è un dettaglio che ci è costato un intero giro di revisione con e-Signature.eu: la piattaforma scarta in silenzio qualsiasi telefono che non sia «+» seguito da sole cifre. Una persona scrive «+32 483 22 90 07», la piattaforma lo salva vuoto e l'OTP via SMS ripiega sull'e-mail senza avvisare. Il connettore normalizza il numero prima di inviarlo; l'ha fatto emergere il settimo giro di revisione, il 14 luglio 2026.

Cosa cambia nel flusso di Odoo a seconda del livello

Il connettore aggiunge un pulsante Send for Signature a preventivi, fatture, ordini di acquisto, contratti dei dipendenti (hr.version in Odoo 19, hr.contract in 18 e 17), candidature, contatti e qualsiasi PDF allegato. Non dipende dall'app Sign, che non compare nemmeno nel manifest, e questo conta perché la stessa documentazione di Odoo dice che Sign genera firme elettroniche semplici, il primo dei tre livelli: per AES o QES bisogna rivolgersi a un prestatore.

La procedura guidata ti fa scegliere separatamente il livello legale minimo e i metodi, e non ti lascia combinarli male: con il minimo su «Qualificata», l'invio con OTP o Veriff viene rifiutato, e la stessa validazione vale per i metodi predefiniti dell'account. Sembra una sciocchezza e previene l'errore più comune: un processo etichettato QES servito da un codice SMS.

Con la SES l'invio parte direttamente: il firmatario digita il codice e il PDF firmato torna da solo. Con la QES c'è un passaggio di identificazione che devi progettare tu: il firmatario ha bisogno dell'app installata e dell'identità già verificata, e se è la prima volta quella registrazione può richiedere più tempo del contratto. La conseguenza pratica è banale e funziona: avvisa la controparte prima di inviare.

Ci sono due modalità: nella modalità e-mail l'invito lo manda e-Signature.eu; nella modalità flusso di Odoo il preventivo esce dal circuito nativo e il cliente firma dal suo portale, dove «Firma» sostituisce «Accetta e paga». Il secondo nascondeva un errore che abbiamo corretto: la sessione su e-Signature.eu deve essere creata solo quando l'e-mail viene davvero inviata; prima, scartare la bozza lasciava la richiesta come inviata.

Abbonamento contro pagamento a firma: il conto sul tovagliolo

Un abbonamento si paga allo stesso modo che tu firmi o no, e quasi sempre include un limite di buste. Il modello di e-Signature.eu è l'opposto: acquisti pacchetti di crediti, il prezzo per credito scende con il volume e ogni firma consuma crediti in base al suo livello. Nel loro catalogo (lo stesso che replica il connettore) una QES con itsme® o Evrotrust consuma un credito per firmatario, una AES con Veriff 0,7 e una SES con OTP 0,4, sia che la richiesta contenga uno o cinque documenti.

Il conto è di una riga: dividi il canone annuo per il prezzo del credito e ottieni il numero di firme oltre il quale l'abbonamento conviene. Fallo con il canone che ti propongono e con la tariffa che e-Signature.eu pubblica sul suo sito: il risultato è un numero, non un'opinione. E c'è un effetto di secondo ordine: con l'abbonamento paghi lo stesso che firmi SES o QES, quindi nulla ti spinge a calibrare il livello; con i crediti, scegliere AES invece di QES costa il 30 % in meno su quella firma. Scegliere il livello passa da discussione giuridica astratta a decisione economica, a ogni invio.

Il saldo si vede dentro Odoo, con la sua data di aggiornamento: l'API non ha un endpoint per il saldo (lo restituisce nella risposta di ogni richiesta), quindi il connettore lo cattura dall'ultima e lo aggiorna con un cron giornaliero, invece di fingere un dato in tempo reale che non esiste.

Cosa viene conservato e dove resta la prova

Una firma senza prova recuperabile non serve il giorno in cui serve. Quando la richiesta si completa, in Odoo restano tre cose:

• Il PDF firmato, allegato al documento di origine e nominato a partire da esso (S00026-signed.pdf), non dall'identificativo interno della richiesta. Sembra solo estetica finché qualcuno cerca il suo contratto e non lo trova.
• L'audit trail ufficiale di e-Signature.eu, salvato come <documento>-audit-trail.pdf. Attenzione: la piattaforma lo genera poco dopo il completamento della richiesta, quindi può non esserci se lo chiedi proprio al momento della firma; il connettore te lo dice invece di fallire senza spiegazioni.
• Un rapporto probatorio proprio del modulo, con il livello eIDAS effettivamente raggiunto, i metodi, l'ora di firma, lo SHA-256 del documento firmato e, per ogni firmatario, la sua identità verificata, il metodo usato e quando ha firmato.

E un pulsante che non vedrai in molti connettori: Verify eIDAS signature apre lo strumento di validazione DSS della Commissione europea perché tu possa validare il PDF firmato con qualcosa che non siamo né noi né e-Signature.eu. Sotto il cofano, lo stato si sincronizza con un webhook firmato con HMAC-SHA256, un registro di idempotenza e un cron orario di recupero; ed eliminare una richiesta terminata la elimina anche dallo storico di e-Signature.eu.

Dieci giri di revisione con e-Signature.eu

Questo connettore non è stato scritto sulla documentazione e basta: è stato messo davanti al team di e-Signature.eu, rotto e riscritto. Nel repository c'è un file di test per ogni giro, da test_round2.py a test_round10.py. Due esempi, oltre al telefono del giro 7:

• Giro 9. Una richiesta annullata dal pannello di e-Signature.eu restava «Inviata» dentro Odoo per sempre. E la correzione ovvia (richiederla di nuovo) non andava bene: annullare dal pannello la elimina su e-Signature.eu e la consultazione risponde 401.
• Giro 10. Fermare una richiesta a metà firma lasciava il firmatario in sospeso all'infinito: la piattaforma rifiuta l'operazione se ancora nessuno ha firmato, e il codice ingoiava l'errore e la segnava comunque come fermata.

C'è perfino una funzione che il connettore si rifiuta di simulare: il posizionamento manuale della firma è documentato, ma il validatore di produzione lo rifiuta (22 varianti provate contro l'API reale il 10 luglio 2026, tutte rifiutate). Omettere il campo farebbe funzionare l'invio posizionando la firma in automatico, ignorando in silenzio le tue coordinate; preferiamo che fallisca con una spiegazione. Oggi sono 121 test verdi su Odoo 17, 18 e 19 con lo stesso codice sorgente, e la suite è stata eseguita anche su una build reale di Odoo.sh.

Link utili

Domande frequenti