Table of contents
✍️ Request a signature
Once the documents have been prepared in one of the supported formats and the signature fields have been entered, follow these steps to request a signature from the user:
Step 1: Create a dossier
Step 2: Recover the ID of the citizen
Step 3: Create a Signature Request
Step 4: Upload the documents
Step 5: Send the request for a signature
This sequence diagram outlines the process for creating a “Signature request”, once the "Signer ID" and "Dossier ID" are obtained
sequenceDiagram
autonumber
participant E as Ente
participant API as Firma con IO (API)
participant ST as Firma con IO (Storage)
actor CIT as Cittadino
E ->> API: Richiede la creazione di una SIGNATURE REQUEST
API -->> E: Restituisce la SIGNATURE REQUEST, in stato DRAFT
loop Per ogni file PDF da caricare
E ->> API: Richiede UPLOAD_URL per il documento
API -->> E: Restituisce UPLOAD_URL
E ->> ST: Carica file PDF tramite UPLOAD URL
ST -->> E: Restituisce esito upload
end
E ->> API: Imposta SIGNATURE REQUEST come READY
API -->> E: Restituisce SIGNATURE REQUEST con QRCODE
alt Inoltro QRCODE
E ->> CIT: Manda il QRCODE usando i propri canali
else Invio Messaggio su App IO
E ->> API: Richiede NOTIFICATION per SIGNATURE_REQUEST
API -->> E: Se CITTADINO ha i Messaggi su IO abilitati, prende in carico la richiesta
API ->> CIT: Inoltra Messaggio su IO con SIGNATURE REQUEST
end
Ongoing support
For problems or questions after integration, write to us at the address enti-firmaconio@assistenza.pagopa.it