标记符号(预览版)

Mark Sign 是符合 eIDAS 法规的合格电子签名服务。 发送文档进行签名,等待签名,下载并验证已签名的文件。

此连接器在以下产品和区域中可用:

Service Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 :
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部(DoD)
Power Apps 高级 除以下各项外的所有 Power Apps 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
Power Automate 高级 除以下各项外的所有 Power Automate 区域 :
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
联系人
Name 标记 ID、UAB
URL https://marksign.eu
Email pagalba@marksign.lt
连接器元数据
Publisher 标记 ID、UAB
网站 https://marksign.eu
隐私策略 https://marksign.eu/privacy-policy
Categories 生产力;内容和文件

标记符号

Mark Sign 是符合 eIDAS 法规的合格电子签名服务。 流可以发送文档进行签名,等到文档签名,然后下载已签名的文件并对其进行验证。

Publisher:标记 ID、UAB

Prerequisites

需要标记签名 API 访问令牌。 请参阅下面的“获取凭据”。

支持的操作

文档:上传

上传文档(PDF、ADoc、BDoc 或 ASiC-E),并准备进行签名。 文件名将成为文档标题。

签名:通过电子邮件邀请

邀请某人签名;Mark Sign 发送邀请电子邮件。 为同一人再次调用它会发送提醒。

签名:按 URL 邀请

添加一个签名者而不发送电子邮件,并返回其个人 邀请 URL 供你传递。

签名:等待所有签名者

保存流,直到文档已签名或拒绝,或者以等待时间(默认为 29 天)过期时的状态结束 timed_out 。

签名:等待一个签名者

保留流,直到一个特定的签名者(通过电子邮件选择)签名。 任何拒绝也会结束等待。

签名:等待下一个签名者

在下一个签名者签署或拒绝时恢复流,不进行轮询。

文档:获取状态

检查文档的总体签名状态。

文档:获取签名者

列出每个签名者的状态,包括拒绝原因(如果签名者被拒绝)。

文档:下载

下载到目前为止收集的所有签名的文档。

文档:列表

列出工作区中的文档,其中包含文本搜索和分页。

文档:删除

从工作区中删除文档。

文档:作为容器上传

将多个文件合并为一个可签名的容器文档(ADoc、BDoc 或 ASiC-E)。 计费遵循 Mark Sign 默认值,其中每个签名者都付费。

为每个签名者创建个人签名链接,以便自行交付。 链接过期,可能需要身份验证,并且是唯一具有拒绝选项的签名页面。

创建一个链接,任何人都可以打开以对文档进行签名,每个链接都在其自己的已验证标识下。

在签名者链接或共享链接过期之前删除该链接。

文档:扩展签名有效性

升级长期有效性(LT)或长期存档(LTA)的文档签名。

文档:验证

检查文档的签名并返回完整的验证报告。

获取凭据

请联系 Mark Sign 客户支持 pagalba@marksign.lt 部门,请求工作区的 API 访问令牌。 在 Power Automate 中创建连接时,将令牌粘贴到“API 密钥”字段中。

令牌绑定到一个工作区,因此通过连接创建或列出的每个文档都属于该工作区。

入门

最简单的签名流:

  1. 文档:上传(例如,来自SharePoint或OneDrive的文件内容和名称令牌)。
  2. 签名:通过电子邮件邀请。 标记签名电子邮件邀请。
  3. 签名:等待下一个签名者。 流会暂停在此处,直到签名发生。
  4. 文档:下载 并存储所需的位置。

对于多个签名者,请使用 签名:通过电子邮件邀请 每个人,然后一个 签名:等待所有签名者 步骤,然后再下载。 若要自行传递链接,而不是标记签名电子邮件,请使用签名:通过 URL 或签名邀请:创建签名者链接并向其发送其链接与你自己的Outlook或 Teams 操作。

