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 für „Document Metadata„:
{
"companyId": "UUID",
"initiatorAliasName": "name xy",
"comment": "Please sign this document.",
"signatureMode": "timestamp",
"jurisdiction": "zertes",
"scanPredefined": true,
"callbackEventTypes": [
"document-completed"
],
"callbackUrl": "callbackUrl",
"visualSignatureRequirement": "required"
}
Beispiel für UUID: „3fa85f64-5717-4562-b3fc-2c963f66afa6“
Die möglichen Parameter sind dem Schema „AddDocumentFile“ aus dem Swagger zu entnehmen.
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.
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, abgelehnt oder der Prozess ist ausgelaufen.
Im Feld „Document Metadata (file name)“ muss nur der Text „data“ eingetragen werden. Das Feld „Document File“ verlangt das Dokument selbst und in „Document File (file name)“ kann der Dokumentenname mitgeben werden.
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 DocumentUrl zurückgegeben, welche dann mit einem HTTP GET Request aufgerufen werden kann.
Hat dies Ihre Frage beantwortet?
