签约发起(追加签署人)
接口说明
[!NOTE]
平台业务场景中,在发起合同时存在多个签署人时,不知某个/某几个签署人信息时,可以通过该接口实现追加签署人。注意:
1、需要先调合同发起接口($SERVICE_URL/v2/sign/applySign),且设置isArchive=0(不归档),才能调该接口继续追加签署人
2、调本接口时如果设置isArchive=1时,且添加签署人/不添加签署人,对合同进行归档,归档成功后则不能再调该接口
3、调本接口时如果设置isArchive=0时,合同未归档,则可以继续调该接口追加签署人;
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/signatory/add #其中$SERVICE_URL为生产或测试的地址
http请求参数
类型 | 是否必填 | 默认值 | 说明 | |
---|---|---|---|---|
applyNo | String | * | 合同编号(合同发起接口中生成的APL开头的编号) | |
signatories | JSONArray | ? | 追加签署人信息,参数说明请参考签约发起接口中的signatories字段说明;isArchive=0时必传,isArchive=1时非必传 | |
isArchive | Integer | * | 是否归档;0不归档,1归档 | |
htmlContent | String | ? | 如果使用表单域+html,需要对原html重新上传,注:需要在HTML源码中加上<meta http-equiv="content-type" content="text/html;charset=utf-8"> | |
positionType | int | ? | 0 | 指定公章位置类型:0或null使用签字座标位置或不指定签字位置;1表单域定位(表单域如果上传为pdf时,需pdf自行定义好表单域,html及url及tmpl等需定义好input标签);2关键字定义 |
JAVA实现
Map<String, Object> params=bodyParams;
String url=SERVICE_URL+"/v2/sign/signatory/add";
params.put("applyNo","APL1574949759255855104");
params.put("isArchive",1);//是否归档,0不归档,1归档,默认值1
/**
* 签约方(个人)
*/
JSONArray signatories=new JSONArray();
SignatoryReq sReq=new SignatoryReq();
sReq.setFullName("测XX"); //姓名
sReq.setIdentityType(1); //证件类型
sReq.setIdentityCard("512501197XXXXXX");//身份证号
sReq.setMobile("1862XXXX"); //手机号
sReq.setChapteJson("[{\"page\":4,\"chaptes\":[{\"offsetX\":0.566,\"offsetY\":0.3919}]}]");
sReq.setSignLevel(1);//签字类型,标准图形章或公章:0标准图形章,1公章或手写,2公章手写或手写,3个人方形标准章(用户类型是个人且姓名2-4个字符生效,其他情况默认使用系统标准图形章)
sReq.setServerCaAuto(1);//0手动签;1自动签
signatories.add(sReq);
params.put("signatories",signatories.toJSONString());
System.out.println(signatories.toJSONString());
String str= HttpClientUtils.init().getPost(url,null,params,true);
System.out.println(str);