SigningHub (versión preliminar)
SigningHub es una solución completa para flujos de trabajo de aprobación de documentos, firmas digitales avanzadas y seguimiento del estado del documento. Está diseñado para optimizar rápidamente la forma en que las empresas entregan, revisan, aprueban y firman sus documentos empresariales
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 | |
|---|---|
| Correo Electrónico | support@ascertia.com |
| Metadatos del conector | |
|---|---|
| Publicador | Ascertia |
| Sitio web | https://www.signinghub.com |
| Directiva de privacidad | https://www.signinghub.com/privacy-policy/ |
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.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
|
Acerca de Signing |
Obtención de los detalles de la instancia de SigningHub |
| Agregar destinatario |
Adición de un destinatario al flujo de trabajo existente |
| Aplicar plantilla |
Aplicación de una plantilla proporcionada en el flujo de trabajo del documento |
| Aprobación de un documento |
El destinatario puede aprobar el flujo de trabajo en este turno |
| Carga de un documento en el flujo de trabajo |
Carga de un documento en un flujo de trabajo existente |
| Completar el flujo de trabajo (Finalizar en el medio) |
El propietario del flujo de trabajo puede completar el flujo de trabajo en cualquier fase para finalizarlo |
| Creación de un flujo de trabajo |
Creación de un nuevo flujo de trabajo dentro de SigningHub |
| Descarga de todos los documentos de un flujo de trabajo |
Descargue todos los documentos en formato extraído o comprimido de un flujo de trabajo existente desde SigningHub. |
| Descargar un documento determinado de un flujo de trabajo |
Descargar un documento determinado de un flujo de trabajo existente |
| Eliminación del destinatario de un flujo de trabajo |
Eliminación de un destinatario determinado de un flujo de trabajo existente |
| Eliminar un flujo de trabajo |
Eliminación del flujo de trabajo existente por el propietario del flujo de trabajo |
| Firmar documento |
Firma un documento mediante el usuario que ha iniciado sesión |
| Obtención de contects |
Obtener una lista de contactos relacionados con el usuario que ha iniciado sesión desde SigningHub |
| Obtención de detalles del flujo de trabajo |
Obtención de los detalles del flujo de trabajo |
| Obtención de flujos de trabajo |
Obtener una lista de flujos de trabajo de SigningHub para el usuario que ha iniciado sesión |
| Obtener los destinatarios |
Obtener una lista de destinatarios de un flujo de trabajo existente |
| Obtener plantillas |
Obtener una lista de todas las plantillas empresariales de SigningHub |
| Rechazar un documento |
El destinatario puede rechazar el flujo de trabajo en su turno |
| Uso compartido de un flujo de trabajo de documento |
Compartir un flujo de trabajo de documento al destinatario |
Acerca de SigningHub
Obtención de los detalles de la instancia de SigningHub
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Construir
|
aboutSigningHub.build | string |
Compilación de la instancia de SigningHub |
|
Derechos de autor
|
aboutSigningHub.copyright | string |
Copyright de SigningHub |
|
Nombre de instalación
|
aboutSigningHub.installation_name | string |
Nombre de instalación de la instancia de SigningHub |
|
US Patent No.
|
aboutSigningHub.patents.us_patent_no | string |
US Patent No. de SigningHub |
|
Versión
|
aboutSigningHub.version | string |
Versión de la instancia de SigningHub |
Agregar destinatario
Adición de un destinatario al flujo de trabajo existente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo existente |
|
Agregar campo de firma
|
addSignatureField | True | boolean |
Adición de un campo de firma al flujo de trabajo |
|
Id. de documento
|
documentId | integer |
Identificador del documento |
|
|
Notificación por correo electrónico
|
emailNotification | True | boolean |
Notificación por correo electrónico |
|
Solo yo
|
onlyMe | boolean |
El tipo de destinatario como solo yo |
|
|
Página No.
|
pageNo | integer |
Número de la página del documento |
|
|
Posición de página
|
pagePosition | True | string |
la posición de la página |
|
Página X
|
pageX | integer |
Posición horizontal en la página del documento |
|
|
Página Y
|
pageY | integer |
Posición vertical en la página del documento |
|
|
Rol
|
role | True | string |
Rol del destinatario |
|
Orden de firma
|
signingOrder | True | integer |
Orden de la firma del destinatario |
|
Correo electrónico del usuario
|
userEmail | True | string |
El correo electrónico del destinatario |
|
Nombre de usuario
|
userName | True | string |
Nombre del destinatario |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Destinatario agregado
|
recipientAdded | boolean |
Respuesta agregada del destinatario |
Aplicar plantilla
Aplicación de una plantilla proporcionada en el flujo de trabajo del documento
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
|
Id. de documento
|
documentId | True | integer |
Identificador del documento |
|
Aplicar a todos
|
applyToAll | True | boolean |
Aplicar a todos los documentos |
|
Nombre de plantilla
|
templateName | True | string |
Nombre de la plantilla aplicada |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Certificación habilitada
|
applyTemplate.certify.enabled | boolean |
Valor habilitado de certificación |
|
Permiso de certificación
|
applyTemplate.certify.permission | string |
Valor del permiso de certificación |
|
Alto del documento
|
applyTemplate.document_height | integer |
Alto del documento |
|
Id. de documento
|
applyTemplate.document_id | integer |
Identificador del documento |
|
Nombre del documento
|
applyTemplate.document_name | string |
Nombre del documento |
|
Orden del documento
|
applyTemplate.document_order | integer |
El orden del documento en el flujo de trabajo |
|
Páginas del documento
|
applyTemplate.document_pages | integer |
Total de páginas del documento |
|
Origen del documento
|
applyTemplate.document_source | string |
Origen del documento |
|
Tipo de documento
|
applyTemplate.document_type | string |
Tipo del documento |
|
Ancho del documento
|
applyTemplate.document_width | integer |
Ancho del documento |
|
Campos de formulario
|
applyTemplate.form_fields | boolean |
Disponibilidad de campos de formulario en el documento |
|
Bloquear campos de formulario
|
applyTemplate.lock_form_fields | boolean |
Valor habilitado de los campos de formulario de bloqueo |
|
Fecha de modificación
|
applyTemplate.modified_on | string |
Fecha de la modificación |
|
Solo para lectura
|
applyTemplate.template.read_only | boolean |
El único tipo listo de la plantilla |
|
Nombre de plantilla
|
applyTemplate.template.template_name | string |
Nombre de la plantilla aplicada |
|
Cargado en
|
applyTemplate.uploaded_on | string |
La fecha de la carga en |
Aprobación de un documento
El destinatario puede aprobar el flujo de trabajo en este turno
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
|
Motivo de aprobación
|
approveReason | string |
Motivo para aprobar el documento |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Documento aprobado
|
documentApproved | boolean |
Estado del documento aprobado |
Carga de un documento en el flujo de trabajo
Carga de un documento en un flujo de trabajo existente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo existente |
|
Contenido del documento
|
documentContent | True | byte |
Contenido del documento agregado en base64 |
|
Nombre del documento con extensión
|
documentName | True | string |
Nombre del documento agregado con extensión |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de documento
|
documentId | string |
Identificador del documento cargado |
Completar el flujo de trabajo (Finalizar en el medio)
El propietario del flujo de trabajo puede completar el flujo de trabajo en cualquier fase para finalizarlo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | string |
Identificador del flujo de trabajo |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Flujo de trabajo completado
|
workflowCompleted | boolean |
Estado del flujo de trabajo completado |
Creación de un flujo de trabajo
Creación de un nuevo flujo de trabajo dentro de SigningHub
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Contenido del documento
|
documentContent | True | string |
Contenido del documento en base64 |
|
Nombre del flujo de trabajo
|
documentName | True | string |
Creación de un nuevo flujo de trabajo dentro de SigningHub |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de documento
|
documentId | integer |
Identificador del documento |
|
Id. de paquete
|
packageId | integer |
Identificador del flujo de trabajo |
Descarga de todos los documentos de un flujo de trabajo
Descargue todos los documentos en formato extraído o comprimido de un flujo de trabajo existente desde SigningHub.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Contenido del flujo de trabajo
|
packageContent | byte |
El contenido del flujo de trabajo en la cadena base64 |
|
Tipo de flujo de trabajo
|
packageType | string |
Tipo del contenido del flujo de trabajo |
Descargar un documento determinado de un flujo de trabajo
Descargar un documento determinado de un flujo de trabajo existente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
|
Id. de documento
|
documentId | True | integer |
Identificador del documento |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Contenido del documento
|
documentContent | byte |
El contenido del documento en la cadena base64 |
|
Tipo de documento
|
documentType | string |
Tipo del documento |
Eliminación del destinatario de un flujo de trabajo
Eliminación de un destinatario determinado de un flujo de trabajo existente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
|
Pedido
|
order | True | integer |
El orden del destinatario eliminado |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Destinatario eliminado
|
recipientDeleted | boolean |
Estado eliminado del destinatario |
Eliminar un flujo de trabajo
Eliminación del flujo de trabajo existente por el propietario del flujo de trabajo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Flujo de trabajo eliminado
|
packageDeleted | boolean |
Respuesta eliminada del flujo de trabajo |
Firmar documento
Firma un documento mediante el usuario que ha iniciado sesión
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
|
Id. de documento
|
documentId | True | integer |
Identificador del documento |
|
Página No.
|
pageNo | True | integer |
Número de la página del documento |
|
Posición de página
|
pagePosition | True | string |
Posición en la página del documento |
|
Página X
|
pageX | integer |
Posición horizontal en la página del documento |
|
|
Página Y
|
pageY | integer |
Posición vertical en la página del documento |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre del documento
|
documentName | string |
Nombre del documento firmado |
|
Nombre del campo
|
fieldName | string |
Nombre del campo firmado |
|
Estado
|
status | string |
Estado del documento firmado |
Obtención de contects
Obtener una lista de contactos relacionados con el usuario que ha iniciado sesión desde SigningHub
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Enterprise
|
enterprise | boolean |
Lista de contactos de empresa |
|
|
Página No.
|
pageNo | True | integer |
Número de la página |
|
Registros por página
|
recordsPerPage | True | integer |
Número de registros por página |
|
Buscar texto
|
searchText | string |
Texto de búsqueda para filtrar la lista |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Correo electrónico del usuario
|
user_email | string |
El correo electrónico del usuario |
|
Nombre de usuario
|
user_name | string |
Nombre del usuario |
|
Identificador nacional de usuario
|
user_national_id | string |
Identificador nacional del usuario |
Obtención de detalles del flujo de trabajo
Obtención de los detalles del flujo de trabajo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Documentos
|
documents | array of object |
Documentos |
|
allowed_permissions
|
documents.certify.allowed_permissions | array of string |
allowed_permissions |
|
default_permission
|
documents.certify.default_permission | string |
default_permission |
|
enabled
|
documents.certify.enabled | boolean |
enabled |
|
created_on
|
documents.created_on | string |
created_on |
|
document_height
|
documents.document_height | integer |
document_height |
|
document_id
|
documents.document_id | integer |
document_id |
|
document_name
|
documents.document_name | string |
document_name |
|
document_order
|
documents.document_order | integer |
document_order |
|
document_pages
|
documents.document_pages | integer |
document_pages |
|
document_source
|
documents.document_source | string |
document_source |
|
document_type
|
documents.document_type | string |
document_type |
|
document_width
|
documents.document_width | integer |
document_width |
|
form_fields
|
documents.form_fields | boolean |
form_fields |
|
lock_form_fields
|
documents.lock_form_fields | boolean |
lock_form_fields |
|
modified_on
|
documents.modified_on | string |
modified_on |
|
template
|
documents.template | string |
template |
|
Carpeta
|
folder | string |
El tipo de carpeta |
|
Fecha de modificación
|
modified_on | string |
Fecha de modificación |
|
Siguiente firmante
|
next_signer | string |
El correo electrónico del siguiente firmante |
|
next_signer_email
|
next_signer_email | array of |
next_signer_email |
|
Nombre del propietario
|
owner_name | string |
Nombre para mostrar del propietario |
|
Id. de flujo de trabajo
|
package_id | integer |
Identificador del flujo de trabajo |
|
Nombre del flujo de trabajo
|
package_name | string |
Nombre del flujo de trabajo |
|
Propietario del flujo de trabajo
|
package_owner | string |
Propietario del flujo de trabajo |
|
Estado del paquete
|
package_status | string |
Estado actual del flujo de trabajo |
|
Cargado en
|
uploaded_on | string |
La fecha del flujo de trabajo cargado |
|
users
|
users | array of |
users |
|
Continuar con la disminución
|
workflow.continue_on_decline | boolean |
Continuar con la disminución del flujo de trabajo |
|
contacts
|
workflow.post_process.contacts | array of |
contacts |
|
Dropbox
|
workflow.post_process.dropbox | boolean |
Valor habilitado de Dropbox |
|
Unidad de Google
|
workflow.post_process.google_drive | boolean |
Valor habilitado para la unidad de Google |
|
Destinatarios de flujo de trabajo
|
workflow.post_process.workflow_recipients | boolean |
Valor de los destinatarios del flujo de trabajo |
|
Solo para lectura
|
workflow.read_only | boolean |
Valor de solo lectura del flujo de trabajo |
|
Modo de flujo de trabajo
|
workflow.workflow_mode | string |
Modo del flujo de trabajo |
|
Estado de flujo de trabajo
|
workflow.workflow_status | string |
Estado del flujo de trabajo |
|
Tipo de flujo de trabajo
|
workflow.workflow_type | string |
Tipo del flujo de trabajo |
Obtención de flujos de trabajo
Obtener una lista de flujos de trabajo de SigningHub para el usuario que ha iniciado sesión
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Estado del documento
|
documentStatus | True | string |
Estado del documento |
|
Carpeta
|
folder | True | string |
Carpeta del flujo de trabajo del usuario |
|
Página No.
|
pageNo | True | integer |
Número de la página del documento |
|
Registros por página
|
recordsPerPage | integer |
Número de registros por página |
|
|
Buscar texto
|
searchText | string |
Texto de búsqueda para filtrar la lista |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Carpeta
|
folder | string |
Carpeta del flujo de trabajo del usuario |
|
Fecha de modificación
|
modified_on | string |
Fecha de la modificación |
|
Siguiente firmante
|
next_signer | string |
El siguiente firmante del flujo de trabajo |
|
next_signer_email
|
next_signer_email | array of object |
next_signer_email |
|
user_email
|
next_signer_email.user_email | string |
user_email |
|
nombre_de_usuario
|
next_signer_email.user_name | string |
nombre_de_usuario |
|
Nombre del propietario
|
owner_name | string |
Nombre del propietario del flujo de trabajo |
|
Id. de flujo de trabajo
|
package_id | integer |
Identificador del flujo de trabajo |
|
Nombre del flujo de trabajo
|
package_name | string |
Nombre del flujo de trabajo |
|
Propietario del flujo de trabajo
|
package_owner | string |
El correo electrónico del propietario del flujo de trabajo |
|
Estado de flujo de trabajo
|
package_status | string |
Estado del flujo de trabajo |
|
Unread
|
unread | boolean |
Tipo no leído |
|
Cargado en
|
uploaded_on | string |
La fecha del flujo de trabajo cargado |
Obtener los destinatarios
Obtener una lista de destinatarios de un flujo de trabajo existente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
destinatarios
|
recipients | array of object |
destinatarios |
|
Delegado
|
recipients.delegatee | string |
Correo electrónico del delegado |
|
Nombre del delegado
|
recipients.delegatee_name | string |
Nombre del delegado |
|
Nombre del grupo
|
recipients.group_name | string |
Nombre del grupo |
|
Pedido
|
recipients.order | integer |
El orden del destinatario |
|
Placeholder
|
recipients.placeholder | string |
Valor del marcador de posición |
|
Estado del proceso
|
recipients.process_status | string |
Estado del marcador de posición |
|
Procesado como
|
recipients.processed_as | string |
Objeto procesado como valor |
|
Procesado por
|
recipients.processed_by | string |
El correo electrónico del procesado por |
|
Procesado en
|
recipients.processed_on | string |
La fecha del procesado |
|
Motivo
|
recipients.reason | string |
Motivo si existe |
|
Rol
|
recipients.role | string |
Rol del destinatario |
|
Orden de firma
|
recipients.signing_order | integer |
Orden de la firma |
|
Correo electrónico del usuario
|
recipients.user_email | string |
El correo electrónico del usuario |
|
Nombre de usuario
|
recipients.user_name | string |
Nombre del usuario |
|
Identificador nacional de usuario
|
recipients.user_national_id | string |
Identificador nacional del usuario |
Obtener plantillas
Obtener una lista de todas las plantillas empresariales de SigningHub
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
templatesCollection
|
templatesCollection | array of object |
templatesCollection |
|
|
templatesCollection.read_only | boolean |
read_only |
|
template_id
|
templatesCollection.template_id | integer |
template_id |
|
template_name
|
templatesCollection.template_name | string |
template_name |
|
template_public
|
templatesCollection.template_public | boolean |
template_public |
Rechazar un documento
El destinatario puede rechazar el flujo de trabajo en su turno
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
|
Motivo del rechazo
|
declineReason | True | string |
Motivo para rechazar el documento |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Documento rechazado
|
documentDeclined | boolean |
Estado del documento rechazado |
Uso compartido de un flujo de trabajo de documento
Compartir un flujo de trabajo de documento al destinatario
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de flujo de trabajo
|
packageId | True | integer |
Identificador del flujo de trabajo |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Id. de flujo de trabajo
|
packageID | integer |
Identificador del flujo de trabajo compartido |