SigningHub (versão prévia)
O SigningHub é uma solução completa para fluxos de trabalho de aprovação de documentos, assinaturas digitais avançadas e acompanhamento de status de documento. Ele foi projetado para otimizar rapidamente a maneira como as empresas entregam, revisam, aprovam e assinam seus documentos comerciais
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| support@ascertia.com |
| Metadados do conector | |
|---|---|
| Publicador | Ascertia |
| Site | https://www.signinghub.com |
| Política de privacidade | https://www.signinghub.com/privacy-policy/ |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Adicionar destinatário |
Adicionar um destinatário ao fluxo de trabalho existente |
| Aplicar modelo |
Aplicar um modelo fornecido no fluxo de trabalho do documento |
| Aprovar um documento |
O destinatário pode aprovar o fluxo de trabalho nesta vez |
| Assinar documento |
Assina um documento por usuário conectado |
| Baixar todos os documentos de um fluxo de trabalho |
Baixar todos os documentos no formato extraído/compactado de um fluxo de trabalho existente do SigningHub |
| Baixar um documento específico de um fluxo de trabalho |
Baixar um documento específico de um fluxo de trabalho existente |
| Carregar um documento no fluxo de trabalho |
Carregar um documento no fluxo de trabalho existente |
| Compartilhar um fluxo de trabalho de documento |
Compartilhar um fluxo de trabalho de documento para o destinatário |
| Concluir o fluxo de trabalho (Terminar no meio) |
O proprietário do fluxo de trabalho pode concluir o fluxo de trabalho em qualquer estágio para encerrá-lo |
| Criar um fluxo de trabalho |
Criar um novo fluxo de trabalho dentro do SigningHub |
| Excluir destinatário de um fluxo de trabalho |
Excluir um destinatário específico de um fluxo de trabalho existente |
| Excluir um fluxo de trabalho |
Excluir fluxo de trabalho existente pelo proprietário do fluxo de trabalho |
| Obter contects |
Obter uma lista de contatos relacionados ao usuário conectado do SigningHub |
| Obter detalhes do fluxo de trabalho |
Obter os detalhes do fluxo de trabalho |
| Obter fluxos de trabalho |
Obter uma lista de fluxos de trabalho do SigningHub para o usuário conectado |
| Obter modelos |
Obter uma lista de todos os modelos empresariais do SigningHub |
| Obter os destinatários |
Obter uma lista de destinatários de um fluxo de trabalho existente |
| Recusar um documento |
O destinatário pode recusar o fluxo de trabalho em sua vez |
|
Sobre o Signing |
Obter os detalhes da instância do SigningHub |
Adicionar destinatário
Adicionar um destinatário ao fluxo de trabalho existente
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho existente |
|
Adicionar campo de assinatura
|
addSignatureField | True | boolean |
Adicionar um campo de assinatura ao fluxo de trabalho |
|
ID do documento
|
documentId | integer |
A ID do documento |
|
|
Notificação por email
|
emailNotification | True | boolean |
Notificação por email |
|
Somente eu
|
onlyMe | boolean |
O tipo de destinatário como somente eu |
|
|
Página Nº.
|
pageNo | integer |
O número da página do documento |
|
|
Posição da página
|
pagePosition | True | string |
a posição na página |
|
Página X
|
pageX | integer |
A posição horizontal na página do documento |
|
|
Página Y
|
pageY | integer |
A posição vertical na página do documento |
|
|
Função
|
role | True | string |
A função do destinatário |
|
Ordem de assinatura
|
signingOrder | True | integer |
A ordem da assinatura do destinatário |
|
Email do usuário
|
userEmail | True | string |
O email do destinatário |
|
Nome de usuário
|
userName | True | string |
O nome do destinatário |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Destinatário adicionado
|
recipientAdded | boolean |
Resposta adicionada do destinatário |
Aplicar modelo
Aplicar um modelo fornecido no fluxo de trabalho do documento
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
|
ID do documento
|
documentId | True | integer |
A ID do documento |
|
Aplicar a todos
|
applyToAll | True | boolean |
Aplicar a todos os documentos |
|
Nome do modelo
|
templateName | True | string |
O nome do modelo aplicado |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Certificar habilitado
|
applyTemplate.certify.enabled | boolean |
O valor habilitado para certificação |
|
Permissão Certify
|
applyTemplate.certify.permission | string |
O valor da permissão de certificação |
|
Altura do documento
|
applyTemplate.document_height | integer |
A altura do documento |
|
ID do documento
|
applyTemplate.document_id | integer |
A ID do documento |
|
Nome do documento
|
applyTemplate.document_name | string |
O nome do documento |
|
Ordem do documento
|
applyTemplate.document_order | integer |
A ordem do documento no fluxo de trabalho |
|
Páginas do documento
|
applyTemplate.document_pages | integer |
Total de páginas do documento |
|
Origem do documento
|
applyTemplate.document_source | string |
A origem do documento |
|
Tipo de documento
|
applyTemplate.document_type | string |
O tipo do documento |
|
Largura do documento
|
applyTemplate.document_width | integer |
A largura do documento |
|
Campos de formulário
|
applyTemplate.form_fields | boolean |
A disponibilidade dos campos de formulário no documento |
|
Campos de formulário de bloqueio
|
applyTemplate.lock_form_fields | boolean |
O valor habilitado dos campos de formulário de bloqueio |
|
Modificado em
|
applyTemplate.modified_on | string |
A data da modificação |
|
Somente leitura
|
applyTemplate.template.read_only | boolean |
O tipo somente pronto do modelo |
|
Nome do modelo
|
applyTemplate.template.template_name | string |
O nome do modelo aplicado |
|
Carregado em
|
applyTemplate.uploaded_on | string |
A data do upload em |
Aprovar um documento
O destinatário pode aprovar o fluxo de trabalho nesta vez
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
|
Aprovar motivo
|
approveReason | string |
O motivo para aprovar o documento |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Documento aprovado
|
documentApproved | boolean |
O status do documento aprovado |
Assinar documento
Assina um documento por usuário conectado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
|
ID do documento
|
documentId | True | integer |
A ID do documento |
|
Página Nº.
|
pageNo | True | integer |
O número da página do documento |
|
Posição da página
|
pagePosition | True | string |
A posição na página do documento |
|
Página X
|
pageX | integer |
A posição horizontal na página do documento |
|
|
Página Y
|
pageY | integer |
A posição vertical na página do documento |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome do documento
|
documentName | string |
O nome do documento assinado |
|
Nome do campo
|
fieldName | string |
O nome do campo assinado |
|
Situação
|
status | string |
O status do documento assinado |
Baixar todos os documentos de um fluxo de trabalho
Baixar todos os documentos no formato extraído/compactado de um fluxo de trabalho existente do SigningHub
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contexto do fluxo de trabalho
|
packageContent | byte |
O conteúdo do fluxo de trabalho na cadeia de caracteres base64 |
|
Tipo de fluxo de trabalho
|
packageType | string |
O tipo de conteúdo do fluxo de trabalho |
Baixar um documento específico de um fluxo de trabalho
Baixar um documento específico de um fluxo de trabalho existente
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
|
ID do documento
|
documentId | True | integer |
A ID do documento |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Conteúdo do documento
|
documentContent | byte |
O conteúdo do documento na cadeia de caracteres base64 |
|
Tipo de documento
|
documentType | string |
O tipo do documento |
Carregar um documento no fluxo de trabalho
Carregar um documento no fluxo de trabalho existente
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho existente |
|
Conteúdo do documento
|
documentContent | True | byte |
O conteúdo do documento adicionado em base64 |
|
Nome do documento com extensão
|
documentName | True | string |
O nome do documento adicionado com extensão |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do documento
|
documentId | string |
A ID do documento carregado |
Compartilhar um fluxo de trabalho de documento
Compartilhar um fluxo de trabalho de documento para o destinatário
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
ID do Fluxo de Trabalho
|
packageID | integer |
A ID do fluxo de trabalho compartilhado |
Concluir o fluxo de trabalho (Terminar no meio)
O proprietário do fluxo de trabalho pode concluir o fluxo de trabalho em qualquer estágio para encerrá-lo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | string |
A ID do fluxo de trabalho |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Fluxo de trabalho concluído
|
workflowCompleted | boolean |
O status do fluxo de trabalho concluído |
Criar um fluxo de trabalho
Criar um novo fluxo de trabalho dentro do SigningHub
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Conteúdo do documento
|
documentContent | True | string |
O conteúdo do documento em base64 |
|
Nome do fluxo de trabalho
|
documentName | True | string |
Criar um novo fluxo de trabalho dentro do SigningHub |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do documento
|
documentId | integer |
A ID do documento |
|
ID do Pacote
|
packageId | integer |
A ID do fluxo de trabalho |
Excluir destinatário de um fluxo de trabalho
Excluir um destinatário específico de um fluxo de trabalho existente
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
|
Pedido
|
order | True | integer |
A ordem do destinatário excluído |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Destinatário excluído
|
recipientDeleted | boolean |
O status excluído do destinatário |
Excluir um fluxo de trabalho
Excluir fluxo de trabalho existente pelo proprietário do fluxo de trabalho
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Fluxo de trabalho excluído
|
packageDeleted | boolean |
A resposta excluída do fluxo de trabalho |
Obter contects
Obter uma lista de contatos relacionados ao usuário conectado do SigningHub
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Enterprise
|
enterprise | boolean |
A lista de contatos corporativos |
|
|
Página Nº.
|
pageNo | True | integer |
O número da página |
|
Registros por página
|
recordsPerPage | True | integer |
O número de registros por página |
|
Pesquisar texto
|
searchText | string |
O texto de pesquisa para filtrar a lista |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Email do usuário
|
user_email | string |
O email do usuário |
|
Nome de usuário
|
user_name | string |
O nome do utilizador |
|
ID nacional do usuário
|
user_national_id | string |
A ID nacional do usuário |
Obter detalhes do fluxo de trabalho
Obter os detalhes do fluxo de trabalho
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
Retornos
| Nome | Caminho | 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 |
|
modelo
|
documents.template | string |
modelo |
|
Pasta
|
folder | string |
O tipo de pasta |
|
Modificado em
|
modified_on | string |
A data da modificação |
|
Próximo signatário
|
next_signer | string |
O email do próximo signatário |
|
next_signer_email
|
next_signer_email | array of |
next_signer_email |
|
Nome do proprietário
|
owner_name | string |
O nome de exibição do proprietário |
|
ID do Fluxo de Trabalho
|
package_id | integer |
A ID do fluxo de trabalho |
|
Nome do fluxo de trabalho
|
package_name | string |
O nome do fluxo de trabalho |
|
Proprietário do fluxo de trabalho
|
package_owner | string |
O proprietário do fluxo de trabalho |
|
Status do pacote
|
package_status | string |
O status atual do fluxo de trabalho |
|
Carregado em
|
uploaded_on | string |
A data do fluxo de trabalho carregado |
|
users
|
users | array of |
users |
|
Continuar em declínio
|
workflow.continue_on_decline | boolean |
Continuar no declínio do fluxo de trabalho |
|
contacts
|
workflow.post_process.contacts | array of |
contacts |
|
Dropbox
|
workflow.post_process.dropbox | boolean |
O valor habilitado para Dropbox |
|
Unidade Google
|
workflow.post_process.google_drive | boolean |
O valor habilitado para a unidade do Google |
|
Destinatários de fluxo de trabalho
|
workflow.post_process.workflow_recipients | boolean |
O valor dos destinatários do fluxo de trabalho |
|
Somente leitura
|
workflow.read_only | boolean |
O valor somente leitura do fluxo de trabalho |
|
Modo de fluxo de trabalho
|
workflow.workflow_mode | string |
O modo do fluxo de trabalho |
|
Status do fluxo de trabalho
|
workflow.workflow_status | string |
O status do fluxo de trabalho |
|
Tipo de fluxo de trabalho
|
workflow.workflow_type | string |
O tipo do fluxo de trabalho |
Obter fluxos de trabalho
Obter uma lista de fluxos de trabalho do SigningHub para o usuário conectado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Status do documento
|
documentStatus | True | string |
O status do documento |
|
Pasta
|
folder | True | string |
A pasta do fluxo de trabalho do usuário |
|
Página Nº.
|
pageNo | True | integer |
O número da página do documento |
|
Registros por página
|
recordsPerPage | integer |
O número de registros por página |
|
|
Pesquisar texto
|
searchText | string |
O texto de pesquisa para filtrar a lista |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Pasta
|
folder | string |
A pasta do fluxo de trabalho do usuário |
|
Modificado em
|
modified_on | string |
A data da modificação |
|
Próximo signatário
|
next_signer | string |
O próximo signatário do fluxo de trabalho |
|
next_signer_email
|
next_signer_email | array of object |
next_signer_email |
|
user_email
|
next_signer_email.user_email | string |
user_email |
|
user_name
|
next_signer_email.user_name | string |
user_name |
|
Nome do proprietário
|
owner_name | string |
O nome do proprietário do fluxo de trabalho |
|
ID do Fluxo de Trabalho
|
package_id | integer |
A ID do fluxo de trabalho |
|
Nome do fluxo de trabalho
|
package_name | string |
O nome do fluxo de trabalho |
|
Proprietário do fluxo de trabalho
|
package_owner | string |
O email do proprietário do fluxo de trabalho |
|
Status do fluxo de trabalho
|
package_status | string |
O status do fluxo de trabalho |
|
Não lido
|
unread | boolean |
Tipo não lido |
|
Carregado em
|
uploaded_on | string |
A data do fluxo de trabalho carregado |
Obter modelos
Obter uma lista de todos os modelos empresariais do SigningHub
Retornos
| Nome | Caminho | 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 |
Obter os destinatários
Obter uma lista de destinatários de um fluxo de trabalho existente
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
destinatários
|
recipients | array of object |
destinatários |
|
Delegar
|
recipients.delegatee | string |
O email do delegado |
|
Nome do delegado
|
recipients.delegatee_name | string |
O nome do delegado |
|
Nome do grupo
|
recipients.group_name | string |
O nome do grupo |
|
Pedido
|
recipients.order | integer |
A ordem do destinatário |
|
Placeholder
|
recipients.placeholder | string |
O valor do espaço reservado |
|
Processo status
|
recipients.process_status | string |
O status do espaço reservado |
|
Processado como
|
recipients.processed_as | string |
O processado como valor |
|
Processado por
|
recipients.processed_by | string |
O email do processado por |
|
Processado em
|
recipients.processed_on | string |
A data do processamento |
|
Reason
|
recipients.reason | string |
O motivo se houver |
|
Função
|
recipients.role | string |
A função do destinatário |
|
Ordem de assinatura
|
recipients.signing_order | integer |
A ordem da assinatura |
|
Email do usuário
|
recipients.user_email | string |
O email do usuário |
|
Nome de usuário
|
recipients.user_name | string |
O nome do utilizador |
|
ID nacional do usuário
|
recipients.user_national_id | string |
A ID nacional do usuário |
Recusar um documento
O destinatário pode recusar o fluxo de trabalho em sua vez
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Fluxo de Trabalho
|
packageId | True | integer |
A ID do fluxo de trabalho |
|
Motivo do declínio
|
declineReason | True | string |
O motivo para recusar o documento |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Documento recusado
|
documentDeclined | boolean |
O status do documento recusado |
Sobre o SigningHub
Obter os detalhes da instância do SigningHub
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Construir
|
aboutSigningHub.build | string |
Compilação da instância do SigningHub |
|
Direitos autorais
|
aboutSigningHub.copyright | string |
Direitos autorais do SigningHub |
|
Nome da instalação
|
aboutSigningHub.installation_name | string |
Nome da instalação da instância do SigningHub |
|
Patente dos EUA Nº.
|
aboutSigningHub.patents.us_patent_no | string |
Patente dos EUA Nº. do SigningHub |
|
Versão
|
aboutSigningHub.version | string |
Versão da instância do SigningHub |