Signhost (versión preliminar)
Signhost el servicio de firma de flujo de trabajo de Entrust es una solución de firma e identificación digital, lo que permite a todos los tipos de empresas con transacciones en línea sin problemas y seguras.
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 | Equipo de éxito del cliente de Signhost |
| URL | https://intercom.help/signhost/en/ |
| Correo Electrónico | support@signhost.com |
| Metadatos del conector | |
|---|---|
| Publicador | Signhost |
| Sitio web | https://www.signhost.com |
| Directiva de privacidad | https://www.evidos.com/privacy |
| Categorías | Contenido y archivos; Productividad |
SignHost
Signhost el servicio de firma de flujo de trabajo de Entrust es una solución de firma e identificación digital, lo que permite a todos los tipos de empresas con transacciones en línea sin problemas y seguras.
Publicador
Entrust Países Bajos B.V.
Prerrequisitos
Necesitará una suscripción a SignHost para poder usar este conector. Puede generar una APIKey desde el portal de Signhost.
Operaciones admitidas
Obtención de los detalles de la transacción
Devuelve los detalles actuales de la transacción. No use esta acción para el sondeo activo.
Eliminar transacción
Elimine una transacción por un identificador de transacción. Cuando una transacción no está en estado final (por ejemplo, totalmente firmada), la transacción se cancelará y limpiará. Se puede indicar a una transacción cancelada que envíe una notificación por correo electrónico a los firmantes en espera de que se canceló la transacción. El estado de la transacción se establecerá en cancelado. Cuando una transacción está en estado final, la transacción se limpiará. El estado de la transacción seguirá siendo el mismo, pero limpiaremos los documentos cargados y los datos confidenciales lo antes posible.
Descargar PDF
Devuelve los documentos (firmados).
Descargar recibo
Devuelve el recibo cuando la transacción se firma correctamente.
Crear transacción
Crea una nueva transacción.
Agregar archivo
Agregue un archivo a la transacción.
Iniciar transacción
Inicia una transacción con el mismo {transactionId}.
Obtención de credenciales
Puede generar un usertoken en la página de configuración en el portal de SignHost. Asegúrese de usar el prefijo "APIKey" delante de su usertoken.
Problemas conocidos y limitaciones
Actualmente no se admiten todas las características. Le damos la bienvenida para ponerse en contacto con nosotros con cualquier solicitud o consulta.
Instrucciones de implementación
Siga las instrucciones de Creación de un conector personalizado a partir de una definición de OpenAPI.
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 |
|---|---|---|---|
| Authorization | securestring | Proporcione su APIKey. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Agregar archivo |
Agregue un archivo a la transacción o sobrescriba un archivo existente con el mismo {fileId}. |
| Crear transacción |
Crea una nueva transacción |
| Descargar pdf |
Devuelve los documentos (firmados). |
| Descargar recibo |
Devuelve el recibo cuando la transacción se firma correctamente (Status=30) |
| Eliminar transacción |
Eliminar una transacción por un identificador de transacción |
| Iniciar transacción |
Inicia una transacción con el mismo {transactionId} |
| Obtención de los detalles de la transacción |
Devuelve los detalles actuales de la transacción. |
Agregar archivo
Agregue un archivo a la transacción o sobrescriba un archivo existente con el mismo {fileId}.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de transacción
|
transactionId | True | string |
Identificador de una transacción existente( aún no iniciada) |
|
Id. de archivo
|
fileId | True | string |
Identificador único proporcionado por usted para el archivo. |
|
Archivo binario
|
body | True | binary |
Carga de archivos |
Crear transacción
Crea una nueva transacción
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Archivos
|
Files | object |
Mapa de archivos adjuntos a esta transacción. |
|
|
Language
|
Language | string |
Solo se permiten de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL y nl-NL. |
|
|
Foca
|
Seal | boolean |
Sellar el documento antes de enviarlo a los firmantes. |
|
|
Id
|
Id | string |
El identificador del firmante debe ser único dentro de una transacción. |
|
|
Correo Electrónico
|
True | string |
Dirección de correo electrónico del firmante |
|
|
IntroText
|
IntroText | string |
Texto de introducción que se muestra al usuario durante el proceso de firma. |
|
|
Tipo
|
Type | True | string |
Tipo del objeto de autenticación. |
|
Number
|
Number | string |
Número de teléfono: este campo es obligatorio cuando se elige el método de autenticación PhoneNumber. |
|
|
Bsn
|
Bsn | number |
Este campo es obligatorio cuando se elige el método de autenticación BSN. |
|
|
Tipo
|
Type | True | string |
Tipo del objeto de verificación. |
|
SendSignRequest
|
SendSignRequest | boolean |
Envíe una invitación de firma al firmante su dirección de correo electrónico. |
|
|
SignUrl
|
SignUrl | string |
Dirección URL única por firmante que proporciona el flujo de firma para el firmante. |
|
|
SignRequestSubject
|
SignRequestSubject | string |
Asunto del correo electrónico de solicitud de firma en texto sin formato. |
|
|
SignRequestMessage
|
SignRequestMessage | string |
Mensaje de la solicitud de inicio de sesión en texto sin formato. |
|
|
SendSignConfirmation
|
SendSignConfirmation | boolean |
Envíe la confirmación de la firma al firmante su dirección de correo electrónico. |
|
|
Language
|
Language | string |
Solo se permiten de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL y nl-NL. |
|
|
ScribbleName
|
ScribbleName | string |
El nombre del firmante, se rellenará previamente en el formulario de escritura. |
|
|
DaysToRemind
|
DaysToRemind | integer |
Cantidad de días antes de recordar a los firmantes. -1 para deshabilitar los recordatorios. |
|
|
Caduca
|
Expires | date-time |
Cuando se establece el firmante ya no se permite firmar la transacción después de esta fecha. |
|
|
Referencia
|
Reference | string |
Referencia del firmante. |
|
|
RejectReason
|
RejectReason | string |
Motivo de rechazo proporcionado por el firmante cuando se rechazó la transacción. |
|
|
ReturnUrl
|
ReturnUrl | string |
Dirección URL para redirigir al usuario a después de firmar, rechazar o cancelar. |
|
|
Context
|
Context | object |
Cualquier objeto json válido que se devuelva. |
|
|
Id
|
Id | string | ||
|
Código
|
Code | integer |
Consulte la documentación de api. |
|
|
Información
|
Info | string |
Puede contener información adicional que pertenezca a esta actividad. |
|
|
Fecha y hora de creación
|
CreatedDateTime | date-time | ||
|
Nombre
|
Name | True | string |
Nombre del receptor. |
|
Correo Electrónico
|
True | string |
Dirección de correo electrónico del receptor. |
|
|
Language
|
Language | string |
Idioma, solo de-DE, en-US, es-ES, fr-FR, it-IT y nl-NL permitidos. |
|
|
Asunto
|
Subject | string |
Asunto del correo electrónico del receptor en texto sin formato. |
|
|
Message
|
Message | True | string |
Mensaje de correo electrónico hacia el receptor en texto sin formato. |
|
Referencia
|
Reference | string |
Referencia del receptor. |
|
|
Context
|
Context | object |
Cualquier objeto json válido que se devuelva. |
|
|
Referencia
|
Reference | string |
Referencia de la transacción. |
|
|
PostbackUrl
|
PostbackUrl | string |
Dirección URL absoluta para postback de las actualizaciones de estado. |
|
|
SignRequestMode
|
SignRequestMode | integer |
Establezca en 1 para enviar a la vez, en 2 para secuencial. |
|
|
DaysToExpire
|
DaysToExpire | integer |
Cantidad de días antes de la expiración. Máximo de 90 días. |
Devoluciones
- Body
- Transaction
Descargar pdf
Devuelve los documentos (firmados).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de transacción
|
transactionId | True | string |
Identificador de la descripción |
|
Nombre
|
fileId | True | string |
Identificador único proporcionado por usted para el archivo. |
Devoluciones
- Content
- binary
Descargar recibo
Devuelve el recibo cuando la transacción se firma correctamente (Status=30)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de transacción
|
transactionId | True | string |
Identificador de la descripción |
Devoluciones
- Content
- binary
Eliminar transacción
Eliminar una transacción por un identificador de transacción
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de transacción
|
transactionId | True | string |
Identificador de la transacción |
|
SendNotifications
|
SendNotifications | boolean |
Envíe notificaciones por correo electrónico a los firmantes en espera. |
|
|
Motivo
|
Reason | string |
Motivo de cancelación. |
Iniciar transacción
Inicia una transacción con el mismo {transactionId}
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de transacción
|
transactionId | True | string |
Identificador de una transacción existente( aún no iniciada) |
Obtención de los detalles de la transacción
Devuelve los detalles actuales de la transacción.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de transacción
|
transactionId | True | string |
Identificador de la transacción |
Devoluciones
- Body
- Transaction
Definiciones
Transacción
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
Identificador de la transacción. |
|
Archivos
|
Files | array of object | |
|
Enlaces
|
Files.Links | array of object | |
|
Rel
|
Files.Links.Rel | string | |
|
Tipo
|
Files.Links.Type | string | |
|
Link
|
Files.Links.Link | string | |
|
DisplayName (Nombre para mostrar)
|
Files.DisplayName | string | |
|
Language
|
Language | string |
El idioma, solo de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL y nl-NL permitidos. |
|
Foca
|
Seal | boolean |
Sellar el documento antes de enviarlo a los firmantes. |
|
Firmantes
|
Signers | array of object |
Información del firmante. |
|
Id
|
Signers.Id | string |
El identificador del firmante debe ser único dentro de una transacción. |
|
Correo Electrónico
|
Signers.Email | string |
Dirección de correo electrónico del firmante |
|
IntroText
|
Signers.IntroText | string |
Texto de introducción que se muestra al usuario durante el proceso de firma. |
|
Autenticaciones
|
Signers.Authentications | array of Authentication |
Lista de autenticaciones con las que debe autenticarse el firmante. |
|
Verificaciones
|
Signers.Verifications | array of Verification |
Lista de comprobaciones con las que tiene que comprobar el firmante. |
|
SendSignRequest
|
Signers.SendSignRequest | boolean |
Envíe una invitación de firma al firmante su dirección de correo electrónico. |
|
SignUrl
|
Signers.SignUrl | string |
Dirección URL única por firmante que proporciona el flujo de firma para el firmante. |
|
SignRequestSubject
|
Signers.SignRequestSubject | string |
Asunto del correo electrónico de solicitud de firma en texto sin formato. |
|
SignRequestMessage
|
Signers.SignRequestMessage | string |
Mensaje de la solicitud de inicio de sesión en texto sin formato. |
|
SendSignConfirmation
|
Signers.SendSignConfirmation | boolean |
Envíe la confirmación de la firma al firmante su dirección de correo electrónico. |
|
Language
|
Signers.Language | string |
Solo se permiten de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL y nl-NL. |
|
ScribbleName
|
Signers.ScribbleName | string |
El nombre del firmante, se rellenará previamente en el formulario de escritura. |
|
DaysToRemind
|
Signers.DaysToRemind | integer |
Cantidad de días antes de recordar a los firmantes. |
|
Caduca
|
Signers.Expires | date-time |
Cuando se establece el firmante ya no se permite firmar la transacción después de esta fecha. |
|
Referencia
|
Signers.Reference | string |
Referencia del firmante. |
|
RejectReason
|
Signers.RejectReason | string |
Motivo de rechazo proporcionado por el firmante cuando se rechazó la transacción. |
|
ReturnUrl
|
Signers.ReturnUrl | string |
Dirección URL para redirigir al usuario a después de firmar, rechazar o cancelar. |
|
Context
|
Signers.Context | object |
Cualquier objeto json válido que se devolverá. |
|
Activities
|
Signers.Activities | array of object |
Lista de actividades adjuntas a este firmante. |
|
Id
|
Signers.Activities.Id | string | |
|
Código
|
Signers.Activities.Code | integer |
|
|
Información
|
Signers.Activities.Info | string |
Puede contener información adicional que pertenezca a esta actividad. |
|
Fecha y hora de creación
|
Signers.Activities.CreatedDateTime | date-time | |
|
Receptores
|
Receivers | array of object | |
|
Nombre
|
Receivers.Name | string |
Nombre del receptor. |
|
Correo Electrónico
|
Receivers.Email | string |
Dirección de correo electrónico del receptor. |
|
Language
|
Receivers.Language | string |
El idioma del receptor, solo se permiten de-DE, en-US, es-ES, fr-FR, it-IT y nl-NL. |
|
Asunto
|
Receivers.Subject | string |
Asunto del correo electrónico del receptor en texto sin formato. |
|
Message
|
Receivers.Message | string |
Mensaje de correo electrónico hacia el receptor en texto sin formato. |
|
Referencia
|
Receivers.Reference | string |
Referencia del receptor. |
|
Context
|
Receivers.Context | object |
Cualquier objeto json válido que se devuelva. |
|
Referencia
|
Reference | string |
Referencia de la transacción. Por ejemplo, "1234" |
|
PostbackUrl
|
PostbackUrl | string |
Dirección URL absoluta para postback de las actualizaciones de estado. |
|
SignRequestMode
|
SignRequestMode | integer |
Establezca en 1 para enviar a la vez, en 2 para secuencial. |
|
DaysToExpire
|
DaysToExpire | integer |
Cantidad de días antes de la expiración. Máximo de 90 días. |
|
SendEmailNotifications
|
SendEmailNotifications | boolean |
Enviar notificaciones por correo electrónico al remitente. |
|
Estado
|
Status | integer |
Estado actual de la transacción. |
|
CancelationReason
|
CancelationReason | string |
Motivo de cancelación original proporcionado durante una llamada DELETE. |
|
Context
|
Context | object |
Cualquier objeto json válido que se devuelva. |
Autenticación
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Tipo
|
Type | string |
Tipo del objeto de autenticación. |
|
Number
|
Number | string |
Número de teléfono: este campo es obligatorio cuando se elige el método de autenticación PhoneNumber. |
|
Bsn
|
Bsn | number |
Este campo es obligatorio cuando se elige el método de autenticación BSN. |
Comprobación
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Tipo
|
Type | string |
Tipo del objeto de verificación. |
binary
Este es el tipo de datos básico "binary".