撤销批量签约发起
接口说明
[!NOTE]
在合同还未签署完成的情况下才可以通过该接口撤销合同。已经签署完成的合同不支持撤销
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/batchSignCancel #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外，还需要传以下参数
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| businessNo | string | * | 业务编号 | |
| part | int | ? | 部分撤销; 0:仅撤未签署完成的合同（其中已签署完成的不撤销） | |
| applyNo | string | ? | 部分撤销；传具体APL编号后，撤销具体的APL合同，多个合同编号用英文逗号分隔 |
代码实现
JAVA实现
Map<String, Object> params = bodyParams;
String url = SERVICE_URL + "/v2/sign/batchSignCancel";
params.put("businessNo", "t97XXXXXX");
String str = HttpClientUtils.init().getPost(url, null, params, true);
System.out.println(str);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
"businessNo" => "XXX" //TODO *
);
$response=$requestUtils->doPost("/v2/sign/batchSignCancel",$request);
http返回参数
[!NOTE]
返回response为application/json的数据，其字段说明如下
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| success | bool | * | 成功true；异常false |
| msg | string | ? | 异常时，返回异常原因 |
| resultCode | string | ? | 异常时返回 |
| data | string | ? | 撤销合同详情 |
data参数说明
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| cancel | string[] | * | 部分撤销才返回，撤销合同编号 |
| notCancel | string[] | * | 部分撤销才返回，未撤销合同编号 |
[!NOTE]
返回结果，参考：
//正确响应：
{"success":true}
//错误响应：
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}