将复合模板发送到Docusign时出错

Question

我正在尝试使用DocuS传节点-客户端使用createEnvelope类发送信封。该类向/envelopes端点发送REST请求。我试图发送的信封包含一个复合模板。

这是我正试图寄给DocuS传的身体

{
  "emailSubject": "Sent from Node SDK",
  "emailBlurb": "Email body here",
  "customFields": {
    "textCustomFields": [
      {
        "name": "DSFSSourceObjectId",
        "required": false,
        "show": false,
        "value": "dealIdHere"
      }
    ]
  },
  "compositeTemplates": [
    {
      "inlineTemplates": [
        {
          "sequence": "1",
          "documents": [
            {
              "documentBase64": "base64StringHere",
              "documentId": "1",
              "fileExtension": ".pdf",
              "name": "filename.pdf"
            }
          ],
          "envelope": {
            "emailBlurb": "Email body here",
            "emailSubject": "Sent from Node SDK",
            "customFields": {
              "textCustomFields": [
                {
                  "name": "DSFSSourceObjectId",
                  "required": false,
                  "show": false,
                  "value": "dealIdHere"
                }
              ]
            },
            "recipients": {
              "signers": [
                {
                  "email": "myEmail@domain.com",
                  "name": "My Name",
                  "recipientId": "1"
                }
              ]
            }
          }
        }
      ],
      "serverTemplates": [
        {
          "sequence": "1"
        }
      ]
    }
  ],
  "status": "sent"
}

当我发送这个主体时，我得到以下错误：“包含至少一个无效参数的请求。复合模板序列中为\'templateId\‘指定的无效值: 1"

如果删除serverTemplates数组，则会得到以下错误：：“信封不完整。完整的信封需要文档、收件人、标签和主题行”。

如果我在templateId对象中包含一个有效的serverTemplate，它将成功地创建一个信封。

我正在转换为Node的as is应用程序使用Docusign，并且能够发送带有1到多个文档的复合模板。每个文档都可以关联到它们自己的文档模板，或者没有DocuS传模板。

如果没有对模板id的某种引用，DocuS传是否不接受复合模板？

Answer 1

您指定的inlineTemplate.envelope属性不正确。可以直接在inlineTemplate中定义收件人和自定义字段。您不必在inlineTemplate中指定emailSubject/emailBlurb。

还请注意，在使用复合模板时，在根级别指定的自定义字段将被忽略。参见此answer

下面的json应该为你工作。

{
    "emailSubject": "Sent from Node SDK",
    "emailBlurb": "Email body here",
    "status": "sent"
    "compositeTemplates": [
        {
            "inlineTemplates": [
                {
                    "sequence": "1",
                    "documents": [
                        {
                            "documentBase64": "base64StringHere",
                            "documentId": "1",
                            "fileExtension": ".pdf",
                            "name": "filename.pdf"
                        }
                    ],

                    "customFields": {
                        "textCustomFields": [
                            {
                                "name": "DSFSSourceObjectId",
                                "required": false,
                                "show": false,
                                "value": "dealIdHere"
                            }
                        ]
                    },
                    "recipients": {
                        "signers": [
                            {
                                "email": "myEmail@domain.com",
                                "name": "My Name",
                                "recipientId": "1"
                            }
                        ]
                    }

                }
            ]
        }
    ]
}