Adobe Sign 发行说明:2021

Adobe Sign:2021 年 10 月

改进的功能

  • 举报滥用链接 - 现在,小型企业帐户和个人帐户包含一个链接,收件人可通过此链接访问一种方法,以报告有关入站协议请求的潜在滥用活动。
电子邮件中的“举报滥用”链接

  • 与 Notarize 集成 - Adobe Sign 与 Notarize, Inc. 的远程在线公证 (RON) 平台的集成,使得客户得以在 Adobe Sign 交易中添加远程在线公证服务。对于直接由 Adobe 通过 ETLA 计划销售产品的企业级和商务级美国客户而言,可启用这项服务。这些客户只能将 Notarize 交易作为加载项,通过额外支付费用来购买。
    • 发送页面更新 - 启用公证的客户可以在收件人记录上选择要求公证选项,此选项就位于身份验证方法的右侧:
注意:

在应用程序或集成中使用嵌入的发送页面的客户也可以访问公证功能。

“发送”页面上的 Notarize 界面

在配置协议并且发送者单击“下一步”后,发送者将收到公证流程的其他配置选项:

配置 Notarize 选项

  • API 更新 - 对 API 进行了重要更新,以支持 Notarize 集成:

POST /agreements

POST /agreements API 已更新为支持发送公证协议。

  • 新角色 NOTARY_SIGNER 应该用于指示公证会话参与者。
  • 新的 NotaryInfo 属性已添加到 AgreementInfo 定义,以包含与创建需要公证的新协议相关的所有选项。

参数名称

REST 对象

说明

memberInfos

ParticipantInfo[]

ParticipantInfo 对象的数组,包含特定于参与者的数据(如电子邮件)。数组中的所有参与者都属于相同集。

role

说明

SIGNER

签署协议

APPROVER

批准协议

DELEGATE_TO_SIGNER

自己无法签名,但将协议委派给其他签名者的人员

DELEGATE_TO_APPROVER

自己无法审批,但将协议委派给其他审批人的人员

SHARE

与之共享此协议的参与者

DELEGATE

将协议委派给的参与者。在通过对协议资源的 POST/PUT 调用创建或更新协议时,不能使用此角色。委派按参与者单独进行。

NOTARY_SIGNER

公证会话参与者

该集内所有参与者(签名者、审批人等)承担的角色

 

FileInfo 扩展

需要扩展 FileInfo 定义,以指明哪些文档应经过公证。

FileInfo

参数名称

键入

默认设置

必需

说明

document

文档

可选

与协议关联的文档。
无法在 POST 调用中提供此字段。
对于 GET 调用,这是响应中返回的唯一字段

label  

字符串

可选

文件信息元素的唯一标签值。对于自定义工作流,这会将文件映射到工作流定义中的相应文件元素。

libraryDocumentId

字符串

可选

将添加到协议中的现有库文档的 ID

transientDocumentId

字符串

可选

将添加到协议的临时文档的 ID

notarize

true

false

可选

表示此文档需要经过公证。

 

ParticipantInfo 扩展

ParticipantInfo 定义已扩展为允许指定公证人身份验证方法。

ParticipantInfo

参数名称

键入

默认设置

必需

说明

email

字符串

不适用

必需

参与者的电子邮件。

notaryAuthentication

枚举

MULTI_FACTOR_AUTHENTICATION

可选

MULTI_FACTOR_AUTHENTICATION - 公证人身份验证使用双重身份验证方法执行
NONE - 无需身份验证。

 

NotaryInfo

新的可选 notaryInfo 字段已添加到 AgreementInfo 定义,以包含 NotaryInfo 对象,它指定与公证关联的其他选项。

NotaryInfo

参数名称

键入

默认设置

必需

说明

notaryType

枚举

如果帐户上仅启用了 Notarize 按需公证服务
则 notaryType 将默认为 NOTARIZE_NOTARY,否则将默认为 BYON_NOTARY

必需

NOTARIZE_NOTARY - Notarize 服务提供公证人
BYON_NOTARY - 帐户提供公证人

payment

枚举

BY_SENDER

可选

仅当类型 == NOTARIZE_NOTARY 时才适用
BY_SENDER - 发件人支付公证费
BY_SIGNER - 签名者支付公证费

appointmentStart

字符串

""

可选

