共用方式為


RSign(預覽)

RSign® 是一個安全且具法律約束力的電子簽章平台,能簡化文件工作流程。 此連接器使使用者能自動發送簽章請求、追蹤即時信封狀態,並檢索已完成的簽署文件與簽章憑證。 它透過數位化文件執行及確保安全且可追蹤的數位交易,提升企業效率。

此連接器適用於以下產品和區域:

服務 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)
連絡人​​
名稱 RSign 支援
URL https://rsign.com/contact/questions
Email support@rpost.com
連接器中繼資料
Publisher RPost 美國公司
Publisher RPost 美國公司
網站 https://rpost.com/
隱私策略 https://rpost.com/legal-notices/privacy-notice
類別 內容和文件;生產力

RSign 自訂連接器概述

連接器名稱: RSign 簡介: RSign® 是一個電子簽章及數位交易管理平台,提供安全、具法律約束力且簡化的文件工作流程。 出版商: RPost

1. 連接器功能

RSign® 連接器提供電子簽章與文件管理功能,讓使用者能直接將 RSign 工作流程整合到其 Power Platform 解決方案中(Power Automate、Power Apps 及 Logic Apps)。

主要行動

該連接器目前支援以下主要操作:

  • 取得 AuthToken: 根據 RSign® 憑證驗證使用者,並取得所有後續 API 呼叫所需的憑證AuthToken()。
  • 使用範本寄信封: 使用預先設定的 RSign® 範本傳送文件以進行電子簽名,並將範本角色對應至特定收件人。
  • 使用規則寄信封: 使用預先設定的 RSign® 規則傳送文件以供電子簽章,允許在請求主體中以 Base64 資料形式提供文件。
  • 取得範本資訊: 擷取特定 RSign® 範本或規則的詳細資訊,包括定義文件與接收者角色(RoleID)。
  • 取回信封狀態: 利用信封代碼取得電子簽名請求的狀態。
  • 取回信封文件: 下載與信封代碼相關的文件(原始及/或最終簽署文件)。

2. 認證設定

RSign® 連接器採用自訂認證方案,要求在執行其他動作前成功呼叫該 Get AuthToken 動作。

