DocuSign REST API - node.js 签名者不尊重 agentCanEditEmail 和 agentCanEditName 属性

Question

我编写了一个 node.js 应用程序来与 DocuSign API 交互。目标是让代理在将文件发送给客户签名（签名者）之前接收要批准的文件（包括编辑签名者姓名/电子邮件）。

预期行为：

• 我们希望能够传递签名者的电子邮件和姓名，然后允许代理在批准之前编辑这些字段。这就是在其网站上设置模板时 DocuSign 的行为方式（无 API）。

实际行为：

• 如果所有签名者都预先填写了电子邮件和姓名，则代理会在单击 DocuSign 链接时自动批准，并且信封会自动发送给签名者
• 如果签名者缺少姓名和/或电子邮件，则代理必须在批准之前填写缺失的字段。

根据agent documentation，我们应该可以在Signer模型上设置agentCanEditEmail和agentCanEditName。通过实验，这两个领域似乎对结果没有影响。我尝试将它们设置为等于布尔真（更合乎逻辑）以及字符串“真”（文档提示的内容）。我也尝试过使用 designatorId 和其他一些似乎无济于事的字段。

任何帮助将不胜感激:)

其他一切都按预期工作......相关代码

let agent1 = docusign.Agent.constructFromObject({
    email: args.agentEmail,
    name: args.agentName,
    recipientId: '1',
    routingOrder: '1'
});
let signer1 = docusign.Signer.constructFromObject({
    email: args.signerEmail,
    name: args.signerName,
    recipientId: '10',
    routingOrder: '10',
    agentCanEditEmail: 'true',
    agentCanEditName: 'true',
    roleName: 'Signer'
});
env.recipients = docusign.Recipients.constructFromObject({
    agents: [agent1],
    signers: [signer1]
});

Answer 1

因此，有两种类型的收件人可以更新其他收件人：

Agent 和 Intermediary

不同之处在于一种用于已经存在某些东西并且他们可能会或可能不会更改它的情况。另一个用于指定它们并且是工作流的一部分。他们必须指定它们，否则这个信封将永远不会继续路由。

当您使用网络应用程序并且它运行良好时，最后一个收件人（您的“签名者”“10”）是您指定了他们的电子邮件和姓名，还是只是将其保留为开放角色？

我怀疑你是前者，所以你不能使用代理。您需要使用中介。如果您在这种情况下使用代理，Web 应用程序实际上会给您一个错误，但可能 API 没有强制执行它（不确定）。

底线 - 改为中介，我认为这会解决您的问题。