Compartir a través de


Zoho Sign

Zoho's Sign es una aplicación de firma digital completa que ayuda a firmar digitalmente documentos empresariales con seguridad y confiabilidad completos

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Compatibilidad con zoho Sign API
URL https://www.zoho.com/sign/contact.html
Correo Electrónico support@zohosign.com
Metadatos del conector
Publicador Zoho Corporation
Sitio web https://www.zoho.com/sign/
Directiva de privacidad https://www.zoho.com/privacy.html
Categorías Contenido y archivos; Productividad

Firmar digitalmente documentos empresariales en línea con seguridad completa y confiabilidad mediante el software de firma electrónica de Zoho. Automatice las transacciones con flujos de trabajo de documentos de firma electrónica simples. Una aplicación de firma digital completa para firmantes empresariales.

Prerrequisitos

Para poder usar este conector, debe haber pagado por Zoho-Sign cuenta en la plataforma de Zoho-Sign. Para obtener más información, consulte https://www.zoho.com/sign/pricing-api.html También puede configurar una cuenta aquí https://zoho.com/sign ##How para obtener las credenciales. La API de Zoho-Sign usa OAuth 2 para autenticarse. Por lo tanto, una vez que la cuenta no esté configurada, no se requieren pasos adicionales.

Todas las API de zoho Sign requieren este encabezado obligatorio: Authorization - Authentication request header (Autorización: encabezado de solicitud de autenticación).

Para las generaciones de tokens, consulte: https://www.zoho.com/sign/api/#getting-started

Introducción al conector

Zoho Sign Connector proporciona la opción para que los usuarios realicen la administración de documentos, la administración de plantillas y otras operaciones directamente, sin tener acceso a la interfaz web de Zoho Sign.

En el administrador de documentos, con estos conectores, los usuarios pueden crear documentos, actualizar documentos, enviar documentos para firmas y obtener una lista de todos los documentos relacionados con su cuenta.

De forma similar para otras operaciones, consulte el título "¿QUÉ SON LAS OPERACIONES ADMITIDAS?" en el vínculo siguiente,

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

Estos conectores le ayudarán a automatizar el uso, directamente desde el documento o la plantilla que se envían al seguimiento de estado y mucho más.

Errores y soluciones comunes

En caso de error, depure con los códigos de error adecuados y su motivo.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Seleccione la región. cuerda / cadena Seleccione el dominio. Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualización de las propiedades de una solicitud creada

Actualización de las propiedades de una solicitud creada

Creación de un documento para la firma

Acción para crear un documento para firmar mediante la carga de un archivo.

Descargar archivo

Descarga un documento o archivo específico

Descargar certificado de finalización

Descarga el certificado de finalización de un sobre específico

Descargar documento

Descarga un sobre específico

Eliminar documento

Eliminar un documento determinado

Invocar API

Invocar API

Obtención de datos de la solicitud completada

Muestra los detalles de un sobre firmado

Obtención de detalles de plantilla concretos

Muestra los detalles de una plantilla de documento específica

Obtener la lista de plantillas

Muestra una lista de todas las plantillas de documento creadas

Obtener un documento

Muestra los detalles de un sobre específico

Recordatorio para destinatarios

Envíe un recordatorio a los destinatarios de un documento determinado.

Recuperar un documento determinado

Recuperar un documento determinado

SendSignRequest

Envío del documento cargado para la firma

Actualización de las propiedades de una solicitud creada

Actualización de las propiedades de una solicitud creada

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
RequestId True string

Id. de solicitud

Tipo documento
request_type_id string

request_type_id

Nombre del documento
request_name True string

Nombre del documento (solicitud)

Nombre del destinatario
recipient_name string

Nombre del destinatario

Correo electrónico del destinatario
recipient_email string

Correo electrónico del destinatario

Número de teléfono
recipient_phonenumber string

Número de teléfono del destinatario para el modo de autenticación SMS.

Código de país
recipient_countrycode string

Código de país del número de teléfono del destinatario para el modo de autenticación SMS.

TipoDeAcción
action_type string

Seleccione si el destinatario es un firmante o un visor o un aprobador o un inpersonSigner.

Notas privadas
private_notes string

Notas privadas

Orden de firma
signing_order integer

Orden de firma

Necesidad de autenticación para el destinatario
verify_recipient boolean

Si el destinatario debe comprobarse mediante uno de los modos de autenticación.

Tipo de entrega de autenticación
verification_type string

Tipo de verificación

Código de verificación
verification_code string

Código de verificación de 6 dígitos para el modo de verificación OFFLINE.

Días para completar
expiration_days integer

Número de días que quedan para que el documento expire.

Enviar en orden
is_sequential boolean

Permitir que los destinatarios inicien sesión en el orden especificado.

