在DocuSign中创建Room时修改State值触发错误的问题

数据老陈

2026-7-6

解决DocuSign Room创建仅支持US-HI州的问题

问题描述

以下JSON请求创建DocuSign Room时，仅当state字段值为"US-HI"时能成功执行，修改为其他州值就会报错：

{
  "name": "Testing000000001",
  "roleId": "2007958",
  "transactionSideId": "listbuy",
  "fieldData": {
    "data" : {
     "address1": "123 EZ Street",
     "address2": "unit 10",
     "city": "Galaxian",
     "state": "US-HI",
     "postalCode": "11112",
     "companyRoomStatus": "5",
     "comments": " laborum.",
     "hubspotId":"121212"
      }
   }
}

排查方向

州代码格式校验：DocuSign对美国州的标识通常要求使用国家代码-两位大写州缩写的格式（比如US-CA、US-NY），检查你替换的州值是否符合该规范，避免使用全名、小写或错误代码。
地址字段关联性验证：DocuSign会校验地址各字段的匹配性，你当前填写的city（Galaxian）和postalCode（11112）可能仅属于夏威夷州，换成其他州后，城市或邮编与该州不匹配触发验证错误，建议更换对应州的真实城市和邮编测试。
角色权限限制：当前使用的roleId对应的账号角色，可能被配置为仅允许创建夏威夷地区的Room，或者transactionSideId的交易类型与地区绑定，换州后角色无操作权限，可检查角色的地区权限设置。
自定义字段枚举限制：如果state是自定义字段，可能后台设置了仅允许US-HI作为可选值，其他值不在枚举范围内导致提交失败，需查看该自定义字段的配置规则。