認證動作(Get AuthToken

此操作需取得以下憑證,必須從 RSign® 平台取得:

參數名稱 類型 Description 可見度
ReferenceKey 字串 與你 RPost® 帳戶相關的參考金鑰。 這很重要
EmailId 字串 你 RSign® 帳號的電子郵件地址。 這很重要
Password 密碼 你 RSign® 帳號的密碼。 這很重要

使用 AuthToken

動作在Get AuthToken回應體中回傳 。AuthToken 此權杖必須在後續的 API 呼叫中傳遞給所有其他支援的動作。

註: 該憑證 AuthToken 有有效期限(),AuthTokenExpires應在流程或應用邏輯中管理,以確保當現有憑證過期時會使用新的。

3. 先決條件

要成功使用此 RSign® 客製化連接器,使用者必須符合以下要求:

  • 有效的 RSign® 授權: 使用者必須持有有效且有效的 RSign® 使用者授權。
  • API 存取: 與所提供憑證相關的 RSign® 帳號必須啟用並付費使用該 API 存取功能。 此功能是產生 ReferenceKey 並成功使用 RSign® 連接器所必需的。

如果您目前不符合這些要求,或對目前的 RSign® 帳號設定不確定,請聯絡您的 RPost® 代表。

4. 整合重要說明

範本與規則使用

  • 範本代碼/規則代碼: 這兩種 Send Envelope 動作都需要一個 TemplateCode (或規則代碼)來識別 RSign® 中預先設定的文件與簽署欄位。
  • 角色定位: 傳送信封時, TemplateRoleRecipientMapping 陣列必須被填入。 每個接收者的 必須先用動作Retrieve Template Information取回。RoleID 這確保收件人正確對應到範本中定義的簽名欄位。

文件處理

  • 使用規則寄信封: 此動作要求文件內容以 Base64 編碼字串DocumentBase64Data()傳遞。
  • 取回信封文件: 文件在回應文中以 Base64 字串ByteArray()形式回傳。 消費流程必須解碼此字串以儲存檔案。

錯誤處理

所有動作都會在回應本體中回傳狀態資訊,包括:

  • StatusCode (整數)
  • StatusMessage (字串)
  • Message (字串)

使用者應根據 實施錯誤檢查 StatusCode ,以確保操作成功執行。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

使用範本寄信封

使用指定的 RSign 範本向特定收件人發送電子簽訊請求。

使用規則發送信封

使用指定的 RSign 規則向指定收件人發送 eSign 請求。

取回信封文件

根據信封代碼,取回信封中文件部分。 它會根據信封狀態,取回原始文件和/或最終簽署文件。

取回信封狀態

根據信封代碼取得信封狀態。 您可以選擇詳細或摘要報告。

取得 AuthToken

回傳一個 AuthToken,用於所有其他 Rsign 支援的動作。

取得範本資訊

根據範本或規則的程式碼取得相關資訊。 回傳的資訊包括範本名稱、文件及定義的角色。

使用範本寄信封

使用指定的 RSign 範本向特定收件人發送電子簽訊請求。

參數

名稱 機碼 必要 類型 Description
驗證權杖
AuthToken True string

AuthToken 從「Get AuthToken」操作中取得。

範本程式碼
TemplateCode True string

要用的範本 ID。

應用程式金鑰
AppKey string

使用該連接器系統的唯一識別碼。 請向 RPost® 客服申請。

角色標識碼
RoleID True string

收件人的角色識別碼。 取自「取回範本資訊」動作。

收件者電子郵件
RecipientEmail True string

收件者的電子郵件位址。

RecipientName
RecipientName True string

收件者的名稱。

行動裝置
Mobile string

收件人的手機號碼。 如果你的範本不要求,留空。

傳回

名稱 路徑 類型 Description
信封代碼
EnvelopeCode string

信封的身分證。

透明度改變訊息
TransparencyChangedMessage string

透明度改變了訊息。

基於語言的 API 訊息
LanguageBasedApiMessge string

基於語言的 API 訊息。

預填收件人識別碼
PrefillRecipientId string

預填收件人識別碼。

發送後導覽頁面
PostSendingNavigationPage string

收件人簽名完成後會被導向的網站。

新簽署者使用者介面是否啟用
IsNewSignerUIEnabled boolean

新簽署者介面啟用了嗎?

狀態代碼
StatusCode integer

回應狀態代碼。

狀態訊息
StatusMessage string

回應狀態訊息。

Message
Message string

回應狀態描述。

信封ID
EnvelopeId string

產生信封的內部 ID。

簽署文件網址
SignDoumentUrl string

信封簽名的全域網址。

得獎名單
RecipientList array of object

得獎者詳情

收件者名稱
RecipientList.RecipientName string

收件人姓名及本信封部分。

收件者電子郵件
RecipientList.RecipientEmail string

收件人的電子郵件地址,附於本信封部分。

訂單
RecipientList.Order integer

收件人需要進入的順序才能完成信封。

類型
RecipientList.Type string

收件人類型,是本信封的部分。 可能的值有:簽名者(Signer)和預填充(Prefill)。

傳遞方式
RecipientList.DeliveryMode integer

表示簽章請求與存取碼傳送給接收者的通道。

撥號代碼
RecipientList.DialCode string

簽章請求與存取碼傳送所在國家的撥號代碼。

國碼 (地區碼)
RecipientList.CountryCode string

簽章請求與存取碼傳送所在國家的代碼。

行動電話號碼
RecipientList.Mobile string

收件人的手機號碼。

行動模式
RecipientList.MobileMode integer

表示簽章請求與存取碼傳送給收件人的行動通訊頻道。

簽名網址
RecipientList.SigningUrl string

收件人用來存取並簽名信封的網址。

撥號代碼下拉選單
DialCodeDropdownList string

撥號代碼下拉選單。

啟用訊息至行動裝置
EnableMessageToMobile string

啟用訊息至行動裝置。

使用規則發送信封

使用指定的 RSign 規則向指定收件人發送 eSign 請求。

參數

名稱 機碼 必要 類型 Description
驗證權杖
AuthToken True string

AuthToken 從「Get AuthToken」操作中取得。

範本程式碼
TemplateCode True string

規則的識別碼。

名稱
Name True string

文件名稱。 包含擴展檔(例如:Agreement.docx)。

DocumentBase64Data
DocumentBase64Data True string

文件需以 Base64 格式傳送。

應用程式金鑰
AppKey string

使用該連接器系統的唯一識別碼。 請向 RPost® 客服申請。

角色標識碼
RoleID True string

收件人的角色識別碼。 取自「取回範本資訊」動作。

收件者電子郵件
RecipientEmail True string

收件者的電子郵件位址。

RecipientName
RecipientName True string

收件者的名稱。

行動裝置
Mobile string

收件人的手機號碼。 如果你的規則沒有要求,請留空。

傳回

名稱 路徑 類型 Description
信封代碼
EnvelopeCode string

信封的身分證。

透明度改變訊息
TransparencyChangedMessage string

透明度改變了訊息。

基於語言的 API 訊息
LanguageBasedApiMessge string

基於語言的 API 訊息。

預填收件人識別碼
PrefillRecipientId string

預填收件人識別碼。

發送後導覽頁面
PostSendingNavigationPage string

收件人簽名完成後會被導向的網站。

新簽署者使用者介面是否啟用
IsNewSignerUIEnabled boolean

新簽署者介面啟用了嗎?

狀態代碼
StatusCode integer

回應狀態代碼。

狀態訊息
StatusMessage string

回應狀態訊息。

Message
Message string

回應狀態描述。

信封ID
EnvelopeId string

產生信封的內部 ID。

簽署文件網址
SignDoumentUrl string

信封簽名的全域網址。

得獎名單
RecipientList array of object

得獎者詳情

收件者名稱
RecipientList.RecipientName string

收件者的名稱。

收件者電子郵件
RecipientList.RecipientEmail string

收件者的電子郵件位址。

訂單
RecipientList.Order integer

收件人需要進入的順序才能完成信封。

類型
RecipientList.Type string

收件人類型,是本信封的部分。 可能的值有:簽名者(Signer)和預填充(Prefill)。

傳遞方式
RecipientList.DeliveryMode integer

表示簽章請求與存取碼傳送給接收者的通道。

撥號代碼
RecipientList.DialCode string

簽章請求與存取碼傳送所在國家的撥號代碼。

國碼 (地區碼)
RecipientList.CountryCode string

簽章請求與存取碼傳送所在國家的代碼。

行動電話號碼
RecipientList.Mobile string

收件人的手機號碼。

行動模式
RecipientList.MobileMode integer

表示簽章請求與存取碼傳送給收件人的行動通訊頻道。

簽署網址
RecipientList.SigningUrl string

收件人用來存取並簽名信封的網址。

撥號代碼下拉選單
DialCodeDropdownList string

撥號代碼下拉選單。

啟用訊息至行動裝置
EnableMessageToMobile string

啟用訊息至行動裝置。

取回信封文件

根據信封代碼,取回信封中文件部分。 它會根據信封狀態,取回原始文件和/或最終簽署文件。

參數

名稱 機碼 必要 類型 Description
信封代碼
EnvelopeCode True string

要取回信封的密碼。

驗證權杖
AuthToken True string

AuthToken 從「Get AuthToken」操作中取得。

傳回

名稱 路徑 類型 Description
地位
Status boolean

狀態成功旗。

狀態代碼
StatusCode integer

回應狀態代碼。

Message
Message string

回應狀態描述。

狀態訊息
StatusMessage string

回應狀態訊息。

信封代碼
Data.EnvelopeCode string

信封代碼作為參數傳遞。

文件列表
Data.DocumentList array of object

文件列表。

檔案類型
Data.DocumentList.DocumentType string

附件的類型。

檔案名稱
Data.DocumentList.FileName string

檔案的名稱。

Description
Data.DocumentList.Description string

文件說明。

位元組陣列
Data.DocumentList.ByteArray string

檔案為 Base64 格式。

其他資訊
Data.DocumentList.AdditionalInfo string

補充資訊。

附件說明
Data.DocumentList.AttachmentDescription string

對檔案內容的詳盡說明。

讀我
Data.ReadMe string

以 Base64 格式的文字檔,標示簽署文件名稱及原始檔案。

合併拉鍊
Data.CombinedZip string

包含信封所有文件的壓縮檔。

總計數
TotalCount integer

總計計數。

有附件上傳存在嗎?
IsAttachmentUploadsExist string

有附件上傳的存在嗎?

取回信封狀態

根據信封代碼取得信封狀態。 您可以選擇詳細或摘要報告。

參數

名稱 機碼 必要 類型 Description
驗證權杖
AuthToken True string

AuthToken 從「Get AuthToken」操作中取得。

EnvelopeCode
EnvelopeCode True string

信封代碼。

詳細或摘要
DetailOrSummary True string

選擇你想要的報告類型。

傳回

名稱 路徑 類型 Description
地位
Status boolean

請求狀態。

狀態代碼
StatusCode integer

回應狀態代碼。

Message
Message string

回應狀態描述。

狀態訊息
StatusMessage string

回應狀態訊息。

Envelope Data List
Data array of object
信封代碼
Data.EnvelopeCode string

信封的身分證。

信封 ID
Data.EnvelopeID string

信封內部識別。

主旨
Data.Subject string

信封上的電子郵件主旨。

信封狀態
Data.Status string

所請求信封的狀態。

信封已完成
Data.IsEnvelopeComplete boolean

表示信封是否已完成。

傳送日期
Data.SentDate string

信封寄出的日期。

最後修改日期
Data.LastModifiedDate string

最後修改日期。

SenderName
Data.SenderName string

寄件者的名稱。

寄件者電子郵件
Data.SenderEmail string

寄件人的電子郵件。

得獎者詳情
Data.RecipientDetails array of object
收件者 ID
Data.RecipientDetails.RecipientID string

收件人身份證,是本信封的一部分。

收件人類型識別碼
Data.RecipientDetails.RecipientTypeID string

收件人部分的類型識別碼。

收件者類型
Data.RecipientDetails.RecipientType string

收件人類型,是本信封的部分。 可能的值有:簽名者(Signer)和預填充(Prefill)。

收件者名稱
Data.RecipientDetails.RecipientName string

收件者的名稱。

Email
Data.RecipientDetails.Email string

收件者的電子郵件位址。

訂單
Data.RecipientDetails.Order integer

收件人需要進入的順序才能完成信封。

狀態標識碼
Data.RecipientDetails.StatusId string

狀態識別碼。

簽署狀態
Data.RecipientDetails.SigningStatus string

收件人的簽名狀態。

上次修改日期
Data.RecipientDetails.LastModifiedDate string

最後修改日期。

參考代碼
Data.ReferenceCode string

參考代碼是現有信封的一部分。

參考電子郵件
Data.ReferenceEmail string

參考電子郵件,請參考現有信封的一部分。

TotalCount
TotalCount integer

符合要求標準的信封總數。

IsAttachmentUploads存在
IsAttachmentUploadsExist string

有附件上傳的存在嗎?

取得 AuthToken

回傳一個 AuthToken,用於所有其他 Rsign 支援的動作。

參數

名稱 機碼 必要 類型 Description
參考資料
ReferenceKey True string

您公司帳戶的唯一識別碼。

電子郵件標識符
EmailId True string

你RSign帳號的電子郵件地址。

密碼
Password True password

你RSign帳號的密碼。

傳回

名稱 路徑 類型 Description
認證訊息
AuthMessage string

回應狀態訊息。

驗證權杖
AuthToken string

用於其他 RSign 動作的認證權杖。

重新整理令牌
RefreshToken string

刷新代幣。

刷新令牌到期
RefreshTokenExpires string

目前刷新代幣到期的日期。

認證令牌過期
AuthTokenExpires string

目前認證令牌到期的日期。

電子郵件 ID
EmailId string

已認證使用者的電子郵件。

API Id
ApiId string

API ID。

取得範本資訊

根據範本或規則的程式碼取得相關資訊。 回傳的資訊包括範本名稱、文件及定義的角色。

參數

名稱 機碼 必要 類型 Description
範本程式碼
TemplateCode True string

範本的程式碼要取回。

驗證權杖
AuthToken True string

AuthToken 從「Get AuthToken」操作中取得。

傳回

名稱 路徑 類型 Description
狀態代碼
StatusCode integer

回應狀態代碼。

狀態訊息
StatusMessage string

回應狀態訊息。

Message
Message string

回應狀態描述。

範本識別碼
TemplateId string

範本識別碼。

範本識別碼
TemplateBasicInfo.TemplateId string

範本識別碼。

範本程式碼
TemplateBasicInfo.TemplateCode integer

用於其他動作的範本程式碼。

用戶電子郵件
TemplateBasicInfo.UserEmail string

範本使用者擁有者的電子郵件。

範本名稱
TemplateBasicInfo.TemplateName string

範本的名稱。

範本說明
TemplateBasicInfo.TemplateDescription string

範本說明。

是靜態的
TemplateBasicInfo.IsStatic string

表示範本是否可修改。

到期日
TemplateBasicInfo.ExpiryDate string

範本到期的日期。

建立日期
TemplateBasicInfo.CreatedDate string

模板創建的日期。

上次修改日期
TemplateBasicInfo.LastModifiedDate string

模板最後一次修改的日期。

主旨
TemplateBasicInfo.Subject string

電子郵件範本主題。

身體
TemplateBasicInfo.Body string

電子郵件範本正文。 HTML 編碼。

類型名稱
TemplateBasicInfo.TypeName string

範本類型(可能值:範本、規則)。

文件列表
TemplateBasicInfo.DocumentList array of object

文件列表。

文件標識碼
TemplateBasicInfo.DocumentList.DocumentId string

範本文件部分的身份證。

文件名稱
TemplateBasicInfo.DocumentList.DocumentName string

範本中文件部分的名稱。

訂單
TemplateBasicInfo.DocumentList.Order integer

文件列表中模板部分的順序。

文件內容細節
TemplateBasicInfo.DocumentList.documentContentDetails array of object

文件內容細節。

控制識別碼
TemplateBasicInfo.DocumentList.documentContentDetails.ControlID string

文件中使用的控制項的內部識別。

控制項名稱
TemplateBasicInfo.DocumentList.documentContentDetails.ControlName string

文件中使用的控制項名稱。

控制 HTML ID
TemplateBasicInfo.DocumentList.documentContentDetails.ControlHtmlID string

文件中使用的控制項的 HTML ID。

群組名稱
TemplateBasicInfo.DocumentList.documentContentDetails.GroupName string

包含控制組的名稱。

標籤
TemplateBasicInfo.DocumentList.documentContentDetails.Label string

文件中要顯示的控制項名稱。

頁碼
TemplateBasicInfo.DocumentList.documentContentDetails.PageNo integer

控制項所在文件中的頁面。

為必填項目
TemplateBasicInfo.DocumentList.documentContentDetails.Required boolean

不管是否需要控制。

控制值
TemplateBasicInfo.DocumentList.documentContentDetails.ControlValue string

控制值已預先填入。

角色識別碼
TemplateBasicInfo.DocumentList.documentContentDetails.RoleId string

識別需要填補控制權的角色。

角色名稱
TemplateBasicInfo.DocumentList.documentContentDetails.RoleName string

需要填補控制權的職位名稱。

選擇控制選項
TemplateBasicInfo.DocumentList.documentContentDetails.SelectControlOptions array of string

選擇控制選項。

範本角色列表
TemplateBasicInfo.TemplateRoleList array of object

得獎者名單。

角色 ID
TemplateBasicInfo.TemplateRoleList.RoleID string

這個範本中角色部分的識別碼。

角色名稱
TemplateBasicInfo.TemplateRoleList.RoleName string

這個範本中角色部分的名稱。

訂單
TemplateBasicInfo.TemplateRoleList.Order integer

角色(收件人)完成範本的順序。

收件者電子郵件
TemplateBasicInfo.TemplateRoleList.RecipientEmail string

此範本中收件人的預先填寫電子郵件部分。

收件者名稱
TemplateBasicInfo.TemplateRoleList.RecipientName string

此範本中預先填寫收件人姓名。

收件人類型識別碼
TemplateBasicInfo.TemplateRoleList.RecipientTypeID string

收件人的內部識別碼。

收件者 ID
TemplateBasicInfo.TemplateRoleList.RecipientID string

此範本中收件人的身分證。

收件者類型
TemplateBasicInfo.TemplateRoleList.RecipientType string

收件人類型。

Cc 簽名者類型
TemplateBasicInfo.TemplateRoleList.CcSignerType string

信用卡收件人類型。

文化資訊
TemplateBasicInfo.TemplateRoleList.CultureInfo string

它是使用者在建立範本/規則時所使用的服務語言。

傳遞方式
TemplateBasicInfo.TemplateRoleList.DeliveryMode integer

表示簽章請求與存取碼傳送給接收者的通道。

撥號代碼
TemplateBasicInfo.TemplateRoleList.DialCode string

簽章請求與存取碼傳送所在國家的撥號代碼。

國碼 (地區碼)
TemplateBasicInfo.TemplateRoleList.CountryCode string

簽章請求與存取碼傳送所在國家的代碼。

行動電話號碼
TemplateBasicInfo.TemplateRoleList.Mobile string

收件人的手機號碼。

行動模式
TemplateBasicInfo.TemplateRoleList.MobileMode integer

表示簽章請求與存取碼傳送給收件人的行動通訊頻道。

電子郵件地址
TemplateBasicInfo.TemplateRoleList.EmailAddress string

收件者的電子郵件地址。

啟用訊息至行動裝置
TemplateBasicInfo.EnableMessageToMobile boolean

啟用訊息至行動裝置。

靜態連結到期日
TemplateBasicInfo.StaticLinkExpiryDate string

靜態連結的有效期限。

範本列表
TemplateList string

範本清單。