DeepSign Power Automate – Prozess
Ein Dokument zur Signatur freigeben
- Aktion: Upload
- Aktion: Prozess starten
- Aktion: Download
Upload:
Als erstes muss ein Dokument auf DeepSign hochgeladen und als Entwurf gespeichert werden.
Hierfür müssen folgende Definitionen in der Aktion «Upload Document» mitgegeben werden:
Beispiel JSON:
{
„companyId“:“3fa85f64-5717-4562-b3fc-2c963f66afa6”,
„initiatorAliasName“:“name xy“,
„comment“:“Please sign this document.“,
„signatureMode“:“timestamp“,
„jurisdiction“:“zertes“,
„scanPredefined“:true,
„callbackEventTypes“:[
„document-completed“
],
„callbackUrl“:“https://myserver.com/my/lovely/callback“,
„visualSignatureRequirement“:“required“
}
- Um die companyId zu ermitteln, loggen Sie sich mit Ihrem DeepCloud Konto über app.deepbox.swiss an. Die UUID nach der DeepBox Domäne (https://app.deepbox.swiss/) entspricht Ihrer companyId.
- Der Parameter initiatorAliasName entspricht dem Namen, welcher im Einladungsmail als Einlader angezeigt wird.
- Der signatureMode kann einer der folgenden Werte beinhalten:
- “timestamp” – Simple Electronic Signature (SES)
- “advanced” – Advanced Electronic Signature (AES)
- “qualified” – Qualified Electronic Signature (QES)
- Die jurisdiction kann einer der folgenden Werte beinhalten:
- “zertes” – Bundesgesetz über die elektronische Signatur (CH based jurisdiction)
- “eidas” – Electronic Identification, Authentication and Trust Services (EU based jurisdiciton)
- Wenn Platzhalter im Dokumenten enthalten sind, können diese ausgelesen werden, sofern der Boolean scanPredefined auf true gesetzt wurde.
- Sobald ein registrierter Event ausgelöst wurde, wird ein POST Request an die hinterlegte callbackUrl gesendet.
Folgende Events können registriert werden:- “signee-completed” – ein Unterzeichner hat das Dokument unterzeichnet oder die Signatur abgelehnt
- “document-completed” – das Dokument wurde unterzeichnet oder abgelehnt
- Mit dem Parameter visualSignatureRequirement kann der Unterzeichner gezwungen werden, eine visuelle Signatur zu platzieren.
Signatur Prozess starten:
Bevor der Signatur Prozess gestartet wird, müssen die Unterzeichner definiert werden. Sollte dies nicht mit Platzhaltern beim Upload gemacht worden sein, muss dies mit separaten Aktionen nachgeholt werden. Danach kann der Signatur Prozess mit der Aktion «Start Signature Process» initialisiert werden.
Signiertes Dokument herunterladen:
Info: Es werden ergänzende Aktionen aus dem HTTP Connector verwendet
Sofern ein Webhook / eine Callback URL registriert wurde, kann in Power Automate ein Prozess erstellt werden, welcher aufgrund der Meldung bei einem DeepSign Event ausgelöst wird.
Hierfür kann der Trigger «Beim Empfang einer HTTP-Anforderung» hinterlegt werden.
Die Meldung des Webhooks folgt diesem Schema:
{
„type“: „object“,
„properties“: {
„eventType“: {
„type“: „string“
},
„documentId“: {
„type“: „string“
},
„timestamp“: {
„type“: „string“
}
}
}
Die HTTP-URL, welche nach dem Speichern des Prozesses generiert wird, muss als Callback URL im DeepSign Upload mitgegeben werden.
Wird dann ein entsprechender Event auf DeepSign ausgelöst, stösst dies den Trigger an.
Wurde das Dokument signiert, können die Details zum Dokument über die Aktion «Get Document Details» abgerufen werden. In der Response wird die DownloadUrl zurückgegeben, welche dann mit einem HTTP Request aufgerufen werden kann.
Hat dies Ihre Frage beantwortet?
