SAAS文件发起

服务说明

[!NOTE]
通过该接口传入用户自有平台中的文件并直接带入至君子签文件发起页面中。需在君子签saas中有注册并认证完成的账号。

注：合同文件和附件材料，单个上传不能超过20M，总共大小不能超过30M。

http请求方式

[!NOTE]
POST multipart/form-data

http请求地址

[!NOTE]
$SERVICE_URL/v2/sign/multiFile/applySign/link #其中$SERVICE_URL为生产或测试的地址

http请求参数

参数	类型	是否必填	默认值	说明
file	file	*		格式：可上传 pdf、doc、docx、jpg、xls、xlsx 、wps格式文件，大小：单个文件最大20MB；注意：多文件就传多个file
attachFile	file	?		上传无需签字盖章的附件材料。大小：单个文件最大20MB；注意：多文件就传多个file
backUrl	string	?		发起成功后转跳的url地址(需携带协议头如https或http 否则转跳会失败)
signatories	JSONArray	？		合同签约方数组形式的json格式字符串

signatories字段说明

[!NOTE]
signatories是合同的签署方信息，为JSONArray结构，即JSONObject数组,且签约人不能存在相同的证件号。签署人参数说明如下：

参数	类型	是否必填	默认值	说明
fullName	string	*		签约方名称,不超过50个字符
identityType	int	*		身份类型:1身份证,2护照,3台胞证,4港澳居民来往内地通行证,11营业执照,12统一社会信用代码
identityCard	string	*		个人传身份证号，企业传营业执照号/统一社会信用代码号
mobile	string	+		手机号码（个人必传），11个字符
email	string	+		邮箱,企业必传（必须与调“企业实名认证”接口时传的邮箱一致）

代码实现

JAVA实现

       Map<String,Object> params=bodyParams;
        String url=SERVICE_URL+"/v2/sign/multiFile/applySign/link";
        List<File> files=new ArrayList<>();

        files.add(new File("d:\\唐\\合同模板制作教程.pdf"));
        files.add(new File("d:\\唐\\微信图片_20220609114829.jpg"));
        params.put("file",files);

        List<File> files1=new ArrayList<>();
        files1.add(new File("d:\\唐\\微信图片_20220609114829.jpg"));
        files1.add(new File("d:\\唐\\合同模板制作教程.pdf"));
        params.put("attachFile",files1);

        /**
         * 签约方1（个人）
         */
        JSONArray signatories=new JSONArray();
        SignatoryReq sReq=new SignatoryReq();

        sReq.setFullName("唐糖"); //姓名
        sReq.setIdentityType(1); //证件类型
        sReq.setIdentityCard("500225198XXXXX");//身份证号
        sReq.setMobile("111XXXXX"); //手机号
        signatories.add(sReq);
        /**
         * 签约方2（企业）
         */
        sReq=new SignatoryReq();
        sReq.setFullName("TT测试公司"); //企业姓名
        sReq.setIdentityType(11); //证件类型
        sReq.setIdentityCard("50090XXXX");//营业执照号
        sReq.setEmail("demXXXt@www.bccto.me"); //在君子签注册认证的邮箱
        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);

http返回参数

[!NOTE]
返回response为application/json的数据，其字段说明如下

参数	类型	是否必返回	说明
success	bool	*	成功true；异常false
msg	string	?	异常时，返回异常原因
resultCode	string	*	成功0，其它参考附录
data	string	?	返回业务内容，成功时返回

data参数说明

参数	类型	是否必返回	说明
fileKey	string	*	文件key
saasLink	string	*	saas合同发起链接

[!NOTE]
返回结果，参考：

//正确响应：
{"data":{"fileKey":"472291XXXB08","saasLink":"https://account-sandbox.XB08&cp=https%XuthorizC9.eyJ0"},"success":true}
//错误响应：
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}

results matching ""

No results matching ""