Oneflow
仕事をより速くし、生活を容易にする真のデジタル契約でより効果的である。 Oneflow を使用してコントラクト管理プロセスを自動化する
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Oneflow AB |
| URL | https://support.oneflow.com/ |
| support@oneflow.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | Oneflow |
| Website | https://oneflow.com |
| プライバシー ポリシー | https://oneflow.com/privacy-notice/ |
| カテゴリ | 販売および CRM;生産性 |
Oneflow
仕事をより速く、より簡単にする真のデジタル契約でより効果的です。 Oneflow を使用してコントラクト管理プロセスを自動化します。
発行元: Oneflow AB
[前提条件]
Oneflow コネクタを使用するには、アクティブな Oneflow 管理者アカウントが必要です。 まだアカウントをお持ちでない場合は、 試用アカウントを作成してください。
サポートされている操作
アクション
契約の作成
選択したテンプレートからコントラクトを作成します。
参加者をコントラクトに追加する
既存の契約に個人または会社ベースの参加者を追加します。
コントラクトの削除
コントラクトを削除します。
コントラクトに添付ファイルを追加する
既存のコントラクトに、展開された PDF または通常の添付ファイルを追加します。
コントラクトを発行する
指定した配信チャネルを介して、すべての署名者にコントラクトを送信します。
コントラクト ファイルをダウンロードする
署名されたコントラクトの PDF コピーと、既存のコントラクトの添付ファイルまたは検証ファイルをダウンロードします。
Ping Oneflow API
Oneflow API の可用性を確認します。
トリガー (条件や動作を引き起こすもの)
コントラクトが更新されたとき
事前に定義されたコントラクト イベントに基づいてフローをトリガーします。
資格情報の取得
Oneflow コネクタの資格情報を取得するには:
Oneflow アカウントにログインし、[Admin > Account > Extension > API Tokens] に進みます。
[この拡張機能で新しいトークンを生成する] をクリックし、Power Automate Flow の接続ウィザードにトークンを貼り付けます。
既知の問題と制限事項
テスト環境で Webhook 登録が削除されない
Oneflow テスト環境を使用することを選択した場合、フローを削除するか、フローからトリガーを削除した後に、Oneflow テスト アカウントで Webhook が削除されないという既知の問題があります。 回避策として、Oneflow テスト アカウントで Webhook を手動で削除する必要があります。
お問い合わせ
当社のウェブサイト: https://oneflow.com/
カスタマー サポート: https://support.oneflow.com
販売と価格: https://oneflow.com/contact/
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Oneflow API キー | securestring | この API の API キー | 正しい |
| メール アドレス | 文字列 | Oneflow ユーザーの電子メール アドレス | 正しい |
| API URL | 文字列 | 接続先の環境を選択します。 | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| Ping |
このエンドポイントを使用して、Oneflow API が使用可能かどうかを確認します。 |
| コントラクト ファイルをダウンロードする |
特定のコントラクト ファイルを ID で取得します。 |
| コントラクトに製品を追加する |
コントラクト内の既存の製品グループに製品を追加します。 |
| コントラクトの状態を取得する |
特定のコントラクトの状態を ID で取得します。 |
| コントラクトの詳細を取得する |
コントラクトの詳細を ID で取得します。 |
| コントラクトを作成する |
選択したテンプレートに基づいて新しいコントラクトを作成します。 |
| コントラクトを削除する |
ID で特定のコントラクトを削除します。 |
| コントラクトを発行する |
署名のために参加者にコントラクトを送信します。 |
| データ フィールドを更新する |
特定のコントラクトのデータ フィールドを ID で更新します。 |
| 参加者の追加 |
コントラクトに参加者を追加する |
| 添付ファイルをアップロードする |
コントラクトに添付ファイルまたは PDF ドキュメントを追加します。 |
Ping
コントラクト ファイルをダウンロードする
特定のコントラクト ファイルを ID で取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
[次のユーザーとしてダウンロード]
|
x-oneflow-user-email-override | string |
このアクションを実行するユーザーを選択するか、カスタム電子メールを入力します |
|
|
コントラクト ID
|
contract_id | True | string |
コントラクト ID |
|
ファイル ID
|
file_id | True | string |
ファイルの種類: * 1 - 契約 PDF * 2 - 検証 |
戻り値
- ファイル コンテンツ
- binary
コントラクトに製品を追加する
コントラクト内の既存の製品グループに製品を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
コントラクト 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 |
2 次価格値。 つまり、製品にサブスクリプション料金がある場合。 |
|
|
割引額
|
amount | string |
数値としての 2 次割引額。 |
|
|
2 割引率
|
discount_percent | string |
価格 2 の割合としての 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 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コントラクトの状態
|
state | string |
draft/pending/overdue/signed/declined |
|
コントラクト状態の更新時刻
|
state_updated_time | string | |
|
コントラクトの更新時刻
|
updated_time | string |
コントラクトの詳細を取得する
コントラクトの詳細を ID で取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
コントラクト ID
|
contract_id | True | string |
コントラクト ID |
戻り値
- Body
- Contract
コントラクトを作成する
選択したテンプレートに基づいて新しいコントラクトを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
次のように作成します。
|
x-oneflow-user-email |
Oneflow ユーザーの電子メールを指定します。 アクションによって、このユーザーとしてコントラクトが作成されます。 |
||
|
コントラクト名
|
name | string | ||
|
ワークスペース名
|
workspace_id | True | integer |
コントラクトのワークスペースを選択する |
|
テンプレート名
|
template_id | True | integer |
コントラクトを作成するテンプレートを選択する |
|
Datafield
|
custom_id | True | string |
データ フィールドを選択して設定する |
|
価値
|
value | string |
データ フィールドの値 |
戻り値
- Body
- Contract
コントラクトを削除する
ID で特定のコントラクトを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
コントラクト ID
|
contract_id | True | string |
コントラクト ID |
|
[Delete As]\(削除者
|
x-oneflow-user-email-override | string |
このアクションを実行するユーザーを選択するか、カスタム電子メールを入力します |
戻り値
- response
- string
コントラクトを発行する
署名のために参加者にコントラクトを送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
コントラクト ID
|
contract_id | True | string |
コントラクト ID |
|
サブジェクト
|
subject | string |
通知の件名 |
|
|
メッセージ
|
message | string |
通知メッセージ |
|
|
[Publish As]\(公開者
|
x-oneflow-user-email-override | string |
このアクションを実行するユーザーを選択するか、カスタム電子メールを入力します |
戻り値
- Body
- Contract
データ フィールドを更新する
特定のコントラクトのデータ フィールドを 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 |
|
[Add As]\(追加\
|
x-oneflow-user-email-override | string |
このアクションを実行するユーザーを選択するか、カスタム電子メールを入力します |
|
|
参加者の種類
|
participant_type | True | string |
個人/会社 |
|
署名順序
|
signing_order | number |
参加者の注文に署名する |
|
|
パーティー
|
party | True | dynamic |
戻り値
- response
- object
添付ファイルをアップロードする
コントラクトに添付ファイルまたは PDF ドキュメントを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
コントラクト ID
|
contract_id | True | string |
コントラクト ID |
|
File
|
file | True | binary |
アップロードするファイル。 ファイル名は file.ext 形式にする必要があります |
|
[次のユーザーとしてアップロード]
|
upload_as | string |
アップロードする添付ファイルの種類を選択する |
|
|
[実行者]
|
x-oneflow-user-email-override | string |
このアクションを実行するユーザーを選択するか、カスタム電子メールを入力します |
戻り値
- response
- object
トリガー
| コントラクトが更新されたとき |
指定したコントラクト更新イベントの 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 |
Parties コレクション |
|
製品グループ
|
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 | |
|
パーティー ID 番号
|
identification_number | string |
パーティー ID 番号 |
|
Is My Party
|
my_party | boolean |
契約当事者がmy_party |
|
パーティー名
|
name | string | |
|
参加者
|
participants | array of Participant |
Participants コレクション |
|
パーティーの種類
|
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/保留中/失敗/バウンス/成功/開いた |
|
参加者の電子メール
|
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:個々の参加者のアクセス許可を更新する |
|
個人参加者の初回訪問時間
|
_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/保留中/失敗/バウンス/成功/開いた |
|
個々の参加者の電子メール
|
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 | array of Product |
products collection |
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
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
データ フィールド ID
|
id | number |
データ フィールド ID |
|
価値
|
value | string |
データ フィールドの値 |
|
データ フィールドの説明
|
description | string |
データ フィールドの説明 |
|
データ フィールド名
|
name | string |
データ フィールドの名前 |
|
Datafield プレースホルダー
|
placeholder | string | |
|
カスタム ID
|
_private_ownerside.custom_id | string |
データ フィールドのカスタム ID |
|
データ フィールドの作成時刻
|
_private_ownerside.created_time | string | |
|
データ フィールドの更新時刻
|
_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 | |
|
署名
|
events.signature | string |
オブジェクト
これは型 'object' です。
文字列
これは基本的なデータ型 'string' です。
binary
これは基本的なデータ型 'binary' です。