馬克·薩恩(預覽)

Mark Sign 是一項符合 eIDAS 規範的合格電子簽章服務。 發送文件進行簽署,等待簽名,下載並驗證已簽署的檔案。

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

Service Class Regions
Copilot Studio 進階 除下列區域外的所有 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)
連絡人
Name 標記編號,UAB
URL https://marksign.eu
Email pagalba@marksign.lt
連接器中繼資料
Publisher 標記編號,UAB
Website https://marksign.eu
隱私權原則 https://marksign.eu/privacy-policy
Categories 生產力;內容和文件

標記符號

Mark Sign 是一項符合 eIDAS 規範的合格電子簽章服務。 流程可以傳送文件進行簽署,等待簽署後下載簽署檔案並進行驗證。

Publisher:Mark ID,UAB

Prerequisites

你需要一個 Mark Sign API 存取權杖。 請參閱下方「取得證件」部分。

支援的作業

文件:上傳

上傳文件(PDF、ADoc、BDoc 或 ASiC-E)並準備簽署。 檔案名稱會變成文件標題。

簽名:以電子郵件邀請

邀請某人簽名;Mark Sign 寄出邀請信。 再打一次給同一個人會提醒你。

簽名:透過網址邀請

在不寄電子郵件的情況下新增簽署者,並回傳他們的 個人邀請網址 讓你轉達。

簽名:等待所有簽名者

直到文件簽署或被拒絕,或在等待時間(預設為 29 天)結束時,狀態才會結束 timed_out 。

簽名:等待一位簽名者

保持流程,直到某位簽署者(透過電子郵件選出)簽署。 任何拒絕也都結束了等待。

簽名:等待下一位簽名者

當下一位簽署者簽署或拒絕時,流程立即恢復,無需投票。

文件:取得狀態

檢查文件的整體簽署狀態。

文件:找簽名者

列出每位簽署人的狀態,包括若簽署人被拒絕,則會說明拒絕理由。

文件:下載

下載了目前收集到的所有簽名文件。

文件:列表

列出你工作區中的文件,並具備文字搜尋和分頁功能。

文件:移除

從工作區移除文件。

文件:以容器形式上傳

將多個檔案合併成一個可簽署的容器文件(ADoc、BDoc 或 ASiC-E)。 帳單依照標記簽名預設方式進行,每位簽署人自行付款。

為每位簽名者建立個人簽名連結,讓自己也能獲得。 這些連結會過期,可能需要身份驗證,且是唯一有拒絕選項的簽名頁面。

建立一個連結,任何人都可以以自己驗證身份開啟簽署文件。

在簽名者連結或分享連結過期前刪除。

文件:延長簽名有效期

升級文件簽章以達成長期有效性(LT)或長期歸檔(LTA)。

文件:驗證

檢查文件簽名並回傳完整的驗證報告。

取得憑證

請聯絡 Mark Sign 客服 pagalba@marksign.lt ,申請您的工作空間 API 存取權杖。 在 Power Automate 建立連線時,將令牌貼上到「API Key」欄位。

權杖綁定在同一個工作區,因此透過該連線建立或列出的所有文件都屬於該工作區。

使用者入門

最簡單的簽約流程:

  1. 文件:上傳(例如來自 SharePoint 或 OneDrive 的檔案內容與名稱標記)。
  2. 簽名:以電子郵件邀請。 Mark Sign 寄出邀請函。
  3. 簽名:等待下一位簽名者。 流程在此暫停,直到簽署儀式進行。
  4. 文件:下載 並儲存在你需要的地方。

若有多名簽署者,請為每位用戶使用「 簽署:透過電子郵件邀請 」,然後在下載前先使用「 簽署:等待所有簽署者」 步驟。 想自己傳送連結,而非 Mark Sign 郵件,請使用 Signing: Invite by URL 或 Signing: Create signer 連結,並用你自己的 Outlook 或 Teams 動作傳送給每位成員的連結。