已知问题和限制

  • 连接器不提供流触发器;请改用流中的等待操作。
  • 文档有一个通知注册。 不要运行两个签名:请同时等待同一文档上的 下一个签名者 步骤。 第二步替换第一步,然后等待,直到超时。在任何块上填写 回调 URL 字段也会替换注册。
  • 签名者只能在签名上拒绝文档 :创建签名者链接 页(打开 “显示拒绝”按钮 ):电子邮件邀请、邀请 URL 和共享链接不提供拒绝选项。
  • 标记标记仅通知有关签名的信息。 当邀请块使用目的review或confirmation,该人的操作永远不会唤醒签名:等待下一个签名者;请改为使用 Document:获取签名者检查其状态。
  • 文档:下载 仅返回文件内容;从 文档:列出 或上传步骤获取文件名。
  • 流运行最多可以持续 30 天(Power Automate限制),因此没有等待才能超过这一点。 签名:等待所有签名者和签名:默认情况下,等待一个签名者在 29 天后以timed_out状态结束。 对于签名:等待下一个登录者,在操作设置中设置超时(例如P29D),并添加配置为在操作超时后运行的分支。如果第一次达到 30 天的运行限制,Power Automate取消整个运行,并且没有分支处理它。
  • 文档:列表 不支持按状态进行筛选。
  • 文档:上传 接受每个调用一个文件;循环访问附件以上传多个附件。 文档:作为容器上传 适用于几个文件;在一次调用中合并许多大型文件可能会超过处理时间限制。

部署说明

运行 paconn create --api-prop apiProperties.json --api-def apiDefinition.swagger.json --script script.csx --icon icon.png 以将此连接器部署为 Power Platform 环境中的自定义连接器。 有关详细信息 ,请参阅 paconn 文档 。

支持

有关连接器或标记签名 API 的问题,请联系 pagalba@marksign.lt。

正在创建连接

连接器支持以下身份验证类型:

默认 用于创建连接的参数。 所有区域 不可共享

违约

适用:所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。

Name 类型 Description Required
API 密钥 安全字符串 工作区的标记签名 API 访问令牌。 从 Mark Sign 支持处 pagalba@marksign.lt请求一个。 是

操作

文档:上传

上传文档并准备文档进行签名。

文档:下载

下载到目前为止收集的所有签名的文档。

文档:作为容器上传

将多个文件合并为一个可签名的容器文档,例如 ADoc 或 ASiC-E。 文件在单个步骤中上传和组合。

文档:列表

首先列出工作区中的文档。

文档:删除

从工作区中删除文档。

文档:扩展签名有效性

升级长期有效性或存档的文档签名。

文档:获取状态

获取文档的签名状态。

文档:获取签名者

列出文档的签名者及其签名状态。

文档:验证

检查文档的签名并返回验证报告。 流会等待检查完成。

签名:创建共享链接

创建一个签名链接,任何人都可以打开该链接来对文档进行签名。 你自己交付它。

签名:创建签名者链接

为每个签名者创建个人签名链接。 你自行传递链接,例如通过电子邮件或 Teams 消息。

签名:删除链接

在签名者链接或共享链接过期之前删除该链接。 无法删除邀请链接。

签名:按 URL 邀请

将签名者添加到文档而不发送电子邮件,并返回其个人邀请链接供你传递。 此链接不会过期,无法删除;如果需要可撤销的链接,请使用“签名:创建签名者链接”。

签名:等待一个签名者

等待一个特定的签名者对文档进行签名,然后让流继续。 超时时以timed_out状态结束。

签名:等待下一个签名者

等待下一个签名者签署或拒绝文档,而不发送任何邀请。 在循环中使用它来等待多个签名者,而无需轮询。

签名:等待所有签名者

等待每个签名者已签名或有人拒绝文档,然后让流继续。 超时时以timed_out状态结束。

签名:通过电子邮件邀请

邀请某人对文档进行签名。 Mark Sign 通过电子邮件发送邀请。

文档:上传

上传文档并准备文档进行签名。

参数

名称 密钥 必需 类型 说明
文件名
file_name True string

文件扩展名的文件的名称,例如 contract.pdf。 它将成为文档标题。

body
body True binary
Access
access string

谁可以查看文档。 默认值为专用。

计费类型
billing_type True string

谁支付签名费用。

返回

名称 路径 类型 说明
Status
status RequestStatus

请求的状态。

文档编号
data.uuid string

文档的 ID。

文件名
data.filename string

文件的名称。

文档:下载

下载到目前为止收集的所有签名的文档。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

返回

文档文件的内容。

文件内容
file

文档:作为容器上传

