Docusignapi Docusign不允许我将收件人添加到模板

我在UI上创建了一个模板并上传了一个文档。然后，我从UI添加了一个收件人，并映射了文档中的几个字段

我想基于此模板创建一个信封，并在发送签名之前填充一些字段。我们的想法是，我们有一个门户，用户可以在其中填写表单，并将文档发送给他进行签名

看着这张照片。我应该这样发送和填充它：

{
    ...
    "templateId": "68a89cdc-xxxx-xxxx-xxxx-fa2ab60713e3",
    "recipients": {
        "signers": [
            {
                ...
                "name": "Example Name",
                "email": "examplename@example.com", 
                "roleName": "Signer One",
            }
        ]
    ...
    },

...
}

但是，这给了我一个错误：

Status: 400  INVALID_REQUEST_PARAMETER: The request contained at least one invalid parameter. 'recipients' may not be specifed when 'templateId' is set. Use 'templateRoles'.

我继续按照建议使用

templateRoles

：

{
    "accountId": "301424",
    "emailSubject": "API Example - Populating Data in Templates",
    "templateId": "44D9E888-xxxx-xxxx-xxxx-7071BC87A0DA",
    "templateRoles": [{
        "email": "john.doe@email.com",
        "name": "John Doe",
        "roleName": "Customer",
        "tabs": {
            "textTabs": [{
                "tabLabel": "CustomerAddress",
                "value": "123 Main St. San Francisco, CA 94105"
            }, 
            {
                "tabLabel": "CustomerSSN",
                "value": "12-345-6789"
            }]
        }
    }],
    "status": "sent"
}

但这并没有用我提供的数据填充任何字段

---

我在这里遗漏了什么？

我觉得你的JSON很不错

您不需要

accountId

或

emailSubject

属性，我建议您不要使用它们

仔细检查

tabLabel

值是否与UI的数据标签设置一致

作为测试，您还可以使用API下载模板。看

---

下面是一个设置模板选项卡值的示例

我最近遇到了这个问题，并联系了他们的支持团队。使用

templateId

和

Recipients

的文档基本上是错误的。它总是会失败。我想他们很快就会改变的

{
    "accountId": "301424",
    "emailSubject": "API Example - Populating Data in Templates",
    "templateId": "44D9E888-xxxx-xxxx-xxxx-7071BC87A0DA",
    "templateRoles": [{
        "email": "john.doe@email.com",
        "name": "John Doe",
        "roleName": "Customer",
        "tabs": {
            "textTabs": [{
                "tabLabel": "CustomerAddress",
                "value": "123 Main St. San Francisco, CA 94105"
            }, 
            {
                "tabLabel": "CustomerSSN",
                "value": "12-345-6789"
            }]
        }
    }],
    "status": "sent"
}

我在UI上创建了一个模板并上传了一个文档。然后我添加了一个 从UI中选择收件人，并映射文档中的几个字段

显然，您可以提供一个空的收件人姓名和电子邮件，尽管UI在输入字段上显示了一个红色星号，似乎暗示这是必需的

您只需要定义角色字段，就可以开始了。因此，在本例中，在模板中（从UI）：

---

你应该可以走了

我想我可以不使用

accountId

，但我确实需要

emailSubject

，因为我希望能够动态编辑它。顺便说一句，这些不是我的实际值，它们实际上是文档上的内容，但我使用相同的结构。