Recordatorios automáticos
email_reminders boolean

Habilite los recordatorios periódicos para que los destinatarios firmen el documento.

Enviar un resto cada - (días)
reminder_period integer

Especifique el intervalo de tiempo en el que se enviará un aviso para la firma a los destinatarios.

Carpeta
folder_id string

id. único de carpeta

Notas
notes html

Notas para todos los destinatarios.

Devoluciones

Nombre Ruta de acceso Tipo Description
código
code integer

código

Mensaje
message string

Mensaje

estado
status string

estado

Creación de un documento para la firma

Acción para crear un documento para firmar mediante la carga de un archivo.

Parámetros

Nombre Clave Requerido Tipo Description
crear un documento
file True file

crear un documento

Devoluciones

Nombre Ruta de acceso Tipo Description
código
code integer

código

request_status
requests.request_status string

Estado de la solicitud

owner_email
requests.owner_email string

Correo electrónico del propietario

created_time
requests.created_time integer

Tiempo creado

document_ids
requests.document_ids array of object

document_ids

image_string
requests.document_ids.image_string string

Cadena de imagen

document_name
requests.document_ids.document_name string

Nombre del documento

pages
requests.document_ids.pages array of object

pages

image_string
requests.document_ids.pages.image_string string

Cadena de imagen

página
requests.document_ids.pages.page integer

página

is_thumbnail
requests.document_ids.pages.is_thumbnail boolean

is_thumbnail

document_size
requests.document_ids.document_size integer

Tamaño del documento

document_order
requests.document_ids.document_order string

Orden del documento

total_pages
requests.document_ids.total_pages integer

Total de páginas

document_id
requests.document_ids.document_id string

Id. de documento

notas
requests.notes string

notas

self_sign
requests.self_sign boolean

autofirma

owner_id
requests.owner_id string

id. de propietario

descripción
requests.description string

Description

folder_name
requests.folder_name string

Nombre de carpeta

request_name
requests.request_name string

Nombre de la solicitud

modified_time
requests.modified_time integer

hora de modificación

is_deleted
requests.is_deleted boolean

Estado de eliminación

expiration_days
requests.expiration_days integer

Días de expiración

in_process
requests.in_process boolean

En proceso

is_sequential
requests.is_sequential boolean

Estado secuencial

request_type_name
requests.request_type_name string

Nombre del tipo de solicitud

owner_first_name
requests.owner_first_name string

Nombre del propietario

folder_id
requests.folder_id string

Id. de carpeta

identificador_de_solicitud
requests.request_id string

Id. de solicitud

request_type_id
requests.request_type_id string

Id. de tipo de solicitud

owner_last_name
requests.owner_last_name string

Apellidos del propietario

sign_percentage
requests.sign_percentage integer

Porcentaje de signos

Mensaje
message string

Message

estado
status string

estado

Descargar archivo

Descarga un documento o archivo específico

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
request_id True integer

Id. de solicitud

Id. de documento
document_id True integer

Id. de documento

Devoluciones

response
file

Descargar certificado de finalización

Descarga el certificado de finalización de un sobre específico

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
request_id True integer

Id. de solicitud

Devoluciones

response
file

Descargar documento

Descarga un sobre específico

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
request_id True integer

Id. de solicitud

Devoluciones

response
file

Eliminar documento

Eliminar un documento determinado

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
request_id True integer

Id. de solicitud

Invocar API

Invocar API

Parámetros

Nombre Clave Requerido Tipo Description
Ruta de URL
url True string

Proporcionar la ruta de acceso url

Método
method True string

Selección del método de API que se va a usar

Devoluciones

response
object

Obtención de datos de la solicitud completada

Muestra los detalles de un sobre firmado

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
request_id True integer

Id. de solicitud

Devoluciones

Nombre Ruta de acceso Tipo Description
código
code integer

código

request_name
document_form_data.request_name string

Nombre de la solicitud

zsdocumentid
document_form_data.zsdocumentid string

Zoho Sign Documentid

Acciones
document_form_data.actions array of object

Acciones

signed_time
document_form_data.actions.signed_time string

Hora firmada

action_type
document_form_data.actions.action_type string

Tipo de acción

recipient_email
document_form_data.actions.recipient_email string

Correo electrónico del destinatario

recipient_name
document_form_data.actions.recipient_name string

Nombre del destinatario

fields
document_form_data.actions.fields array of object

fields

field_label
document_form_data.actions.fields.field_label string

Etiqueta de campo

field_value
document_form_data.actions.fields.field_value string

Valor de campo

field_name
document_form_data.actions.fields.field_name string

Nombre del campo

estado
status string

estado

Obtención de detalles de plantilla concretos

Muestra los detalles de una plantilla de documento específica

Parámetros