已知問題和限制

  • 連接器不提供流量觸發器;在流程中使用等待操作。
  • 文件只有一次註冊通知。 不要同時執行兩次 簽署:同時等待簽署者對同一 文件的下一步。 第二步會替換第一步,第一步則會等到超時結束。在任何區塊上填寫 回撥網址 欄位也會取代註冊。
  • 簽署者只能在簽署: 建立簽署者連結 頁面(開啟 顯示拒絕按鈕 )拒絕文件;電子郵件邀請、邀請網址和分享連結都沒有拒絕選項。
  • Mark Sign 只會通知簽名。 當邀請區塊使用 目的 或reviewconfirmation時,該人的行動永遠不會喚醒 。簽署:等待下一位簽署者;用文件查看狀態 :改為取得簽署者 。
  • 文件:下載僅 回傳檔案內容;從 文件清單 或上傳步驟取檔名。
  • 一次流程運行最多只能持續30天(Power Automate的限制),所以沒有等待時間能超過這段時間。 簽署:等待所有簽署者, 簽署: 等待一名簽署者 在預設 29 天後結束 timed_out 狀態。 簽署時:等待下一個簽署者,在動作設定中設定逾時(例如P29D),並新增一個分支設定在動作逾時後執行。如果先達到 30 天的生產限制,Power Automate 會取消整個生產,且沒有分支處理。
  • 文件:List 不支援依狀態篩選。
  • 文件:上傳 每次通話接受一個檔案;循環播放附件以上傳多個。 文件:以容器形式上傳 是針對少數檔案設計的;將多個大型檔案合併於一通通話中,可能會超過處理時間限制。

部署指示

在你的 Power Platform 環境中執行 paconn create --api-prop apiProperties.json --api-def apiDefinition.swagger.json --script script.csx --icon icon.png 此連接器作為自訂連接器。 詳情請參閱 Paconn 文件 。

支援

如連接器或 Mark Sign API 出現問題,請聯絡 pagalba@marksign.lt。

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有地區 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

Name 類型 Description Required
API 金鑰 安全字串 你工作區的 Mark Sign API 存取權杖。 請向 pagalba@marksign.ltMark Sign 客服申請。 True

動作

文件:上傳

上傳文件並準備簽署。

文件:下載

下載了目前收集到的所有簽名文件。

文件:以容器形式上傳

將多個檔案合併成一個可簽署的容器文件,例如 ADoc 或 ASiC-E。 檔案會在同一步驟內上傳並合併。

文件:列表

列出工作區中的文件,排在最新的。

文件:取得狀態

會取得文件的簽署狀態。

文件:延長簽名有效期

升級文件簽章以維持長期有效性或存檔。

文件:找簽名者

列出文件簽署者及其簽署狀態。

文件:移除

從你的工作區移除一份文件。

文件:驗證

檢查文件簽名並回傳驗證報告。 流程會等到檢查結束後才進行。

簽名:以電子郵件邀請

邀請某人簽署該文件。 Mark Sign 會透過電子郵件發送邀請函。

簽名:刪除連結

在簽名者連結或分享連結過期前刪除。 邀請連結無法刪除。

簽名:建立共享連結

建立一個簽名連結,任何人都可以打開簽署文件。 你自己送。

簽名:建立簽名連結

為每位簽名者建立個人簽名連結。 你可以自己發送連結,例如透過電子郵件或 Teams 訊息。

簽名:等待一位簽名者

等待某位簽署人簽署文件後,讓流程繼續進行。 時間結束時,timed_out狀態結束。

簽名:等待下一位簽名者

等待下一位簽署人簽署或拒絕文件,且不發送任何邀請。 用它循環等待多個簽署者,而不做輪詢。

簽名:等待所有簽名者

等到所有簽署者都簽完或有人拒絕文件,然後讓流程繼續進行。 時間結束時,timed_out狀態結束。

簽名:透過網址邀請

