签约状态查询及时间查询

接口说明

[!NOTE]
查询签约人签字状态及签字时间,此接口签约人信息必传

http请求方式

[!NOTE]
POST application/x-www-form-urlencoded

http请求地址

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

http请求参数

除公共必填参数外，还需要传以下参数

参数	类型	是否必填	默认值	说明
applyNo	string	*		合同编号
fullName	string	*		签约人名称
identityCard	string	*		签约人证件号
identityType	int	*		证件类型 1身份证, 2护照, 3台胞证, 4港澳居民来往内地通行证, 11营业执照, 12统一社会信用代码, 20子账号, 99其他
showAll	Integer	？		是否查询所用签约人状态，默认不查询，1查询全部可不传签约人信息

代码实现

JAVA实现

   Map<String,Object> params=bodyParams;
        String url=SERVICE_URL+"/v2/sign/info";
        params.put("applyNo","APL1580371234133655552");
        params.put("fullName","TT测XXX");
        params.put("identityCard","500903000035447");
        params.put("identityType","11");
        params.put("showAll","1");

        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	?	异常时返回
data	object	?	返回业务内容，成功时返回

data参数说明

参数	类型	是否必返回	说明
signStatus	int	*	0 ：未签 1 ：已签 2：拒签 3：已保全
signTime	string	*	签字时间
users	JSONArray	？	签约人列表

users参数说明

参数	类型	是否必返回	说明
fullName	string	*	名称
identityType	Integer	*	证件类型
identityCard	string	*	证件号
signStatus	Integer	*	签约状态
signTime	Date	?	签字时间

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

//正确响应：
{"data":{"signStatus":3,"signTime":1694157702000,"users":[{"fullName":"唐XX","identityCard":"50022XXXXX","identityType":1,"signStatus":1,"signTime":1694157702000},{"fullName":"TT测试公司","identityCard":"50090XXXXX","identityType":11,"signStatus":1,"signTime":1694157702000}]},"success":true}

//错误响应：
{"msg":"查询不到签约方信息","resultCode":"SIGN_INFO_NOT_EXISTS","success":false}

results matching ""

No results matching ""