Freigeben über


Zoho-Zeichen

Zohos Sign ist eine vollständige digitale Signatur-App, mit der Geschäftsdokumente mit vollständiger Sicherheit und Zuverlässigkeit digital signiert werden können.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm 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 Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Zoho-Signier-API-Unterstützung
URL https://www.zoho.com/sign/contact.html
Email support@zohosign.com
Connectormetadaten
Herausgeber Zoho Corporation
Webseite https://www.zoho.com/sign/
Datenschutzrichtlinie https://www.zoho.com/privacy.html
Kategorien Inhalt und Dateien; Produktivität

Digitales Signieren von Geschäftsdokumenten online mit vollständiger Sicherheit und Zuverlässigkeit mithilfe der E-Signatur-Software von Zoho. Automatisieren Sie Ihre Transaktionen mit einfachen E-Sign-Dokumentworkflows. Eine vollständige digitale Signatur-App für Geschäftssignaturen.

Voraussetzungen

Um diesen Connector zu verwenden, müssen Sie Zoho-Sign Konto auf der Zoho-Sign-Plattform bezahlt haben. Ausführliche Informationen finden Sie hier https://www.zoho.com/sign/pricing-api.html auch unter "# https://zoho.com/sign #How", um Anmeldeinformationen abzurufen. Die Zoho-Sign-API verwendet OAuth 2 zur Authentifizierung. Sobald das Konto eingerichtet ist, sind also keine zusätzlichen Schritte erforderlich.

Alle Zoho-Sign-APIs erfordern diesen obligatorischen Header: Autorisierung – Authentifizierungsanforderungsheader.

Informationen zu Tokengenerationen finden Sie unter: https://www.zoho.com/sign/api/#getting-started

Erste Schritte mit Ihrem Connector

Zoho Sign Connector bietet Benutzern die Möglichkeit, Dokumentverwaltung, Vorlagenverwaltung und andere Vorgänge direkt durchzuführen, ohne auf die Webschnittstelle von Zoho Sign zuzugreifen

Unter Dokument-Manager können Benutzer mithilfe dieser Connectors Dokumente erstellen, Dokumente aktualisieren, Dokumente für Signaturen senden und eine Liste aller Dokumente im Zusammenhang mit Ihrem Konto abrufen.

Siehe auch für andere Vorgänge den Titel "WAS SIND DIE UNTERSTÜTZTEN VORGÄNGE?" im folgenden Link,

https://www.zoho.com/sign/api/#introduction

Diese Connectors helfen Ihnen bei der Automatisierung der Verwendung direkt aus dem Dokument oder der Vorlage, die an die Statusverfolgung gesendet wird, und vieles mehr.

Häufige Fehler und Abhilfemaßnahmen

Debuggen Sie sie bei einem Fehler mit den richtigen Fehlercodes und deren Grund.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe 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 Erforderlich
Wählen Sie die Region aus. Schnur Wählen Sie die Domäne aus. Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen bestimmter Vorlagendetails

Zeigt die Details einer bestimmten Dokumentvorlage an.

Abrufen eines Dokuments

Zeigt die Details eines bestimmten Umschlags an.

Abrufen von Daten der abgeschlossenen Anforderung

Zeigt die Details eines signierten Umschlags an.

Abschlusszertifikat herunterladen

Lädt das Abschlusszertifikat eines bestimmten Umschlags herunter.

Aktualisieren der Eigenschaften einer erstellten Anforderung

Aktualisieren der Eigenschaften einer erstellten Anforderung

Aufrufen der API

Aufrufen der API

Datei herunterladen

Lädt ein bestimmtes Dokument oder eine bestimmte Datei herunter.

Dokument herunterladen

Lädt einen bestimmten Umschlag herunter.

Dokument löschen

Löschen eines bestimmten Dokuments

Erinnerung für Empfänger

Senden Sie eine Erinnerung an Empfänger eines bestimmten Dokuments.

Erstellen eines Dokuments zum Signieren

Eine Aktion zum Erstellen eines Dokuments zum Signieren durch Hochladen einer Datei.

Liste der Vorlagen abrufen

Zeigt eine Liste aller erstellten Dokumentvorlagen an.

SendSignRequest

