Oneflow
透過真正的數位合約提高效率，讓工作更快、生活更輕鬆。 使用 Oneflow 自動化您的合約管理流程
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Oneflow AB |
| URL | https://support.oneflow.com/ |
| support@oneflow.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Oneflow |
| 網站 | https://oneflow.com |
| 隱私策略 | https://oneflow.com/privacy-notice/ |
| 類別 | 銷售和客戶關係管理;生產力 |
Oneflow
透過真正的數位合約提高效率，讓工作更快、生活更輕鬆。 使用 Oneflow 自動化您的合約管理流程。
發行商： Oneflow AB
先決條件
若要使用 Oneflow 連接器，您需要一個有效的 Oneflow 管理員帳戶。 如果您還沒有帳戶，請繼續 建立試用帳戶。
支援的作業
行動
建立合約
從選取的範本建立合約。
將參與者新增至合約
將個人或公司參與者新增至現有合約。
刪除合約
刪除合約。
將附件新增至合約
將展開的 PDF 或一般附件新增至現有合約。
發佈合約
透過指定的交付管道將合約傳送給所有簽署者。
下載合約檔案
下載已簽署合約的 PDF 副本以及現有合約的任何附件或驗證檔案。
Ping Oneflow API
檢查 Oneflow API 可用性。
觸發器
更新合約時
根據預先定義的合約事件觸發您的流程。
取得認證
若要取得 Oneflow 連接器認證：
登入您的 Oneflow 帳戶並繼續使用管理員 > 帳戶 > 擴充功能 > API 權杖。
按一下 [在此擴充功能中產生新權杖]，並將權杖貼到 Power Automate 流程中的連線精靈中。
已知問題與限制
測試環境中不會刪除 Webhook 註冊
如果您選擇使用 Oneflow 測試環境，則在刪除流程或從流程中移除觸發程式之後，Oneflow 測試帳戶中未刪除 Webhook 時，就會發生已知問題。 作為因應措施，應在您的 Oneflow 測試帳戶中手動刪除 Webhook。
與我們連絡
我們的網站： https://oneflow.com/
客戶支援： https://support.oneflow.com
銷售和定價： https://oneflow.com/contact/
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Oneflow API 金鑰 | securestring | 此 API 的 API 金鑰 | 對 |
| 電子郵件地址 | 字串 | Oneflow 用戶電子郵件地址 | 對 |
| API 網址 | 字串 | 選取您要連線的環境。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| Ping |
使用此端點來檢查 Oneflow API 是否可用。 |
| 上傳附件 |
將附件或 PDF 文件新增至合約。 |
| 下載合約檔案 |
依特定合約檔案的識別碼擷取特定合約檔案。 |
| 刪除合約 |
按其 ID 刪除特定合約。 |
| 取得合約狀態 |
依特定合約的 ID 擷取其狀態。 |
| 取得合約詳細資料 |
依合約的 ID 擷取合約的詳細資料。 |
| 將產品新增至合約 |
將產品新增至合約中的現有產品群組。 |
| 建立合約 |
根據選取的範本建立新合約。 |
| 新增參與者 |
將參與者新增至合約 |
| 更新資料欄位 |
依識別碼更新特定合約中的資料欄位。 |
| 發佈合約 |
將合同發送給參與者簽署。 |
Ping
上傳附件
將附件或 PDF 文件新增至合約。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
合約標識碼
|
contract_id | True | string |
合約標識碼 |
|
檔案
|
file | True | binary |
要上傳的檔案。 檔案名稱應為 file.ext 格式 |
|
上傳為
|
upload_as | string |
選擇要上傳的附件類型 |
|
|
執行方式
|
x-oneflow-user-email-override | string |
選取要執行此動作的使用者，或輸入自訂電子郵件 |
傳回
- response
- object
下載合約檔案
依特定合約檔案的識別碼擷取特定合約檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
下載為
|
x-oneflow-user-email-override | string |
選取要執行此動作的使用者，或輸入自訂電子郵件 |
|
|
合約標識碼
|
contract_id | True | string |
合約標識碼 |
|
檔案標識碼
|
file_id | True | string |
文件類型：* 1 - 合約 PDF * 2 - 驗證 |
傳回
- 檔案內容
- binary
刪除合約
按其 ID 刪除特定合約。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
合約標識碼
|
contract_id | True | string |
合約標識碼 |
|
刪除為
|
x-oneflow-user-email-override | string |
選取要執行此動作的使用者，或輸入自訂電子郵件 |
傳回
- response
- string
取得合約狀態
依特定合約的 ID 擷取其狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
合約標識碼
|
contract_id | True | string |
合約標識碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
合約狀態
|
state | string |
草稿/待處理/逾期/已簽署/已拒絕 |
|
合約狀態更新時間
|
state_updated_time | string | |
|
合約更新時間
|
updated_time | string |
取得合約詳細資料
將產品新增至合約
將產品新增至合約中的現有產品群組。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
合約標識碼
|
x-ms-oneflow-contract_id | True | integer |
合約標識碼 |
|
產品組
|
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 |
選取輸入數量類型 （即核取方塊、數字、單一選取）。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
合約狀態
|
state | string |
草稿/待處理/逾期/已簽署/已拒絕 |
|
合約狀態更新時間
|
state_updated_time | string | |
|
合約更新時間
|
updated_time | string |
建立合約
根據選取的範本建立新合約。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
建立為
|
x-oneflow-user-email |
指定 Oneflow 使用者電子郵件。 動作會以此使用者身分建立合約。 |
||
|
合約名稱
|
name | string | ||
|
工作區名稱
|
workspace_id | True | integer |
選取合約的工作區 |
|
範本名稱
|
template_id | True | integer |
選取要從中建立合約的範本 |
|
資料欄位
|
custom_id | True | string |
選取要填入的資料欄位 |
|
價值觀
|
value | string |
資料欄位值 |
傳回
- 身體
- Contract
新增參與者
將參與者新增至合約
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
合約標識碼
|
contract_id | True | string |
合約標識碼 |
|
新增為
|
x-oneflow-user-email-override | string |
選取要執行此動作的使用者，或輸入自訂電子郵件 |
|
|
參與者類型
|
participant_type | True | string |
個人/公司 |
|
簽署順序
|
signing_order | number |
參加者簽名順序 |
|
|
合作對象
|
party | True | dynamic |
傳回
- response
- object
更新資料欄位
依識別碼更新特定合約中的資料欄位。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
合約標識碼
|
contract_id | True | string |
合約標識碼 |
|
自訂標識碼
|
data_field_id | True | string |
資料欄位的自訂 ID （外部索引鍵）。 |
|
更新為
|
x-oneflow-user-email-override | string |
選取要執行此動作的使用者，或輸入自訂電子郵件 |
|
|
價值觀
|
value | string |
要為資料欄位設定的值。 |
|
|
自訂標識碼
|
custom_id | True | string |
資料欄位的自訂ID |
傳回
- 身體
- Datafield
發佈合約
將合同發送給參與者簽署。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
合約標識碼
|
contract_id | True | string |
合約標識碼 |
|
主旨
|
subject | string |
通知主題 |
|
|
Message
|
message | string |
通知訊息 |
|
|
發佈為
|
x-oneflow-user-email-override | string |
選取要執行此動作的使用者，或輸入自訂電子郵件 |
傳回
- 身體
- Contract
觸發程序
| 更新合約時 |
註冊指定合約更新事件的 Webhook |
更新合約時
註冊指定合約更新事件的 Webhook
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
更新類型
|
filters | True | array of string | |
|
範本群組識別碼
|
template_group_id | integer |
（選用）依範本群組篩選合約。 |
傳回
定義
Contract
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
合約刪除權限
|
_permissions.contract:delete | boolean |
用戶可以刪除合約 |
|
合約名稱
|
_private.name | string | |
|
合約價值
|
_private.value.amount | string | |
|
貨幣
|
_private.value.currency | string | |
|
工作區識別碼
|
_private.workspace_id | integer | |
|
合約建立時間
|
_private_ownerside.created_time | string | |
|
範本識別碼
|
_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 |
資料欄位描述 |
|
識別碼
|
data_fields.id | integer |
資料欄位識別碼 |
|
名稱
|
data_fields.name | string |
資料欄位名稱 |
|
暫存區
|
data_fields.placeholder | string |
資料欄位預留位置 |
|
value
|
data_fields.value | string |
資料欄位值 |
|
合約 ID
|
id | integer |
合約標識碼 |
|
合約結束時間
|
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 |
等待/作用中/已結束 |
|
生命週期狀態更新時間
|
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 |
草稿/待處理/逾期/已簽署/已拒絕 |
|
合約狀態更新時間
|
state_updated_time | string | |
|
合約更新時間
|
updated_time | string |
Party
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
政黨國家代碼
|
country_code | string | |
|
政黨識別號碼
|
identification_number | string |
當事人識別號碼 |
|
是我的黨
|
my_party | boolean |
合約方my_party |
|
政黨名稱
|
name | string | |
|
參與者
|
participants | array of Participant |
參與者集合 |
|
派對類型
|
type | string |
公司/個人 |
|
參與者
|
participant | Individual_Participant |
個別參與者物件 |
參與者
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
參與者可以更新合約嗎？
|
_permissions.contract:update | boolean | |
|
參與者首次訪問時間
|
_private_ownerside.first_visited_time | string | |
|
參加者：最後一次訪問時間
|
_private_ownerside.last_visited_time | string | |
|
參與者造訪次數
|
_private_ownerside.visits | integer | |
|
參與者傳遞管道
|
delivery_channel | string |
電子郵件/無/same_device/簡訊 |
|
參與者傳遞狀態
|
delivery_status | string |
not_sent/待處理/失敗/退回/成功/已開啟 |
|
參與者電子郵件
|
string | ||
|
參與者識別號碼
|
identification_number | string |
參與者識別號碼 |
|
參與者my_participant
|
my_participant | boolean | |
|
參與者姓名
|
name | string | |
|
參與者是組織者
|
organizer | boolean | |
|
參與者電話號碼
|
phone_number | string | |
|
參與者簽名方法
|
sign_method | string |
standard_esign/簡訊/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
參與者簽署狀態
|
sign_state | string |
未決定/已簽署/拒絕 |
|
參與者簽署狀態更新時間
|
sign_state_updated_time | string |
sign_state_updated_time |
|
參與者是簽署人
|
signatory | boolean | |
|
參與者頭銜
|
title | string | |
|
參與者 2FA 方法
|
two_step_authentication_method | string |
電子郵件/簡訊/無 |
Individual_Participant
個別參與者物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
個人參與者可以更新合約
|
_permissions.contract:update | boolean |
合約：更新個別參與者的權限 |
|
個人參加者首次訪問時間
|
_private_ownerside.first_visited_time | string | |
|
個別參與者最後一次訪問時間
|
_private_ownerside.last_visited_time | string | |
|
個人參與者更新時間
|
_private_ownerside.updated_time | string | |
|
個別參與者訪問次數
|
_private_ownerside.visits | integer | |
|
個人參與者傳遞管道
|
delivery_channel | string |
電子郵件/無/same_device/簡訊 |
|
個別參與者的傳遞狀態
|
delivery_status | string |
not_sent/待處理/失敗/退回/成功/已開啟 |
|
個別參與者電子郵件
|
string | ||
|
個人參與者識別號碼
|
identification_number | string | |
|
個人參與者my_participant
|
my_participant | boolean | |
|
個人參與者姓名
|
name | string | |
|
個人參與者是組織者
|
organizer | boolean | |
|
個人參與者電話號碼
|
phone_number | string | |
|
個人參與者簽名方式
|
sign_method | string |
standard_esign/簡訊/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
個別參與者簽署狀態
|
sign_state | string |
未決定/已簽署/拒絕 |
|
個別參與者簽署狀態更新時間
|
sign_state_updated_time | string | |
|
個人參與者為簽署人
|
signatory | boolean | |
|
個人參與者頭銜
|
title | string | |
|
個人參與者 2FA 方法
|
two_step_authentication_method | string |
電子郵件/簡訊/無 |
Product_Group
product_group product_groups收藏中的物品
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
產品群組識別碼
|
id | integer | |
|
Products
|
products | array of Product |
產品收藏 |
Product
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
為交易對手鎖定？
|
counterparty_lock | boolean |
counterparty_lock |
|
描述
|
description | string | |
|
識別碼
|
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 |
數量/multiple_choice/single_choice |
資料欄位
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料欄位識別碼
|
id | number |
資料欄位識別碼 |
|
價值觀
|
value | string |
資料欄位值 |
|
資料欄位描述
|
description | string |
資料欄位的描述 |
|
資料欄位名稱
|
name | string |
資料欄位的名稱 |
|
資料欄位預留位置
|
placeholder | string | |
|
自訂標識碼
|
_private_ownerside.custom_id | string |
資料欄位的自訂ID |
|
資料欄位建立時間
|
_private_ownerside.created_time | string | |
|
資料欄位更新時間
|
_private_ownerside.updated_time | string |
Webhook_Event
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
合約識別碼
|
contract.id | number |
合約識別碼 |
|
回呼 ID
|
callback_id | string |
回呼 ID |
|
events
|
events | array of object | |
|
事件建立時間
|
events.created_time | date-time | |
|
事件識別碼
|
events.id | number | |
|
事件類型
|
events.type | string | |
|
Signature
|
events.signature | string |
物件
這是類型 'object'。
字串
這是基本資料類型「string」。
二進位
這是基本數據類型 『binary』。