問題編號
Adobe Sign 發行說明:2021 年
Adobe Sign:2021 年 3 月
改善功能
Adobe Sign 行動檢視中的「流動模式」
「Liquid Mode」是一種可供自由選用的功能,可產生回應式檢視畫面,讓您能根據簽署者的裝置類型改善文件顯示畫面。
簽署的文件以標準 PDF 版本儲存,而收件人可以在手機上看到 Liquid Mode,並可切換檢視原始文件。
您現在可以上傳 HTML 文件並為行動電話生成 流動模式 檢視。
增強電子郵件安全性的選項
現已新增兩個選項來提升電子郵件安全。 預設啟用兩項設定:
- 在電子郵件內附上一個可檢視所簽署合約的連結
- 在電子郵件內附上合約第一頁的影像
- 預設啟用
- 啟用時,協議第一頁的影像在某些電子郵件分發中可見
v6 REST API 更新
每個 V6 REST API 要求中的標準標頭
每個 v6 REST API 要求現在預設顯示下列標準標頭:
/AGREEMENTS
所有具有 協議 ID 路徑的 /agreements 端點,如果協議已透過 GDPR 工具刪除,現在會傳回 404 AGREEMENT_DESTROYED 錯誤代碼。
程式庫範本
PUT /libraryDocuments/{libraryDocumentId} - 已展開以包含新欄位 ownerId
僅會影響 v6 REST API。
任何 未 包含這些標頭的 v6 REST API 呼叫都會明確記錄該缺失。
- GET /libraryDocuments - 已展開以包含新欄位 ownerEmail
- GET /libraryDocuments/{libraryDocumentId} - 已展開以包含新欄位:ownerId、ownerEmail 和 ownerName
LibraryDocumentInfo 物件中的新欄位:
行為已 更新 的欄位:
- PUT /widgets - 現在支援使用 libraryDocumentId 搭配有效 ID 來建立網頁表單
新增的狀態代碼:
- PUT /widgets/{widgetId} 已擴展以包含新欄位 ownerId
新增的狀態代碼:
體驗變更
行為已 更新 的欄位:
參數:
回應物件:
- PUT /megaSigns/{megaSignId}/formFields - 更新 Mega Sign 協議的表單欄位
參數:
回應物件:
- PUT /megaSigns/{megaSignId}/state:已新增 AUTHORING 做為 狀態 值來支援撰寫 Mega Sign 範本。因此,megaSignCancellationInfo 不再是必填欄位
已為所有剩餘帳戶啟用新的「首頁」和「管理」頁面
所有帳戶的控制項設定已更新,為使用者啟用現代 首頁 和 管理 頁面。
管理員選單中的控制項仍可供必須還原為傳統體驗的帳戶使用:
Adobe Sign 服務層級和帳戶 ID 已在管理員選單中公開
管理員現在可以在全域設定頁面上找到其帳戶 ID:
群組 ID 可以在 群組設定 頁面上找到:
明確的 HIPAA 配置
新頁面會清楚顯示帳戶何時可管理受 HIPAA 規範的合約。
- 此控制項只在帳戶層級顯示。 群組層級管理員沒有存取權限
- 此控制項為「僅檢視」,清楚指出何時已配置帳戶
- 請與客戶成功經理或支援人員連絡,以啟用 HIPAA 設定
對於在 Windows 系統上使用 Outlook 桌面應用程式的客戶,「行動號召」按鈕已變更
使用 Outlook 桌面版電子郵件用戶端的收件者會發現 Adobe Sign 電子郵件的「行動呼籲」按鈕有所變動。
新體驗移除了藍色 HTML 按鈕,改為提供可點按的文字連結:
此變更僅影響 Windows 系統上的 Outlook 桌面應用程式。其他電子郵件用戶端和作業系統會繼續收到使用藍色按鈕的範本。
資料治理的最大值已增加到 5475 天(15 年)
使用「資料治理規則從 Adobe Sign 系統自動刪除協議」的客戶現在可以將刪除日期設定為最多 15 年(從原先的 10 年增加)。
用於驗證美國社會安全號碼的欄位層級文字標籤已更新:
用於驗證美國社會安全號碼的欄位層級文字標籤已更新,以澄清 SSN 僅適用於美國:
提醒:社群驗證已移除
如 11 月所宣布,使用社群身分識別的驗證方法已從 Admin 選單的驗證方法清單中移除。
提醒:個人 Twitter 整合已移除
誠如 12 月公告所述,系統已移除使用者透過個人 Twitter 連結驗證身分的功能。
非使用中使用者被納入合約時將收到電子郵件通知
設定為非使用中狀態的使用者現在會收到電子郵件通知,指示收件人將合約委派給其他使用者。
已解決的問題
Adobe Sign:2021 年 5 月
改善功能
將資料庫範本和網頁表單的所有權轉移給其他使用者
現在,帳戶中可存取資產的任何管理員都能變更資產擁有者。
管理員可以將資產所有權指派給其管轄下的任何使用者。
- 帳戶管理員可存取所有共用資產和所有使用者。 因此,帳戶層級管理員可將任何資料庫範本或網頁表單的擁有權,重新指派給其帳戶中的其他使用者
- 如果資產設為只供一名使用者 (擁有者) 使用,就不是共用資產,因此無法重新指派給新的擁有者
- 群組管理員只能存取所管理群組內的資料庫範本和網頁表單
- 群組管理員只能將資產重新指派給主要群組屬於其管理權限下的使用者
支援資產轉移的更新 API 端點
下文說明的端點僅適用於 v6 REST API。
延伸支援資料庫文件擁有者的更新。
LibraryDocumentInfo:
其他錯誤狀態碼:
其他錯誤狀態碼:
LibraryDocument 物件的新欄位:
LibraryDocumentInfo 物件內的新欄位:
具有更新行為的欄位:
WidgetInfo 物件內的新欄位:
具有更新行為的欄位:
體驗變更
預設 v6 REST GET /workflows{workflowId} 傳回值已變更
v6 REST GET /workflows{workflowId} API 呼叫已更新為傳回 WorkflowID 的目前版本 (與原始版本 ID 相對,這是 5 月版本前的傳回值)
此更新使預設 API 體驗與 Webhook 體驗一致,提供相同的 WorkflowID,這應該會改善應用程式的開發和管理。
如果基於任何原因,您的帳戶需要 API 傳回原始 ID (如 5 月釋放前所做的),請聯絡支援人員要求您的帳戶傳回工作流程的基礎版本 ID
已解決的問題
Adobe Sign:2021 年 6 月
有意升級的現有企業和商業帳戶可在此參閱升級流程 >
在 Sign 中推出 Liquid Mode
為透過「傳送頁面」或 sendAgreement API 傳送的 HTML,啟用手機版 Liquid Mode 檢視。 帳戶和群組層級的「管理員」功能表清單已新增針對 HTML 啟用 Sign 專屬 Liquid Mode 的選項。
Liquid Mode 文件的完整詳細資訊可在此參閱 >
Liquid Mode 目前僅適用於 NA1、NA2 和 NA4 環境。
若要啟用流暢的網頁表單功能,您必須在「全域設定」選單中啟用「允許其他參與者」選項:
OAuth 2.0 是新預設值
已新增新 (改善) 版本 OAuth 端點,避免使用錯誤。 此版本具下列功能:
- api_access_point/web_access_point 只在存取權杖請求 (內文) 中傳回
- Adobe Sign 不接受將密碼當作查詢參數
- 支援用戶端密碼輪換
OAuth v1 會繼續在接下來幾個月為現有連線運作,確保可持續存取。
OAuth v1 的淘汰將在排程後於技術通知頁面上公告。
用戶端密碼輪換
所有擁有 Adobe Sign UI 應用程式 ID 存取權限的管理員,都可輪換應用程式用戶端密碼:
體驗變更
GET /agreements/{agreementId}/signingUrls 的更新 v6 REST API 結果
6 月版發佈前,呼叫 GET /agreements/{agreementId}/signingUrls 時,API 會在合約建立後立即傳回 404。
清除 404 錯誤不久後,回應會傳回非 404 回應,但只包括傳送者的簽署 URL (儘管簽署者的參與仍在定義中)。
2021 年 6 月版發佈後,系統傳送 200 代碼時,會在完成簽署 URL 完整清單前,傳回 404: AGREEMENT_NOT_EXPOSED 代碼。
若客戶不想在系統傳回 200 回應前繼續嘗試 API 呼叫,建議可使用 Webhook 回應 AGREEMENT_CREATED 事件。
已解決的問題
Adobe Sign:2021 年 8 月
體驗變更
- Aadhaar 國際支援 – 所有 Adobe Sign 執行個體的客戶現在可將選用的 Aadhaar 服務當作數位簽名供應商。 先前僅供 IN1 執行個體上的帳戶使用。 可根據簽名交易,付費購買 Aadhaar 附加元件。
- REST v6 更新:POST /users - REST v6 POST /users API 呼叫已更新為在未定義選用 primaryGroupId 參數時,在帳戶的「預設」群組中建立使用者。 只有 REST API v6 受此變更影響。
已解決的問題
|
|
描述 |
|---|---|
|
4299495 |
修正了工作流程設計工具中的問題,該問題會導致指示中客戶定義的 URL 無法正常運作。 |
|
4308294 |
修正了報告 CSV 檔案中的問題,當同一收件人電子郵件在合約中使用超過一次時,「收件人」和「收件人姓名」欄位可能會留空。 |
|
4310569 |
Adobe Sign 模板已從沙箱選項中排除。 |
|
4311098 |
修正了群組管理員無法透過 CSV 上傳更新群組中使用者的問題。 |
|
4311723 |
修正了當使用者在不同的 Adobe Sign 執行個體上時,GET /groups/ID/users API 呼叫會失敗的問題。 |
|
4312103 |
修正了透過大量上傳建立的 SAML 使用者會處於「已建立」狀態 (而非「活躍」狀態) 的問題。 |
|
4312309 |
修正了如果其他使用者在群組中建立了網頁表單,群組管理員無法重新指派網頁表單擁有權的問題。 |
|
4312840 |
修正了當第二封啟用電子郵件傳送給新使用者,而使用者點擊第二封電子郵件連結時所發生的啟用問題。 |
|
4314751 |
修正了代表其他使用者簽署時,拒絕合約的選項不可見的問題。 |
|
4315033 |
修正了當 SAML 模式設定為強制時,帳戶管理員無法重設密碼的問題。 |
|
4315605 |
修正了政府核發證件影像無法成功處理的問題。 |
|
4316057 |
修正了政府核發證件會產生錯誤,指出找不到文件四個角落的問題。 |
|
4316474 |
修正了在未啟用該選項的帳戶中,代理簽署功能可見的問題。 |
|
4316659 |
修正以下問題:合約完成簽署後,GET /agreements/id 呼叫中「actingUserEmail」的電子郵件地址可能傳回一封系統產生的電子郵件。 |
|
4317095 |
修正了當第一個簽署者使用基於知識的身份驗證時,收件人姓名會被匯入到參與者 1 標籤中的問題。 |
|
4317221 |
修正了儘管設定為不通知建立者,但對於失敗的 webhook 會自動向 webhook 建立者傳送通知電子郵件的問題。 |
|
4317347 |
修正了 Power Automate 中 OAuth 驗證會將使用者重新導向至首頁的問題。 |
|
4317429 |
修正了管理員透過 CSV 上傳更新時無法更新使用者「可以傳送」屬性的問題。 |
|
4317548 |
修正了部分使用 iPad 的客戶會看到網頁而不是針對行動裝置最佳化頁面的問題。 |
|
4317629 |
修正了包含撇號的名稱顯示撇號的 HTML 代碼的顯示問題。 |
|
4318175 |
修正使用者透過電子郵件連結封存帳戶時,可能收到錯誤訊息的問題。 |
|
4319012 |
修正透過 REST v5 和 v6 POST /users 建立使用者後,預設群組中並未建立使用者的問題。 |
|
4320197 |
修正了由於按鈕為非使用中狀態,導致無法從管理頁面下載簽署者身分報告的問題。 |
Adobe Sign:2021 年 9 月
改善功能
- 沙箱 - 企業層級客戶可選擇購買沙箱環境的存取權限,測試範本、客戶工作流程、API 應用程式等。 可為安全環境更新,將這些物件從生產環境移至沙箱,然後在更新經驗證且可供部署時移回生產環境。
- ECDSA 數位簽名支援 - Adobe Sign 現在支援基於 ECDSA 格式更安全且有效率的數位簽名,該格式使用 ANS X9.62-2005 標準中定義的橢圓曲線密碼學。
現在支援具 SHA-2 雜湊函數 (如 FIPS 標準定義) 的 NIST 曲線,讓雲端簽名協會的信任服務供應商 (TSP) 合作夥伴可選擇提供簽署者更快更安全的橢圓曲線認證,包括符合美國聯邦政府和新加坡政府使用建議需求的認證。
- Liquid Mode 已更新 - Liquid Mode 簽署體驗現在不止侷限於合約,更可適用於網頁表單。 Liquid Mode 表單不僅能減少您手動捏合和縮放才能順利檢視表單內容的煩惱,並集中改善需填欄位的效能,大幅改善簽署體驗。
- 新 TSP - Cleverbase (荷蘭)、PrimeSign (奧地利)、Sectigo (全球) 和 TrustPro (愛爾蘭) 是新的雲端簽名協會信任服務供應商,提供認證以套用符合最高標準和法規遵循需求的安全數位簽名。
- 自訂收件人的電子郵件頁首中「收件人」和「副本」欄位 - 擔心透過電子郵件頁首向收件人洩露電子郵件地址的客戶可以選擇隱藏「收件人」和「副本」欄位中的電子郵件地址值。
- 此選項適用於企業和商務帳戶,使用者可於帳戶和群組層級設定。
- 可以透過導覽至帳戶設定 > 電子郵件設定 > 自訂「收件人」和「副本」欄位來存取功能控制項。
體驗變更
- Adobe 使用條款中的 eSign 頁面接受動作 - 為符合 Adobe 法規要求,Adobe Sign 正在更新 eSign 頁面上的使用條款 (TOU) 接受行為。 在新體驗中,所有「不明」收件者在與合約互動之前,都必須先按一下「繼續」按鈕,接受 Adobe Sign TOU 和隱私政策。 此接受動作與客戶帳戶可能已設定的所有自訂 ToU 不同,後者會根據帳戶 TOU/CD 接受設定繼續解析。
- 「未知」收件人是指任何不是受信任帳戶中已註冊、使用中使用者電子郵件的電子郵件地址。
- 「已知」使用者在驗證使用者帳戶時,已在註冊過程中接受 Adobe Sign ToU,因此系統不會再次提醒他們接受條款。
以下為合約的無條件同意流程範例,流程中採用客戶所設定的自訂 ToU:
- 開啟合約後,選取「繼續」按鈕接受 Adobe Sign ToU。
- 依需求填寫合約欄位。
- 透過選取按一下即可簽署按鈕來接受客戶披露和自訂 ToU。
- 鎖定所輸入簽名的姓名值 - 3 月版推出一項設定,允許使用者在已填寫或已知姓名 (透過 API 或使用者設定檔) 的情況下,啟用/停用收件者在簽署時編輯姓名值的功能。 此功能原本並不適用於使用者輸入的簽名,因此部分簽署者可在簽名程序中變更姓名的值。 9 月版更新了這項功能,從此之後,所有簽名類型 (包括使用者輸入的簽名) 一律適用上述姓名鎖定設定。
- 已啟用輸入其姓名和姓名縮寫並停用簽署者可以變更其姓名或姓名縮寫的客戶將看到行為變更 – 在鍵入簽名的簽名程序期間,姓名值不再可編輯。
- 若客戶想在簽名程序中允許收件者編輯姓名的值,應啟用「簽署者可以變更其姓名或縮寫簽名」設定 (位於「簽名偏好設定」選單)。
- 非活躍使用者也能簽署合約 - 現在 Adobe Sign 將非活躍的使用者視為系統不認識的使用者 (以便能簽署傳入的合約)。 邀請非活躍的使用者簽署合約時,系統會明確為該合約的簽署作業建立單次使用的使用者 ID。 該一次性使用者 ID 與非活躍使用者的 ID,乃至管理該使用者的帳戶全都無關。 這會產生多個後續影響:
- 非活躍使用者可簽署其收到的合約,因為非活躍的狀態不會套用至系統為該合約產生的一次性使用者 ID。
- 一次性使用者 ID 簽署的合約不是非活躍使用者 ID 的資產,不會儲存於非活躍使用者 ID 的帳戶。
- 非活躍使用者 ID 的共用內容不會反映一次性使用者 ID 簽署的合約。
- 檢舉非活躍使用者 ID 的報告不會反映一次性使用者 ID 簽署的合約。
- 如果重新啟用非活躍使用者 ID,使用者不會在「管理」頁面上看到一次性使用者 ID 的合約簽署記錄。
上述行為有兩種例外情形:
- 在使用者遭標示為「非活躍」之前傳送的合約可能無法簽署 (合約已經與非活躍的使用者 ID 繫結)。
- 明確設定為不允許簽署合約的使用者將仍不被允許進行任何簽署動作。
非活躍使用者依舊無法使用其擁有的授權 (無論以何種方式取得) 登入 Adobe Sign 系統,也無法傳送合約。
- 改善透過密碼存取網頁表單的安全性 - 網頁表單已會在數次嘗試存取受密碼保護 URL 失敗後延遲一段時間。
- Aadhaar 國際支援 – 所有 Adobe Sign 執行個體的客戶現在可將選用的 Aadhaar 服務當作數位簽名供應商。 先前僅供 IN1 執行個體上的帳戶使用。 可根據簽名交易,付費購買 Aadhaar 附加元件。
- 合約的有限共用 - 將合約共用至外部電子郵件地址時,合約共用已設有上限。
- 多授權帳戶可共用任一合約最多十次。
- 個體帳戶可以共用合約最多 5 次。
- 與內部使用者共用合約不受限制。
- 多授權帳戶可共用任一合約最多十次。
- 已從服務中移除「電話驗證」的「自訂公司名稱」 - 已從服務中移除可插入「電話驗證」方法的可自訂公司名稱值,如 6 月技術通知所公告。
- 已啟用 HIPAA 設定的帳戶現在已可在「全域/群組設定」頁面的收件者電子郵件中存取影像和連結的控制項。
- 檔案附件包含在最終 PDF 中的順序已更新為首先依頁面編號排序,然後依欄位位置排序(從左到右;從上到下讀取時)
- 全新「管理」頁面中的「更換收件者」現在已可供寄件者針對新收件者加入選用訊息。
- 如果合約已設定多因素驗證,則外部簽署者若想存取已完成的合約,現在就必須通過驗證程序 (而不是收到登入 Adobe Sign 的提示)。
- 使用「管理」頁面的「下載表單欄位資料」功能存取欄位資料時,網頁表單會回報未經驗證的網頁表單的欄位值。
API 更新
- 網頁表單的「閱讀合約」選項 - 有兩個新 REST v6 API 呼叫可提供檢視網頁表單的存取權限:
- GET /widgets/<resourceId>
- GET /widgets/<resourceId>/combinedDocument/url
- GET/workflows/{workflowId} 現在會在回應中傳回參與者角色。
已解決的問題
| 4292343 | 改善在行動裝置使用 TYPE 簽名選項的簽名清晰度。 |
| 4295123 | 修正在瀏覽器中開啟時數位簽名無法顯示的問題。 |
| 4299289 | 改善「更換收件者」體驗,允許寄件者加入要傳送給新收件者的訊息。 |
| 4299857 | 修正已簽署的合約無法套用憑證印章的問題。 |
| 4304261 | 修正「閱讀協議」選項無法填入「選項」選單的問題 |
| 4308516 | 修正使用者在使用 OneDrive 時持續收到系統要求取得管理員同意的問題 |
| 4310225 | 修正包含多個簽名的合約會觸發伺服器錯誤:「錯誤訊息:套用到此文件的簽名無效,請清除並再簽署一次。」的錯誤。 |
| 4310416 | 更新 v5 REST API,以便在透過 POST /users 建立使用者時,建立為「作用中」狀態。 |
| 4311287 | 修正從群組中移除使用者後,「群組」導覽按鈕會在啟用 UMG 的帳戶中消失的問題。 |
| 4311956 | 修正欄位的指定字型大小無法反映在簽署者體驗中的問題。 |
| 4312302 | 修正 SAML 模式設為「強制」時,「重設密碼」選項會遭移除的問題。 |
| 4312735 | 修正共用通知已停用時仍發出共用事件通知的問題。 |
| 4313025 | 修正混合路由啟用後表單填寫者角色無法填寫未指定角色的問題。 |
| 4313030 | 修正寄件者主要群組未獲允許寄件時,啟用 UMG 的帳戶會在使用自訂工作流程時觸發錯誤的問題。 |
| 4313264 | 更新 HIPAA 啟用後的設定,可在「全域設定」頁面允許存取電子郵件連結/影像設定。 |
| 4315839 | 修正寄件者同時是第二收件者時自訂工作流程不允許使用預填欄位的問題。 |
| 4316058 | 更新報告欄位行為,允許文字欄位的前置文字為零。 |
| 4317382 | 修正選項按鈕在工具提示中顯示撇號的 HTML 程式碼的問題 |
| 4317978 | 更新最終 PDF 中檔案附件的排序方式,先根據欄位的頁數對附件進行分組,再根據欄位相對位置分組 (閱讀方向為左至右、上至下時)。 |
| 4318598 | GET/workflows/{workflowId} REST v6 API 呼叫現在會在回應中傳回參與者角色 |
| 4318606 | 「管理」頁面的「下載表單欄位資料」功能現在可傳回未經驗證的網頁表單欄位值。 |
| 4318617 | 修正已啟用 UMG 的帳戶不允許群組管理員重新傳送邀請的問題。 |
| 4318679 | 修正書面簽名文件無法上傳的間歇性問題。 |
| 4318926 | 修正產生行動裝置合約表單時觸發錯誤 (瀏覽器的 Cookie 功能停用) 的問題。 |
| 4318991 | 修正 SAML 設為「允許」時最大登入錯誤設定遭到忽略的問題。 |
| 4319068 | 現在如果多因素驗證已完成設定,外部收件者必須通過第二步驟驗證程序 (而非登入 Adobe Sign) 才能存取已填寫的合約。 |
| 4319422 | 修正收件者在未確認密碼 (針對密碼已經過驗證的合約) 之下遭到更換的問題 |
| 4319455 | 修正進階共用中的設定可能不會在儲存後保持一致的問題。 |
| 4320123 | 修正在「管理」頁面中嘗試檢視與核准合約時觸發錯誤的問題。 |
| 4320205 | 修正透過進階共用預先填入合約時無法儲存進度的問題。 |
| 4320542 | 修正啟用 UMG 的帳戶中如有一個群組透過「搜尋」遭到移除,所有使用者群組聯盟都可能遭移除的問題。 |
| 4321357 | 修正選取 KBA 驗證方式並啟用「傳送時要求姓名」時,傳送頁面可能發生錯誤的問題。 |
| 4322445 | 改善編寫功能,確保背景顏色一致。 |
| 4322956 | 修正自訂電子郵件範本中的收件者無法看見簽署者實際電子郵件地址的問題。 |
| 4323609 | 開發中 - 修正上傳已簽署的文件來完成合約時無法觸發 AGREEMENT_WORKFLOW_COMPLETED Webhook 通知的問題。 |
| 4323968 | 改善簽名鎖定功能,可在姓名值經由設定檔或 API 提供時加入已輸入的簽名。 |
Adobe Sign:2021 年 10 月
改善功能
- 不當使用行為檢舉連結 - 小型企業和個人層級帳戶現已新增檢舉連結,收件者發現傳入的合約要求涉及任何不當活動時,即可立即檢舉。
- Notarize 整合功能 - Adobe Sign 整合 Notarize, Inc. 的遠端線上公證 (RON) 平台,可讓客戶在 Adobe Sign 交易中新增遠端線上公證服務。 透過 ETLA 方案直接向 Adobe 購買的美國企業和商業客戶均可使用。 Notarize 交易僅限以附加服務的方式,供這些客戶額外付費購買。
- 「傳送」頁面更新 - 啟用公證功能的客戶可以在收件者記錄上選取「要求公證」選項 (就在驗證方法右邊):
- 「傳送」頁面更新 - 啟用公證功能的客戶可以在收件者記錄上選取「要求公證」選項 (就在驗證方法右邊):
在應用程式或整合服務中使用內嵌「傳送」頁面的客戶,也可以存取公證功能。
設定好合約且寄件者按「下一步」後,系統會顯示額外的公證程序設定選項供寄件者選用:
- API 更新 - API 經過大幅更新,以支援 Notarize 整合功能:
POST /agreements
POST /agreements API 已更新,支援傳送合約以進行公證。
- 必須使用新角色 NOTARY_SIGNER 來指出公證工作階段參與者。
- AgreementInfo 定義新增了 NotaryInfo 屬性,包含與建立需要公證的新合約關聯的所有選項。
|
參數名稱 |
REST 物件 |
描述 |
||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
memberInfos |
ParticipantInfo[] |
ParticipantInfo 物件陣列,包含參與者專屬資料 (例如電子郵件)。 陣列中的所有參與者都屬於同一資料集。 |
||||||||||||||||
|
role |
|
由資料集中的所有參與者擔任的角色 (簽署者、核准者等) |
FileInfo 擴充功能
FileInfo 定義需要擴充,以指出應公證的文件。
|
參數名稱 |
類型 |
預設 |
必要 |
描述 |
|---|---|---|---|---|
|
document |
Document |
|
選擇性 |
與合約相關聯的文件。 |
|
label |
String |
|
選擇性 |
檔案資訊元素的唯一標籤值。 若為自訂工作流程,這會將檔案對應到工作流程定義中的相應檔案元素。 |
|
libraryDocumentId |
String |
|
選擇性 |
要加入合約中的現有資料庫文件 ID |
|
transientDocumentId |
String |
|
選擇性 |
要加入合約中的暫時性文件 ID |
|
notarize |
true |
false |
選擇性 |
指出此文件需要公證。 |
ParticipantInfo 擴充功能
ParticipantInfo 定義已擴充,允許指定公證驗證方法。
|
參數名稱 |
類型 |
預設 |
必要 |
描述 |
|---|---|---|---|---|
|
|
String |
不適用 |
必要 |
參與者的電子郵件。 |
|
notaryAuthentication |
Enum |
MULTI_FACTOR_AUTHENTICATION |
選擇性 |
MULTI_FACTOR_AUTHENTICATION - 使用雙因素驗證方法執行公證驗證 |
NotaryInfo
AgreementInfo 定義新增了選擇性 notaryInfo 欄位,包含用於指定額外公證關聯選項的 NotaryInfo 物件。
|
參數名稱 |
類型 |
預設 |
必要 |
描述 |
|---|---|---|---|---|
|
notaryType |
Enum |
如果帳戶只啟用「Notarize 公證隨選服務」, |
必要 |
NOTARIZE_NOTARY - Notarize 服務提供公證 |
|
payment |
Enum |
BY_SENDER |
選擇性 |
type == NOTARIZE_NOTARY 時才適用 |
|
appointmentStart |
String |
"" |
選擇性 |
ISO_DATE_TIME 格式設定字串請見 ISO_ZONED_DATE_TIME |
|
note |
String |
無 |
選擇性 |
公證工作階段備註。 |
|
notaryEmail |
String |
"" |
選擇性 |
自攜公證的電子郵件 |
範例 /agreement
PUT|GET /agreements/{aid}
PUT /agreements/{aid} API 支援以公證選項更新合約。 GET /agreements/{aid} API 會傳回為合約公證設定的任何選項。 請參閱「POST /agreements」一節,以檢視更新的屬性。
錯誤碼
POST /agreements 的現有錯誤碼保持不變。 我們已定義新的錯誤碼,如下所示:
|
REST 錯誤碼 |
HTTP 狀態碼 |
訊息 |
狀況 |
|---|---|---|---|
|
PERMISSION_DENIED |
403 |
使用者設定或 Oauth 範圍權杖不允許傳送合約以進行公證。 |
當角色設定為 NOTARY_SIGNER,且 API 呼叫者 (即可能的寄件者) 未啟用公證功能及/或未設定公證服務提供者時,將擲回此錯誤。 |
文件影響
在請求的 AgreementInfo 物件中,「status」元素將包含新合約狀態「WAITING_FOR_PORGATIONG」。
POST /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/signingTokens
客戶 (公證簽署者) 可使用此 API 來取得簽署權杖,以便完成流程的電子簽署階段。
- 新增了簽署功能,以擷取新角色 - ACCEPT_BEFORE_NOTARIZATION。
- 不應取得簽署權杖來完成公證階段。
PUT /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/status
客戶 (公證簽署者) 可使用此 API 來完成流程的電子簽署階段。 為了加入新角色,導入了新的列舉狀態值 - ACCEPTED_BEFORE_NOTARIZATION。
|
屬性 |
類型 |
描述 |
||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Status |
Enum<String>
|
|
||||||||||||||
公證簽署者可依序透過下列 API 呼叫完成電子簽署階段:
- GET /agreements/{agreementId}/members - 擷取公證簽署者的參與者 ID 和參與者集 ID
- POST /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/signingTokens - 為具備 ACCEPT_BEFORE_NOTARIZATION 能力的公證簽署者請求簽署權杖
- POST /transientDocuments - 上傳已審核的文件
- PUT /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/status - 提交已審核的文件並完成電子簽署階段。
新 Webhook 事件
客戶可訂閱新 Webhook 事件 AGREEMENT_READY_FOR_NOTARIZATION,以便於合約可進行公證時收到通知。 此事件不會顯示在 Webhook UI 上,不過可以透過 POST /webhooks API 呼叫訂閱。
文件影響
下列 API 未修改,但相關文件已更新,加入新合約狀態「WAITING_FOR_NOTARIZATION」或新角色「NOTARY_SIGNER」。
GET /agreements
在回應 UserAgreements/UserAgreement 物件中,「status」元素現在加入相應狀態「WAITING_FOR_NOTARIZATION」。
GET /agreements/{agreementId}
在回應 AgreementInfo 物件中,「status」元素現在加入相應狀態「WAITING_FOR_NOTARIZATION」。
GET /agreements/{agreementId}/events
API 已更新,支援新的 READY_TO_NOTARIZE 和 NOTARIZED 事件。
在回應 Event 物件中,
- 「participantRole」元素現在加入新角色 NOTARY_SIGNER。
- 「type」元素加入新事件 READY_TO_NOTARIZE 和 NOTARIZED。 「description」元素分別為「傳送以進行公證的文件」和「收到經過公證的文件」
GET /agreements/{agreementId}/members/participantSets/{participantSetId}
在回應 DetailedParticipantSetInfo 物件中,「status」元素現在加入相應狀態「WAITING_FOR_NOTARIZATION」。
PUT /agreements/{agreementId}
請求 AgreementInfo 物件現在加入「WAITING_FOR_NOTARIZATION」狀態。
PUT /agreements/{agreementId}/members/participantSets/{participantSetId}
WAITING_FOR_NOTARIZATION 狀態是 DetailedParticipantSetInfo 物件中的「status」元素值之一。
POST /agreements/{agreementId}/view
WAITING_FOR_NOTARIZATION 狀態已新增為允許的檢視之一。
GET /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/signingInfo
如果請求路徑中指定的參與者有公證簽署者角色,API 會傳回 ACCEPT_BEFORE_NOTARIZATION 簽署設定,以符合此合約/參與者的其他所有簽署設定。
已解決的問題
| 問題 | 描述 |
| 4308901 | 以電話驗證方法委派合約時,如果所委派電話號碼的國家/地區代碼相同會造成錯誤,此問題現已修正。 |
| 4314113 | 修正使用者在傳送新合約時無法編輯預設到期日期的問題。 |
| 4318558 | 以電話驗證取代收件者時,系統發生「指定的參與者集 ID 無效」錯誤,此問題現已修正。 |
| 4319038 | 使用「大量傳送」工作流程傳送時,傳送者無法選擇「外部收件者身分驗證」,此問題現已修正。 |
| 4319798 | 選取選項按鈕會使游標跳至其他欄位,此問題現已修正。 |
| 4320154 | 修正資料庫範本無法儲存至新群組關係的問題。 |
| 4323013 | 在管理頁面開啟網頁表單會引發「文件目前無法存取或沒有頁面可供檢視」錯誤,此問題現已修正。 |
| 4323554 | 更新管理員權限的事件時間/日期戳記可能產生兩筆時間值相同的記錄,此問題現已修正。 |
| 4323609 | 修正在管理頁面上傳已簽署的合約時無法觸發 AGREEMENT_WORKFLOW_COMPLETED Webhook 的問題。 |
| 4325142 | 合約取消後,自訂電子郵件範本無法反映正確的參與者名稱值,此問題現已修正。 |
| 4326747 | 修正「大量傳送」頁面無法完成載入程序而省略「上傳」和「傳送」動作的問題。 |
| 4326855 | 修正收件者無法拒絕核准合約的問題。 |
| 4327000 | 修正 Smart-Id 認證失敗 (錯誤訊息指出找不到演算法) 的問題。 |