发送签约提醒

服务说明

[!NOTE] 文件签约提醒,通过发送手机短信方式提醒签约方签署合同。支持单个web签约合同或批量签署合同

http请求方式

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

http请求地址

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

http请求参数

参数 类型 是否必填 默认值 说明
applyNo string + 合同编号-单个合同签约时使用
businessNo string + 业务编号-批量签时通知专用
fullName string * 签约人名称
identityCard string * 签约人证件号
identityType int * 证件类型 1身份证, 2护照, 3台胞证, 4港澳居民来往内地通行证, 11营业执照, 12统一社会信用代码, 20子账号, 99其他
signNotifyType int * 1 提醒类型,1签字提醒,2到期前提醒,3到期后提醒,4合同到期前提醒,5合同到期后提醒
customizeName string ? 自定义接收短信中的商户名

特殊说明

[!NOTE] 短信签约链接地址有效期为24小时,过期后需要重新请求短信。该接口因涉及到短信费用,如果未购买短信服务,需要联系商务购买。

代码实现

JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("applyNo","XXX"); //TODO +
//params.put("businessNo","XXX"); //TODO +
params.put("fullName","易XX");
params.put("identityCard","500240XXXXXXXXXXXXXXX");
params.put("identityType",1);
//params.put("signNotifyType",1); //默认为1

ResultInfo<Void> ri= requestUtils.doPost("/v2/sign/notify",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
    "applyNo" => "APL0000XXXXXXXXX", //TODO +
    //"businessNo" => "0000XXXXXXXXX", //TODO +
    "fullName" => "易XX", //TODO *
    "identityCard" => "5002XXXXXXXXXXXXXXXXXX", //TODO *
    "identityType" => 1, //TODO *
    //"signNotifyType" => 1 //默认为1
);
$response=$requestUtils->doPost("/v2/sign/notify",$request);

http返回参数

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

参数 类型 是否必返回 说明
success bool * 成功true;异常false
msg string ? 异常时,返回异常原因
resultCode int * 成功0,其它参考附录

[!NOTE] 返回结果,参考:

//正确响应:
{"success":true}

//错误响应:
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}

results matching ""

    No results matching ""