Nombre Clave Requerido Tipo Description
Lista de plantillas
template_id True string

Lista de plantillas

Obtener la lista de plantillas

Muestra una lista de todas las plantillas de documento creadas

Devoluciones

Nombre Ruta de acceso Tipo Description
templates
templates array of object
template_id
templates.template_id string
template_name
templates.template_name string

Nombre de la plantilla

Obtener un documento

Muestra los detalles de un sobre específico

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
RequestId True integer

Id. de solicitud

Devoluciones

Nombre Ruta de acceso Tipo Description
código
code integer

código

request_status
requests.request_status string

Estado de la solicitud

notas
requests.notes string

Notas

attachments
requests.attachments array of

Attachments

reminder_period
requests.reminder_period integer

Período de recordatorio

owner_id
requests.owner_id string

Id. del propietario

descripción
requests.description string

Descripción de la solicitud

request_name
requests.request_name string

Nombre de la solicitud

modified_time
requests.modified_time integer

Tiempo de modificación

action_time
requests.action_time integer

Tiempo de acción

is_deleted
requests.is_deleted boolean

Eliminar el estado de la solicitud

expiration_days
requests.expiration_days integer

Días de expiración

is_sequential
requests.is_sequential boolean

Estado secuencial

sign_submitted_time
requests.sign_submitted_time integer

Hora de enviar la firma

owner_first_name
requests.owner_first_name string

Nombre del propietario

sign_percentage
requests.sign_percentage float

Porcentaje de signos

expire_by
requests.expire_by integer

Fecha de expiración del documento

is_expiring
requests.is_expiring boolean

Expiración del documento

owner_email
requests.owner_email string

Identificador de correo electrónico del propietario

created_time
requests.created_time integer

Hora en que se creó el documento

email_reminders
requests.email_reminders boolean

Envío de recordatorios por correo electrónico

document_ids
requests.document_ids array of object

Identificadores de documento

image_string
requests.document_ids.image_string string

Cadena de imagen

document_name
requests.document_ids.document_name string

Nombre del documento

pages
requests.document_ids.pages array of object

pages

image_string
requests.document_ids.pages.image_string string

Cadena de imagen

página
requests.document_ids.pages.page integer

página

is_thumbnail
requests.document_ids.pages.is_thumbnail boolean

Estado de la miniatura

document_size
requests.document_ids.document_size integer

Tamaño del documento

document_order
requests.document_ids.document_order string

Orden del documento

total_pages
requests.document_ids.total_pages integer

Número total de páginas del documento

document_id
requests.document_ids.document_id string

Id. de documento

self_sign
requests.self_sign boolean

Estado del signo propio

sign_id
requests.sign_id string

Id. de inicio de sesión

folder_name
requests.folder_name string

Nombre de la carpeta

in_process
requests.in_process boolean

Estado del proceso

validez
requests.validity integer

Validez del documento

request_type_name
requests.request_type_name string

Nombre del tipo de solicitud

folder_id
requests.folder_id string

Id. de carpeta

identificador_de_solicitud
requests.request_id string

Id. de solicitud

request_type_id
requests.request_type_id string

Id. de tipo de solicitud

owner_last_name
requests.owner_last_name string

Apellidos del propietario

Acciones
requests.actions array of object

Acciones

verify_recipient
requests.actions.verify_recipient boolean

Comprobación del identificador de correo de destinatarios

action_type
requests.actions.action_type string

Tipo de acción

private_notes
requests.actions.private_notes string

Notas privadas

recipient_email
requests.actions.recipient_email string

Id. de correo electrónico del destinatario

send_completed_document
requests.actions.send_completed_document boolean

Estado del documento completado de envío

verification_type
requests.actions.verification_type string

Tipo de verificación

allow_signing
requests.actions.allow_signing boolean

Permitir el estado de firma

recipient_phonenumber
requests.actions.recipient_phonenumber string

Número de teléfono del destinatario

is_bulk
requests.actions.is_bulk boolean

Estado de masa

action_id
requests.actions.action_id string

Id. de acción

is_revoked
requests.actions.is_revoked boolean

Estado de revocación

is_embedded
requests.actions.is_embedded boolean

Estado de incrustado

signing_order
requests.actions.signing_order integer

Orden de firma

recipient_name
requests.actions.recipient_name string

Nombre del destinatario

action_status
requests.actions.action_status string

Estado de la acción

recipient_countrycode
requests.actions.recipient_countrycode string

Código de país del destinatario

ishost
requests.actions.ishost boolean

estado de uso del host

lenguaje
requests.actions.language string

lenguaje

in_person_name
requests.actions.in_person_name string

En nombre de persona

in_person_email
requests.actions.in_person_email string

Correo electrónico en persona

verification_code
requests.actions.verification_code string

Código de verificación

