带有单个文档、两个签名者、预填充字段的信封的 JSON 请求

Question

我有一个信封，其中包含一个文档和两个签名者，保存为服务器端模板。签署者按特定顺序执行协议。该文档中有许多预填充字段。

我正在尝试使用 Integromat 自动发送此协议。不幸的是，Integromat 的模块不允许在模板中预填充字段，因此我必须手动创建 API 请求。这就是我陷入困境的地方。

我最接近的是下面的 JSON 请求，已发布到： .../v2.1/accounts/{accountId}/envelopes，自动填充大写值：

{
  "templateId": "TEMPLATE_ID",
  "templateRoles": [
    {
      "email": "CLIENT_EMAIL",
      "name": "CLIENT_NAME",
      "roleName": "Recipient",
      "tabs": {
        "prefillTabs": {
          "textTabs": [{
            "tabLabel": "Prefill: Purpose",
            "value": "PURPOSE_FIELD_DATA"
          }]
        }
      }
    }, {
      "email": "STAFF_EMAIL",
      "name": "STAFF_NAME",
      "roleName": "Company"
    }
  ],
  "status": "sent"
}

API 的响应是：

操作因错误而失败。 [400]必填字段是 不完整。标签ID：GUI_HERE

我不知道如何获取提交的预填充数据，因为它与特定签名者无关。我已经查阅了 v2.1 API 文档，但没有足够简单的场景来满足此请求。

如果我在这里遗漏了一些明显的东西，我深表歉意；这是我第一次使用 DocuSign 的 API 进行竞技表演。

您知道我做错了什么，或者更好的是，对于这个（大概）简单的场景，请求的正文应该是什么？

Answer 1

更新： 对于预填充选项卡，您需要同时拥有

tabId

和

tabLabel

，而像常规选项卡那样仅拥有

tabLabel

是不够的。

我的猜测是模板上选项卡的

tabId

字段与 API 请求中的内容不匹配： 您的请求中有此值：

Prefill: Purpose

与模板设置的方式相符吗？

Answer 2

我刚刚尝试使用复合模板。 当我向收件人添加预填充选项卡时，我收到错误

Error code: INVALID_TAB_OPERATION.

Message: The Tab specified is not valid for the requested operation. 
PrefillTab not allowed for recipient.

这是有道理的，因为预填充选项卡与文档相关联，而不是与收件人相关联。

我尝试将文档添加到复合模板中，但这也不起作用。

我建议您使用常规选项卡。将它们标记为

locked

，这样它们就无法更改。标记它们

shared

，以便每个签名者都能看到它们。然后填写它们的值作为信封的一部分：创建调用。

这是执行此操作的“生动示例”。请注意 text2 选项卡已锁定。 （它应该将

shared

属性设置为 true。您可以从左侧的选项卡/文本工具箱添加该属性。）另请参阅有关模板的

博客文章

。

Answer 3

我最近这样做了，但问题是第一个收件人，您需要使用 powerform 链接手动发送电子邮件。

在这里，我动态构建 PowerForm URL，在其中传递值以预填充模板字段。

要从 integromat 发送电子邮件，您可以配置 Gmail 模块或任何其他电子邮件模块并创建 html 模板，您可以在锚标记中附加 Powerform URL

Answer 4