Oneflow
Seja mais eficaz com contratos verdadeiramente digitais que facilitam o trabalho e a vida. Automatizar o processo de gerenciamento de contrato com o Oneflow
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 | |
|---|---|
| Nome | AB de fluxo único |
| URL | https://support.oneflow.com/ |
| support@oneflow.com |
| Metadados do conector | |
|---|---|
| Publicador | Oneflow |
| Site | https://oneflow.com |
| Política de privacidade | https://oneflow.com/privacy-notice/ |
| Categorias | Vendas e CRM; Produtividade |
Oneflow
Seja mais eficaz com contratos verdadeiramente digitais que facilitam o trabalho e a vida. Automatize o processo de gerenciamento de contrato com o Oneflow.
Publicador: AB do Oneflow
Pré-requisitos
Para usar o conector do Oneflow, você precisa de uma conta de administrador do Oneflow ativa. Se você ainda não tiver uma conta, vá em frente e crie uma conta de avaliação.
Operações com suporte
Ações
Criar contrato
Crie um contrato com base em 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 regular a um contrato existente.
Publicar contrato
Envie um contrato a todos os signatários por meio de um canal de entrega especificado.
Baixar arquivos de contrato
Baixe uma cópia em PDF de um contrato assinado e qualquer anexo ou arquivo de verificação de um contrato existente.
API de fluxo único de ping
Verifique a disponibilidade da API do Oneflow.
Triggers
Quando um contrato é atualizado
Dispare seu fluxo com base em eventos de contrato predifinados.
Obtendo credenciais
Para obter as credenciais do conector do Oneflow:
Faça logon em sua conta do 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 Fluxo do Power Automate.
Problemas e limitações conhecidos
O registro do webhook não é excluído no ambiente de teste
Se você optar por usar o ambiente de teste do Oneflow, haverá um problema conhecido quando um webhook não é excluído em sua conta de teste do Oneflow depois que você exclui um fluxo ou remove um gatilho de um fluxo. Os webhooks devem ser excluídos manualmente em sua conta de teste do Oneflow como uma solução alternativa.
Entre em contato conosco
Nosso site: https://oneflow.com/
Suporte ao cliente: https://support.oneflow.com
Vendas e preços: https://oneflow.com/contact/
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.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API de fluxo único | secureString | A chave de API para esta api | Verdade |
| Endereço de email | cadeia | Endereço de email do usuário do Oneflow | Verdade |
| API URL | cadeia | Selecione o ambiente ao qual você deseja se conectar. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à 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 em um contrato. |
| Atualizar um campo de dados |
Atualize um campo de dados no contrato específico por sua ID. |
| Baixar um arquivo de contrato |
Recupere um arquivo de contrato específico por sua 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. |
| Excluir um contrato |
Exclua um contrato específico por sua ID. |
| Obter detalhes do contrato |
Recupere os detalhes de um contrato por sua ID. |
| Obter o status de um contrato |
Recupere o status de um contrato específico por sua ID. |
| Ping |
Use esse 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
| Nome | Chave | Obrigató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 essa ação ou insira um email personalizado |
|
|
Tipo de Participante
|
participant_type | True | string |
Individual/Empresa |
|
Ordem de assinatura
|
signing_order | number |
Assinar ordem do participante |
|
|
entidade
|
party | True | dynamic |
Retornos
- response
- object
Adicionar produto a um contrato
Adicione um produto a um grupo de produtos existente em um contrato.
Parâmetros
| Nome | Chave | Obrigató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 do produto ao qual adicionar os produtos. Ordenado de cima para baixo no contrato. |
|
Produto bloqueado para equivalentes?
|
counterparty_lock | boolean |
Selecione se deseja que os atributos do produto sejam editáveis por equivalentes. |
|
|
Descrição do produto
|
description | string |
Adicione detalhes sobre o produto. |
|
|
Nome do Produto
|
name | string |
O nome do produto. |
|
|
Quantidade
|
amount | string |
Valor base para o produto. |
|
|
Valor do desconto
|
amount | string |
Valor do desconto como um número. |
|
|
1 Porcentagem de Desconto
|
discount_percent | string |
Desconto como um percentual do valor base. |
|
|
Quantidade
|
amount | string |
Valor de preço secundário. Ou seja, se o produto tiver uma taxa de assinatura. |
|
|
Valor do desconto
|
amount | string |
Valor de desconto secundário como um número. |
|
|
2 Porcentagem de Desconto
|
discount_percent | string |
Valor de desconto secundário como um percentual de Preço 2. |
|
|
Quantidade
|
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 entrada de quantidade (ou seja, uma caixa de seleção, número, seleção única). |
Retornos
| Nome | 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 por sua ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
ID personalizada
|
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 essa ação ou insira um email personalizado |
|
|
Value
|
value | string |
Valor a ser definido para o campo de dados. |
|
|
ID personalizada
|
custom_id | True | string |
ID personalizada do campo de dados |
Retornos
- Corpo
- Datafield
Baixar um arquivo de contrato
Recupere um arquivo de contrato específico por sua ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Baixar como
|
x-oneflow-user-email-override | string |
Selecione o usuário para executar essa ação ou insira um email personalizado |
|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
ID do arquivo
|
file_id | True | string |
Tipo de arquivo: * 1 – CONTRATO PDF * 2 – Verificação |
Retornos
- Conteúdo do arquivo
- binary
Carregar anexos
Adicione um anexo ou um documento PDF a um contrato.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
File
|
file | True | binary |
Arquivo a ser carregado. O nome do arquivo deve estar no formato file.ext |
|
Carregar como
|
upload_as | string |
selecionar o tipo de anexo a ser carregado |
|
|
Executar como
|
x-oneflow-user-email-override | string |
Selecione o usuário para executar essa ação ou insira um email personalizado |
Retornos
- response
- object
Criar um contrato
Crie um novo contrato com base no modelo selecionado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Criar como
|
x-oneflow-user-email |
Especifique o email do usuário do 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 workspace para seu contrato |
|
Nome do modelo
|
template_id | True | integer |
Selecione um modelo do qual criar seu contrato |
|
Datafield
|
custom_id | True | string |
Selecione o campo de dados a ser preenchido |
|
Value
|
value | string |
Valor de datafield |
Retornos
- Corpo
- Contract
Excluir um contrato
Exclua um contrato específico por sua ID.
Parâmetros
| Nome | Chave | Obrigató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 essa ação ou insira um email personalizado |
Retornos
- response
- string
Obter detalhes do contrato
Recupere os detalhes de um contrato por sua ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
Retornos
- Corpo
- Contract
Obter o status de um contrato
Recupere o status de um contrato específico por sua ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
Retornos
| Nome | 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 esse ponto de extremidade para verificar se a API do Oneflow está disponível.
Retornos
- response
- object
Publicar um contrato
Envia contrato aos participantes para assinatura.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do contrato
|
contract_id | True | string |
ID do contrato |
|
Assunto
|
subject | string |
Assunto de notificação |
|
|
Message
|
message | string |
Mensagem de notificação |
|
|
Publicar como
|
x-oneflow-user-email-override | string |
Selecione o usuário para executar essa ação ou insira um email personalizado |
Retornos
- Corpo
- Contract
Gatilhos
| 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
| Nome | Chave | Obrigató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. |
Retornos
- Corpo
- Webhook_Event
Definições
Contrato
| Nome | 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 | |
|
Workspace Id
|
_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 |
O 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 |
Coleta de campos de dados |
|
tempo criado
|
data_fields._private_ownerside.created_time | string |
Campo de dados created_time |
|
ID personalizada
|
data_fields._private_ownerside.custom_id | string |
Campo de dados custom_id |
|
Tempo atualizado
|
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 |
|
espaço reservado
|
data_fields.placeholder | string |
Espaço reservado para campo de dados |
|
value
|
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 | |
|
Hora de cancelamento do contrato
|
lifecycle_state.cancel_time | string | |
|
Contrato encerrado por rescisão?
|
lifecycle_state.has_ended_by_termination | boolean | |
|
A hora de início do período de aviso passou?
|
lifecycle_state.has_passed_notice_period_start_time | boolean | |
|
O contrato foi 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 atualizado do estado do ciclo de vida
|
lifecycle_state.lifecycle_state_updated_time | string | |
|
Partes
|
parties | array of Party |
Coleção parties |
|
Grupos de produtos
|
product_groups | array of Product_Group |
coleção product_groups |
|
Tempo de publicação do contrato
|
published_time | string | |
|
Tempo 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
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Código do país de festa
|
country_code | string | |
|
Número de identificação da parte
|
identification_number | string |
Número de identificação da parte |
|
É Minha Festa
|
my_party | boolean |
A parte do contrato é my_party |
|
Nome da festa
|
name | string | |
|
Participantes
|
participants | array of Participant |
Coleção de participantes |
|
Tipo de festa
|
type | string |
empresa/indivíduo |
|
participante
|
participant | Individual_Participant |
Objeto participante individual |
Participante
| Nome | 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 | |
|
Hora da última visita do participante
|
_private_ownerside.last_visited_time | string | |
|
Contagem de visitas do participante
|
_private_ownerside.visits | integer | |
|
Canal de entrega do participante
|
delivery_channel | string |
email/none/same_device/sms |
|
Status de entrega do participante
|
delivery_status | string |
not_sent/pending/failure/bounce/success/opened |
|
Email do participante
|
string | ||
|
Número de identificação do participante
|
identification_number | string |
Número de identificação do participante |
|
O participante está my_participant
|
my_participant | boolean | |
|
Nome do participante
|
name | string | |
|
O participante é organizador
|
organizer | boolean | |
|
Número de telefone do participante
|
phone_number | string | |
|
Método de sinal do participante
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Estado do sinal do participante
|
sign_state | string |
decisa/assinada/recusada |
|
Hora atualizada do estado do sinal do participante
|
sign_state_updated_time | string |
sign_state_updated_time |
|
Participante é signatário
|
signatory | boolean | |
|
Título do participante
|
title | string | |
|
Método 2FA do participante
|
two_step_authentication_method | string |
email/sms/none |
Individual_Participant
Objeto participante individual
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Participante individual pode atualizar contrato
|
_permissions.contract:update | boolean |
permissões contract:update para Participante Individual |
|
Hora da primeira visita do participante individual
|
_private_ownerside.first_visited_time | string | |
|
Hora da última visita do participante individual
|
_private_ownerside.last_visited_time | string | |
|
Tempo atualizado do participante individual
|
_private_ownerside.updated_time | string | |
|
Contagem de visitas de participantes individuais
|
_private_ownerside.visits | integer | |
|
Canal de entrega de participantes individuais
|
delivery_channel | string |
email/none/same_device/sms |
|
Status de entrega de participante individual
|
delivery_status | string |
not_sent/pending/failure/bounce/success/opened |
|
Email de participante individual
|
string | ||
|
Número de identificação de participante individual
|
identification_number | string | |
|
O participante individual é my_participant
|
my_participant | boolean | |
|
Nome do participante individual
|
name | string | |
|
Participante individual é organizador
|
organizer | boolean | |
|
Número de telefone de participante individual
|
phone_number | string | |
|
Método de sinal de participante individual
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Estado de sinal de participante individual
|
sign_state | string |
decisa/assinada/recusada |
|
Tempo atualizado do estado do sinal de participante individual
|
sign_state_updated_time | string | |
|
Participante individual é signatário
|
signatory | boolean | |
|
Título de participante individual
|
title | string | |
|
Método 2FA de participante individual
|
two_step_authentication_method | string |
email/sms/none |
Product_Group
product_group item na coleção product_groups
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do Grupo de Produtos
|
id | integer | |
|
Products
|
products | array of Product |
coleção de produtos |
Product
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
bloqueado para equivalentes?
|
counterparty_lock | boolean |
counterparty_lock |
|
descrição
|
description | string | |
|
id
|
id | integer | |
|
nome
|
name | string | |
|
quantidade
|
price_1.amount.amount | string |
Valor do valor do preço 1 |
|
valor base
|
price_1.base_amount.amount | string |
Valor do valor do preço 1 |
|
valor do desconto
|
price_1.discount_amount.amount | string |
Valor do desconto de preço 1 |
|
percentual de desconto
|
price_1.discount_percent | string |
Percentual de desconto do preço 1 |
|
quantidade
|
price_2.amount.amount | string |
Valor do valor do preço 2 |
|
valor 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 de preço 2 |
|
Percentual de desconto
|
price_2.discount_percent | string |
Percentual de desconto do preço 2 |
|
quantidade
|
quantity.amount | number | |
|
tipo
|
quantity.type | string |
quantity/multiple_choice/single_choice |
Datafield
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do datafield
|
id | number |
Datafield Id |
|
Value
|
value | string |
Valor de datafield |
|
Descrição do datafield
|
description | string |
Descrição do campo de dados |
|
Nome do campo de dados
|
name | string |
Nome do campo de dados |
|
Espaço reservado de datafield
|
placeholder | string | |
|
ID personalizada
|
_private_ownerside.custom_id | string |
ID personalizada do campo de dados |
|
Datafield created time
|
_private_ownerside.created_time | string | |
|
Tempo atualizado do datafield
|
_private_ownerside.updated_time | string |
Webhook_Event
| Nome | 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 |
objeto
Esse é o tipo 'object'.
cadeia
Esse é o tipo de dados básico 'string'.
binário
Esse é o tipo de dados básico 'binary'.