将多个文件合并为一个可签名的容器文档,例如 ADoc 或 ASiC-E。 文件在单个步骤中上传和组合。

参数

名称 密钥 必需 类型 说明
文档类型
document_type True string

要创建的文档的类型。

文件名
file_name True string

文件扩展名的文件的名称,例如 contract.pdf。

文件内容
file_content True byte

文件的内容。

文件类型(仅限 ADoc)
adoc_file_type string

容器中文件的角色。 仅当文档类型为 ADoc 时使用。

返回

名称 路径 类型 说明
Status
status RequestStatus

请求的状态。

文档编号
data.uuid string

文档的 ID。

文件名
data.filename string

文档文件的名称。

文档:列表

首先列出工作区中的文档。

参数

名称 密钥 必需 类型 说明
搜寻
query string

在文档标题和文件名中查找的短语。

Offset
offset integer

要跳过的文档数。

Limit
limit integer

要返回的文档数。 默认值为 10。

返回

名称 路径 类型 说明
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

匹配文档的总数。

文档:删除

从工作区中删除文档。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

返回

文档:扩展签名有效性

升级长期有效性或存档的文档签名。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

Level
level True string

长期有效性的 LT,用于长期存档的 LTA。

返回

文档:获取状态

获取文档的签名状态。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

返回

名称 路径 类型 说明
Status
status RequestStatus

请求的状态。

文档状态
data.document_status string

签名状态:已保存(正在等待签名)、signed_partially(有些已签名)或已签名(每个人都已签名)。

文档:获取签名者

列出文档的签名者及其签名状态。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

返回

名称 路径 类型 说明
Status
status RequestStatus

请求的状态。

签名者:
data array of object

文档的签名者。

签名者 ID
data.id string

签名者的 ID。

名字
data.name string

签名者的名字。

姓氏
data.surname string

签名者的姓氏。

Email
data.email string

签名者的电子邮件地址。

签名状态
data.status string

签名者是否已签名:挂起、签名、拒绝、审阅、确认、拒绝或审阅。

拒绝原因
data.rejection_reason string

签名者拒绝文档时给出的原因。

文档:验证

检查文档的签名并返回验证报告。 流会等待检查完成。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

返回

名称 路径 类型 说明
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

每个签名的结果。

签名 ID
data.signatures.id string

签名的 ID。

签名时间
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

执行验证时。

签名:创建共享链接

创建一个签名链接,任何人都可以打开该链接来对文档进行签名。 你自己交付它。

参数

名称 密钥 必需 类型 说明
文档 ID
documents True array of string

链接签名的文档。 使用上传或列表步骤中的文档 ID 值。

回调 URL
callback_url string

一个 URL,用于在文档签名时通知。

过期时间(分钟)
expire_after integer

链接过期前的分钟数。 默认值为 2880(两天)。

删除文档(分钟)
delete_document_after integer

从工作区中删除文档之前的分钟数。 默认情况下,它保留。

返回

名称 路径 类型 说明
Status
status RequestStatus

请求的状态。

签名链接
data.signing_link string

任何人都可以打开该链接进行签名。

签名链接 ID
data.signing_link_id string

链接的 ID,用于“签名:删除链接”。

有效期至
data.valid_until integer

链接过期时,作为 Unix 时间戳。

签名:创建签名者链接

为每个签名者创建个人签名链接。 你自行传递链接,例如通过电子邮件或 Teams 消息。

参数

名称 密钥 必需 类型 说明
文档 ID
documents True array of string

要为其创建签名链接的文档。 使用上传或列表步骤中的文档 ID 值。

签名者 ID
id string

签名者自己的 ID,在请求中是唯一的。 当电子邮件为空时是必需的。

名字
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

一个 URL,用于在文档签名时通知。

拒绝回调 URL
reject_callback_url string

一个 URL,用于在签名者拒绝文档时通知。

过期时间(分钟)
expire_after integer

链接过期前的分钟数。 默认值为 2880(两天)。

显示拒绝按钮
show_reject_button boolean

签名者是否可以拒绝签名页上的文档。 默认值为“是”。

删除文档(分钟)
delete_document_after integer

从工作区中删除文档之前的分钟数。 默认情况下,它保留。

返回

