You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

调用API发送含条件标签的DocuSign模板时出现CONDITIONALTAB_HAS_INVALID_PARENT错误

DocuSign API条件标签报错:CONDITIONALTAB_HAS_INVALID_PARENT 问题排查

通过UI/Web门户发送带条件标签的DocuSign模板正常,但调用API时收到错误响应:

CONDITIONALTAB_HAS_INVALID_PARENT - 条件标签引用了无效的父标签。父标签的标签名必须与另一个标签匹配。仅允许一个父标签。签名字段不能作为父标签。标签名为sig-spanish的子标签存在无效父标签。

我们已将模板简化:用一个包含2个单选按钮的单选组作为父标签,搭配两个对应单选选项的条件签名字段。

调用createEnvelope()方法时的字段格式如下:

[
  {
    "roleName": "primary",
    "tabs": {
      "radioGroupTabs": [
        {
          "documentId": "1",
          "groupName": "radio-group1",
          "originalValue": "Spanish",
          "radios": [
            {
              "bold": "false",
              "font": "calibri",
              "fontColor": "black",
              "fontSize": "size10",
              "italic": "false",
              "locked": "false",
              "pageNumber": "1",
              "required": "true",
              "selected": "true",
              "tabId": "d032aff1-ecbd-4d51-bce2-c0fd4225ecbf",
              "underline": "false",
              "value": "Spanish",
              "xPosition": "171",
              "yPosition": "247"
            },
            {
              "bold": "false",
              "font": "calibri",
              "fontColor": "black",
              "fontSize": "size10",
              "italic": "false",
              "locked": "false",
              "pageNumber": "1",
              "required": "true",
              "selected": "false",
              "tabId": "a45319cb-d98c-42d2-942f-3a77202ee7e1",
              "underline": "false",
              "value": "English",
              "xPosition": "170",
              "yPosition": "326"
            }
          ],
          "recipientId": "72120635",
          "requireAll": "false",
          "requireInitialOnSharedChange": "false",
          "shared": "false",
          "tabType": "radiogroup",
          "templateLocked": "false",
          "templateRequired": "false",
          "value": "Spanish"
        }
      ],
      "signHereTabs": [
        ...
        {
          "conditionalParentLabel": "radio-group1",
          "conditionalParentValue": "Spanish",
          "documentId": "1",
          "name": "SignHere",
          "optional": "false",
          "pageNumber": "1",
          "recipientId": "72120635",
          "scaleValue": "1",
          "stampType": "signature",
          "tabId": "65bef1a3-4cd3-4ff7-8d2b-80a57fc1fbd3",
          "tabLabel": "sig-spanish",
          "tabType": "signhere",
          "templateLocked": "false",
          "templateRequired": "false",
          "tooltip": "SignHere",
          "xPosition": "254",
          "yPosition": "242"
        },
        {
          "conditionalParentLabel": "radio-group1",
          "conditionalParentValue": "English",
          "documentId": "1",
          "name": "SignHere",
          "optional": "false",
          "pageNumber": "1",
          "recipientId": "72120635",
          "scaleValue": "1",
          "stampType": "signature",
          "tabId": "e027af5d-32e5-4b15-9b8d-8d721f0de470",
          "tabLabel": "sig-english",
          "tabType": "signhere",
          "templateLocked": "false",
          "templateRequired": "false",
          "xPosition": "253",
          "yPosition": "316"
        }
      ],
      "textTabs": [
        ...
      ]
    },
    "email": "test@example.com",
    "name": "Test",
    "clientUserId": "test@example.com-primary",
    "embeddedRecipientStartURL": "SIGN_AT_DOCUSIGN"
  }
]

根据官方文档,当前设置符合要求,但文档还有以下说明:

UI与API支持的条件父标签类型不同:

  • UI中仅允许以下类型作为触发条件字段的父标签:复选框、单选按钮、下拉框、文本框
  • API中,若将optional属性设为true,可使用任意字段类型作为父标签

若父标签是复选框或单选组中的按钮,需使用on作为值表示父标签处于激活状态

针对该问题已尝试以下方法,但均未解决:

  • 给父标签设置optional: 'true'
  • 给子字段设置optional: 'true'
  • 将单选组改为复选框
  • 仅保留一个条件子标签和一个父标签
  • 组合使用上述方法

内容的提问来源于stack exchange,提问作者Nick

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.18 18:40:53