接口说明
批量添加签署者
API 方法名:nuonuo.eleConShortcutSign.batchAddSigners 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| application | String | 否 | - | 应用名称,请联系对接人员分配 | 测试应用 |
| procedureNo | String | 否 | - | 流程编号 | 20200402205741691733333333 |
| signerList | Array | 否 | 10 | 签署方个数需要在1-10个 | 如下 |
| └ signerType | Number | 否 | - | 签署者类型 0:个人 1:企业 | 0 |
| └ signerAccountId | String | 否 | - | 签署者账户id | ea25029c31814f259bfbd36ff23243242 |
| └ signerPartId | String | 否 | - | 签署者主体id(当signerType=0时,signerAccountId和signerPartId必须相同) | ea25029c31814f259bfbd36ff23243242 |
| └ signShape | Number | 是 | - | 签署形态 0集成页面、1自定义页面,默认0 | 0 |
| └ signatureSave | String | 是 | - | 是否保存个人手绘签名0:保存 1:不保存(不填默认保存) | 1 |
| └ automaticSignFlag | Number | 否 | - | 盖章方式:0手动盖章、1自动盖章、 2手动盖章(指定位置)、3接口盖章 | 0 |
| └ autoSignInfoList | Array | 是 | - | 自动签章信息,当automaticSignFlag=1时必传,自动签章信息不能超过50个,仅支持发起方自动签章 | 如下 |
| └ charterType | Number | 是 | - | 印章类型 0:个人印章 1:企业印章 | 1 |
| └ charterId | String | 是 | - | 印章id | - |
| └ signPage | Array | 是 | - | 签章页数 | [1,2,3] |
| └ signX | Number | 是 | - | 签章x坐标,最终会最大保留4位小数 | 100 |
| └ signY | Number | 是 | - | 签章y坐标,最终会最大保留4位小数 | 200 |
| └ specifyLocationList | Array | 是 | - | 指定签署位置,当automaticSignFlag=2时必传,指定签章位置不能超过50个 | 如下 |
| └ signPage | Array | 是 | - | 签章页数 | [1,2,3] |
| └ signX | Number | 是 | - | 签章x坐标,最终会最大保留4位小数 | 100 |
| └ signY | Number | 是 | - | 签章y坐标,最终会最大保留4位小数 | 200 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 返回码 | - |
| describe | String | 否 | - | 描述,当接口发生错误时,有值。 | - |
| result | String | 否 | - | 是否添加成功 | - |
请求报文示例
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);
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
H200 | 200 | |
H88888 | 参数异常 | 检查入参 |
H99999 | 系统异常 | 根据提示原因或联系管理员解决 |