在不寄電子郵件的情況下,會將簽署人加入文件,並回傳他們的個人邀請連結讓你轉交。 連結不會過期且無法刪除;需要撤銷連結時,請使用「簽署:建立簽署者連結」。

文件:上傳

上傳文件並準備簽署。

參數

名稱 機碼 必要 類型 Description
檔案名稱
file_name True string

檔案名稱及其副檔名,例如 contract.pdf。 它成為文件標題。

body
body True binary
存取
access string

誰可以查看該文件。 預設是私人的。

計費類型
billing_type True string

誰付簽名費?

傳回

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

文件識別碼
data.uuid string

文件的 ID。

檔案名稱
data.filename string

檔案的檔名。

文件:下載

下載了目前收集到的所有簽名文件。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

傳回

文件檔案的內容。

檔案內容
file

文件:以容器形式上傳

將多個檔案合併成一個可簽署的容器文件,例如 ADoc 或 ASiC-E。 檔案會在同一步驟內上傳並合併。

參數

名稱 機碼 必要 類型 Description
檔案類型
document_type True string

要建立的文件類型。

檔案名稱
file_name True string

檔案名稱及其副檔名,例如 contract.pdf。

檔案內容
file_content True byte

檔案的內容。

檔案類型(僅限 ADoc)
adoc_file_type string

檔案在容器中的角色。 僅在文件類型為 ADoc 時使用。

傳回

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

文件識別碼
data.uuid string

文件的 ID。

檔案名稱
data.filename string

文件檔案的名稱。

文件:列表

列出工作區中的文件,排在最新的。

參數

名稱 機碼 必要 類型 Description
搜尋
query string

文件標題和檔案名稱中需要注意的詞彙。

Offset
offset integer

要跳過多少文件?

極限
limit integer

要退多少文件。 預設值為 10。

傳回

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

文件:
data array of object

文件。

文件識別碼
data.uuid string

文件的 ID。

檔案名稱
data.filename string

檔案的檔名。

文件狀態
data.status string

文件的簽署狀態,例如已儲存(等待簽名)、signed_partially或已簽署。

上傳於
data.uploaded_at date-time

文件上傳時。

Total
total integer

匹配文件的總數。

文件:取得狀態

會取得文件的簽署狀態。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

傳回

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

文件狀態
data.document_status string

簽署狀態:已儲存(等待簽名)、signed_partially(部分已簽署)或簽署(所有人皆已簽署)。

文件:延長簽名有效期

升級文件簽章以維持長期有效性或存檔。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

Level
level True string

LT 代表長期效度,LTA 代表長期存檔。

傳回

文件:找簽名者

列出文件簽署者及其簽署狀態。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

傳回

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

手語者:
data array of object

文件的簽署者。

簽署者識別碼
data.id string

簽署者的身分證。

名字
data.name string

簽名者的名字。

姓氏
data.surname string

簽署者的姓氏。

Email
data.email string

簽署人的電子郵件地址。

簽署狀態
data.status string

簽署方是否已簽署:待定、簽署、拒絕、審查、確認、拒絕或審查。

拒絕原因
data.rejection_reason string

簽署人拒絕文件的理由。

文件:移除

從你的工作區移除一份文件。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

傳回

文件:驗證

檢查文件簽名並回傳驗證報告。 流程會等到檢查結束後才進行。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

傳回

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

有效
data.document.is_valid boolean

文件簽名是否有效。

有效期到
data.document.valid_to string

文件有效期有多長。

文件名稱
data.document.name string

文件的標題。

MIME 類型
data.document.mimetype string

文件的檔案類型。

簽章:
data.signatures array of object

每個簽名的結果。

簽章識別碼
data.signatures.id string

簽名的識別碼。

簽約時間
data.signatures.signing_time string

簽名時。

簽名格式
data.signatures.signature_format string

簽名格式。

有效
data.signatures.is_valid boolean

簽名是否有效。

有效期到
data.signatures.valid_to string

簽名有效期有多長。

