DocuSign API:使用复合模板时,SignHere 和 InitialHere 选项卡在信封中多次插入

DocuSign API: SignHere and InitialHere tabs getting inserted multiple times in envelope when using composite templates

我最近更改了我的 DocuSign 信封发送实现,开始使用复合模板而不是直接文档,并注意到文档中的所有锚点都插入了多个签名选项卡,因此导致每个锚点都必须签名 N(复合数量信封中的模板)由客户提供的次数。例如,在文档中,您可以看到它要求出现两个首字母,而不是像使用复合材料之前那样只出现一个:

我已确认我发送的文档没有重复的锚文本,因此我发送的请求(从 C# DocuSign 库创建)似乎有问题或配置有问题我们的 DocuSign 帐户。这是上述示例的 JSON 请求:

{
  "compositeTemplates": [
    {
      "document": {
        "documentBase64": "[redacted]",
        "documentId": "1",
        "fileExtension": "pdf",
        "name": "Job Directions",
        "transformPdfFields": "False"
      },
      "inlineTemplates": [
        {
          "recipients": {
            "signers": [
              {
                "email": "customer@mail.com",
                "emailNotification": {
                  "emailBody": "[redacted]",
                  "emailSubject": "Map and Directions"
                },
                "name": "Abraham Lincoln",
                "recipientId": "1",
                "routingOrder": "1",
                "tabs": {
                  "dateSignedTabs": [
                    {
                      "anchorString": "#signerdate1#"
                    }
                  ],
                  "initialHereTabs": [
                    {
                      "anchorString": "#initial1#"
                    }
                  ],
                  "listTabs": [
                    {
                      "anchorString": "#paymentmethod#",
                      "listItems": [
                        {
                          "text": "Cash"
                        },
                        {
                          "text": "Check"
                        },
                        {
                          "text": "Wire"
                        }
                      ],
                      "required": "true",
                      "tabLabel": "Payment Method",
                      "width": "200"
                    }
                  ],
                  "signHereTabs": [
                    {
                      "anchorString": "#signer1#"
                    }
                  ]
                }
              }
            ]
          },
          "sequence": "1"
        }
      ]
    },
    {
      "document": {
        "documentBase64": "[redacted]",
        "documentId": "2",
        "fileExtension": "pdf",
        "name": "Job Map",
        "transformPdfFields": "False"
      },
      "inlineTemplates": [
        {
          "recipients": {
            "signers": [
              {
                "email": "customer@mail.com",
                "emailNotification": {
                  "emailBody": "[redacted]",
                  "emailSubject": "Map and Directions"
                },
                "name": "Abraham Lincoln",
                "recipientId": "1",
                "routingOrder": "1",
                "tabs": {
                  "dateSignedTabs": [
                    {
                      "anchorString": "#signerdate1#"
                    }
                  ],
                  "initialHereTabs": [
                    {
                      "anchorString": "#initial1#"
                    }
                  ],
                  "listTabs": [
                    {
                      "anchorString": "#paymentmethod#",
                      "listItems": [
                        {
                          "text": "Cash"
                        },
                        {
                          "text": "Check"
                        },
                        {
                          "text": "Wire"
                        }
                      ],
                      "required": "true",
                      "tabLabel": "Payment Method",
                      "width": "200"
                    }
                  ],
                  "signHereTabs": [
                    {
                      "anchorString": "#signer1#"
                    }
                  ]
                }
              }
            ]
          },
          "sequence": "1"
        }
      ]
    }
  ],
  "emailSubject": "Map and Directions",
  "enforceSignerVisibility": "true",
  "status": "sent"
}

我们已经与 DocuSign 的支持人员联系了好几天,但他们甚至不知道发生了什么。他们尝试将我们的锚定人口范围设置为“文档”,但当他们这样做时,我们开始在 DocuSign 响应中收到此错误“ONESIGNALLSIGN_NOT_SATISFIED”。

对于可能发生的事情,我们将不胜感激。谢谢!

如果您的锚字符串范围设置为信封(相对于文档),则 DocuSign 将扫描信封中的所有文档(无论它们如何进入信封)以查找这些字符串。

您明确地为两个内联模板指定了两次相同的锚字符串,期望它仅适用于该模板中的文档,但事实并非如此。它适用于整个信封。

为了保持灵活性,您可以将锚字符串从一个模板更改为另一个模板,但如果您需要它们相同 - 仅在两个模板之一中指定它们。