Konzepte

Prozess-Lebenszyklus

Ein Signierprozess durchläuft vier Zustände:

Zustand	Bedeutung
CREATED	Der Prozess existiert und es können noch Dateien angehängt werden.
PENDING	Der Prozess wurde freigegeben und wartet auf Signaturen.
COMPLETED	Alle erforderlichen Signaturen wurden erfasst.
EXPIRED	Der Prozess wurde nicht vor Ablauf abgeschlossen.

Endpunkte

Erstellen und Vorbereiten

Methode	Endpoint	Mindestzustand	Zweck
POST	/api/process	-	Einen neuen Signierprozess erstellen.
POST	/api/process/{processId}/attach	CREATED	Ein PDF-Dokument anhängen.
POST	/api/process/{processId}/setup	CREATED	Den Prozess an die Swisscom-UI zur manuellen Einrichtung übergeben.
POST	/api/process/{processId}/release	CREATED	Einen vollständig vorbereiteten Prozess ohne manuelle UI-Interaktion freigeben.
POST	/api/process/{processId}/open/{personId}	PENDING	Eine signaturspezifische URL für den direkten Zugriff erzeugen.

Lesen und Überwachen

Methode	Endpoint	Mindestzustand	Zweck
GET	/api/process/{processId}	CREATED	Den vollständigen Prozess-Payload abrufen.
GET	/api/process/{processId}/status	CREATED	Den aktuellen Lebenszyklus-Zustand lesen.
GET	/api/process/{processId}/file/{fileId}	CREATED / COMPLETED	Originale oder signierte Ausgaben herunterladen.
GET	/api/process/{processId}/record	CREATED	Den Audit-Datensatz abrufen.

Prozess-Autorisierung

Swisscom unterscheidet zwischen Initiatoren und Eingeladenen, wenn entschieden wird, ob eine Person auf einen Prozess zugreifen darf.

Für Initiatoren wird der Zugriff zunächst über direkte Eigentümerschaft, anschliessend über Organisations- oder Teamzugehörigkeit und danach über verifizierte Kontaktattribute wie E-Mail-Adresse oder Mobilnummer ermittelt. Greift keine dieser Prüfungen, fällt die Plattform auf einen Einmalcode-Ablauf zurück.

Für Eingeladene ist der übliche Pfad eine verifizierte E-Mail- oder Mobilnummer-Übereinstimmung, mit derselben codebasierten Rückfallebene, wenn kein verifiziertes Attribut verwendet werden kann.