首页 > 开放平台 > 电子合同(快捷签) > 合同签署相关
开放平台/合同签署相关/批量添加签署者

批量添加签署者

2026-09-24 更新 阅读 版本 v1.0

接口说明

批量添加签署者

API 方法名:nuonuo.eleConShortcutSign.batchAddSigners 版本:V2.0

请求地址

环境请求地址
正式环境https://sdk.nuonuo.com/open/v1/services
沙箱环境https://sandbox.nuonuocs.cn/open/v1/services

公共请求参数(消息头)

参数名类型必填长度说明示例
Content-typeString否-MIME类型【消息头】-

公共请求参数(消息体)

参数名类型必填长度说明示例
senidString否-唯一标识,由企业自己生成32位随机码【消息体】-

私有请求参数

参数名类型必填长度说明示例
applicationString否-应用名称,请联系对接人员分配测试应用
procedureNoString否-流程编号20200402205741691733333333
signerListArray否10签署方个数需要在1-10个如下
   └ signerTypeNumber否-签署者类型 0:个人 1:企业0
   └ signerAccountIdString否-签署者账户idea25029c31814f259bfbd36ff23243242
   └ signerPartIdString否-签署者主体id(当signerType=0时,signerAccountId和signerPartId必须相同)ea25029c31814f259bfbd36ff23243242
   └ signShapeNumber是-签署形态 0集成页面、1自定义页面,默认00
   └ signatureSaveString是-是否保存个人手绘签名0:保存 1:不保存(不填默认保存)1
   └ automaticSignFlagNumber否-盖章方式:0手动盖章、1自动盖章、 2手动盖章(指定位置)、3接口盖章0
   └ autoSignInfoListArray是-自动签章信息,当automaticSignFlag=1时必传,自动签章信息不能超过50个,仅支持发起方自动签章如下
      └ charterTypeNumber是-印章类型 0:个人印章 1:企业印章1
      └ charterIdString是-印章id-
      └ signPageArray是-签章页数[1,2,3]
      └ signXNumber是-签章x坐标,最终会最大保留4位小数100
      └ signYNumber是-签章y坐标,最终会最大保留4位小数200
   └ specifyLocationListArray是-指定签署位置,当automaticSignFlag=2时必传,指定签章位置不能超过50个如下
      └ signPageArray是-签章页数[1,2,3]
      └ signXNumber是-签章x坐标,最终会最大保留4位小数100
      └ signYNumber是-签章y坐标,最终会最大保留4位小数200

响应参数

参数名类型必填长度说明示例
codeString否-返回码-
describeString否-描述,当接口发生错误时,有值。-
resultString否-是否添加成功-

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.eleConShortcutSign.batchAddSigners"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"signerList\": [
    {
      \"signerAccountId\": \"ea25029c31814f259bfbd36ff23243242\",
      \"signerPartId\": \"ea25029c31814f259bfbd36ff23243242\",
      \"automaticSignFlag\": 0,
      \"signShape\": 0,
      \"specifyLocationList\": [
        {
          \"signPage\": [
            \"[1\",
            \"2\",
            \"3]\"
          ],
          \"signY\": 200,
          \"signX\": 100
        }
      ],
      \"signerType\": 0,
      \"signatureSave\": \"1\",
      \"autoSignInfoList\": [
        {
          \"charterType\": 1,
          \"signPage\": [
            \"[1\",
            \"2\",
            \"3]\"
          ],
          \"signY\": 200,
          \"charterId\": \"\",
          \"signX\": 100
        }
      ]
    }
  ],
  \"application\": \"测试应用\",
  \"procedureNo\": \"20200402205741691733333333\"
}";
String url = "https://sdk.nuonuo.com/open/v1/services"; // SDK请求地址
String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识,32位随机码,无需修改,保持默认即可
String result = sdk.sendPostSyncRequest(url, senid, appKey, appSecret, token, taxnum, method, content);
System.out.println(result);

返回码说明

返回码说明处理建议
H200200
H88888参数异常检查入参
H99999系统异常根据提示原因或联系管理员解决
标签: 开放平台

申请试用

请留下您的联系方式,我们将在一个工作日内与您联系