Senden des hochgeladenen Dokuments zur Signatur

Zurückrufen eines bestimmten Dokuments

Zurückrufen eines bestimmten Dokuments

Abrufen bestimmter Vorlagendetails

Zeigt die Details einer bestimmten Dokumentvorlage an.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Liste der Vorlagen
template_id True string

Liste der Vorlagen

Abrufen eines Dokuments

Zeigt die Details eines bestimmten Umschlags an.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
RequestId True integer

Anfrage-ID

Gibt zurück

Name Pfad Typ Beschreibung
Code
code integer

Code

request_status
requests.request_status string

Status der Anforderung

Notizen
requests.notes string

Hinweise

attachments
requests.attachments array of

Attachments

reminder_period
requests.reminder_period integer

Erinnerungszeitraum

owner_id
requests.owner_id string

Besitzer-ID

Beschreibung
requests.description string

Beschreibung der Anforderung

request_name
requests.request_name string

Name der Anforderung

modified_time
requests.modified_time integer

Änderungszeit

action_time
requests.action_time integer

Aktionszeit

is_deleted
requests.is_deleted boolean

Löschen des Status der Anforderung

expiration_days
requests.expiration_days integer

Ablauftage

is_sequential
requests.is_sequential boolean

Sequenzieller Status

sign_submitted_time
requests.sign_submitted_time integer

Signierzeit

owner_first_name
requests.owner_first_name string

Vorname des Besitzers

sign_percentage
requests.sign_percentage float

Signierprozentsatz

expire_by
requests.expire_by integer

Ablaufdatum des Dokuments

is_expiring
requests.is_expiring boolean

Dokument läuft ab am

owner_email
requests.owner_email string

E-Mail-ID des Besitzers

created_time
requests.created_time integer

Zeitpunkt der Erstellung des Dokuments

email_reminders
requests.email_reminders boolean

Senden von Erinnerungen per E-Mail

document_ids
requests.document_ids array of object

Dokument-IDs

image_string
requests.document_ids.image_string string

Bildzeichenfolge

document_name
requests.document_ids.document_name string

Dokumentname

pages
requests.document_ids.pages array of object

pages

image_string
requests.document_ids.pages.image_string string

Bildzeichenfolge

Seite
requests.document_ids.pages.page integer

Seite

is_thumbnail
requests.document_ids.pages.is_thumbnail boolean

Status der Miniaturansicht

document_size
requests.document_ids.document_size integer

Größe des Dokuments

document_order
requests.document_ids.document_order string

Dokumentreihenfolge

total_pages
requests.document_ids.total_pages integer

Gesamtanzahl der Seiten im Dokument

document_id
requests.document_ids.document_id string

Dokument-ID

self_sign
requests.self_sign boolean

Self sign status

sign_id
requests.sign_id string

Sign-ID

folder_name
requests.folder_name string

Name des Ordners

in_process
requests.in_process boolean

Im Prozessstatus

Gültigkeit
requests.validity integer

Gültigkeit des Dokuments

request_type_name
requests.request_type_name string

Anforderungstypname

folder_id
requests.folder_id string

Ordner-ID

Anfrage_ID
requests.request_id string

Anforderungs-ID

request_type_id
requests.request_type_id string

Anforderungstyp-ID

owner_last_name
requests.owner_last_name string

Nachname des Besitzers

Handlungen
requests.actions array of object

Handlungen

verify_recipient
requests.actions.verify_recipient boolean

E-Mail-ID des Empfängers überprüfen

action_type
requests.actions.action_type string

Aktionstyp

private_notes
requests.actions.private_notes string

Private Notizen

recipient_email
requests.actions.recipient_email string

E-Mail-ID des Empfängers

send_completed_document
requests.actions.send_completed_document boolean

Status des abgeschlossenen Sendedokuments

verification_type
requests.actions.verification_type string

Überprüfungstyp

allow_signing
requests.actions.allow_signing boolean

Signierungsstatus zulassen

recipient_phonenumber
requests.actions.recipient_phonenumber string

Telefonnummer des Empfängers

is_bulk
requests.actions.is_bulk boolean

Status des Massenvorgangs

action_id
requests.actions.action_id string

Aktions-ID

is_revoked
requests.actions.is_revoked boolean

