Tabella dei contenuti

Linee guida di utilizzo

I comportamenti del Pulsante Firma con IO possono essere scelti dall’Ente nella fase di integrazione. Di seguito elenchiamo alcuni possibili scenari da gestire e conseguenti consigli sulla gestione.

Flusso di firma terminato con successo tramite il pulsante Firma con IO

L’utente si trova nell’area a lui riservata sul portale del proprio Ente, sceglie di procedere alla firma di un documento, dunque clicca il pulsante Firma con IO
Il click sul pulsante avvierà una richiesta di firma per quell’utente, che dunque dovrà attendere da min. 30 secondi a max 1 minuto per poter proseguire.

È stato previsto lato UI per il pulsante Firma con IO una modale con loading di attesa in questa fase.

3. Al termine del caricamento, l’utente atterra su app IO attraverso l’universal link.

4. L’utente procede su app IO e firma

Firma in corso (da completare)

L’utente accede al flusso per la firma, poi lo interrompe prima di concluderlo. A questo punto torna a cliccare la CTA Firma con IO per completare la firma.

Si consiglia in questo caso all’Ente di verificare lo stato della firma e, in caso di richiesta di firma in corso (WAIT_FOR_SIGNATURE), di consentire tramite la CTA all’utente di riaprire la stessa richiesta di firma e completare il processo.

Firma già effettuata

L’utente dopo aver completato il processo di firma, torna a cliccare la CTA firma con IO.

Si consiglia in questo caso all’Ente di verificare lo stato della firma e, in caso di firma già effettuata dall’utente (SIGNED), evitare che al nuovo click sulla CTA parta un nuovo processo di firma. La soluzione migliore potrebbe essere quella di eliminare/inibire la CTA e il pulsante Firma con IO e offrire all’utente una thank you page sul canale che ringrazia della firma effettuata.

Firma in corso (completate lato utente ma in corso di firma lato QTSP)

Si consiglia in questo caso all’Ente di verificare lo stato della firma e, in caso di firma in corso di completamento (WAIT_FOR_QTSP) di offrire all’utente un’information page che lo rimanda all’app IO per verificare lo stato della Firma.

Errore di firma (problemi sui documenti)

L’utente procede correttamente con la firma in app, ma al termine del flusso firma riceve un messaggio di errore che lo informa che non è stato possibile procedere con la firma dei documenti. A questo punto torna a cliccare la CTA Firma con IO.

Se non è stato possibile completare la firma, la ragione è legata a problemi tecnici nel/i documento/i inviato/i dall’Ente.

Si consiglia in questo caso all’Ente di verificare lo stato della firma e, in caso di firma rigettata (REJECTED), non consentire all’utente di avviare una nuova richiesta di firma con quella stessa CTA. Si consiglia di inibire/eliminare la CTA oppure di sostituirla con una legata a documenti corretti. Prima della presa in carico, si consiglia di prevedere una error page informativa.

NB: agli Enti è messo a disposizione un endpoint per la validazione dei documenti prima dell’invio della richiesta di firma per evitare che questo problema si verifichi il più delle volte.

Errore di firma (problemi temporanei sull’APP IO)

L’utente clicca sulla CTA Firma con IO ma l’APP IO temporaneamente non risponde.

Si consiglia in questo caso all’Ente di inserire un error page temporanea che consiglia all’utente di tornare a firmare tra qualche minuto.

In questa pagina

Flusso di firma terminato con successo tramite il pulsante Firma con IO

Firma in corso (da completare)

Firma già effettuata

Firma in corso (completate lato utente ma in corso di firma lato QTSP)

Errore di firma (problemi sui documenti)

Errore di firma (problemi temporanei sull’APP IO)

Serve aiuto durante l’integrazione?

Scrivi un’e-mail in cui descrivi il tuo problema o dubbio all’indirizzo firmaconio-tech@pagopa.it

Assistenza continua

Per problemi o dubbi dopo l’integrazione, scrivici all’indirizzo enti-firmaconio@assistenza.pagopa.it