接口说明
添加合同签署者
API 方法名:nuonuo.eleConShortcutSign.addSigner 版本: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 |
| signerType | String | 否 | - | 签署者账户类型 0:个人 1:企业(用于区分是个人合同还是企业合同) | 1 |
| signerAccountId | String | 否 | - | 签署操作者账户id,即操作本次签署的个人 | ea25029c31814f259bfbd36ff23243242 |
| signerPartId | String | 否 | - | 签署者主体id,即本次签署对应合同的归属方(当signerType=0时,signerAccountId和signerPartId必须相同) | b1ea98b0ef114a8caf87f4f572424342 |
| signatureSave | String | 是 | - | 是否保存个人手绘签名 0:保存 1:不保存(不填默认保存) | 1 |
| autoSign | String | 否 | - | 是否自动盖章,仅支持合同发起方自动盖章。0:手动盖章 1:自动盖章 | 0 |
| autoSignInfo | Object | 是 | - | 自动签章信息 自动签章时必传 非自动签章如果填了则会忽略 | - |
| └ charterType | String | 否 | - | 印章类型 0:个人印章 1:企业印章 | 0 |
| └ charterId | String | 否 | - | 印章id | a0e776cd7ac743245134783f603096e4 |
| └ signPage | String | 否 | - | 签章页数 | 1 |
| └ signX | String | 否 | - | 签章x坐标,最终会最大保留4位小数。(该坐标取的是印章左下角距离盖章页左侧的坐标大小,请传入有效的坐标,否则会报错) | 0 |
| └ signY | String | 否 | - | 签章y坐标,最终会最大保留4位小数。(该坐标取的是印章左下角距离盖章页下侧的坐标大小,请传入有效的坐标,否则会报错) | 0 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 返回码(H200:成功; H99999:请求异常或服务器异常; H88888:参数异常) | - |
| describe | String | 否 | - | 描述,当接口发生错误时,有值。 | - |
| result | String | 否 | - | 是否添加成功 | - |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.eleConShortcutSign.addSigner"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"signerAccountId\": \"ea25029c31814f259bfbd36ff23243242\",
\"application\": \"测试应用\",
\"signerPartId\": \"b1ea98b0ef114a8caf87f4f572424342\",
\"autoSignInfo\": {
\"charterType\": \"0\",
\"signPage\": \"1\",
\"signY\": \"0\",
\"charterId\": \"a0e776cd7ac743245134783f603096e4\",
\"signX\": \"0\"
},
\"procedureNo\": \"20200402205741691733333333\",
\"signerType\": \"1\",
\"signatureSave\": \"1\",
\"autoSign\": \"0\"
}";
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 | 成功 | |
H88888 | 参数异常 | 检查入参 |
H99999 | 系统异常 | 根据提示原因或联系管理员解决 |