attachment_size
requests.attachment_size integer

Tamaño de los datos adjuntos

Mensaje
message string

Mensaje

estado
status string

estado

Recordatorio para destinatarios

Envíe un recordatorio a los destinatarios de un documento determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
request_id True integer

Id. de solicitud

Recuperar un documento determinado

Recuperar un documento determinado

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
request_id True integer

Id. de solicitud

SendSignRequest

Envío del documento cargado para la firma

Parámetros

Nombre Clave Requerido Tipo Description
Id. de solicitud
RequestId True string

Id. de solicitud

Devoluciones

Nombre Ruta de acceso Tipo Description
código
code integer

código

Mensaje
message string

Mensaje

estado
status string

estado

Desencadenadores

Desencadenadores de signo de Zoho

Registro de una devolución de llamada para un evento determinado

Desencadenadores de signo de Zoho

Registro de una devolución de llamada para un evento determinado

Parámetros

Nombre Clave Requerido Tipo Description
Acciones
webhook_actions True string

Acciones de webhook

Devoluciones

Nombre Ruta de acceso Tipo Description
request_status
requests.request_status string

estado de la solicitud

notas
requests.notes string

notas

reminder_period
requests.reminder_period integer

período de aviso

owner_id
requests.owner_id string

id. de propietario

descripción
requests.description string

descripción

request_name
requests.request_name string

Nombre de solicitud

modified_time
requests.modified_time integer

Hora de modificación

action_time
requests.action_time integer

Tiempo de acción

is_deleted
requests.is_deleted boolean

Estado de eliminado

expiration_days
requests.expiration_days integer

Días de expiración

is_sequential
requests.is_sequential boolean

Estado de la operación secuencial

sign_submitted_time
requests.sign_submitted_time integer

Hora de enviar la firma

owner_first_name
requests.owner_first_name string

Propietario del nombre

sign_percentage
requests.sign_percentage integer

Porcentaje de signos

expire_by
requests.expire_by integer

Expirar por

owner_email
requests.owner_email string

Correo electrónico del propietario

created_time
requests.created_time integer

Tiempo creado

email_reminders
requests.email_reminders boolean

Avisos por correo electrónico

document_ids
requests.document_ids array of object

Lista de identificadores de documento

document_name
requests.document_ids.document_name string

Escriba el nombre del documento.

document_size
requests.document_ids.document_size integer

Tamaño del documento

document_order
requests.document_ids.document_order string

Orden del documento

total_pages
requests.document_ids.total_pages integer

Número total de páginas del documento

document_id
requests.document_ids.document_id string

Id. de documento

self_sign
requests.self_sign boolean

Estado del signo propio

in_process
requests.in_process boolean

Estado de en proceso

validez
requests.validity integer

Validez

request_type_name
requests.request_type_name string

Nombre del tipo de solicitud

decline_reason
requests.decline_reason string

Motivo del rechazo

identificador_de_solicitud
requests.request_id string

Id. de solicitud

request_type_id
requests.request_type_id string

Id. de tipo de solicitud

owner_last_name
requests.owner_last_name string

Apellidos del propietario

Acciones
requests.actions array of object

Acciones

verify_recipient
requests.actions.verify_recipient boolean

Comprobar destinatario

action_type
requests.actions.action_type string

Tipo de acción

private_notes
requests.actions.private_notes string

Notas privadas

recipient_email
requests.actions.recipient_email string

Correo electrónico del destinatario

allow_signing
requests.actions.allow_signing boolean

Estado de la firma

recipient_phonenumber
requests.actions.recipient_phonenumber string

Número de teléfono del destinatario

is_bulk
requests.actions.is_bulk boolean

Estado de la acción masiva

action_id
requests.actions.action_id string

Id. de acción

is_revoked
requests.actions.is_revoked boolean

Estado de revocación

is_embedded
requests.actions.is_embedded boolean

Estado de incrustado

signing_order
requests.actions.signing_order integer

Orden de firma

recipient_name
requests.actions.recipient_name string

Nombre del destinatario

action_status
requests.actions.action_status string

Estado de la acción

recipient_countrycode
requests.actions.recipient_countrycode string

Código de país del destinatario

performed_by_email
notifications.performed_by_email string

Realizado por correo electrónico

performed_at
notifications.performed_at integer

Realizado en

reason
notifications.reason string

Motivo

actividad
notifications.activity string

Activity

operation_type
notifications.operation_type string

Tipo de operación

action_id
notifications.action_id string

Id. de acción

performed_by_name
notifications.performed_by_name string

Realizado por nombre

signing_order
notifications.signing_order integer

Orden de firma

ip_address
notifications.ip_address string

Dirección IP

Definiciones

archivo

Este es el tipo de datos básico "file".

objeto

Este es el tipo 'objeto'.