名称 路径 类型 说明
Status
status RequestStatus

请求的状态。

签名链接:
temporary_signing_links array of object

每个签名者一个签名链接。

签名者 ID
temporary_signing_links.id string

签名者自己的 ID。

名字
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

文档文件的名称。

签名:删除链接

在签名者链接或共享链接过期之前删除该链接。 无法删除邀请链接。

参数

名称 密钥 必需 类型 说明
签名链接 ID
temporarySigningLinkId True string

“签名: 创建签名者链接”或“签名: 创建共享链接”输出中的签名链接 ID。

返回

签名:按 URL 邀请

将签名者添加到文档而不发送电子邮件,并返回其个人邀请链接供你传递。 此链接不会过期,无法删除;如果需要可撤销的链接,请使用“签名:创建签名者链接”。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

名字
name True string

签名者的名字。

姓氏
surname True string

签名者的姓氏。

Email
email True email

签名者的电子邮件地址。

成功 URL
success_url string

完成签名后发送签名者的位置。

Purpose
purpose string

为何邀请此人。 选择评审以仅邀请查看。

回调 URL
callback_url string

一个 URL,用于在文档签名时通知。

返回

名称 路径 类型 说明
Status
status RequestStatus

请求的状态。

邀请 URL
data.invitation_url string

要传递到签名者的个人签名页链接。

签名:等待一个签名者

等待一个特定的签名者对文档进行签名,然后让流继续。 超时时以timed_out状态结束。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

签名者电子邮件
signer_email True string

要等待的签名者的电子邮件,邀请他们时使用的相同电子邮件。

超时(分钟)
timeout_minutes integer

等待的时间(以分钟为单位)以分钟为单位,然后以timed_out状态结束。 默认值为 41760 (29 天),最大值为 43200 (30 天)。

返回

签名:等待下一个签名者

等待下一个签名者签署或拒绝文档,而不发送任何邀请。 在循环中使用它来等待多个签名者,而无需轮询。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

返回

签名:等待所有签名者

等待每个签名者已签名或有人拒绝文档,然后让流继续。 超时时以timed_out状态结束。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

超时(分钟)
timeout_minutes integer

等待的时间(以分钟为单位)以分钟为单位,然后以timed_out状态结束。 默认值为 41760 (29 天),最大值为 43200 (30 天)。

返回

签名:通过电子邮件邀请

邀请某人对文档进行签名。 Mark Sign 通过电子邮件发送邀请。

参数

名称 密钥 必需 类型 说明
文档编号
documentId True string

文档的 ID,来自“Document: Upload”、“Document: Upload as container”或“Document: List”的输出。

名字
name True string

签名者的名字。

姓氏
surname True string

签名者的姓氏。

Email
email True email

签名者的电子邮件地址。

语言
language string

邀请的语言。 默认值为立陶宛语。

成功 URL
success_url string

完成签名后发送签名者的位置。

Purpose
purpose string

为何邀请此人。 选择评审以仅邀请查看。

回调 URL
callback_url string

一个 URL,用于在文档签名时通知。

返回

定义

SigningEvent

名称 路径 类型 说明
文档编号
uuid string

文档的 ID。

文档状态
status string

文档的签名状态,如已签名或signed_partially。 拒绝显示在签名者状态中。

签名者计数
members_count integer

有多少人被邀请签名。

已签名计数
signed_members_count integer

有多少人签了字。

签名者:
members array of object

受邀签署的每个人。

签名者 ID
members.id string

签名者的 ID。

名字
members.member_name string

签名者的名字。

姓氏
members.member_surname string

签名者的姓氏。

Email
members.member_email string

签名者的电子邮件地址。

签名状态
members.status string

签名者状态,如挂起、已签名或拒绝。

AcknowledgedResponse

名称 路径 类型 说明
Status
status RequestStatus

请求的状态。

SigningWaitResponse

名称 路径 类型 说明
文档状态
document_status string

等待的结束方式:已签名、拒绝或timed_out。

拒绝者
rejected_by string

谁拒绝了该文档,如果它被拒绝了。

拒绝原因
rejection_reason string

签名者给出的原因(如果文档被拒绝)。

请求状态

请求的状态。

请求的状态。

Status
string

文件

这是基本数据类型“file”。