Status des Widerrufs

is_embedded
requests.actions.is_embedded boolean

Status des eingebetteten Bereichs

signing_order
requests.actions.signing_order integer

Signierreihenfolge

recipient_name
requests.actions.recipient_name string

Name des Angerufenen

action_status
requests.actions.action_status string

Status einer Aktion

recipient_countrycode
requests.actions.recipient_countrycode string

Empfängerlandcode

ishost
requests.actions.ishost boolean

Hostverwendungsstatus

language
requests.actions.language string

language

in_person_name
requests.actions.in_person_name string

Im Personennamen

in_person_email
requests.actions.in_person_email string

Persönliche E-Mail

verification_code
requests.actions.verification_code string

Überprüfungscode

attachment_size
requests.attachment_size integer

Größe der Anlage

message
message string

message

status
status string

status

Abrufen von Daten der abgeschlossenen Anforderung

Zeigt die Details eines signierten Umschlags an.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
request_id True integer

Anforderungs-ID

Gibt zurück

Name Pfad Typ Beschreibung
Code
code integer

Code

request_name
document_form_data.request_name string

Anforderungsname

zsdocumentid
document_form_data.zsdocumentid string

Zoho Sign Documentid

Handlungen
document_form_data.actions array of object

Handlungen

signed_time
document_form_data.actions.signed_time string

Signierte Uhrzeit

action_type
document_form_data.actions.action_type string

Aktionstyp

recipient_email
document_form_data.actions.recipient_email string

E-Mail-Adresse des Empfängers

recipient_name
document_form_data.actions.recipient_name string

Name des Angerufenen

fields
document_form_data.actions.fields array of object

fields

field_label
document_form_data.actions.fields.field_label string

Feldbezeichnung

field_value
document_form_data.actions.fields.field_value string

Feldwert

field_name
document_form_data.actions.fields.field_name string

Feldname

status
status string

status

Abschlusszertifikat herunterladen

Lädt das Abschlusszertifikat eines bestimmten Umschlags herunter.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
request_id True integer

Anfrage-ID

Gibt zurück

response
file

Aktualisieren der Eigenschaften einer erstellten Anforderung

Aktualisieren der Eigenschaften einer erstellten Anforderung

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
RequestId True string

Anfrage-ID

Dokumenttyp
request_type_id string

request_type_id

Dokumentname
request_name True string

Name des Dokuments (Anforderung)

Empfängername
recipient_name string

Name des Angerufenen

Empfänger-E-Mail
recipient_email string

E-Mail-Adresse des Empfängers

Rufnummer
recipient_phonenumber string

Telefonnummer des Empfängers für den SMS-Authentifizierungsmodus.

Ländercode
recipient_countrycode string

Ländercode der Telefonnummer des Empfängers für den SMS-Authentifizierungsmodus.

Aktionstyp
action_type string

Wählen Sie aus, ob es sich bei dem Empfänger um einen Signierer oder einen Viewer oder einen Genehmigenden oder einen InpersonSigner handelt.

Private Notizen
private_notes string

Private Notizen

Signierreihenfolge
signing_order integer

Signierreihenfolge

Authentifizierung für Empfänger benötigen
verify_recipient boolean

Gibt an, ob der Empfänger von einem der Authentifizierungsmodi überprüft werden muss.

Authentifizierungsübermittlungstyp
verification_type string

Überprüfungstyp

Überprüfungscode
verification_code string

6-stelliger Überprüfungscode für den OFFLINE-Überprüfungsmodus.

Tage bis zum Abschluss
expiration_days integer

Die Anzahl der Tage, die für das Dokument verbleiben, um abgelaufen zu sein.

Senden in der Reihenfolge
is_sequential boolean

Zulassen, dass sich Empfänger in der angegebenen Reihenfolge anmelden.

Automatische Erinnerungen
email_reminders boolean

Aktivieren Sie regelmäßige Erinnerungen für die Empfänger, um das Dokument zu signieren.

Senden Eines Rests alle - (Tage)
reminder_period integer

Geben Sie das Zeitintervall an, in dem eine Erinnerung für die Signatur an die Empfänger gesendet werden soll.

Ordner
folder_id string

eindeutige Ordner-ID

Hinweise
notes html

