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 的响应是：

The operation failed with an error. [400] A Required field is incomplete. TabId: GUI_HERE

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

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

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

Answer 1

更新： 对于 pre-fill 选项卡，您需要同时拥有 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，以便每个签名者都能看到它们。然后在 Envelopes:create 通话中填写它们的值。

这是 live example 的做法。请注意已锁定的 text2 选项卡。（它应该将 shared 属性设置为 true。您可以从左侧的 Tabs/text 工具箱添加它。）

另请参阅有关模板的blog post。

Answer 3

Integromat 甚至不使用 DocuSign Rest API 也能做到。您可以使用 Powerforms，它将节省您的 Rest API 成本。

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

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

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

JSON 请求包含单个文档、两个签名者、预填字段的信封

JSON request for envelope with single document, two signers, pre-fill fields

docusignapi