Oneflow
通过真正使工作更快、生活更轻松的数字合同更加有效。 使用 Oneflow 自动执行合同管理过程
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | Oneflow AB |
| URL | https://support.oneflow.com/ |
| support@oneflow.com |
| 连接器元数据 | |
|---|---|
| 发布者 | Oneflow |
| 网站 | https://oneflow.com |
| 隐私策略 | https://oneflow.com/privacy-notice/ |
| 类别 | 销售和 CRM;生产力 |
Oneflow
通过真正使工作更快、更轻松的数字合同更加有效。 使用 Oneflow 自动执行合同管理过程。
发布者：Oneflow AB
先决条件
若要使用 Oneflow 连接器，需要一个有效的 Oneflow 管理员帐户。 如果还没有帐户，请继续 创建一个试用帐户。
支持的操作
行动
创建合同
从所选模板创建协定。
将参与者添加到合同
将个人或基于公司的参与者添加到现有合同中。
删除协定
删除协定。
将附件添加到协定
将展开的 PDF 或常规附件添加到现有合同。
发布协定
通过指定的交付渠道向所有签署方发送合同。
下载合同文件
下载已签名合同的 PDF 副本以及现有合同的任何附件或验证文件。
Ping Oneflow API
检查 Oneflow API 可用性。
Triggers
更新合同时
根据预先定义的协定事件触发流。
获取凭据
若要获取 Oneflow 连接器凭据，请执行以下作：
登录到 Oneflow 帐户，然后转到管理员 > 帐户 > 扩展 > API 令牌。
单击“在此扩展中生成新令牌”，并将令牌粘贴到 Power Automate Flow 中的连接向导中。
已知问题和限制
测试环境中不会删除 Webhook 注册
如果选择使用 Oneflow 测试环境，在删除流或从流中删除触发器后，Oneflow 测试帐户中未删除 Webhook 时，会出现一个已知问题。 应在 Oneflow 测试帐户中手动删除 Webhook 作为解决方法。
联系我们
我们的网站： https://oneflow.com/
客户支持： https://support.oneflow.com
销售和定价： https://oneflow.com/contact/
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| Oneflow API 密钥 | securestring | 此 API 的 Api 密钥 | True |
| 电子邮件地址 | 字符串 | Oneflow 用户电子邮件地址 | True |
| API URL | 字符串 | 选择要连接到的环境。 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| Ping |
使用此终结点检查 Oneflow API 是否可用。 |
| 上传附件 |
将附件或 PDF 文档添加到协定。 |
| 下载合同文件 |
按 ID 检索特定协定文件。 |
| 创建协定 |
基于所选模板创建新协定。 |
| 删除协定 |
按 ID 删除特定协定。 |
| 发布协定 |
将合同发送给参与者进行签名。 |
| 将产品添加到合同 |
将产品添加到合同中的现有产品组。 |
| 更新数据字段 |
按 ID 更新特定协定中的数据字段。 |
| 添加参与者 |
将参与者添加到合同 |
| 获取协定的状态 |
按其 ID 检索特定协定的状态。 |
| 获取合同详细信息 |
按协定 ID 检索协定的详细信息。 |
Ping
上传附件
将附件或 PDF 文档添加到协定。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
合同 ID
|
contract_id | True | string |
合同 ID |
|
文件
|
file | True | binary |
要上传的文件。 文件名应采用 file.ext 格式 |
|
上传为
|
upload_as | string |
选择要上传的附件类型 |
|
|
执行为
|
x-oneflow-user-email-override | string |
选择要执行此作的用户，或输入自定义电子邮件 |
返回
- response
- object
下载合同文件
按 ID 检索特定协定文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
下载为
|
x-oneflow-user-email-override | string |
选择要执行此作的用户，或输入自定义电子邮件 |
|
|
合同 ID
|
contract_id | True | string |
合同 ID |
|
文件 ID
|
file_id | True | string |
文件类型：* 1 - 合同 PDF * 2 - 验证 |
返回
- 文件内容
- binary
创建协定
基于所选模板创建新协定。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
创建为
|
x-oneflow-user-email |
指定 Oneflow 用户电子邮件。 作将创建此用户的协定。 |
||
|
协定名称
|
name | string | ||
|
工作区名称
|
workspace_id | True | integer |
为合同选择工作区 |
|
模板名称
|
template_id | True | integer |
选择要从中创建合同的模板 |
|
Datafield
|
custom_id | True | string |
选择要填充的数据字段 |
|
价值
|
value | string |
Datafield 值 |
返回
- Body
- Contract
删除协定
按 ID 删除特定协定。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
合同 ID
|
contract_id | True | string |
合同 ID |
|
删除为
|
x-oneflow-user-email-override | string |
选择要执行此作的用户，或输入自定义电子邮件 |
返回
- response
- string
发布协定
将合同发送给参与者进行签名。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
合同 ID
|
contract_id | True | string |
合同 ID |
|
Subject
|
subject | string |
通知主题 |
|
|
Message
|
message | string |
通知消息 |
|
|
发布为
|
x-oneflow-user-email-override | string |
选择要执行此作的用户，或输入自定义电子邮件 |
返回
- Body
- Contract
将产品添加到合同
将产品添加到合同中的现有产品组。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
合同 ID
|
x-ms-oneflow-contract_id | True | integer |
合同 ID |
|
产品组
|
x-ms-oneflow-product-group-index | True | integer |
选择要将产品添加到的产品表索引。 从上到下对合同进行排序。 |
|
为对应方锁定的产品？
|
counterparty_lock | boolean |
选择是否希望产品属性可由对应方编辑。 |
|
|
产品说明
|
description | string |
添加有关产品的详细信息。 |
|
|
产品名称
|
name | string |
产品的名称。 |
|
|
金额
|
amount | string |
产品的基数。 |
|
|
折扣金额
|
amount | string |
折扣金额作为数字。 |
|
|
1 折扣百分比
|
discount_percent | string |
折扣作为基本金额的百分比。 |
|
|
金额
|
amount | string |
次要价格值。 即，如果产品具有订阅费用。 |
|
|
折扣金额
|
amount | string |
次要折扣金额作为数字。 |
|
|
2 折扣百分比
|
discount_percent | string |
以价格 2 的百分比表示的次要折扣金额。 |
|
|
金额
|
amount | number |
如果类型为 multiple_choice/single_choice，则为任意正数或 1/0 |
|
|
产品类型
|
type | string |
选择数量输入类型（即复选框、数字、单选）。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
合同状态
|
state | string |
draft/pending/overdue/signed/declined |
|
合同状态更新时间
|
state_updated_time | string | |
|
合同更新时间
|
updated_time | string |
更新数据字段
按 ID 更新特定协定中的数据字段。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
合同 ID
|
contract_id | True | string |
合同 ID |
|
自定义 ID
|
data_field_id | True | string |
数据字段的自定义 ID（外部键）。 |
|
更新为
|
x-oneflow-user-email-override | string |
选择要执行此作的用户，或输入自定义电子邮件 |
|
|
价值
|
value | string |
要为数据字段设置的值。 |
|
|
自定义 ID
|
custom_id | True | string |
数据字段的自定义 ID |
返回
- Body
- Datafield
添加参与者
将参与者添加到合同
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
合同 ID
|
contract_id | True | string |
合同 ID |
|
添加为
|
x-oneflow-user-email-override | string |
选择要执行此作的用户，或输入自定义电子邮件 |
|
|
参与者类型
|
participant_type | True | string |
个人/公司 |
|
签名顺序
|
signing_order | number |
参与者的签名顺序 |
|
|
参与方
|
party | True | dynamic |
返回
- response
- object
获取协定的状态
按其 ID 检索特定协定的状态。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
合同 ID
|
contract_id | True | string |
合同 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
合同状态
|
state | string |
draft/pending/overdue/signed/declined |
|
合同状态更新时间
|
state_updated_time | string | |
|
合同更新时间
|
updated_time | string |
获取合同详细信息
触发器
| 更新合同时 |
为指定的协定更新事件注册 Webhook |
更新合同时
为指定的协定更新事件注册 Webhook
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
更新类型
|
filters | True | array of string | |
|
模板组 ID
|
template_group_id | integer |
（可选）按模板组筛选协定。 |
返回
- Body
- Webhook_Event
定义
合同
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
协定删除权限
|
_permissions.contract:delete | boolean |
用户可以删除协定 |
|
协定名称
|
_private.name | string | |
|
合同价值
|
_private.value.amount | string | |
|
货币
|
_private.value.currency | string | |
|
工作区 ID
|
_private.workspace_id | integer | |
|
合同创建时间
|
_private_ownerside.created_time | string | |
|
模板 ID
|
_private_ownerside.template_id | integer | |
|
可以接收附件
|
available_options.can_receive_attachments | boolean |
合同可以接收附件 |
|
可以接收扩展的 PDF
|
available_options.can_receive_expanded_pdf | boolean |
合同可以接收扩展的 PDF |
|
数据字段
|
data_fields | array of object |
数据收集字段 |
|
创建时间
|
data_fields._private_ownerside.created_time | string |
数据字段created_time |
|
自定义 ID
|
data_fields._private_ownerside.custom_id | string |
数据字段custom_id |
|
更新时间
|
data_fields._private_ownerside.updated_time | string |
数据字段updated_time |
|
描述
|
data_fields.description | string |
数据字段说明 |
|
id
|
data_fields.id | integer |
数据字段 ID |
|
姓名
|
data_fields.name | string |
数据字段名称 |
|
占位符
|
data_fields.placeholder | string |
数据字段占位符 |
|
value
|
data_fields.value | string |
数据字段值 |
|
合同 ID
|
id | integer |
合同 ID |
|
合同结束时间
|
lifecycle_state.contract_end_time | string | |
|
合同开始时间
|
lifecycle_state.contract_start_time | string | |
|
合同取消时间
|
lifecycle_state.cancel_time | string | |
|
合同由终止结束？
|
lifecycle_state.has_ended_by_termination | boolean | |
|
通知期开始时间是否经过？
|
lifecycle_state.has_passed_notice_period_start_time | boolean | |
|
已取消合同
|
lifecycle_state.is_canceled | boolean | |
|
合同定期
|
lifecycle_state.is_recurring | boolean | |
|
生命周期状态
|
lifecycle_state.lifecycle_state | string |
awaiting/active/ended |
|
生命周期状态更新时间
|
lifecycle_state.lifecycle_state_updated_time | string | |
|
各方
|
parties | array of Party |
参与方集合 |
|
产品组
|
product_groups | array of Product_Group |
product_groups集合 |
|
合同发布时间
|
published_time | string | |
|
合同签名到期时间
|
signing_period_expiry_time | string | |
|
合同状态
|
state | string |
draft/pending/overdue/signed/declined |
|
合同状态更新时间
|
state_updated_time | string | |
|
合同更新时间
|
updated_time | string |
参与方
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
参与方国家/地区代码
|
country_code | string | |
|
参与方标识号
|
identification_number | string |
参与方标识号 |
|
我的聚会
|
my_party | boolean |
合同方my_party |
|
群名
|
name | string | |
|
参与者
|
participants | array of Participant |
参与者集合 |
|
群类型
|
type | string |
公司/个人 |
|
参与者
|
participant | Individual_Participant |
单个参与者对象 |
参与者
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
参与者更新合同吗？
|
_permissions.contract:update | boolean | |
|
参与者首次访问时间
|
_private_ownerside.first_visited_time | string | |
|
参与者上次访问时间
|
_private_ownerside.last_visited_time | string | |
|
参与者访问计数
|
_private_ownerside.visits | integer | |
|
参与者传送渠道
|
delivery_channel | string |
email/none/same_device/sms |
|
参与者传递状态
|
delivery_status | string |
not_sent/pending/failure/bounce/success/opened |
|
参与者电子邮件
|
string | ||
|
参与者标识号
|
identification_number | string |
参与者标识号 |
|
参与者my_participant
|
my_participant | boolean | |
|
参与者名称
|
name | string | |
|
参与者是组织者
|
organizer | boolean | |
|
参与者电话号码
|
phone_number | string | |
|
参与者签名方法
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
参与者签名状态
|
sign_state | string |
undecided/signed/declined |
|
参与者签名状态更新时间
|
sign_state_updated_time | string |
sign_state_updated_time |
|
参与者是签名者
|
signatory | boolean | |
|
参与者标题
|
title | string | |
|
参与者 2FA 方法
|
two_step_authentication_method | string |
email/sms/none |
Individual_Participant
单个参与者对象
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
单个参与者可以更新合同
|
_permissions.contract:update | boolean |
contract：update permissions for Individual Participant |
|
个人参与者首次访问
|
_private_ownerside.first_visited_time | string | |
|
个人参与者上次访问时间
|
_private_ownerside.last_visited_time | string | |
|
单个参与者的更新时间
|
_private_ownerside.updated_time | string | |
|
个人参与者访问计数
|
_private_ownerside.visits | integer | |
|
单个参与者传送渠道
|
delivery_channel | string |
email/none/same_device/sms |
|
单个参与者传递状态
|
delivery_status | string |
not_sent/pending/failure/bounce/success/opened |
|
单个参与者电子邮件
|
string | ||
|
单个参与者标识号
|
identification_number | string | |
|
个人参与者是my_participant
|
my_participant | boolean | |
|
单个参与者名称
|
name | string | |
|
个人参与者是组织者
|
organizer | boolean | |
|
单个参与者电话号码
|
phone_number | string | |
|
单个参与者签名方法
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
单个参与者签名状态
|
sign_state | string |
undecided/signed/declined |
|
单个参与者签名状态更新时间
|
sign_state_updated_time | string | |
|
个人参与者是签署人
|
signatory | boolean | |
|
个人参与者标题
|
title | string | |
|
单个参与者 2FA 方法
|
two_step_authentication_method | string |
email/sms/none |
Product_Group
product_groups集合中的product_group项
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
产品组 ID
|
id | integer | |
|
Products
|
products | array of Product |
产品集合 |
产品
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
为对应方锁定？
|
counterparty_lock | boolean |
counterparty_lock |
|
描述
|
description | string | |
|
id
|
id | integer | |
|
姓名
|
name | string | |
|
量
|
price_1.amount.amount | string |
价格 1 的金额值 |
|
基量
|
price_1.base_amount.amount | string |
价格 1 的金额值 |
|
折扣金额
|
price_1.discount_amount.amount | string |
折扣金额 1 |
|
折扣百分比
|
price_1.discount_percent | string |
价格的折扣百分比 1 |
|
量
|
price_2.amount.amount | string |
价格 2 的金额值 |
|
基量
|
price_2.base_amount.amount | string |
价格 2 的基本金额值 |
|
折扣金额
|
price_2.discount_amount.amount | string |
折扣金额 2 |
|
折扣百分比
|
price_2.discount_percent | string |
价格的折扣百分比 2 |
|
量
|
quantity.amount | number | |
|
类型
|
quantity.type | string |
quantity/multiple_choice/single_choice |
Datafield
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Datafield ID
|
id | number |
Datafield Id |
|
价值
|
value | string |
Datafield 值 |
|
Datafield 说明
|
description | string |
数据字段的说明 |
|
Datafield 名称
|
name | string |
数据字段的名称 |
|
Datafield 占位符
|
placeholder | string | |
|
自定义 ID
|
_private_ownerside.custom_id | string |
数据字段的自定义 ID |
|
Datafield 创建时间
|
_private_ownerside.created_time | string | |
|
Datafield 更新时间
|
_private_ownerside.updated_time | string |
Webhook_Event
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
合同 ID
|
contract.id | number |
合同 ID |
|
回调 ID
|
callback_id | string |
回调 ID |
|
events
|
events | array of object | |
|
事件创建时间
|
events.created_time | date-time | |
|
事件 ID
|
events.id | number | |
|
事件类型
|
events.type | string | |
|
Signature
|
events.signature | string |
对象
这是类型“object”。
字符串
这是基本数据类型“string”。
二进制
这是基本数据类型“binary”。