Notizen für alle Empfänger.

Gibt zurück

Name Pfad Typ Beschreibung
Code
code integer

Code

message
message string

message

status
status string

status

Aufrufen der API

Aufrufen der API

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
URL-Pfad
url True string

Url-Pfad angeben

Methode
method True string

Zu verwendende Select-API-Methode

Gibt zurück

response
object

Datei herunterladen

Lädt ein bestimmtes Dokument oder eine bestimmte Datei herunter.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
request_id True integer

Anfrage-ID

Dokument-ID
document_id True integer

Dokument-ID

Gibt zurück

response
file

Dokument herunterladen

Lädt einen bestimmten Umschlag herunter.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
request_id True integer

Anfrage-ID

Gibt zurück

response
file

Dokument löschen

Löschen eines bestimmten Dokuments

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
request_id True integer

Anfrage-ID

Erinnerung für Empfänger

Senden Sie eine Erinnerung an Empfänger eines bestimmten Dokuments.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
request_id True integer

Anfrage-ID

Erstellen eines Dokuments zum Signieren

Eine Aktion zum Erstellen eines Dokuments zum Signieren durch Hochladen einer Datei.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Erstellen eines Dokuments
file True file

Erstellen eines Dokuments

Gibt zurück

Name Pfad Typ Beschreibung
Code
code integer

Code

request_status
requests.request_status string

Status der Anforderung

owner_email
requests.owner_email string

E-Mail-Adresse des Besitzers

created_time
requests.created_time integer

Erstellte Zeit

document_ids
requests.document_ids array of object

document_ids

image_string
requests.document_ids.image_string string

Bildzeichenfolge

document_name
requests.document_ids.document_name string

Dokumentname

pages
requests.document_ids.pages array of object

pages

image_string
requests.document_ids.pages.image_string string

Bildzeichenfolge

Seite
requests.document_ids.pages.page integer

Seite

is_thumbnail
requests.document_ids.pages.is_thumbnail boolean

is_thumbnail

document_size
requests.document_ids.document_size integer

Dokumentgröße

document_order
requests.document_ids.document_order string

Dokumentreihenfolge

total_pages
requests.document_ids.total_pages integer

Gesamtseiten

document_id
requests.document_ids.document_id string

Dokument-ID

Notizen
requests.notes string

Notizen

self_sign
requests.self_sign boolean

Selbstzeichen

owner_id
requests.owner_id string

Besitzer-ID

Beschreibung
requests.description string

Description

folder_name
requests.folder_name string

Ordnername

request_name
requests.request_name string

Anforderungsname

modified_time
requests.modified_time integer

Geänderte Uhrzeit

is_deleted
requests.is_deleted boolean

Status des Löschvorgangs

expiration_days
requests.expiration_days integer

Ablauftage

in_process
requests.in_process boolean

In Bearbeitung

is_sequential
requests.is_sequential boolean

Sequenzieller Status

request_type_name
requests.request_type_name string

Anforderungstypname

owner_first_name
requests.owner_first_name string

Vorname des Besitzers

folder_id
requests.folder_id string

Ordner-ID

Anfrage_ID
requests.request_id string

Anforderungs-ID

request_type_id
requests.request_type_id string

Anforderungstyp-ID

owner_last_name
requests.owner_last_name string

Nachname des Besitzers

sign_percentage
requests.sign_percentage integer

Signierprozentsatz

message
message string

Nachricht

status
status string

status

Liste der Vorlagen abrufen

Zeigt eine Liste aller erstellten Dokumentvorlagen an.

Gibt zurück

Name Pfad Typ Beschreibung
templates
templates array of object
template_id
templates.template_id string
template_name
templates.template_name string

Vorlagenname

SendSignRequest

Senden des hochgeladenen Dokuments zur Signatur

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
RequestId True string

Anfrage-ID

Gibt zurück

Name Pfad Typ Beschreibung
Code
code integer

Code

message
message string

message

status
status string

status

Zurückrufen eines bestimmten Dokuments

Zurückrufen eines bestimmten Dokuments

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anfrage-ID
request_id True integer

Anfrage-ID

Auslöser

Zoho-Zeichentrigger

Registrieren eines Rückrufs für ein bestimmtes Ereignis

