接口说明
合同发起方发起合同作废,返回合同状态(“4”已作废,“5”作废中)。当合同除了发起方以外的签署方没有签署合同时,发起方发起作废,合同状态直接变更为已作废;当有除发起方以外的签署方签署了合同,发起方发起作废,合同状态变更为作废中。
API 方法名:nuonuo.electronicContract.raiseCancel 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| contractNo | String | 否 | 35 | 合同编号 | 2020071411270878078495659 |
| cancelReason | String | 否 | 20 | 作废原因 | 测试发起作废 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| contractStatus | String | 否 | - | 4:已作废,5:作废中 | 4 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.electronicContract.raiseCancel"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"contractNo\": \"2020071411270878078495659\",
\"cancelReason\": \"测试发起作废\"
}";
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);
响应报文示例
{
"code": "H200",
"describe": "成功",
"result": {
"contractStatus": "4"
}
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
H10116 | 各种业务异常 | 请根据具体异常描述处理 |
H10107 | 合同编号不能超过35个字符 | 请检查合同编号 |
H200 | 成功 | |