Concetti

Ciclo di vita del processo

Un processo di firma attraversa quattro stati:

Stato	Significato
CREATED	Il processo esiste e i file possono ancora essere allegati.
PENDING	Il processo è stato rilasciato e attende le firme.
COMPLETED	Tutte le firme richieste sono state raccolte.
EXPIRED	Il processo non è stato completato entro la scadenza.

Servizi principali

Creare e preparare

Metodo	Endpoint	Stato minimo	Scopo
POST	/api/process	-	Creare un nuovo processo di firma.
POST	/api/process/{processId}/attach	CREATED	Allegare un documento PDF.
POST	/api/process/{processId}/setup	CREATED	Consegnare il processo all'interfaccia Swisscom per la configurazione manuale.
POST	/api/process/{processId}/release	CREATED	Rilasciare un processo completamente preparato senza interazione manuale nell'interfaccia.
POST	/api/process/{processId}/open/{personId}	PENDING	Generare un URL specifico per il firmatario per l'accesso diretto.

Leggere e monitorare

Metodo	Endpoint	Stato minimo	Scopo
GET	/api/process/{processId}	CREATED	Recuperare il payload completo del processo.
GET	/api/process/{processId}/status	CREATED	Leggere lo stato corrente del ciclo di vita.
GET	/api/process/{processId}/file/{fileId}	CREATED / COMPLETED	Scaricare gli originali o l'output firmato.
GET	/api/process/{processId}/record	CREATED	Recuperare la traccia di audit.

Autorizzazione del processo

Swisscom distingue tra iniziatori e invitati per decidere se una persona può accedere a un processo.

Per gli iniziatori, l'accesso viene risolto prima tramite la proprietà diretta, quindi tramite l'appartenenza all'organizzazione o al team, e infine tramite attributi di contatto verificati come l'indirizzo e-mail o il numero di cellulare. Se nessuno di questi controlli è applicabile, la piattaforma ricorre a un flusso con codice monouso.

Per gli invitati, il percorso normale è una corrispondenza verificata di e-mail o numero di cellulare, con lo stesso fallback basato su codice se non è disponibile alcun attributo verificato.