憑證
data.certificates array of object

簽名所使用的憑證。

items
data.certificates object
時間戳記
data.timestamps array of object

時間戳記套用到文件上。

items
data.timestamps object
驗證時間
metadata.validation_time string

驗證時,

簽名:以電子郵件邀請

邀請某人簽署該文件。 Mark Sign 會透過電子郵件發送邀請函。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

名字
name True string

簽名者的名字。

姓氏
surname True string

簽署者的姓氏。

Email
email True email

簽署人的電子郵件地址。

語言
language string

邀請函的語言。 預設是立陶宛語。

成功網址
success_url string

簽字完成後該把簽字人送到哪裡。

Purpose
purpose string

為什麼這個人會被邀請。 選擇「評論」邀請僅供觀看。

回呼 URL
callback_url string

一個用來通知文件簽署時的網址。

傳回

簽名:刪除連結

在簽名者連結或分享連結過期前刪除。 邀請連結無法刪除。

參數

名稱 機碼 必要 類型 Description
簽名連結 ID
temporarySigningLinkId True string

簽名連結 ID 來自「簽署:建立簽署者連結」或「簽署:建立共享連結」的輸出。

傳回

簽名:建立共享連結

建立一個簽名連結,任何人都可以打開簽署文件。 你自己送。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documents True array of string

連結簽署的文件。 使用上傳或清單步驟中的文件 ID 值。

回呼 URL
callback_url string

一個用來通知文件簽署時的網址。

過期時間(分鐘)
expire_after integer

距離連結過期還有幾分鐘。 違約是2880(兩天)。

刪除文件 (分鐘)
delete_document_after integer

文件即將從工作區刪除只剩幾分鐘。 預設情況下,它會被保留。

傳回

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

簽署連結
data.signing_link string

任何人都可以開啟簽名連結。

簽名連結 ID
data.signing_link_id string

連結的 ID,代表「簽署:刪除連結」。

有效期限
data.valid_until integer

當連結到期時,作為 Unix 的時間戳記。

簽名:建立簽名連結

為每位簽名者建立個人簽名連結。 你可以自己發送連結,例如透過電子郵件或 Teams 訊息。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documents True array of string

建立簽署連結的文件。 使用上傳或清單步驟中的文件 ID 值。

簽署者識別碼
id string

你自己的身份證,簽名者,且在申請中獨一無二。 當電子郵件為空時,必須使用。

名字
name string

簽名者的名字。

姓氏
surname string

簽署者的姓氏。

Email
email email

簽署人的電子郵件地址。 當簽署者 ID 為空時必須。

個人法典
personal_code string

簽署者的個人代碼。 當需要認證時,這是必要的。

要求認證
authentication_required boolean

如果是,簽署者必須在開啟連結前驗證身份。

職位(僅限ADoc)
position string

簽署者的職務,顯示在 ADoc 簽名中。

系所(僅限ADoc)
structural_subdivision string

簽署人部門,以 ADoc 簽名顯示。

簽署目的(僅限 ADoc)
signing_purpose string

為什麼這個人會簽名,這會用 ADoc 簽名來顯示。

回呼 URL
callback_url string

一個用來通知文件簽署時的網址。

拒絕回撥網址
reject_callback_url string

一個 URL,用來通知簽署者拒絕文件。

過期時間(分鐘)
expire_after integer

距離連結過期還有幾分鐘。 違約是2880(兩天)。

顯示拒絕按鈕
show_reject_button boolean

簽署人是否可以在簽署頁面拒絕該文件。 預設是肯定的。

刪除文件 (分鐘)
delete_document_after integer

文件即將從工作區刪除只剩幾分鐘。 預設情況下,它會被保留。

傳回

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

簽名連結:
temporary_signing_links array of object

每位簽名者只需一個簽名連結。

簽署者識別碼
temporary_signing_links.id string

簽名者用的你自己的身分證。

名字
temporary_signing_links.member_name string