ISO_DATE_TIME 格式的字符串 请参阅 ISO_ZONED_DATE_TIME

note

字符串

可选

公证会的说明。

notaryEmail

字符串

""

可选

自带公证的电子邮件

 

示例 /agreement

{
    "fileInfos": [
        {
            "transientDocumentId": "",
            "notarize": true
        }
    ],
    "name": "notary_agreement_name",
    "participantSetsInfo": [
        {
            "memberInfos": [
                {
                    "email": "someone@somewhere.com",
                    "securityOption": {
                        "notaryAuthentication": "MULTI_FACTOR_AUTHENTICATION"
                    }
                }
            ],
            "order": 1,
            "role": "NOTARY_SIGNER",
            "name": "participant_set_name"
        }
    ],
    "signatureType": "ESIGN",
    "state": "IN_PROCESS",
    "notaryInfo": {
        "appointment": "2021-10-29'T'13:00",
        "notaryEmail": "notaries@email.com",
        "notaryType": "PROVIDER_NOTARY",
        "note": "This is a note for the notary.",
        "payment": "BY_SIGNER"
    }
}

 

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_NOTARIZATION”。

 

POST /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/signingTokens

客户(公证签名者)可以使用该 API 来获取签名令牌,以便可以完成流程的电子签名阶段。 

  • 添加了新签名功能以捕获新角色 - ACCEPT_BEFORE_NOTARIZATION。 
  • 应获取签名令牌来完成公证阶段。
{
  "securityInfo": {
  "authenticationMethod": "NONE"
},
  "signingCapabilities": [
    "ACCEPT_BEFORE_NOTARIZATION"
  ]
}

 

PUT /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/status

客户(公证签名者)可以使用该 API 完成流程的电子签名阶段。为了照顾到新角色,引入了新枚举状态值 - ACCEPTED_BEFORE_NOTARIZATION。

属性

类型

说明

Status

Enum<String>

Value

SIGNED

APPROVED

ACCEPTED

DELIVERED

FORM_FILLED

ACCEPTED_BEFORE_NOTARIZATION

                                         

此状态指示角色为 SIGNER 的接收者已完成协议。

此状态指示角色为 APPROVER 的接收者已完成协议。

此状态表示角色为 ACCEPTOR 的接收者已完成协议。

此状态指示角色为 CERTIFIED_RECIPIENT 的接收者已完成协议。

此状态指示角色为 FORM_FILLER 的接收者已完成协议。

此状态指示角色为 NOTARY_SIGNER 的接收者已完成协议而未进行公证

公证签名者可以按照以下 API 调用序列完成电子签名阶段:

  1. GET /agreements/{agreementId}/members - 获取公证签名者的参与者 ID 和参与者集 ID
  2. POST /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/signingTokens - 为具有 ACCEPT_BEFORE_NOTARIZATION 功能的公证签名者请求签名令牌
  3. POST /transientDocuments - 上传已审阅的文档
  4. PUT /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/status - 提交已审阅的文档并完成电子签名阶段。

新的 Webhook 事件

客户可以订阅新的 WebHook 事件 AGREEMENT_READY_FOR_NOTARIZATION,在协议准备好进行公证时获得通知。该事件在 webhooks 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”元素分别为“Document sent for notarization”(文档已发送进行公证)和“Notarized document received”(已收到公证的文档)

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 修复了在管理页面上打开 Web 表单时会触发错误“文档尚不可用或将没有可查看的页面”的问题。
4323554 修复了更新管理员权限的事件时间/日期戳可能生成两条具有相同时间值的记录的问题。
4323609 修复了在管理页面中上传已签名协议时不会触发 AGREEMENT_WORKFLOW_COMPLETED Webhook 的问题。
4325142 修复了取消协议后自定义电子邮件模板不会反映参与者的正确姓名值的问题。
4326747 修复了可能导致“批量发送”页面无法完成加载过程,且忽略“上载”和“发送”操作的问题。
4326855 修复了可能阻止收件人拒绝批准协议的问题。
4327000 更正了可能导致 Smart-Id 凭据失败,并显示未找到算法的错误的问题。
注意:

本文档将重点介绍当前发布版本中的新增功能、体验变化和已解决的问题。

并非所有功能/变更都一定会在发布之日启用。

如果您希望通过电子邮件接收发行说明通知,请在此处订阅 >

Adobe 徽标

登录到您的帐户