Zeichen markieren (Vorschau)
Mark Sign ist ein qualifizierter elektronischer Signaturdienst, der mit der eIDAS-Verordnung konform ist. Senden Sie Dokumente zum Signieren, warten Sie auf die Signaturen, laden Sie die signierten Dateien herunter und überprüfen Sie sie.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure Government Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Id markieren, UAB |
| URL | https://marksign.eu |
| E‑Mail | pagalba@marksign.lt |
| Connectormetadaten | |
|---|---|
| Herausgeber | Id markieren, UAB |
| Website | https://marksign.eu |
| Datenschutzrichtlinie | https://marksign.eu/privacy-policy |
| Categories | Produktivität; Inhalt und Dateien |
Zeichen markieren
Mark Sign ist ein qualifizierter elektronischer Signaturdienst, der mit der eIDAS-Verordnung konform ist. Ein Fluss kann ein Dokument zur Signatur senden, warten, bis es signiert ist, und dann die signierte Datei herunterladen und überprüfen.
Publisher: Id markieren, UAB
Prerequisites
Sie benötigen ein Mark Sign-API-Zugriffstoken. Weitere Informationen finden Sie weiter unten unter "Anmeldeinformationen".
Unterstützte Vorgänge
Dokument: Hochladen
Lädt ein Dokument (PDF, ADoc, BDoc oder ASiC-E) hoch und bereitet es auf die Signierung vor. Der Dateiname wird zum Dokumenttitel.
Signieren: Per E-Mail einladen
lädt eine Person zum Signieren ein; Mark Sign sendet die Einladungs-E-Mail. Beim erneuten Aufrufen für dieselbe Person wird eine Erinnerung gesendet.
Signieren: Nach URL einladen
Fügt einen Signierer hinzu, ohne eine E-Mail zu senden, und gibt die persönliche Einladungs-URL zurück, die Sie übermitteln möchten.
Signieren: Warten auf alle Signierer
Hält den Fluss, bis das Dokument signiert oder abgelehnt wurde, oder endet mit dem timed_out Status, wenn die Wartezeit (standardmäßig 29 Tage) ausläuft.
Signieren: Warten Auf einen Signierer
Hält den Fluss, bis ein bestimmter Signierer, der per E-Mail ausgewählt wurde, zeichent. Jede Ablehnung beendet auch das Warten.
Signieren: Warten auf den nächsten Signierer
Setzt den Fluss fort, sobald der nächste Signierer signiert oder abgelehnt wird, ohne Abfragen.
Dokument: Status abrufen
Überprüft den Gesamtsignierstatus des Dokuments.
Dokument: Signierer abrufen
Listet den Status jedes Signierers auf, einschließlich des Ablehnungsgrundes, wenn ein Signierer abgelehnt wurde.
Dokument: Herunterladen
Lädt das Dokument mit allen bisher gesammelten Signaturen herunter.
Dokument: Liste
Listet die Dokumente in Ihrem Arbeitsbereich mit Textsuche und Paging auf.
Dokument: Entfernen
Entfernt ein Dokument aus dem Arbeitsbereich.
Dokument: Als Container hochladen
Kombiniert mehrere Dateien in einem signierbaren Containerdokument (ADoc, BDoc oder ASiC-E). Die Abrechnung folgt dem Mark-Zeichenstandard, wobei jeder Signierer zahlt.
Signieren: Erstellen von Signierlinks
Erstellt einen persönlichen Signaturlink für jeden Signierer, um sich selbst zu übermitteln. Die Links laufen ab, können eine Identitätsüberprüfung erfordern und sind die einzigen Signaturseiten mit einer Ablehnungsoption.
Signieren: Erstellen eines freigegebenen Links
Erstellt einen Link, den jeder öffnen kann, um die Dokumente zu signieren, jeweils unter ihrer eigenen überprüften Identität.
Signieren: Link löschen
Löscht einen Signiererlink oder einen freigegebenen Link, bevor er abläuft.
Dokument: Gültigkeit der Signatur verlängern
Aktualisiert die Dokumentsignaturen für die langfristige Gültigkeit (Long-Term Validity, LT) oder die langfristige Archivierung (LTA).
Dokument: Überprüfen
Überprüft die Signaturen eines Dokuments und gibt den vollständigen Überprüfungsbericht zurück.
Abrufen von Anmeldeinformationen
Wenden Sie sich an den Kundensupport von Mark Sign, pagalba@marksign.lt um ein API-Zugriffstoken für Ihren Arbeitsbereich anzufordern. Fügen Sie beim Erstellen einer Verbindung in Power Automate das Token in das Feld "API-Schlüssel" ein.
Das Token ist an einen Arbeitsbereich gebunden, sodass jedes Dokument, das über die Verbindung erstellt oder aufgelistet wird, zu diesem Arbeitsbereich gehört.
Getting Started
Der einfachste Signaturfluss:
- Dokument: Hochladen (z. B. Dateiinhalt und Namenstoken aus SharePoint oder OneDrive).
- Signieren: Per E-Mail einladen. Markieren Sie die E-Mails der Einladung.
- Signieren: Warten Sie auf den nächsten Signierer. Der Ablauf wird hier angehalten, bis die Signatur erfolgt.
- Dokument: Laden Sie es herunter , und speichern Sie es dort, wo Sie es benötigen.
Verwenden Sie bei mehreren Signierern signieren : Per E-Mail für jede Person einladen, und dann eine Signatur: Warten Sie auf alle Signierer , bevor Sie den Download ausführen. Wenn Sie die Links selbst anstelle von "Signieren"-E-Mails übermitteln möchten, verwenden Sie "Signieren": "Nach URL einladen" oder "Signieren": Erstellen Sie Signiererlinks, und senden Sie jeder Person ihren Link mit Ihrer eigenen Outlook- oder Teams-Aktion.
Bekannte Probleme und Einschränkungen
- Der Verbinder stellt keine Flusstrigger bereit; verwenden Sie stattdessen die Wartevorgänge innerhalb eines Flusses.
- Ein Dokument verfügt über eine Benachrichtigungsregistrierung. Führen Sie nicht zwei Signaturen aus: Warten Sie auf die nächsten Signierschritte für dasselbe Dokument gleichzeitig. Die zweite ersetzt den ersten, und der erste Schritt wartet dann, bis es zu einem Zeitüberschreitungen kommt. Das Ausfüllen eines Rückruf-URL-Felds für jeden Block ersetzt auch die Registrierung.
- Signierer können ein Dokument nur auf einer Signatur ablehnen: Seite "Signiererlinks erstellen " (mit Schaltfläche "Ablehnen anzeigen" aktiviert); E-Mail-Einladungen, Einladungs-URLs und freigegebene Links bieten keine Ablehnungsoption.
- Mark Sign benachrichtigt nur über Signaturen. Wenn ein Einladungsblock einen Zweck oder
reviewconfirmationeine Aktion dieser Person verwendet, wird nie die Signatur aktiviert: Warten Sie auf den nächsten Signierer. Überprüfen Sie stattdessen ihren Status mit "Dokument: Signierer abrufen ". - Dokument: Download gibt den Dateiinhalt nur zurück; Nehmen Sie den Dateinamen aus "Document: Liste" oder aus Ihrem Uploadschritt.
- Ein Ablauf kann höchstens 30 Tage dauern (ein Power Automate Limit), sodass kein Warten das überleben kann.
Signieren: Warten Sie auf alle Signierer und Signierer: Warten Sie, bis ein Signierer nach 29 Tagen standardmäßig mit dem
timed_outStatus endet. For Signing: Wait for next signer, set a Timeout (for exampleP29D) in the action settings and add a branch configured to run after the action has timeout. Wenn die 30-Tage-Ausführungsgrenze zuerst erreicht wird, Power Automate wird die gesamte Ausführung abgebrochen, und es wird keine Verzweigung behandelt. - Dokument: Die Liste unterstützt keine Filterung nach Status.
- Dokument: Upload akzeptiert eine Datei pro Anruf; Sie können Anlagen durchlaufen, um mehrere hochzuladen. Dokument: Das Hochladen als Container ist für einige Dateien vorgesehen. Das Kombinieren vieler großer Dateien in einem Aufruf kann das Verarbeitungszeitlimit überschreiten.
Bereitstellungsanweisungen
Führen Sie paconn create --api-prop apiProperties.json --api-def apiDefinition.swagger.json --script script.csx --icon icon.png diese Ausführung aus, um diesen Connector als benutzerdefinierten Connector in Ihrer Power Platform-Umgebung bereitzustellen. Ausführliche Informationen finden Sie in der paconn-Dokumentation .
Support
Wenden Sie sich bei Problemen mit dem Connector oder der Mark Sign-API an pagalba@marksign.lt.
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Standard | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Required |
|---|---|---|---|
| API-Schlüssel | securestring | Das Signier-API-Zugriffstoken Ihres Arbeitsbereichs. Fordern Sie eine von der Mark Sign-Unterstützung unter an.pagalba@marksign.lt | True |
Aktionen
| Dokument: Als Container hochladen |
Kombiniert mehrere Dateien in einem signierbaren Containerdokument, z. B. ADoc oder ASiC-E. Die Dateien werden in einem einzigen Schritt hochgeladen und kombiniert. |
| Dokument: Entfernen |
Entfernt ein Dokument aus Ihrem Arbeitsbereich. |
| Dokument: Gültigkeit der Signatur verlängern |
Aktualisiert die Dokumentsignaturen für die langfristige Gültigkeit oder Archivierung. |
| Dokument: Herunterladen |
Lädt das Dokument mit allen bisher gesammelten Signaturen herunter. |
| Dokument: Hochladen |
Lädt ein Dokument hoch und bereitet es für die Signatur vor. |
| Dokument: Liste |
Listet die Dokumente in Ihrem Arbeitsbereich auf, die am neuesten sind. |
| Dokument: Signierer abrufen |
Listet die Signierer eines Dokuments mit ihrem Signaturstatus auf. |
| Dokument: Status abrufen |
Ruft den Signaturstatus eines Dokuments ab. |
| Dokument: Überprüfen |
Überprüft die Signaturen eines Dokuments und gibt den Überprüfungsbericht zurück. Der Ablauf wartet, bis die Überprüfung abgeschlossen ist. |
| Signieren: Erstellen eines freigegebenen Links |
Erstellt einen Signaturlink, den jeder öffnen kann, um die Dokumente zu signieren. Sie liefern es selbst. |
| Signieren: Erstellen von Signierlinks |
Erstellt einen persönlichen Signaturlink für jeden Signierer. Sie übermitteln die Links selbst, z. B. per E-Mail oder Teams-Nachricht. |
| Signieren: Link löschen |
Löscht einen Signiererlink oder einen freigegebenen Link, bevor er abläuft. Einladungslinks können nicht gelöscht werden. |
| Signieren: Nach URL einladen |
Fügt dem Dokument einen Signierer hinzu, ohne eine E-Mail zu senden, und gibt dessen persönlichen Einladungslink zurück, über den Sie übermitteln können. Der Link läuft nicht ab und kann nicht gelöscht werden; verwenden Sie "Signieren: Signiererlinks erstellen", wenn Sie Links benötigen, die Sie widerrufen können. |
| Signieren: Per E-Mail einladen |
Lädt eine Person ein, das Dokument zu signieren. Mark Sign sendet die Einladung per E-Mail. |
| Signieren: Warten auf alle Signierer |
Wartet, bis jeder Signierer das Dokument signiert hat oder jemand das Dokument abgelehnt hat, und ermöglicht dann den Ablauf. Endet mit dem timed_out Status, wenn die Zeit ausläuft. |
| Signieren: Warten auf den nächsten Signierer |
Wartet, bis der nächste Signierer das Dokument signiert oder ablehnt, ohne Einladungen zu senden. Verwenden Sie sie in einer Schleife, um auf mehrere Signierer zu warten, ohne abfragen zu müssen. |
| Signieren: Warten Auf einen Signierer |
Wartet, bis ein bestimmter Signierer das Dokument signiert, und der Fluss wird fortgesetzt. Endet mit dem timed_out Status, wenn die Zeit ausläuft. |
Dokument: Als Container hochladen
Kombiniert mehrere Dateien in einem signierbaren Containerdokument, z. B. ADoc oder ASiC-E. Die Dateien werden in einem einzigen Schritt hochgeladen und kombiniert.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokumenttyp
|
document_type | True | string |
Der Typ des zu erstellenden Dokuments. |
|
Dateiname
|
file_name | True | string |
Der Name der Datei mit der Erweiterung, z. B. contract.pdf. |
|
Inhalt der Datei
|
file_content | True | byte |
Der Inhalt der Datei. |
|
Dateityp (nur ADoc)
|
adoc_file_type | string |
Die Rolle der Datei im Container. Wird nur verwendet, wenn der Dokumenttyp ein ADoc ist. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
|
Dokument-ID
|
data.uuid | string |
Die ID des Dokuments. |
|
Dateiname
|
data.filename | string |
Der Name der Dokumentdatei. |
Dokument: Entfernen
Entfernt ein Dokument aus Ihrem Arbeitsbereich.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
Gibt zurück
- Body
- AcknowledgedResponse
Dokument: Gültigkeit der Signatur verlängern
Aktualisiert die Dokumentsignaturen für die langfristige Gültigkeit oder Archivierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
|
Grad
|
level | True | string |
LT für langzeitgültige Gültigkeit, LTA für die langfristige Archivierung. |
Gibt zurück
- Body
- AcknowledgedResponse
Dokument: Herunterladen
Lädt das Dokument mit allen bisher gesammelten Signaturen herunter.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
Gibt zurück
Der Inhalt der Dokumentdatei.
- Inhalt der Datei
- file
Dokument: Hochladen
Lädt ein Dokument hoch und bereitet es für die Signatur vor.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dateiname
|
file_name | True | string |
Der Name der Datei mit der Erweiterung, z. B. contract.pdf. Er wird zum Dokumenttitel. |
|
body
|
body | True | binary | |
|
Access
|
access | string |
Wer das Dokument anzeigen kann. Der Standardwert ist privat. |
|
|
Abrechnungstyp
|
billing_type | True | string |
Wer zahlt für die Signaturen. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
|
Dokument-ID
|
data.uuid | string |
Die ID des Dokuments. |
|
Dateiname
|
data.filename | string |
Der Name der Datei. |
Dokument: Liste
Listet die Dokumente in Ihrem Arbeitsbereich auf, die am neuesten sind.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Search
|
query | string |
Ein Ausdruck, der in Dokumenttiteln und Dateinamen gesucht werden soll. |
|
|
Abstand
|
offset | integer |
Wie viele Dokumente übersprungen werden sollen. |
|
|
Limit
|
limit | integer |
Wie viele Dokumente zurückgegeben werden sollen. Der Standardwert ist 10. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
|
Dokumente:
|
data | array of object |
Die Dokumente. |
|
Dokument-ID
|
data.uuid | string |
Die ID des Dokuments. |
|
Dateiname
|
data.filename | string |
Der Name der Datei. |
|
Dokumentstatus
|
data.status | string |
Der Signaturstatus des Dokuments, z. B. gespeichert (auf Signaturen warten), signed_partially oder signiert. |
|
Hochgeladen unter
|
data.uploaded_at | date-time |
Beim Hochladen des Dokuments. |
|
Total
|
total | integer |
Die Gesamtzahl der übereinstimmenden Dokumente. |
Dokument: Signierer abrufen
Listet die Signierer eines Dokuments mit ihrem Signaturstatus auf.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
|
Unterzeichner:
|
data | array of object |
Die Signierer des Dokuments. |
|
Signierer-ID
|
data.id | string |
Die ID des Signierers. |
|
Vorname
|
data.name | string |
Der Vorname des Signierers. |
|
Nachname
|
data.surname | string |
Der Nachname des Signierers. |
|
E‑Mail
|
data.email | string |
Die E-Mail-Adresse des Signierers. |
|
Signaturstatus
|
data.status | string |
Gibt an, ob der Signierer signiert hat: ausstehend, signiert, abgelehnt, überprüft, bestätigt, abgelehnt oder überprüft. |
|
Ablehnungsgrund
|
data.rejection_reason | string |
Der Grund, den der Signierer beim Ablehnen des Dokuments gegeben hat. |
Dokument: Status abrufen
Ruft den Signaturstatus eines Dokuments ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
|
Dokumentstatus
|
data.document_status | string |
Der Signaturstatus: gespeichert (auf Signaturen warten), signed_partially (einige haben signiert) oder signiert (jeder hat signiert). |
Dokument: Überprüfen
Überprüft die Signaturen eines Dokuments und gibt den Überprüfungsbericht zurück. Der Ablauf wartet, bis die Überprüfung abgeschlossen ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
|
Ist gültig
|
data.document.is_valid | boolean |
Gibt an, ob die Dokumentsignaturen gültig sind. |
|
Gültig bis
|
data.document.valid_to | string |
Wie lange das Dokument gültig bleibt. |
|
Dokumentname
|
data.document.name | string |
Der Titel des Dokuments. |
|
MIME-Typ
|
data.document.mimetype | string |
Der Dateityp des Dokuments. |
|
Signaturen:
|
data.signatures | array of object |
Das Ergebnis für jede Signatur. |
|
Signatur-ID
|
data.signatures.id | string |
Die ID der Signatur. |
|
Signierzeit
|
data.signatures.signing_time | string |
Als die Signatur erstellt wurde. |
|
Signaturformat
|
data.signatures.signature_format | string |
Das Format der Signatur. |
|
Ist gültig
|
data.signatures.is_valid | boolean |
Gibt an, ob die Signatur gültig ist. |
|
Gültig bis
|
data.signatures.valid_to | string |
Wie lange die Signatur gültig bleibt. |
|
Zertifikate
|
data.certificates | array of object |
Die von den Signaturen verwendeten Zertifikate. |
|
Elemente
|
data.certificates | object | |
|
Zeitstempel
|
data.timestamps | array of object |
Die zeitstempel, die auf das Dokument angewendet wurden. |
|
Elemente
|
data.timestamps | object | |
|
Gültigkeitsdauer
|
metadata.validation_time | string |
Wann die Überprüfung durchgeführt wurde. |
Signieren: Erstellen eines freigegebenen Links
Erstellt einen Signaturlink, den jeder öffnen kann, um die Dokumente zu signieren. Sie liefern es selbst.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-IDs
|
documents | True | array of string |
Die Dokumente, die die Verknüpfungszeichen signiert. Verwenden Sie Dokument-ID-Werte aus Upload- oder Listenschritten. |
|
Rückruf-URL
|
callback_url | string |
Eine URL, die benachrichtigt werden soll, wenn das Dokument signiert ist. |
|
|
Ablauf nach (Minuten)
|
expire_after | integer |
Minuten bis zum Ablauf des Links. Der Standardwert ist 2880 (zwei Tage). |
|
|
Dokument nach (Minuten) löschen
|
delete_document_after | integer |
Minuten bis das Dokument aus dem Arbeitsbereich gelöscht wird. Standardmäßig wird sie beibehalten. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
|
Signierungslink
|
data.signing_link | string |
Der Link, den jeder zum Signieren öffnen kann. |
|
Signaturlink-ID
|
data.signing_link_id | string |
Die ID des Links für "Signieren: Link löschen". |
|
Gültig bis
|
data.valid_until | integer |
Wenn der Link abläuft, als Unix-Zeitstempel. |
Signieren: Erstellen von Signierlinks
Erstellt einen persönlichen Signaturlink für jeden Signierer. Sie übermitteln die Links selbst, z. B. per E-Mail oder Teams-Nachricht.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-IDs
|
documents | True | array of string |
Die Dokumente zum Erstellen von Signaturlinks Verwenden Sie Dokument-ID-Werte aus Upload- oder Listenschritten. |
|
Signierer-ID
|
id | string |
Ihre eigene ID für den Signierer, eindeutig innerhalb der Anforderung. Erforderlich, wenn E-Mails leer sind. |
|
|
Vorname
|
name | string |
Der Vorname des Signierers. |
|
|
Nachname
|
surname | string |
Der Nachname des Signierers. |
|
|
E‑Mail
|
Die E-Mail-Adresse des Signierers. Erforderlich, wenn die Signierer-ID leer ist. |
|||
|
Persönlicher Code
|
personal_code | string |
Der persönliche Code des Signierers. Erforderlich, wenn die Authentifizierung erforderlich ist. |
|
|
Authentifizierung erforderlich
|
authentication_required | boolean |
Wenn ja, muss der Signierer seine Identität überprüfen, bevor er den Link öffnet. |
|
|
Position (nur ADoc)
|
position | string |
Die Position des Signierers, die in ADoc-Signaturen angezeigt wird. |
|
|
Abteilung (nur ADoc)
|
structural_subdivision | string |
Die Abteilung des Signierers, die in ADoc-Signaturen angezeigt wird. |
|
|
Signierungszweck (nur ADoc)
|
signing_purpose | string |
Warum die Person signiert, in ADoc-Signaturen angezeigt. |
|
|
Rückruf-URL
|
callback_url | string |
Eine URL, die benachrichtigt werden soll, wenn das Dokument signiert ist. |
|
|
Ablehnungsrückruf-URL
|
reject_callback_url | string |
Eine URL, die benachrichtigt werden soll, wenn ein Signierer das Dokument ablehnt. |
|
|
Ablauf nach (Minuten)
|
expire_after | integer |
Minuten bis zum Ablauf des Links. Der Standardwert ist 2880 (zwei Tage). |
|
|
Schaltfläche "Ablehnen" anzeigen
|
show_reject_button | boolean |
Gibt an, ob Signierer das Dokument auf der Signaturseite ablehnen können. Der Standardwert ist ja. |
|
|
Dokument nach (Minuten) löschen
|
delete_document_after | integer |
Minuten bis das Dokument aus dem Arbeitsbereich gelöscht wird. Standardmäßig wird sie beibehalten. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
|
Signieren von Links:
|
temporary_signing_links | array of object |
Ein Signaturlink pro Signierer. |
|
Signierer-ID
|
temporary_signing_links.id | string |
Ihre eigene ID für den Signierer. |
|
Vorname
|
temporary_signing_links.member_name | string |
Der Vorname des Signierers. |
|
Nachname
|
temporary_signing_links.member_surname | string |
Der Nachname des Signierers. |
|
E‑Mail
|
temporary_signing_links.member_email | string |
Die E-Mail-Adresse des Signierers. |
|
Signierungslink
|
temporary_signing_links.temporary_signing_link | string |
Der Link, den der Signierer öffnet, um das Dokument zu signieren. |
|
Signaturlink-ID
|
temporary_signing_links.temporary_signing_link_id | string |
Die ID des Signierlinks. |
|
Gültig bis
|
temporary_signing_links.valid_until | integer |
Wenn der Link abläuft, als Unix-Zeitstempel. |
|
Dokumente:
|
documents | array of object |
Die Dokumente, für die die Links erstellt wurden. |
|
Dokument-ID
|
documents.uuid | string |
Die ID des Dokuments. |
|
Dateiname
|
documents.filename | string |
Der Name der Dokumentdatei. |
Signieren: Link löschen
Löscht einen Signiererlink oder einen freigegebenen Link, bevor er abläuft. Einladungslinks können nicht gelöscht werden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Signaturlink-ID
|
temporarySigningLinkId | True | string |
Die Signaturlink-ID aus der Ausgabe von "Signieren: Signiererlinks erstellen" oder "Signieren: Freigegebenen Link erstellen". |
Gibt zurück
- Body
- AcknowledgedResponse
Signieren: Nach URL einladen
Fügt dem Dokument einen Signierer hinzu, ohne eine E-Mail zu senden, und gibt dessen persönlichen Einladungslink zurück, über den Sie übermitteln können. Der Link läuft nicht ab und kann nicht gelöscht werden; verwenden Sie "Signieren: Signiererlinks erstellen", wenn Sie Links benötigen, die Sie widerrufen können.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
|
Vorname
|
name | True | string |
Der Vorname des Signierers. |
|
Nachname
|
surname | True | string |
Der Nachname des Signierers. |
|
E‑Mail
|
True |
Die E-Mail-Adresse des Signierers. |
||
|
Erfolgs-URL
|
success_url | string |
Wo der Signierer nach Abschluss der Signierung gesendet werden soll. |
|
|
Purpose
|
purpose | string |
Warum die Person eingeladen wird. Wählen Sie "Überprüfen" aus, um nur zur Anzeige einzuladen. |
|
|
Rückruf-URL
|
callback_url | string |
Eine URL, die benachrichtigt werden soll, wenn das Dokument signiert ist. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
|
Einladungs-URL
|
data.invitation_url | string |
Der Link zur persönlichen Signaturseite zum Übermitteln an den Signierer. |
Signieren: Per E-Mail einladen
Lädt eine Person ein, das Dokument zu signieren. Mark Sign sendet die Einladung per E-Mail.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
|
Vorname
|
name | True | string |
Der Vorname des Signierers. |
|
Nachname
|
surname | True | string |
Der Nachname des Signierers. |
|
E‑Mail
|
True |
Die E-Mail-Adresse des Signierers. |
||
|
Language
|
language | string |
Die Sprache der Einladung. Der Standardwert ist Litauisch. |
|
|
Erfolgs-URL
|
success_url | string |
Wo der Signierer nach Abschluss der Signierung gesendet werden soll. |
|
|
Purpose
|
purpose | string |
Warum die Person eingeladen wird. Wählen Sie "Überprüfen" aus, um nur zur Anzeige einzuladen. |
|
|
Rückruf-URL
|
callback_url | string |
Eine URL, die benachrichtigt werden soll, wenn das Dokument signiert ist. |
Gibt zurück
- Body
- AcknowledgedResponse
Signieren: Warten auf alle Signierer
Wartet, bis jeder Signierer das Dokument signiert hat oder jemand das Dokument abgelehnt hat, und ermöglicht dann den Ablauf. Endet mit dem timed_out Status, wenn die Zeit ausläuft.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
|
Timeout (Minuten)
|
timeout_minutes | integer |
Wie lange warten Sie in Minuten, bevor Sie mit dem timed_out Status enden. Der Standardwert ist 41760 (29 Tage), maximal 43200 (30 Tage). |
Gibt zurück
- Body
- SigningWaitResponse
Signieren: Warten auf den nächsten Signierer
Wartet, bis der nächste Signierer das Dokument signiert oder ablehnt, ohne Einladungen zu senden. Verwenden Sie sie in einer Schleife, um auf mehrere Signierer zu warten, ohne abfragen zu müssen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
Gibt zurück
- Body
- SigningEvent
Signieren: Warten Auf einen Signierer
Wartet, bis ein bestimmter Signierer das Dokument signiert, und der Fluss wird fortgesetzt. Endet mit dem timed_out Status, wenn die Zeit ausläuft.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dokument-ID
|
documentId | True | string |
Die ID des Dokuments aus der Ausgabe von "Document: Upload", "Document: Upload as container" oder "Document: List". |
|
Signierer-E-Mail
|
signer_email | True | string |
Die E-Mail des Signierers, auf die gewartet werden soll, die gleiche E-Mail, die beim Einladen verwendet wird. |
|
Timeout (Minuten)
|
timeout_minutes | integer |
Wie lange warten Sie in Minuten, bevor Sie mit dem timed_out Status enden. Der Standardwert ist 41760 (29 Tage), maximal 43200 (30 Tage). |
Gibt zurück
- Body
- SigningWaitResponse
Definitionen
SigningEvent
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Dokument-ID
|
uuid | string |
Die ID des Dokuments. |
|
Dokumentstatus
|
status | string |
Der Signaturstatus des Dokuments, z. B. signiert oder signed_partially. Eine Ablehnung wird in den Signierstatus angezeigt. |
|
Signiereranzahl
|
members_count | integer |
Wie viele Personen zum Signieren eingeladen wurden. |
|
Signierte Anzahl
|
signed_members_count | integer |
Wie viele Personen signiert haben. |
|
Unterzeichner:
|
members | array of object |
Jeder eingeladen, sich anzumelden. |
|
Signierer-ID
|
members.id | string |
Die ID des Signierers. |
|
Vorname
|
members.member_name | string |
Der Vorname des Signierers. |
|
Nachname
|
members.member_surname | string |
Der Nachname des Signierers. |
|
E‑Mail
|
members.member_email | string |
Die E-Mail-Adresse des Signierers. |
|
Signaturstatus
|
members.status | string |
Der Signierstatus, z. B. ausstehend, signiert oder abgelehnt. |
AcknowledgedResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Der Status der Anforderung. |
SigningWaitResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Dokumentstatus
|
document_status | string |
Wie das Warten beendet wurde: signiert, abgelehnt oder timed_out. |
|
Abgelehnt von
|
rejected_by | string |
Wer das Dokument abgelehnt hat, wenn es abgelehnt wurde. |
|
Ablehnungsgrund
|
rejection_reason | string |
Der Grund, den der Signierer gegeben hat, wenn das Dokument abgelehnt wurde. |
RequestStatus
Datei
Dies ist der grundlegende Datentyp "Datei".