立即簽名
SignNow 為企業、法律、人力資源、醫療保健和財務團隊提供安全、合規且可審計的電子簽名工作流程。 使用 SignNow 連接器以角色為基礎的順序傳送和追蹤簽名請求、預先填寫文件欄位以及管理文件群組。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | 說明中心 |
| URL | https://support.signnow.com/ |
| integrations@pdffiller.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 達達文檔 |
| 網站 | https://signnow.com |
| 隱私策略 | https://www.signnow.com/privacy_policy |
| 類別 | 生產力;人力資源 |
SignNow 連接器
SignNow 為企業、法律、人力資源、醫療保健和財務團隊提供安全、合規且可審計的電子簽名工作流程。 使用 SignNow 連接器以角色為基礎的順序傳送和追蹤簽名請求、預先填寫文件欄位以及管理文件群組。
Pre-requisites
您需要 SignNow 帳戶 和 SignNow API 訂閱才能繼續。
部署範例
首先,使用您自己的值更新 apiProperties.json 中的 clientId 值。
執行下列命令並遵循提示:
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <client_secret>
支援的動作和觸發器
如需詳細資訊,請參閱 文件 。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 上傳文件 |
將文件上傳至 SignNow |
| 下載文件 |
從 SignNow 下載文件 |
| 刪除文件 |
從 SignNow 刪除文件 |
| 刪除文件內嵌邀請 |
此動作會刪除文件的內嵌邀請 |
| 刪除文件群組內嵌邀請 |
此動作會刪除特定文件群組的內嵌邀請 |
| 取代文件群組邀請中的收件者 |
此動作會依其邀請 ID 取代文件群組邀請中的收件者。 您還可以為每個文檔設置邀請到期、提醒、重新分配權限和拒絕選項 |
| 取代文件邀請中的收件者 |
此動作會根據收件者的角色取代文件邀請中的收件者。 它還允許更新邀請設置,例如身份驗證類型、到期天數和每個角色的其他高級參數 |
| 取得文件欄位 |
從文件中的可填欄位擷取值 |
| 取得文件欄位 [已棄用] |
此動作已被取代。 請改用 取得文件欄位 。
|
| 取得文件清單 |
擷取使用者文件清單 |
| 取得文件結構描述 [已淘汰] |
此動作已被取代。 請改用 取得文件結構描述 。
|
| 取得文件群組 |
擷取使用者的文件群組清單 |
| 取得文件群組 |
擷取使用者的文件群組清單 |
| 取得文件群組邀請狀態 |
此動作會擷取文件群組邀請的相關資訊,包括每個步驟和動作的狀態 |
| 取得文件資訊 |
獲取文檔屬性,如名稱、ID、創建/更新日期等。 |
| 取得文件邀請狀態 |
此動作會擷取文件邀請的相關資訊,包括每個步驟和動作的狀態 |
| 取消邀請 |
簽名邀請取消 |
| 已棄用 - 進階文件邀請 |
動作已被取代。 使用手動定義結構描述的邀請請求。 它允許為將來生成的文檔設置邀請 |
| 已棄用 - 邀請簽署 |
動作已被取代。 邀請其他人填寫並簽署文件 |
| 已棄用 - 邀請簽署文件群組 |
動作已被取代。 邀請其他人填寫並簽署文件群組 |
| 建立文件內嵌傳送連結 |
此動作會產生特定文件的內嵌傳送連結,讓第三方使用者準備並傳送文件以供簽署 |
| 建立文件內嵌邀請 |
此動作會為文件建立內嵌的簽署邀請。 建立邀請後,產生內嵌的簽署連結 |
| 建立文件群組內嵌傳送連結 |
此動作會為特定文件群組產生內嵌的傳送連結,讓協力廠商使用者準備並傳送文件群組以供簽署 |
| 建立文件群組內嵌邀請 |
此動作會為文件群組建立內嵌的簽署邀請。 建立邀請後,產生內嵌的簽署連結 |
| 建立簽署連結 |
產生文件連結並共用,讓文件簽署 |
| 從多個檔案建立文件群組 |
透過將多個檔案上傳為 base64 編碼字串來建立文件群組 |
| 從範本建立文件 |
從選取的範本產生文件 |
| 從群組範本建立文件群組 |
從選取的群組範本建立文件群組 |
| 產生文件內嵌邀請連結 |
此動作會產生文件內嵌邀請的連結 |
| 產生文件群組內嵌邀請連結 |
此動作會產生文件群組內嵌邀請的連結 |
| 邀請簽署文件 |
此動作會建立並傳送要簽署之文件的欄位邀請 |
| 邀請簽署文件群組 |
此動作會建立簽署文件群組的邀請。 您可以設定多步驟工作流程,讓不同的收件者在不同階段對文件群組採取行動 |
| 預先填入文件欄位值 |
使用特定值自動填入文件中的可填寫欄位 |
| 預先填入文件欄位值 [已淘汰] |
此動作已被取代。 請改用 預填文件欄位值 。
|
| 預先填入文件群組智慧欄位值 |
使用特定值自動填入文件中的智慧欄位 |
| 預先填入文件群組欄位值 |
使用特定值自動填充文檔中的可填寫字段 |
| 預先填入智慧欄位值 |
預先填入指定文件的「智慧型欄位」值 |
上傳文件
將文件上傳至 SignNow
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
file | True | file |
要上傳的檔案 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件 ID
|
id | DocumentId |
唯一文件 ID |
下載文件
從 SignNow 下載文件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
doc_id | True | string |
指定唯一的文件 ID 或從清單中選取文件 |
|
格式
|
mode | string |
選擇要下載的文件格式 |
傳回
- response
- binary
刪除文件
從 SignNow 刪除文件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
doc_id | True | string |
指定唯一的文件識別碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
地位
|
status | string |
文件移除狀態 |
刪除文件內嵌邀請
此動作會刪除文件的內嵌邀請
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
id | True | string |
文件 ID |
刪除文件群組內嵌邀請
此動作會刪除特定文件群組的內嵌邀請
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件群組 ID
|
id | True | string |
文件群組 ID |
取代文件群組邀請中的收件者
此動作會依其邀請 ID 取代文件群組邀請中的收件者。 您還可以為每個文檔設置邀請到期、提醒、重新分配權限和拒絕選項
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件群組 ID
|
id | True | string |
文件群組 ID |
|
邀請ID
|
invite_id | True | string |
文件群組邀請 ID |
|
步驟識別碼
|
step_id | string |
文件群組邀請中邀請步驟的識別碼 |
|
|
要取代的收件者
|
recipient_to_update | string |
要替換的收件者的電子郵件 |
|
|
新收件者
|
new_recipient | string |
新收件者的電子郵件 |
|
|
到期日
|
expiration_days | integer |
邀請到期的天數;最多 30 天 |
|
|
提醒
|
reminder | integer |
在多少天內向簽署者發送提醒;最多 30 天 |
|
|
文件 ID
|
document_id | True | string |
文件群組中的文件 ID |
|
允許轉發
|
allow_forwarding | boolean |
是否允許收件者將此邀請重新指派給另一個電子郵件地址。 可能的值:False - 不允許。 True - 允許。 |
|
|
允許依簽章拒絕
|
decline_by_signature | boolean |
定義是否在簽名欄位上顯示 [拒絕簽署] 選項。 True:顯示拒絕選項;False:隱藏拒絕選項 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
地位
|
status | string |
收件人替換狀態 |
取代文件邀請中的收件者
此動作會根據收件者的角色取代文件邀請中的收件者。 它還允許更新邀請設置,例如身份驗證類型、到期天數和每個角色的其他高級參數
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
id | True | string |
文件 ID |
|
Role
|
role | True | string |
要取代的收件者的角色名稱 |
|
新電子郵件
|
True | string |
新收件者電子郵件 |
|
|
Role
|
role | True | string |
需要額外邀請參數的角色名稱 |
|
到期日
|
expiration_days | integer |
邀請到期的天數。 最多 30 天 |
|
|
允許依簽章拒絕
|
decline_by_signature | boolean |
定義是否在簽名欄位上顯示 [拒絕簽署] 選項。 True:顯示拒絕選項;False:隱藏拒絕選項 |
|
|
提醒
|
reminder | integer |
在多少天內向收件人發送提醒。 最多 30 天 |
|
|
驗證類型
|
authentication_type | string |
在簽署工作階段期間用於收件者驗證的驗證類型。 允許的值:「密碼」、「電話」和「簡訊」 |
|
|
驗證密碼
|
authentication_password | string |
為簽署者驗證設定的密碼。 「密碼」驗證類型需要 |
|
|
驗證電話
|
authentication_phone | string |
用於驗證簽署者的電話號碼。 「電話通話」和「簡訊」驗證類型為必要項目。 範例:+1XXXXXXXXX |
|
|
驗證簡訊訊息
|
authentication_sms_message | string |
傳送給簽署者的自訂簡訊訊息,包含 {password} 預留位置。 與「簡訊」驗證類型一起使用。 如果沒有此參數,簽署者會收到帶有自動產生密碼(解鎖碼)的預設簡訊 - 「SignNow 文件邀請解鎖碼:123456」。 範例:輸入密碼 {password} 以解除鎖定文件 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
替換
|
replacements | array of object |
新收件人的詳細信息 |
|
新的邀請ID
|
replacements.new_invite_id | string |
新欄位邀請ID |
|
Role
|
replacements.role | string |
已取代之收件者的角色名稱 |
|
新電子郵件
|
replacements.new_email | string |
新收件者電子郵件 |
取得文件欄位
從文件中的可填欄位擷取值
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template_id | True | string |
指定要從中取得欄位的文件範本 |
|
文件 ID
|
doc_id | True | string |
指定唯一的文件識別碼 |
傳回
取得文件欄位 [已棄用]
此動作已被取代。 請改用 取得文件欄位 。
取得文件欄位值。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template_id | True | string |
指定要從中取得欄位的文件範本 |
|
文件 ID
|
doc_id | True | string |
指定唯一的文件識別碼 |
傳回
取得文件清單
擷取使用者文件清單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template | boolean |
指定是否應擷取文件或範本 |
|
|
包括預設範本
|
includeDefaultTemplate | boolean |
指定是否應將預設範本新增至範本清單 |
傳回
- response
- array of DocumentProperties
取得文件結構描述 [已淘汰]
此動作已被取代。 請改用 取得文件結構描述 。
取得 OpenAPI 文件結構描述
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
doc_id | string |
指定唯一的文件識別碼 |
|
|
欄位類型篩選器
|
select | string |
用逗號分隔您要擷取的欄位類型 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
properties
|
properties | object |
取得文件群組
擷取使用者的文件群組清單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組範本
|
doc_group_id | True | string |
從清單中選取群組範本 |
|
Template
|
template | True | boolean |
指定是否應擷取文件群組或群組範本 |
傳回
取得文件群組
擷取使用者的文件群組清單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template | True | boolean |
指定是否應擷取文件群組或群組範本 |
|
限制
|
limit | integer |
退回的項目總數(介於 1 到 50 之間) |
|
|
Offset
|
offset | integer |
集合中要傳回的第一個項目的 (從零開始) 位移 |
傳回
取得文件群組邀請狀態
此動作會擷取文件群組邀請的相關資訊,包括每個步驟和動作的狀態
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件群組 ID
|
id | True | string |
文件群組 ID |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件群組邀請標識符
|
document_group_invite_id | string |
文件群組的邀請ID |
|
文件群組狀態
|
status | string |
文件群組簽署狀態。 可能的值:「已建立」、「擱置」、「已履行」、「已取消」 |
|
擁有者電子郵件
|
owner_email | string |
文件群組擁有者的電子郵件地址 |
|
文件組被拒絕
|
is_document_declined | boolean |
如果簽署者或核准者拒絕群組中的任何文件,則傳回 'true';否則,傳回 'false' |
|
steps
|
steps | array of object |
Steps |
|
步驟識別碼
|
steps.step_id | string |
文件群組邀請中的步驟識別碼 |
|
簽署訂單
|
steps.signing_order | integer |
簽署順序 |
|
文件標識碼
|
steps.document_id | string |
文件 ID |
|
文件名稱
|
steps.document_name | string |
文件名稱 |
|
簽署者電子郵件
|
steps.signer_email | string |
收件者電子郵件地址 |
|
角色名稱
|
steps.role_name | string |
收件者角色名稱 |
|
動作類型
|
steps.action_type | string |
文件中收件者所需的動作。 可能的值:「Sign」、「View」、「Approve」或「FreeFormSign」 |
|
步驟邀請ID
|
steps.invite_id | string |
邀請步驟的ID |
|
地位
|
steps.status | string |
步驟的簽署狀態 |
|
已拒絕
|
steps.declined | boolean |
如果此步驟中的收件者拒絕文件,則為 True |
|
拒絕原因
|
steps.decline_reason | string |
收件者在拒絕文件時提供的訊息 |
|
已建立
|
steps.created | integer |
建立步驟的日期 |
|
Updated
|
steps.updated | integer |
上次更新步驟狀態的日期 |
取得文件資訊
獲取文檔屬性,如名稱、ID、創建/更新日期等。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template | True | boolean |
指定是否應擷取文件或範本 |
|
文件 ID
|
doc_id | True | string |
指定唯一的文件 ID 或從清單中選取文件 |
傳回
取得文件邀請狀態
此動作會擷取文件邀請的相關資訊,包括每個步驟和動作的狀態
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
id | True | string |
文件 ID |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件被拒絕
|
is_document_declined | boolean |
如果文件被簽署者或核准者拒絕,則為 true,否則為 false |
|
steps
|
steps | array of object |
Steps |
|
簽署訂單
|
steps.signing_order | integer |
簽署順序 |
|
收件者電子郵件
|
steps.signer_email | string |
收件者電子郵件地址 |
|
角色名稱
|
steps.role_name | string |
收件者角色名稱 |
|
動作類型
|
steps.action_type | string |
文件中收件者所需的動作。 可能的值:「Sign」、「View」、「Approve」或「FreeFormSign」 |
|
邀請ID
|
steps.invite_id | string |
邀請ID |
|
地位
|
steps.status | string |
簽署狀態。 可能的值:「已建立」、「擱置」、「已履行」、「已取消」、「略過」 |
|
已拒絕
|
steps.declined | boolean |
如果此步驟的收件者拒絕文件,則傳回 'true' |
|
拒絕原因
|
steps.decline_reason | string |
收件者在拒絕文件時提供的訊息 |
|
已建立
|
steps.created | integer |
建立步驟的日期 |
|
Updated
|
steps.updated | integer |
上次更新步驟狀態的日期 |
取消邀請
已棄用 - 進階文件邀請
動作已被取代。 使用手動定義結構描述的邀請請求。 它允許為將來生成的文檔設置邀請
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
doc_id | True | string |
提供文件 ID |
|
名稱
|
role | string |
簽署者的角色名稱 |
|
|
電子郵件
|
指定簽署者的電子郵件 |
|||
|
電話號碼(透過簡訊邀請)
|
phone_invite | string |
指定 +XXXXXXXXXXXX 收件人的電話號碼。 透過簡訊邀請時需要。 |
|
|
訂單
|
order | integer |
設定多個簽署者的簽署順序 |
|
|
個人化主題
|
subject | string |
為簽署者新增個人化主旨 |
|
|
個人化訊息
|
message | string |
為簽署者新增個人化訊息 |
|
|
驗證類型
|
authentication_type | string |
透過密碼、簡訊或電話驗證使用者身分 |
|
|
密碼
|
password | string |
設定驗證類型密碼的密碼 |
|
|
電話
|
phone | string |
為驗證類型 電話 或 簡訊 指定 +XXXXXXXXXX 電話號碼 |
|
|
到期前天數
|
expiration_days | integer |
讓簽署者在邀請到期的天數內收到通知 |
|
|
發送提醒
|
reminder | integer |
傳送邀請後自動跟進電子郵件提醒的天數 |
|
|
每 X 天發送一次提醒
|
remind_repeat | integer |
收件人將每隔設定的天數收到一封提醒電子郵件。 |
|
|
允許轉發
|
reassign | boolean |
允許簽署者將簽署委派給其他人 |
|
|
在簽名上顯示拒絕
|
decline_by_signature | boolean |
如果收件者拒絕簽署文件,請將簽名欄位蓋章為「拒絕簽署」 |
|
|
CC
|
cc | string |
以逗號分隔的電子郵件,將在邀請中進行 Carbon 複製 |
|
|
主旨
|
subject | string |
輸入您的主旨 |
|
|
Message
|
message | string |
輸入您的訊息 |
|
|
完成後向各方發送電子郵件
|
on_complete | string |
簽署文件時,各方都會收到通知電子郵件 |
傳回
- response
- object
已棄用 - 邀請簽署
動作已被取代。 邀請其他人填寫並簽署文件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template | True | boolean |
指定是否應擷取文件或範本 |
|
文件
|
template_id | True | string |
從清單中選取範本 |
|
body
|
body | True | dynamic |
傳回
- response
- object
已棄用 - 邀請簽署文件群組
動作已被取代。 邀請其他人填寫並簽署文件群組
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template | True | boolean |
指定是否應擷取文件群組或群組範本 |
|
文件群組
|
template_group_id | True | string |
從清單中選取文件群組 |
|
body
|
body | True | dynamic |
傳回
- response
- object
建立文件內嵌傳送連結
此動作會產生特定文件的內嵌傳送連結,讓第三方使用者準備並傳送文件以供簽署
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
id | True | string |
文件 ID |
|
類型
|
type | string |
指定連結應開啟的傳送步驟。 可能的值:「邀請」:開啟文件的「傳送邀請」頁面,使用者可以在其中新增簽署者電子郵件、主旨、訊息等。「文件」:在編輯器中開啟文件以新增可填寫的欄位,然後開啟「傳送邀請」頁面 |
|
|
重新導向 URI
|
redirect_uri | string |
內嵌傳送設定後開啟的頁面。 如果新增「重新導向目標」,則為必要項目 |
|
|
連結到期
|
link_expiration | integer |
指定連結將保持作用中的分鐘數。 允許的範圍:15 到 45 分鐘。 管理員層級使用者最多可以將持續時間設定為 43200 分鐘 |
|
|
重新導向目標
|
redirect_target | string |
決定是否要在瀏覽器的新索引標籤中開啟重新導向 URI,或在簽署工作階段之後在相同的索引標籤中開啟重新導向 URI。 可能的值:「在新分頁中」 – 在新分頁中開啟連結,「在同一分頁中」 — 在同一分頁中開啟連結 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
網址
|
url | string |
內嵌文件傳送的連結 |
建立文件內嵌邀請
此動作會為文件建立內嵌的簽署邀請。 建立邀請後,產生內嵌的簽署連結
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
id | True | string |
文件 ID |
|
簽署者電子郵件
|
True |
收件者電子郵件地址 |
||
|
Role
|
role | True | string |
收件者角色名稱,例如「簽署者 1」(不支援檢視者角色) |
|
訂單
|
order | True | integer |
簽署順序 |
|
名稱公式
|
name_formula | string |
使用前置詞 (任何文字) 和可填寫欄位資料產生完整文件名稱的公式。 範例:「Contract|signer_name|signed_date」,其中「Contract」是前置詞,「signer_name」和「signed_date」是可填寫欄位的名稱 |
|
|
Role
|
role | True | string |
收件者角色名稱,例如「簽署者 1」(不支援檢視者角色) |
|
語言
|
language | string |
指定簽署者簽署工作階段和通知電子郵件的語言。 可能的值:en 代表英文,es 代表西班牙文,fr 代表法文。 如果未設定,則語言由您的 SignNow 帳戶的語言決定 |
|
|
名字
|
first_name | string |
收件人名字 |
|
|
姓氏
|
last_name | string |
收件者姓氏 |
|
|
必要的預設簽名名稱
|
required_preset_signature_name | string |
簽名欄位的預先填入文字,已鎖定以供收件者編輯。 不能與「prefill_signature_name」或「force_new_signature」一起使用 |
|
|
預先填入簽名名稱
|
prefill_signature_name | string |
具有簽名名稱的字串,當簽署者按一下簽名欄位時出現。 簽署者可以編輯簽名 |
|
|
需要新簽名
|
force_new_signature | boolean |
定義簽署者是否可以使用其儲存的簽名。 如果設定為「true」,簽署者必須新增簽名。 如果設定為「false」,簽署者可以使用已儲存的簽名 |
|
|
重新導向 URI
|
redirect_uri | string |
簽署工作階段完成後開啟的連結 |
|
|
拒絕重新導向 Uri
|
decline_redirect_uri | string |
收件者拒絕簽署文件後開啟的連結 |
|
|
關閉重新導向 Uri
|
close_redirect_uri | string |
收件者在簽署工作階段期間按一下 [儲存進度] 和 [稍後完成] 或 [在檢視模式中關閉] 時開啟的連結 |
|
|
重新導向目標
|
redirect_target | string |
決定是否要在瀏覽器的新索引標籤中開啟重新導向 URI,或在簽署工作階段之後在相同的索引標籤中開啟重新導向 URI。 可能的值:「在新分頁中」 – 在新分頁中開啟連結,「在同一分頁中」 — 在同一分頁中開啟連結 |
|
|
驗證類型
|
authentication_type | string |
在簽署工作階段期間用於收件者驗證的驗證類型。 允許的值:「密碼」、「電話」和「簡訊」 |
|
|
驗證密碼
|
authentication_password | string |
為簽署者驗證設定的密碼。 「密碼」驗證類型需要 |
|
|
驗證電話
|
authentication_phone | string |
用於驗證簽署者的電話號碼。 「電話通話」和「簡訊」驗證類型為必要項目。 範例:+1XXXXXXXXX |
|
|
驗證簡訊訊息
|
authentication_sms_message | string |
傳送給簽署者的自訂簡訊訊息,包含 {password} 預留位置。 與「簡訊」驗證類型一起使用。 如果沒有此參數,簽署者會收到包含自動產生密碼 (解鎖碼) 的預設簡訊 - 「SignNow 文件邀請解除鎖定碼:123456」範例:輸入密碼 {password} 以解除鎖定您的文件 |
|
|
送貨類型
|
delivery_type | string |
定義邀請的傳送方式 |
|
|
連結到期
|
link_expiration | integer |
電子郵件邀請會在多少分鐘內到期。 只有在「傳遞類型=電子郵件」時才能使用。 有效範圍:15–43200分鐘 |
|
|
工作階段到期
|
session_expiration | integer |
簽署工作階段會在多少分鐘內到期。 如果為此邀請產生連結,則會話到期會重設。 僅適用於「傳遞類型=電子郵件」和「簽署」動作。 有效範圍:15–1440分鐘 |
|
|
QES 簽名
|
signature | string |
QES 類型。 可能的值:「Eideasy」、「Nom151」。 用於向簽署者請求 QES 簽名。 邀請中的所有簽署者都必須使用相同的簽名類型。 若要使用 QES 建立邀請,使用者必須屬於已啟用 QES 的組織 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料
|
data | array of object |
資料 |
|
身份識別碼
|
data.id | string |
已建立內嵌邀請的ID |
|
Email
|
data.email | string |
收件者電子郵件 |
|
角色識別碼
|
data.role_id | string |
收件者角色識別碼 |
|
訂單
|
data.order | integer |
收件者簽署順序 |
|
地位
|
data.status | string |
內嵌邀請狀態 |
建立文件群組內嵌傳送連結
此動作會為特定文件群組產生內嵌的傳送連結,讓協力廠商使用者準備並傳送文件群組以供簽署
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件群組 ID
|
id | True | string |
文件群組 ID |
|
類型
|
type | string |
指定內嵌連結應開啟的傳送步驟:「管理」 — 在「將文件新增至文件群組」頁面上開啟連結;'edit':在編輯器中開啟連結;'send-invite':開啟「傳送邀請」頁面上的連結 |
|
|
重新導向 URI
|
redirect_uri | string |
內嵌傳送設定後開啟的頁面。 如果新增「重新導向目標」,則為必要項目 |
|
|
連結到期
|
link_expiration | integer |
指定連結將保持作用中的分鐘數。 允許的範圍:15 到 45 分鐘。 管理員層級使用者最多可以將持續時間設定為 43200 分鐘 |
|
|
重新導向目標
|
redirect_target | string |
決定是否要在瀏覽器的新索引標籤中開啟重新導向 URI,或在簽署工作階段之後在相同的索引標籤中開啟重新導向 URI。 可能的值:「在新分頁中」 – 在新分頁中開啟連結,「在同一分頁中」 — 在同一分頁中開啟連結 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
網址
|
url | string |
內嵌文件群組傳送的連結 |
建立文件群組內嵌邀請
此動作會為文件群組建立內嵌的簽署邀請。 建立邀請後,產生內嵌的簽署連結
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件群組 ID
|
id | True | string |
文件群組 ID |
|
訂單
|
order | True | integer |
簽署訂單步驟。 指派給特定 |
|
Email
|
True | string |
收件者電子郵件地址 |
|
|
文件標識碼
|
id | True | string |
文件的 ID |
|
Role
|
role | string |
檔案中的收件者角色。 不應為「檢視」動作指定角色 |
|
|
行動
|
action | True | string |
文件中收件者所需的動作。 允許的值:「sign」、「view」 |
|
訂單
|
order | True | string |
簽署訂單步驟 |
|
Email
|
True | string |
收件者電子郵件地址 |
|
|
語言
|
language | string |
指定簽署者簽署工作階段和通知電子郵件的語言。 可能的值:en 代表英文,es 代表西班牙文,fr 代表法文。 如果未設定,則語言由您的 SignNow 帳戶的語言決定 |
|
|
名字
|
first_name | string |
收件人名字 |
|
|
姓氏
|
last_name | string |
收件者姓氏 |
|
|
必要的預設簽名名稱
|
required_preset_signature_name | string |
簽名欄位的預先填入文字,已鎖定以供收件者編輯 |
|
|
重新導向 URI
|
redirect_uri | string |
簽署工作階段完成後開啟的連結 |
|
|
拒絕重新導向 Uri
|
decline_redirect_uri | string |
收件者拒絕簽署文件後開啟的連結 |
|
|
關閉重新導向 Uri
|
close_redirect_uri | string |
收件者在簽署工作階段期間按一下 [儲存進度] 和 [稍後完成] 或 [在檢視模式中關閉] 時開啟的連結 |
|
|
重新導向目標
|
redirect_target | string |
決定是否要在瀏覽器的新索引標籤中開啟重新導向 URI,或在簽署工作階段之後在相同的索引標籤中開啟重新導向 URI。 可能的值:「在新分頁中」 – 在新分頁中開啟連結,「在同一分頁中」 — 在同一分頁中開啟連結 |
|
|
送貨類型
|
delivery_type | string |
定義邀請的傳送方式 |
|
|
連結到期
|
link_expiration | integer |
電子郵件邀請會在多少分鐘內到期。 只有在「傳遞類型=電子郵件」時才能使用。 有效範圍:15–43200分鐘 |
|
|
工作階段到期
|
session_expiration | integer |
簽署工作階段會在多少分鐘內到期。 如果為此邀請產生連結,則會話到期會重設。 僅適用於「傳遞類型=電子郵件」和「簽署」動作。 有效範圍:15–1440分鐘 |
|
|
驗證類型
|
authentication_type | string |
在簽署工作階段期間用於收件者驗證的驗證類型。 允許的值:「密碼」、「電話」和「簡訊」 |
|
|
驗證密碼
|
authentication_password | string |
為簽署者驗證設定的密碼。 「密碼」驗證類型需要 |
|
|
驗證電話
|
authentication_phone | string |
用於驗證簽署者的電話號碼。 「電話通話」和「簡訊」驗證類型為必要項目。 範例:+1XXXXXXXXX |
|
|
驗證簡訊訊息
|
authentication_sms_message | string |
傳送給簽署者的自訂簡訊訊息,包含 {password} 預留位置。 與「簡訊」驗證類型一起使用。 如果沒有此參數,簽署者會收到帶有自動產生密碼(解鎖碼)的預設簡訊 - 「SignNow 文件邀請解鎖碼:123456」。 範例:輸入密碼 {password} 以解除鎖定文件 |
|
|
QES 簽名
|
signature | string |
QES 類型。 可能的值:「Eideasy」、「Nom151」。 用於向簽署者請求 QES 簽名。 邀請中的所有簽署者都必須使用相同的簽名類型。 若要使用 QES 建立邀請,使用者必須屬於已啟用 QES 的組織 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
邀請ID
|
id | string |
已建立內嵌邀請的ID |
建立簽署連結
產生文件連結並共用,讓文件簽署
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
doc_id | True | string |
指定唯一的文件 ID 或從清單中選取文件 |
|
fields
|
fields | dynamic |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
URL
|
url_no_signup | string |
簽署連結 |
從多個檔案建立文件群組
透過將多個檔案上傳為 base64 編碼字串來建立文件群組
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件群組名稱
|
group_name | True | string |
輸入文件群組的名稱 |
|
文件名稱
|
name | True | string |
帶副檔名的文件名稱:Report.pdf、Letter.docx 等 |
|
檔案內容
|
content | True | string |
代表文件內容的 Base64 編碼字串 |
傳回
從範本建立文件
從選取的範本產生文件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件範本
|
doc_id | True | string |
從清單中選取範本 |
|
文件名稱
|
document_name | string |
輸入文件的新檔案名稱 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件 ID
|
id | DocumentId |
唯一文件 ID |
從群組範本建立文件群組
從選取的群組範本建立文件群組
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組範本
|
doc_group_id | True | string |
從清單中選取群組範本 |
|
文件群組名稱
|
group_name | string |
輸入文件群組的新名稱 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件群組 ID
|
id | DocumentGroupId |
唯一文件群組 ID |
產生文件內嵌邀請連結
此動作會產生文件內嵌邀請的連結
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
id | True | string |
文件 ID |
|
欄位邀請ID
|
field_invite_id | True | string |
來自「建立文件內嵌邀請」動作的內嵌邀請 ID |
|
連結到期
|
link_expiration | integer |
指定連結將保持作用中的分鐘數。 有效範圍:15-45分鐘 |
|
|
工作階段到期
|
session_expiration | integer |
指定簽署工作階段將保持作用中的分鐘數。 有效範圍:15-1440分鐘 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Link
|
data.link | string |
為文件產生的內嵌邀請連結 |
產生文件群組內嵌邀請連結
此動作會產生文件群組內嵌邀請的連結
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件群組 ID
|
id | True | string |
文件群組 ID |
|
文件群組內嵌邀請ID
|
invite_id | True | string |
來自「建立文件群組內嵌邀請」動作的文件群組內嵌邀請的ID |
|
Email
|
True |
收件者電子郵件地址 |
||
|
連結到期
|
link_expiration | integer |
指定連結將保持作用中的分鐘數。 有效範圍:15-45分鐘 |
|
|
工作階段到期
|
session_expiration | integer |
指定簽署工作階段將保持作用中的分鐘數。 有效範圍:15-1440分鐘 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
內嵌邀請連結
|
link | string |
文件群組內嵌邀請的連結 |
邀請簽署文件
此動作會建立並傳送要簽署之文件的欄位邀請
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
id | True | string |
文件 ID |
|
Email
|
string |
收件者電子郵件地址 |
||
|
電子郵件群組
|
email_group | string |
應收到邀請的使用者群組。 當其中一個使用者簽署文件時,即視為已完成。 必須與「電子郵件群組」進階參數搭配使用。 如果未新增「電子郵件」或「電話邀請」,但無法與上述任一參數同時使用,則為必要 |
|
|
電話邀請
|
phone_invite | string |
收件者電話號碼。 透過簡訊邀請的必要條件 |
|
|
Role
|
role | True | string |
收件者角色名稱。 例如簽署者 1、簽署者 2 |
|
訂單
|
order | True | integer |
簽署順序。 簽署順序會定義收件者必須簽署或填寫文件的順序。 訂單步驟中的所有收件者完成簽署後,文件將繼續進行下一個訂單步驟(例如,2、3)。 多個收件者可以共用相同的簽署順序 |
|
Role
|
role | True | string |
收件者角色名稱,用於對應進階引數 |
|
預先填入簽名名稱
|
prefill_signature_name | string |
簽名欄位中的預先填入文字,可供簽署者編輯 |
|
|
必要的預設簽名名稱
|
required_preset_signature_name | string |
簽名欄位的預先填入文字,已鎖定以供收件者編輯。 不能與「預先填寫簽名名稱」或「需要新簽名」一起使用 |
|
|
需要新簽名
|
force_new_signature | boolean |
定義簽署者是否可以使用已儲存的簽名。 False – 簽署者可以使用已儲存的簽名;True – 簽署者必須建立新簽名 |
|
|
允許轉發
|
reassign | boolean |
定義收件者是否可以將邀請轉寄至另一個電子郵件地址。 'true':收件者可以轉發邀請;'false':收件者無法轉寄邀請 |
|
|
允許依簽章拒絕
|
decline_by_signature | boolean |
定義是否在簽名欄位上顯示 [拒絕簽署] 選項。 True – 顯示拒絕選項;false – 隱藏拒絕選項 |
|
|
在 X 天內發送提醒
|
remind_after | integer |
邀請後 X 天,收件人會收到提醒電子郵件 (從 1 到 179 天)。 必須小於「到期前天數」 |
|
|
在到期前 X 天內發送提醒
|
remind_before | integer |
到期前 X 天,收款人會收到提醒電子郵件 (從 1 到 179 天)。 必須小於「到期前天數」 |
|
|
每 X 天發送一次提醒
|
remind_repeat | integer |
邀請傳送後,接收者每 x 天收到一封提醒電子郵件 (1 到 7 天) |
|
|
到期前天數
|
expiration_days | integer |
在 X 天內,邀請到期 (從 3 到 180 天) |
|
|
驗證類型
|
authentication_type | string |
在簽署工作階段期間用於收件者驗證的驗證類型。 允許的值:「密碼」、「電話」和「簡訊」 |
|
|
驗證密碼
|
password | string |
為簽署者驗證設定的密碼。 「密碼」驗證類型需要 |
|
|
驗證電話
|
phone | string |
用於驗證簽署者的電話號碼。 「電話通話」和「簡訊」驗證類型為必要項目。 範例:+1XXXXXXXXX |
|
|
驗證簡訊訊息
|
authentication_sms_message | string |
傳送給簽署者的自訂簡訊訊息,包含 {password} 預留位置。 與「簡訊」驗證類型一起使用。 如果沒有此參數,簽署者會收到帶有自動產生密碼(解鎖碼)的預設簡訊 - 「SignNow 文件邀請解鎖碼:123456」。 範例:輸入密碼 {password} 以解除鎖定文件 |
|
|
主旨
|
subject | string |
收件者的自訂電子郵件主旨 |
|
|
Message
|
message | string |
收件者的自訂電子郵件訊息 |
|
|
重新導向 URI
|
redirect_uri | string |
完成並簽署所有要求的欄位後,簽署者會重新導向至此 URI |
|
|
重新導向目標
|
redirect_target | string |
決定是否要在瀏覽器的新索引標籤中開啟重新導向 URI,或在簽署工作階段之後在相同的索引標籤中開啟重新導向 URI。 可能的值:「在新分頁中」 – 在新分頁中開啟連結,「在同一分頁中」 — 在同一分頁中開啟連結 |
|
|
拒絕重新導向 Uri
|
decline_redirect_uri | string |
收件者拒絕文件後開啟的連結 |
|
|
關閉重新導向 Uri
|
close_redirect_uri | string |
收件者在簽署工作階段期間按一下 [儲存進度] 和 [稍後完成] 或 [在檢視模式中關閉] 時開啟的連結 |
|
|
完成重定向是否已取消
|
is_finish_redirect_canceled | boolean |
指定是否取消組織的完成重新導向設定。 True – 重新導向已取消;False – 重新導向保持作用中 |
|
|
關閉重新導向是否已取消
|
is_close_redirect_canceled | boolean |
指定是否取消組織的儲存進度重新導向設定。 True – 重新導向已取消;False – 重新導向保持作用中 |
|
|
拒絕重新導向是否已取消
|
is_decline_redirect_canceled | boolean |
指定是否取消組織的拒絕重新導向設定。 True – 重新導向已取消;False – 重新導向保持作用中 |
|
|
語言
|
language | string |
指定簽署者簽署工作階段和通知電子郵件的語言。 可能的值:en 代表英文,es 代表西班牙文,fr 代表法文。 如果未設定,則語言由您的 SignNow 帳戶的語言決定 |
|
|
Email
|
True | string |
檢視者電子郵件地址 |
|
|
Role
|
role | True | string |
檢視者角色名稱 |
|
訂單
|
order | True | integer |
整數:發送的順序,從1開始 |
|
Role
|
role | True | string |
檢視者角色名稱。 用於映射進階參數 |
|
主旨
|
subject | string |
檢視者的自訂電子郵件主旨 |
|
|
Message
|
message | string |
檢視者的自訂電子郵件訊息 |
|
|
Email
|
True | string |
核准者電子郵件地址 |
|
|
Role
|
role | True | string |
核准者角色名稱 |
|
訂單
|
order | True | integer |
接收核准要求的順序 |
|
Role
|
role | True | string |
核准者角色名稱。 用於映射進階參數 |
|
到期日
|
expiration_days | integer |
邀請到期前的天數 |
|
|
Message
|
message | string |
核准者的自訂電子郵件訊息 |
|
|
主旨
|
subject | string |
核准者的自訂電子郵件主旨 |
|
|
驗證類型
|
authentication_type | string |
在簽署工作階段期間用於收件者驗證的驗證類型。 允許的值:「密碼」、「電話」和「簡訊」 |
|
|
密碼
|
password | string |
為簽署者驗證設定的密碼。 「密碼」驗證類型需要 |
|
|
電話
|
phone | string |
用於驗證簽署者的電話號碼。 「電話通話」和「簡訊」驗證類型為必要項目。 範例:+1XXXXXXXXX |
|
|
驗證簡訊訊息
|
authentication_sms_message | string |
傳送給簽署者的自訂簡訊訊息,包含 {password} 預留位置。 與「簡訊」驗證類型一起使用。 如果沒有此參數,簽署者會收到帶有自動產生密碼(解鎖碼)的預設簡訊 - 「SignNow 文件邀請解鎖碼:123456」。 範例:輸入密碼 {password} 以解除鎖定文件 |
|
|
重新導向 URI
|
redirect_uri | string |
核准者核准文件後開啟的 URL |
|
|
重新導向目標
|
redirect_target | string |
決定是否要在瀏覽器的新索引標籤中開啟重新導向 URI,或在簽署工作階段之後在相同的索引標籤中開啟重新導向 URI。 可能的值:「在新分頁中」 – 在新分頁中開啟連結,「在同一分頁中」 — 在同一分頁中開啟連結 |
|
|
寄件者
|
from | string |
寄件者電子郵件地址。 只能使用與您的 SignNow 帳戶關聯的電子郵件(登入電子郵件)。 如果留空,則會自動設定 |
|
|
ID
|
id | string |
電子郵件群組的ID。 必須事先建立的唯一 40 個字元識別碼 |
|
|
名稱
|
name | string |
群組的名稱。 在「簽署者 > 電子郵件群組」欄位中使用該選項 |
|
|
Email
|
string |
應收到邀請的電子郵件地址 |
||
|
Email
|
string |
應收到邀請的電子郵件地址 |
||
|
名稱
|
name | string |
步驟名稱 |
|
|
Email
|
string |
副本收件人電子郵件地址 |
||
|
Step
|
step | integer |
發送順序,從1開始 |
|
|
主旨
|
subject | string |
所有收件者的電子郵件主旨 |
|
|
Message
|
message | string |
所有收件者的電子郵件訊息 |
|
|
CC 主題
|
cc_subject | string |
所有副本收件者的副本電子郵件主旨 |
|
|
抄送訊息
|
cc_message | string |
所有副本收件者的副本電子郵件訊息 |
|
|
QES 簽名
|
signature | string |
QES 類型。 可能的值:「Eideasy」、「Nom151」。 用於向簽署者請求 QES 簽名。 邀請中的所有簽署者都必須使用相同的簽名類型。 若要使用 QES 建立邀請,使用者必須屬於已啟用 QES 的組織 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
地位
|
status | string |
地位 |
邀請簽署文件群組
此動作會建立簽署文件群組的邀請。 您可以設定多步驟工作流程,讓不同的收件者在不同階段對文件群組採取行動
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件群組 ID
|
id | True | string |
文件群組 ID |
|
訂單
|
order | True | integer |
簽署步驟順序:1 - 收件人先簽署文件組,然後將文件組發送到 2、3 等。數個收件者可以保留相同的簽署順序 |
|
Email
|
string |
收件者電子郵件地址 |
||
|
電子郵件群組
|
email_group | string |
收件者的連絡人群組 |
|
|
角色名稱
|
role_name | True | string |
文件中的收件者角色名稱 (可用來識別指派給此特定收件者的檔案中的欄位) |
|
行動
|
action | True | string |
允許對文件執行動作。 可能的值:檢視、簽署、核准 |
|
文件 ID
|
document_id | True | string |
此收件者需要採取動作的文件識別碼 |
|
必要的預設簽名名稱
|
required_preset_signature_name | string |
簽名欄位的預先填入文字,已鎖定以供收件者編輯 |
|
|
允許轉發
|
allow_reassign | boolean |
定義收件者是否可以將邀請轉寄至另一個電子郵件地址。 'true':收件者可以轉發邀請;'false':收件者無法轉寄邀請 |
|
|
允許依簽章拒絕
|
decline_by_signature | boolean |
定義是否在簽名欄位上顯示 [拒絕簽署] 選項。 True:顯示拒絕選項;False:隱藏拒絕選項 |
|
|
驗證類型
|
type | string |
在簽署工作階段期間用於收件者驗證的驗證類型。 允許的值:「密碼」、「電話」和「簡訊」 |
|
|
密碼
|
value | string |
為簽署者驗證設定的密碼。 「密碼」驗證類型需要 |
|
|
電話
|
phone | string |
用於驗證簽署者的電話號碼。 「電話通話」和「簡訊」驗證類型為必要項目。 範例:+1XXXXXXXXX |
|
|
Message
|
message | string |
傳送給簽署者的自訂簡訊訊息,包含 {password} 預留位置。 與「簡訊」驗證類型一起使用。 如果沒有此參數,簽署者會收到帶有自動產生密碼(解鎖碼)的預設簡訊 - 「SignNow 文件邀請解鎖碼:123456」 |
|
|
商家標識符
|
merchant_id | string |
新增至您組織的商家帳戶的ID |
|
|
貨幣
|
currency | string |
要求的付款貨幣 |
|
|
總數
|
amount | string |
要求的付款金額 |
|
|
Uri
|
redirect_uri | string |
完成並簽署所有要求的欄位後,簽署者會重新導向至此 URI |
|
|
重新導向目標
|
redirect_target | string |
決定是否要在瀏覽器的新索引標籤中開啟重新導向 URI,或在簽署工作階段之後在相同的索引標籤中開啟重新導向 URI。 可能的值:「在新分頁中」 – 在新分頁中開啟連結,「在同一分頁中」 — 在同一分頁中開啟連結 |
|
|
拒絕重新導向 Uri
|
decline_redirect_uri | string |
收件者拒絕文件後開啟的連結 |
|
|
關閉重新導向 Uri
|
close_redirect_uri | string |
當簽署者在簽署工作階段期間按一下「儲存進度」和「稍後完成」或「在檢視模式中關閉」時開啟的連結 |
|
|
完成重定向是否已取消
|
is_finish_redirect_canceled | boolean |
指定是否取消組織的完成重新導向設定。 True – 重新導向已取消;False – 重新導向保持作用中 |
|
|
關閉重新導向是否已取消
|
is_close_redirect_canceled | boolean |
指定是否取消組織的儲存進度重新導向設定。 True – 重新導向已取消;False – 重新導向保持作用中 |
|
|
拒絕重新導向是否已取消
|
is_decline_redirect_canceled | boolean |
指定是否取消組織的拒絕重新導向設定。 True – 重新導向已取消;False – 重新導向保持作用中 |
|
|
語言
|
language | string |
指定簽署者簽署工作階段和通知電子郵件的語言。 可能的值:en 代表英文,es 代表西班牙文,fr 代表法文。 如果未設定,則語言由您的 SignNow 帳戶的語言決定 |
|
|
訂單
|
order | True | integer |
簽署步驟順序:1 - 收件人先簽署文件組,然後將文件組發送到 2、3 等。數個收件者可以保留相同的簽署順序 |
|
Email
|
True | string |
收件者的電子郵件地址 |
|
|
電子郵件群組
|
email_group | string |
收件者的連絡人群組 |
|
|
主旨
|
subject | string |
收件者的自訂電子郵件主旨 |
|
|
Message
|
message | string |
收件者的自訂電子郵件訊息 |
|
|
到期前天數
|
expiration_days | integer |
在 x 天內,邀請會過期 (從 3 到 180 天) |
|
|
在 X 天內發送提醒
|
remind_after | integer |
邀請後 X 天,收件人會收到提醒電子郵件 (從 1 到 179 天)。 必須少於到期日 |
|
|
在到期前 X 天內發送提醒
|
remind_before | integer |
到期前 X 天,收款人會收到提醒電子郵件 (從 1 到 179 天)。 必須少於到期日 |
|
|
每 X 天發送一次提醒
|
remind_repeat | integer |
邀請傳送後,接收者每 x 天收到一封提醒電子郵件 (1 到 7 天) |
|
|
身份識別碼
|
id | string |
電子郵件群組的ID。 必須事先建立的唯一 40 個字元識別碼 |
|
|
名稱
|
name | string |
群組的名稱。 在「邀請步驟 > 電子郵件群組」中使用它 |
|
|
Email
|
string |
應收到邀請的電子郵件地址 |
||
|
Email
|
string |
將收到完成電子郵件的收件者的電子郵件地址 |
||
|
停用文件附件
|
disable_document_attachment | boolean |
是否停用傳送包含完成電子郵件的文件附件。 可能的值:False - 啟用文件附件,True - 停用文件附件 |
|
|
主旨
|
subject | string |
完成電子郵件的自訂主旨 |
|
|
Message
|
message | string |
完成電子郵件的自訂訊息 |
|
|
簽署為合併
|
sign_as_merged | boolean |
如果為true,則允許API使用者傳送邀請,該邀請會在單一檔案中以合併檔案群組的形式開啟 |
|
|
用戶端時間戳記
|
client_timestamp | integer |
文件群組邀請的時間戳記 |
|
|
Email
|
string |
應收到邀請的電子郵件地址 |
||
|
QES 簽名
|
signature | string |
QES 類型。 可能的值:「Eideasy」、「Nom151」。 用於向簽署者請求 QES 簽名。 邀請中的所有簽署者都必須使用相同的簽名類型。 若要使用 QES 建立邀請,使用者必須屬於已啟用 QES 的組織 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
身份識別碼
|
id | string |
文件群組邀請 ID |
|
待處理的邀請連結
|
pending_invite_link | string |
待處理的邀請連結 |
預先填入文件欄位值
使用特定值自動填入文件中的可填寫欄位
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template_id | True | string |
指定要從中取得欄位的文件範本 |
|
文件 ID
|
doc_id | True | string |
指定唯一的文件識別碼 |
|
fields
|
fields | dynamic |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件 ID
|
id | DocumentId |
唯一文件 ID |
預先填入文件欄位值 [已淘汰]
此動作已被取代。 請改用 預填文件欄位值 。
預先填入欄位值和屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template_id | True | string |
指定要從中取得欄位的文件範本 |
|
文件 ID
|
doc_id | True | string |
指定唯一的文件識別碼 |
|
fields
|
fields | dynamic |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件 ID
|
id | DocumentId |
唯一文件 ID |
預先填入文件群組智慧欄位值
使用特定值自動填入文件中的智慧欄位
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template_group_id | True | string |
指定要從中取得欄位的文件群組範本 |
|
文件群組 ID
|
doc_group_id | True | string |
指定唯一的文件群組 ID |
|
fields
|
fields | dynamic |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件群組 ID
|
id | DocumentGroupId |
唯一文件群組 ID |
預先填入文件群組欄位值
使用特定值自動填充文檔中的可填寫字段
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template_group_id | True | string |
指定要從中取得欄位的文件群組範本 |
|
文件群組 ID
|
doc_group_id | True | string |
指定唯一的文件群組 ID |
|
fields
|
fields | dynamic |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件群組 ID
|
id | DocumentGroupId |
唯一文件群組 ID |
預先填入智慧欄位值
預先填入指定文件的「智慧型欄位」值
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template_id | True | string |
指定要從中取得欄位的文件範本 |
|
文件 ID
|
doc_id | True | string |
指定唯一的文件識別碼 |
|
fields
|
fields | dynamic |
觸發程序
| 在文件事件上啟動流程 |
選取要觸發的事件:新的或更新的簽名邀請;當有人建立、更新、完成或刪除文件時 |
| 在文件事件上啟動流程 [已淘汰] |
此動作已被取代。 請改用 [在文件事件上啟動流程 ]。
|
在文件事件上啟動流程
選取要觸發的事件:新的或更新的簽名邀請;當有人建立、更新、完成或刪除文件時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Event
|
event | True | string |
選取應觸發流程的事件 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Event
|
meta.event | string |
導致觸發程序的文件事件。 |
|
文件 ID
|
content.document_id | string |
導致事件的目標文件的唯一ID。 |
|
文件名稱
|
content.document_name | string |
目標文件檔名,不含副檔名 |
在文件事件上啟動流程 [已淘汰]
此動作已被取代。 請改用 [在文件事件上啟動流程 ]。
您可以為下列其中一個事件建立觸發器:文件建立、文件更新、文件刪除、文件完成、邀請建立、邀請更新
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Event
|
event | True | string |
選取應該觸發流程的事件。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
時間戳
|
meta.timestamp | integer |
事件發生的日期和時間(Unix 時間戳記格式)。 |
|
Event
|
meta.event | string |
導致觸發程序的文件事件。 |
|
文件 ID
|
content.document_id | string |
導致事件的目標文件的唯一ID。 |
|
文件名稱
|
content.document_name | string |
目標文件檔名,不含副檔名 |
定義
文件屬性
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件 ID
|
id | DocumentId |
唯一文件 ID |
|
文件名稱
|
document_name | string |
沒有副檔名的文件檔名 |
|
頁數
|
page_count | integer |
文件中的頁數 |
|
已建立
|
created | integer |
以 Unix 時間戳記格式建立文件的日期和時間 |
|
Updated
|
updated | integer |
文件以 Unix 時間戳記格式更新的日期和時間 |
|
範本名稱
|
original_filename | string |
範本檔案名稱與副檔名 (如有) |
|
範本識別碼
|
origin_document_id | string |
範本文件 ID (如有) |
|
是模板
|
template | boolean |
如果文件是範本,則為 true。 |
|
文件狀態
|
status | string |
文件狀態 |
DocumentGroups回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
document_groups
|
document_groups | array of DocumentGroupProperties | |
|
文件群組總計數
|
document_group_total_count | integer |
SignNow 帳戶中的文件群組總數 |
文件群組屬性
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件群組 ID
|
group_id | DocumentGroupId |
唯一文件群組 ID |
|
文件群組名稱
|
group_name | string |
文件群組名稱 |
|
Documents
|
documents | array of DocumentGroupDocumentProperties |
Documents |
DocumentGroupDocumentProperties
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件 ID
|
id | DocumentId |
唯一文件 ID |
|
文件名稱
|
document_name | string |
沒有副檔名的文件檔名 |
|
範本識別碼
|
origin_document_id | string |
範本文件 ID (如有) |
CreateDocumentGroupFromFiles回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文件群組名稱
|
group_name | string |
文件群組名稱 |
|
文件群組識別碼
|
group_id | string |
文件群組識別碼 |
|
檔
|
documents | array of object | |
|
文件 ID
|
documents.id | DocumentId |
唯一文件 ID |
|
文件名稱
|
documents.name | string |
文件名稱 |
DocumentId
文件群組識別碼
物件
這是類型 'object'。
二進位
這是基本數據類型 『binary』。