Um fluxo
Seja mais eficaz com contratos verdadeiramente digitais que tornam o trabalho mais rápido e a vida mais fácil. Automatize o seu processo de gestão de contratos com o Oneflow
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Oneflow AB |
| URL | https://support.oneflow.com/ |
| support@oneflow.com |
| Metadados do conector | |
|---|---|
| Editora | Um fluxo |
| Sítio Web | https://oneflow.com |
| Política de privacidade | https://oneflow.com/privacy-notice/ |
| Categorias | Vendas e CRM; Produtividade |
Um fluxo
Seja mais eficaz com contratos verdadeiramente digitais que tornam o trabalho mais rápido e a vida mais fácil. Automatize o seu processo de gestão de contratos com o Oneflow.
Editora: Oneflow AB
Pré-requisitos
Para usar o conector Oneflow, você precisa de uma conta de administrador do Oneflow ativa. Se você ainda não tem uma conta, vá em frente e crie uma conta de avaliação.
Operações suportadas
Ações
Criar contrato
Crie um contrato a partir de um modelo selecionado.
Adicionar participante ao contrato
Adicione um indivíduo ou um participante baseado na empresa a um contrato existente.
Excluir contrato
Excluir um contrato.
Adicionar anexos ao contrato
Adicione um PDF expandido ou um anexo normal a um contrato existente.
Publicar contrato
Envie um contrato a todos os signatários através de um canal de entrega especificado.
Baixar arquivos de contrato
Descarregue uma cópia PDF de um contrato assinado e qualquer anexo ou ficheiro de verificação de um contrato existente.
Ping Oneflow API
Verifique a disponibilidade da API do Oneflow.
Acionadores
Quando um contrato é atualizado
Acione seu fluxo com base no(s) evento(s) de contrato pré-definido(s).
Obtenção de credenciais
Para obter as credenciais do conector Oneflow:
Faça login na sua conta Oneflow e prossiga para Tokens de API de Extensão > de Conta > de Administrador>.
Clique em Gerar um novo token nesta extensão e cole o token no assistente de conexão no Power Automate Flow.
Problemas conhecidos e limitações
O registro do Webhook não é excluído no ambiente de teste
Se você optar por usar o ambiente de teste do Oneflow, há um problema conhecido quando um webhook não é excluído em sua conta de teste do Oneflow depois de excluir um fluxo ou remover um gatilho de um fluxo. Webhooks devem ser excluídos manualmente em sua conta de teste do Oneflow como uma solução alternativa.
Contacte-nos
Nosso site: https://oneflow.com/
Apoio ao cliente: https://support.oneflow.com
Vendas e preços: https://oneflow.com/contact/
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave da API do Oneflow | securestring | A chave de api para esta api | Verdade |
| Endereço de e-mail | cadeia (de caracteres) | Endereço de e-mail do usuário Oneflow | Verdade |
| API URL | cadeia (de caracteres) | Selecione o ambiente ao qual deseja se conectar. | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Adicionar Participante |
Adicionar participante ao contrato |
| Adicionar produto a um contrato |
Adicione um produto a um grupo de produtos existente num contrato. |
| Atualizar um campo de dados |
Atualize um campo de dados no contrato específico pelo seu ID. |
| Carregar anexos |
Adicione um anexo ou um documento PDF a um contrato. |
| Criar um contrato |
Crie um novo contrato com base no modelo selecionado. |
| Descarregar um ficheiro de contrato |
Recupere um arquivo de contrato específico por seu ID. |
| Eliminar um contrato |
Exclua um contrato específico por seu ID. |
| Obter detalhes do contrato |
Recupere os detalhes de um contrato pelo seu ID. |
| Obter o status de um contrato |
Recupere o status de um contrato específico por sua ID. |
| Ping |
Use este ponto de extremidade para verificar se a API do Oneflow está disponível. |
| Publicar um contrato |
Envia contrato aos participantes para assinatura. |
Adicionar Participante
Adicionar participante ao contrato
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
Adicionar como
|
x-oneflow-user-email-override | string |
Selecione o usuário para executar esta ação como, ou insira um e-mail personalizado |
|
|
Tipo de Participante
|
participant_type | True | string |
Pessoa Física/Empresa |
|
Ordem de assinatura
|
signing_order | number |
Ordem de assinatura do participante |
|
|
festa
|
party | True | dynamic |
Devoluções
- response
- object
Adicionar produto a um contrato
Adicione um produto a um grupo de produtos existente num contrato.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
x-ms-oneflow-contract_id | True | integer |
ID do contrato |
|
Grupo de produtos
|
x-ms-oneflow-product-group-index | True | integer |
Selecione o índice da tabela de produtos ao qual adicionar os produtos. Encomendado de cima para baixo no contrato. |
|
Produto bloqueado para contrapartes?
|
counterparty_lock | boolean |
Selecione se deseja que os atributos do produto sejam editáveis pelas contrapartes. |
|
|
Descrição do Produto
|
description | string |
Adicione detalhes sobre o produto. |
|
|
Nome do Produto
|
name | string |
Nome do produto. |
|
|
Montante
|
amount | string |
Valor base para o produto. |
|
|
Valor do desconto
|
amount | string |
Valor do desconto como um número. |
|
|
1 Desconto por Cento
|
discount_percent | string |
Desconto em percentagem do valor base. |
|
|
Montante
|
amount | string |
Valor de preço secundário. ou seja, se o produto tiver uma taxa de subscrição. |
|
|
Valor do desconto
|
amount | string |
Valor de desconto secundário como um número. |
|
|
2 Desconto por cento
|
discount_percent | string |
Valor de desconto secundário como uma porcentagem do Preço 2. |
|
|
Montante
|
amount | number |
Qualquer número positivo ou 1/0 se o tipo for multiple_choice/single_choice |
|
|
Tipo de Produto
|
type | string |
Selecione um tipo de quantidade de entrada (ou seja, uma caixa de seleção, número, seleção única). |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Estado do contrato
|
state | string |
rascunho/pendente/vencido/assinado/recusado |
|
Tempo de atualização do estado do contrato
|
state_updated_time | string | |
|
Tempo de atualização do contrato
|
updated_time | string |
Atualizar um campo de dados
Atualize um campo de dados no contrato específico pelo seu ID.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
ID personalizado
|
data_field_id | True | string |
ID personalizada (chave externa) do campo de dados. |
|
Atualizar como
|
x-oneflow-user-email-override | string |
Selecione o usuário para executar esta ação como, ou insira um e-mail personalizado |
|
|
Valor
|
value | string |
Valor a ser definido para o campo de dados. |
|
|
ID personalizado
|
custom_id | True | string |
ID personalizada do campo de dados |
Devoluções
- Body
- Datafield
Carregar anexos
Adicione um anexo ou um documento PDF a um contrato.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
Ficheiro
|
file | True | binary |
Ficheiro a carregar. O nome do arquivo deve estar no formato file.ext |
|
Carregar como
|
upload_as | string |
Selecione o tipo de anexo a ser carregado |
|
|
Executar como
|
x-oneflow-user-email-override | string |
Selecione o usuário para executar esta ação como, ou insira um e-mail personalizado |
Devoluções
- response
- object
Criar um contrato
Crie um novo contrato com base no modelo selecionado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Criar como
|
x-oneflow-user-email |
Especifique o e-mail do usuário Oneflow. A ação criará contrato como este usuário. |
||
|
Nome do contrato
|
name | string | ||
|
Nome do espaço de trabalho
|
workspace_id | True | integer |
Selecione um espaço de trabalho para o seu contrato |
|
Nome do modelo
|
template_id | True | integer |
Selecione um modelo a partir do qual criar o seu contrato |
|
Campo de dados
|
custom_id | True | string |
Selecionar campo de dados a ser preenchido |
|
Valor
|
value | string |
Valor do campo de dados |
Devoluções
- Body
- Contract
Descarregar um ficheiro de contrato
Recupere um arquivo de contrato específico por seu ID.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Baixar As
|
x-oneflow-user-email-override | string |
Selecione o usuário para executar esta ação como, ou insira um e-mail personalizado |
|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
ID do arquivo
|
file_id | True | string |
Tipo de ficheiro: * 1 - Contrato PDF * 2 - Verificação |
Devoluções
- Conteúdo do Ficheiro
- binary
Eliminar um contrato
Exclua um contrato específico por seu ID.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
Excluir como
|
x-oneflow-user-email-override | string |
Selecione o usuário para executar esta ação como, ou insira um e-mail personalizado |
Devoluções
- response
- string
Obter detalhes do contrato
Recupere os detalhes de um contrato pelo seu ID.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
Devoluções
- Body
- Contract
Obter o status de um contrato
Recupere o status de um contrato específico por sua ID.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Estado do contrato
|
state | string |
rascunho/pendente/vencido/assinado/recusado |
|
Tempo de atualização do estado do contrato
|
state_updated_time | string | |
|
Tempo de atualização do contrato
|
updated_time | string |
Ping
Use este ponto de extremidade para verificar se a API do Oneflow está disponível.
Devoluções
- response
- object
Publicar um contrato
Envia contrato aos participantes para assinatura.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
Assunto
|
subject | string |
Objeto da notificação |
|
|
Message
|
message | string |
Mensagem de notificação |
|
|
Publicar como
|
x-oneflow-user-email-override | string |
Selecione o usuário para executar esta ação como, ou insira um e-mail personalizado |
Devoluções
- Body
- Contract
Acionadores
| Quando um contrato é atualizado |
Registrar um webhook para um evento de atualização de contrato especificado |
Quando um contrato é atualizado
Registrar um webhook para um evento de atualização de contrato especificado
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tipo de atualização
|
filters | True | array of string | |
|
ID do Grupo de Modelos
|
template_group_id | integer |
(Opcional) Filtrar contratos por um grupo de modelos. |
Devoluções
- Body
- Webhook_Event
Definições
Contrato
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Permissão de exclusão de contrato
|
_permissions.contract:delete | boolean |
O usuário pode excluir o contrato |
|
Nome do contrato
|
_private.name | string | |
|
Valor do contrato
|
_private.value.amount | string | |
|
Moeda
|
_private.value.currency | string | |
|
ID do espaço de trabalho
|
_private.workspace_id | integer | |
|
Tempo de criação do contrato
|
_private_ownerside.created_time | string | |
|
ID do modelo
|
_private_ownerside.template_id | integer | |
|
Pode receber anexos
|
available_options.can_receive_attachments | boolean |
Contrato pode receber anexos |
|
Pode receber PDF expandido
|
available_options.can_receive_expanded_pdf | boolean |
O contrato pode receber PDF expandido |
|
Campo de dados
|
data_fields | array of object |
Recolha de campos de dados |
|
tempo de criação
|
data_fields._private_ownerside.created_time | string |
Campo de dados created_time |
|
ID personalizado
|
data_fields._private_ownerside.custom_id | string |
Campo de dados custom_id |
|
Hora atualizada
|
data_fields._private_ownerside.updated_time | string |
Campo de dados updated_time |
|
descrição
|
data_fields.description | string |
Descrição do campo de dados |
|
id
|
data_fields.id | integer |
ID do campo de dados |
|
nome
|
data_fields.name | string |
Nome do campo de dados |
|
marcador de posição
|
data_fields.placeholder | string |
Espaço reservado para campo de dados |
|
valor
|
data_fields.value | string |
Valor do campo de dados |
|
ID do contrato
|
id | integer |
ID do contrato |
|
Hora de término do contrato
|
lifecycle_state.contract_end_time | string | |
|
Hora de início do contrato
|
lifecycle_state.contract_start_time | string | |
|
Tempo de cancelamento do contrato
|
lifecycle_state.cancel_time | string | |
|
Contrato terminado por rescisão?
|
lifecycle_state.has_ended_by_termination | boolean | |
|
O prazo de pré-aviso já passou?
|
lifecycle_state.has_passed_notice_period_start_time | boolean | |
|
Contrato cancelado
|
lifecycle_state.is_canceled | boolean | |
|
O contrato é recorrente
|
lifecycle_state.is_recurring | boolean | |
|
Estado do ciclo de vida
|
lifecycle_state.lifecycle_state | string |
aguardando/ativo/encerrado |
|
Tempo de atualização do estado do ciclo de vida
|
lifecycle_state.lifecycle_state_updated_time | string | |
|
Festas
|
parties | array of Party |
Recolha de festas |
|
Grupos de produtos
|
product_groups | array of Product_Group |
product_groups coleção |
|
Tempo de publicação do contrato
|
published_time | string | |
|
Prazo de expiração da assinatura do contrato
|
signing_period_expiry_time | string | |
|
Estado do contrato
|
state | string |
rascunho/pendente/vencido/assinado/recusado |
|
Tempo de atualização do estado do contrato
|
state_updated_time | string | |
|
Tempo de atualização do contrato
|
updated_time | string |
Parte
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Código do país do partido
|
country_code | string | |
|
Número de identificação do partido
|
identification_number | string |
Número de identificação da parte |
|
É o meu partido
|
my_party | boolean |
A parte contratante é my_party |
|
Nome do partido
|
name | string | |
|
Participantes
|
participants | array of Participant |
Recolha de participantes |
|
Tipo de partido
|
type | string |
Empresa/Pessoa Física |
|
participante
|
participant | Individual_Participant |
Objeto individual do participante |
Participante
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
O participante pode atualizar o contrato?
|
_permissions.contract:update | boolean | |
|
Hora da primeira visita do participante
|
_private_ownerside.first_visited_time | string | |
|
Participante Última visita
|
_private_ownerside.last_visited_time | string | |
|
Contagem de visitas dos participantes
|
_private_ownerside.visits | integer | |
|
Canal de entrega do participante
|
delivery_channel | string |
e-mail/nenhum/same_device/sms |
|
Status de entrega do participante
|
delivery_status | string |
not_sent/pendente/falha/rejeição/sucesso/aberto |
|
E-mail do participante
|
string | ||
|
Número de identificação do participante
|
identification_number | string |
Número de identificação do participante |
|
O participante é my_participant
|
my_participant | boolean | |
|
Nome do participante
|
name | string | |
|
O participante é o organizador
|
organizer | boolean | |
|
Número de telefone do participante
|
phone_number | string | |
|
Método de assinatura do participante
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Estado do sinal do participante
|
sign_state | string |
indeciso/assinado/recusado |
|
Estado de sinal do participante hora atualizada
|
sign_state_updated_time | string |
sign_state_updated_time |
|
O participante é signatário
|
signatory | boolean | |
|
Título do participante
|
title | string | |
|
Método Participante 2FA
|
two_step_authentication_method | string |
e-mail/sms/none |
Individual_Participant
Objeto individual do participante
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Participante individual pode atualizar contrato
|
_permissions.contract:update | boolean |
contrato:atualizar permissões para Participante Individual |
|
Primeira visita individual do participante
|
_private_ownerside.first_visited_time | string | |
|
Hora da última visita individual do participante
|
_private_ownerside.last_visited_time | string | |
|
Tempo de atualização individual do participante
|
_private_ownerside.updated_time | string | |
|
Contagem de visitas individuais de participantes
|
_private_ownerside.visits | integer | |
|
Canal de entrega individual do participante
|
delivery_channel | string |
e-mail/nenhum/same_device/sms |
|
Estado de entrega individual do participante
|
delivery_status | string |
not_sent/pendente/falha/rejeição/sucesso/aberto |
|
E-mail individual do participante
|
string | ||
|
Número de identificação individual do participante
|
identification_number | string | |
|
O participante individual é my_participant
|
my_participant | boolean | |
|
Nome individual do participante
|
name | string | |
|
Participante individual é organizador
|
organizer | boolean | |
|
Número de telefone individual do participante
|
phone_number | string | |
|
Método de assinatura individual do participante
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Estado de sinal de participante individual
|
sign_state | string |
indeciso/assinado/recusado |
|
Estado de sinal do participante individual hora atualizada
|
sign_state_updated_time | string | |
|
Participante individual é signatário
|
signatory | boolean | |
|
Título individual do participante
|
title | string | |
|
Método 2FA de participante individual
|
two_step_authentication_method | string |
e-mail/sms/none |
Product_Group
product_group item da coleção product_groups
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do grupo de produtos
|
id | integer | |
|
Products
|
products | array of Product |
Coleção de produtos |
Produto
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
bloqueado para contrapartes?
|
counterparty_lock | boolean |
counterparty_lock |
|
descrição
|
description | string | |
|
id
|
id | integer | |
|
nome
|
name | string | |
|
Montante
|
price_1.amount.amount | string |
Valor do preço 1 |
|
Montante de base
|
price_1.base_amount.amount | string |
Valor do preço 1 |
|
valor do desconto
|
price_1.discount_amount.amount | string |
Valor do desconto do preço 1 |
|
percentual de desconto
|
price_1.discount_percent | string |
Percentagem de desconto do preço 1 |
|
Montante
|
price_2.amount.amount | string |
Valor do preço 2 |
|
Montante de base
|
price_2.base_amount.amount | string |
Valor base do preço 2 |
|
valor do desconto
|
price_2.discount_amount.amount | string |
Valor do desconto do preço 2 |
|
desconto por cento
|
price_2.discount_percent | string |
Percentagem de desconto do preço 2 |
|
Montante
|
quantity.amount | number | |
|
tipo
|
quantity.type | string |
quantidade/multiple_choice/single_choice |
Campo de dados
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do campo de dados
|
id | number |
ID do campo de dados |
|
Valor
|
value | string |
Valor do campo de dados |
|
Descrição do campo de dados
|
description | string |
Descrição do campo de dados |
|
Nome do campo de dados
|
name | string |
Nome do campo de dados |
|
Espaço reservado para campo de dados
|
placeholder | string | |
|
ID personalizado
|
_private_ownerside.custom_id | string |
ID personalizada do campo de dados |
|
Tempo de criação do campo de dados
|
_private_ownerside.created_time | string | |
|
Hora atualizada do campo de dados
|
_private_ownerside.updated_time | string |
Webhook_Event
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do contrato
|
contract.id | number |
ID do contrato |
|
ID de retorno de chamada
|
callback_id | string |
ID de retorno de chamada |
|
events
|
events | array of object | |
|
Hora de criação do evento
|
events.created_time | date-time | |
|
ID do evento
|
events.id | number | |
|
Tipo de evento
|
events.type | string | |
|
Signature
|
events.signature | string |
objecto
Este é o tipo 'objeto'.
cadeia (de caracteres)
Este é o tipo de dados básico 'string'.
binário
Este é o tipo de dados básico 'binário'.