簽名者的名字。

姓氏
temporary_signing_links.member_surname string

簽署者的姓氏。

Email
temporary_signing_links.member_email string

簽署人的電子郵件地址。

簽署連結
temporary_signing_links.temporary_signing_link string

簽署者開啟簽署文件的連結。

簽名連結 ID
temporary_signing_links.temporary_signing_link_id string

簽名連結的ID。

有效期限
temporary_signing_links.valid_until integer

當連結到期時,作為 Unix 的時間戳記。

文件:
documents array of object

這些連結所建立的文件。

文件識別碼
documents.uuid string

文件的 ID。

檔案名稱
documents.filename string

文件檔案的名稱。

簽名:等待一位簽名者

等待某位簽署人簽署文件後,讓流程繼續進行。 時間結束時,timed_out狀態結束。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

簽署者電子郵件
signer_email True string

簽署人的電子郵件要等待,也是邀請他們時使用的那封郵件。

暫停(分鐘)
timeout_minutes integer

要等多久?幾分鐘,最後才會顯示timed_out狀態。 違約金額為41760(29天),最高為43200(30天)。

傳回

簽名:等待下一位簽名者

等待下一位簽署人簽署或拒絕文件,且不發送任何邀請。 用它循環等待多個簽署者,而不做輪詢。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

傳回

機身
SigningEvent

簽名:等待所有簽名者

等到所有簽署者都簽完或有人拒絕文件,然後讓流程繼續進行。 時間結束時,timed_out狀態結束。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

暫停(分鐘)
timeout_minutes integer

要等多久?幾分鐘,最後才會顯示timed_out狀態。 違約金額為41760(29天),最高為43200(30天)。

傳回

簽名:透過網址邀請

在不寄電子郵件的情況下,會將簽署人加入文件,並回傳他們的個人邀請連結讓你轉交。 連結不會過期且無法刪除;需要撤銷連結時,請使用「簽署:建立簽署者連結」。

參數

名稱 機碼 必要 類型 Description
文件識別碼
documentId True string

文件的 ID,來自「文件:上傳」、「文件:以容器形式上傳」或「文件:清單」的輸出。

名字
name True string

簽名者的名字。

姓氏
surname True string

簽署者的姓氏。

Email
email True email

簽署人的電子郵件地址。

成功網址
success_url string

簽字完成後該把簽字人送到哪裡。

Purpose
purpose string

為什麼這個人會被邀請。 選擇「評論」邀請僅供觀看。

回呼 URL
callback_url string

一個用來通知文件簽署時的網址。

傳回

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

邀請網址
data.invitation_url string

個人簽名頁面連結,將送達給簽署者。

定義

簽名活動

名稱 路徑 類型 Description
文件識別碼
uuid string

文件的 ID。

文件狀態
status string

文件的簽署狀態,例如簽署或signed_partially。 拒絕會顯示在簽署者狀態中。

簽名者伯爵
members_count integer

有多少人被邀請簽名。

簽名伯爵
signed_members_count integer

有多少人簽了名。

手語者:
members array of object

所有人都被邀請簽名。

簽署者識別碼
members.id string

簽署者的身分證。

名字
members.member_name string

簽名者的名字。

姓氏
members.member_surname string

簽署者的姓氏。

Email
members.member_email string

簽署人的電子郵件地址。

簽署狀態
members.status string

簽署者狀態,例如待處理、簽署或拒絕。

已確認回應

名稱 路徑 類型 Description
Status
status RequestStatus

要求的狀態。

簽名等待回應

名稱 路徑 類型 Description
文件狀態
document_status string

等待的結局:簽約、拒絕還是timed_out。

被拒絕的
rejected_by string

如果文件被拒絕,是誰拒絕的?

拒絕原因
rejection_reason string

簽署人給出的理由,如果文件被拒絕。

RequestStatus

要求的狀態。

要求的狀態。

Status
string

檔案

這是基本資料類型「檔案」。