Zoho-Zeichentrigger

Registrieren eines Rückrufs für ein bestimmtes Ereignis

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aktionen
webhook_actions True string

Webhook-Aktionen

Gibt zurück

Name Pfad Typ Beschreibung
request_status
requests.request_status string

Anforderungsstatus

Notizen
requests.notes string

Notizen

reminder_period
requests.reminder_period integer

Erinnerungszeitraum

owner_id
requests.owner_id string

Besitzer-ID

Beschreibung
requests.description string

Beschreibung

request_name
requests.request_name string

Anforderungsname

modified_time
requests.modified_time integer

Geänderte Zeit

action_time
requests.action_time integer

Aktionszeit

is_deleted
requests.is_deleted boolean

Status des gelöschten Vorgangs

expiration_days
requests.expiration_days integer

Ablauftage

is_sequential
requests.is_sequential boolean

Status des sequenziellen Vorgangs

sign_submitted_time
requests.sign_submitted_time integer

Signierzeit

owner_first_name
requests.owner_first_name string

Besitzer des Vornamens

sign_percentage
requests.sign_percentage integer

Signierprozentsatz

expire_by
requests.expire_by integer

Ablauf bis

owner_email
requests.owner_email string

E-Mail-Adresse des Besitzers

created_time
requests.created_time integer

Erstellte Zeit

email_reminders
requests.email_reminders boolean

E-Mail-Erinnerungen

document_ids
requests.document_ids array of object

Liste der Dokument-IDs

document_name
requests.document_ids.document_name string

Geben Sie den Dokumentnamen ein.

document_size
requests.document_ids.document_size integer

Größe des Dokuments

document_order
requests.document_ids.document_order string

Reihenfolge des Dokuments

total_pages
requests.document_ids.total_pages integer

Gesamtanzahl der Seiten im Dokument

document_id
requests.document_ids.document_id string

Dokument-ID

self_sign
requests.self_sign boolean

Status des Selbstzeichens

in_process
requests.in_process boolean

Status des Prozesses

Gültigkeit
requests.validity integer

Gültigkeit

request_type_name
requests.request_type_name string

Anforderungstypname

decline_reason
requests.decline_reason string

Grund ablehnen

Anfrage_ID
requests.request_id string

Anforderungs-ID

request_type_id
requests.request_type_id string

Anforderungstyp-ID

owner_last_name
requests.owner_last_name string

Nachname des Besitzers

Handlungen
requests.actions array of object

Handlungen

verify_recipient
requests.actions.verify_recipient boolean

Empfänger überprüfen

action_type
requests.actions.action_type string

Aktionstyp

private_notes
requests.actions.private_notes string

Private Notizen

recipient_email
requests.actions.recipient_email string

E-Mail-Adresse des Empfängers

allow_signing
requests.actions.allow_signing boolean

Status der Signierung

recipient_phonenumber
requests.actions.recipient_phonenumber string

Telefonnummer des Empfängers

is_bulk
requests.actions.is_bulk boolean

Status der Massenaktion

action_id
requests.actions.action_id string

Aktions-ID

is_revoked
requests.actions.is_revoked boolean

Status des Widerrufs

is_embedded
requests.actions.is_embedded boolean

Status des eingebetteten Bereichs

signing_order
requests.actions.signing_order integer

Signierreihenfolge

recipient_name
requests.actions.recipient_name string

Name des Angerufenen

action_status
requests.actions.action_status string

Status einer Aktion

recipient_countrycode
requests.actions.recipient_countrycode string

Ländercode des Empfängers

performed_by_email
notifications.performed_by_email string

Von E-Mail ausgeführt

performed_at
notifications.performed_at integer

Durchgeführt am

Grund
notifications.reason string

Ursache

activity
notifications.activity string

Activity

operation_type
notifications.operation_type string

Vorgangstyp

action_id
notifications.action_id string

Aktions-ID

performed_by_name
notifications.performed_by_name string

Nach Name ausgeführt

signing_order
notifications.signing_order integer

Signierreihenfolge

ip_address
notifications.ip_address string

IP-Adresse

Definitionen

file

Dies ist der grundlegende Datentyp "Datei".

Objekt

Dies ist der Typ 'object'.