Concepts

Cycle de vie d'un processus

Un processus de signature passe par quatre états :

État	Signification
CREATED	Le processus existe et des fichiers peuvent encore y être attachés.
PENDING	Le processus a été libéré et attend des signatures.
COMPLETED	Toutes les signatures requises ont été collectées.
EXPIRED	Le processus n'a pas été complété avant son expiration.

Services principaux

Créer et préparer

Méthode	Endpoint	État minimum	Objectif
POST	/api/process	-	Créer un nouveau processus de signature.
POST	/api/process/{processId}/attach	CREATED	Attacher un document PDF.
POST	/api/process/{processId}/setup	CREATED	Confier le processus à l'interface Swisscom pour une configuration manuelle.
POST	/api/process/{processId}/release	CREATED	Libérer un processus entièrement préparé sans interaction manuelle dans l'interface.
POST	/api/process/{processId}/open/{personId}	PENDING	Générer une URL spécifique au signataire pour un accès direct.

Lire et surveiller

Méthode	Endpoint	État minimum	Objectif
GET	/api/process/{processId}	CREATED	Récupérer le payload complet du processus.
GET	/api/process/{processId}/status	CREATED	Lire l'état actuel du cycle de vie.
GET	/api/process/{processId}/file/{fileId}	CREATED / COMPLETED	Télécharger les originaux ou la sortie signée.
GET	/api/process/{processId}/record	CREATED	Récupérer la piste d'audit.

Autorisation des processus

Swisscom distingue les initiateurs des invités lorsqu'il s'agit de déterminer si une personne peut accéder à un processus.

Pour les initiateurs, l'accès est d'abord résolu via la propriété directe, puis l'appartenance à une organisation ou à une équipe, et enfin via des attributs de contact vérifiés tels que l'adresse e-mail ou le numéro de mobile. Si aucune de ces vérifications ne s'applique, la plateforme retombe sur un flux à code à usage unique.

Pour les invités, le chemin normal est une correspondance vérifiée d'e-mail ou de numéro de mobile, avec le même repli par code si aucun attribut vérifié ne peut être utilisé.