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.

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.

Erstellt einen Link, den jeder öffnen kann, um die Dokumente zu signieren, jeweils unter ihrer eigenen überprüften Identität.

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:

  1. Dokument: Hochladen (z. B. Dateiinhalt und Namenstoken aus SharePoint oder OneDrive).
  2. Signieren: Per E-Mail einladen. Markieren Sie die E-Mails der Einladung.
  3. Signieren: Warten Sie auf den nächsten Signierer. Der Ablauf wird hier angehalten, bis die Signatur erfolgt.
  4. 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_out Status endet. For Signing: Wait for next signer, set a Timeout (for example P29D) 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

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

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.

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.

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
email email

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.

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

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
email True email

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
email True email

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

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

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

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

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

Der Status der Anforderung.

Der Status der Anforderung.

Status
string

Datei

Dies ist der grundlegende Datentyp "Datei".