接口描述
发起企业授权书签署适用于以下两种情形：
- authType=1（授权至平台）：当企业用户需要委托平台方（应用ID所属的开发者企业）进行自动盖章时，需要先通过该接口发起授权书的授权签署任务。
- authType=2（授权至经办人）：当企业用户需要委托某个经办人进行代企业签署盖章时，需要先通过该接口发起授权书的授权签署任务。
接口名称
AuthService.createAuth(OnlineCreateAuthParam onlineCreateAuthParam)
请求参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
onlineCreateAuthParam | OnlineCreateAuthParam | 是 | 创建授权参数 | |
organizeId | String | 是 | 授权方企业账号ID（创建企业签署账号接口返回） | |
contact | String | 是 | 代委托方企业签署本授权书的经办人的联系方式：手机号或者邮箱 注意：请传入能为企业操作盖章人员的联系方式，会绑定e签宝SaaS官网的登录手机号/邮箱 | |
sendNotice | boolean | 否 | 是否给经办人联系方式发送e签宝通知链接，默认：true（发送通知） true - 发送通知 false - 不发送通知 | |
authType | int | 否 | 授权模式，默认为 1（授权至平台） 1 - 授权至平台，personId无需传递 2 - 授权至经办人，personId必传 | |
personId | String | 否 | 授权方经办人个人账号ID（创建个人签署账号接口返回） | |
validDate | long | 是 | 授权有效期截止时间（截止到当日23:59:59） 注意：
| |
sealScope | String | 否 | 自定义授权印章范围，不传则默认为全部 仅做为授权书内容的展示，不做接口校验。例如：合同专用章、人事专用章等 | |
fileType | String | 否 | 自定义签署文件类型，不传则默认为全部 仅做为授权书内容的展示，不做接口校验。例如：借贷协议、运输协议、物流条款等 | |
notifyUrl | String | 否 | 回调通知地址，点击了解 回调通知服务 签署完成结果通知平台，签署完成或者拒签触发回调 | |
redirectUrl | String | 否 | 重定向跳转地址，重定向到平台指定页面 | |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
onlineCreateAuthResult | OnlineCreateAuthResult | 是 | 响应结果类 | |
errCode | int | 是 | 错误码，0标识成功，其他均标识失败 | |
msg | String | 否 | 错误信息，错误码对应的说明信息 | |
errorShow | boolean | 否 | 错误信息是否建议显示 | |
authId | String | 否 | 授权流程ID | |
请求示例
// 获取客户端的代码：
ServiceClient getKHD = ServiceClientManager.get(ConfigConstant.PROJECT_ID);
/** 发起企业授权书签署任务 */
OnlineCreateAuthParam onlineCreateAuthParam = new OnlineCreateAuthParam();//创建授权参数
onlineCreateAuthParam.setOrganizeId("AD12C9XXXXXBFA89BABDF6E8FA");//授权方企业账号ID
//onlineCreateAuthParam.setPersonId("836534XXXXXX12345F4FAD90294432");//授权方经办人个人账号ID
onlineCreateAuthParam.setAuthType(1);//授权模式，默认为 1（授权至平台）：1 - 授权至平台，personId无需传递；2 - 授权至经办人，personId必传
onlineCreateAuthParam.setContact("15300001111");//手机号或者邮箱
onlineCreateAuthParam.setSendNotice(true);//是否发送通知
onlineCreateAuthParam.setSealScope("合同专用章");//自定义授权印章范围
onlineCreateAuthParam.setFileType("物流条款");//自定义签署文件类型
onlineCreateAuthParam.setNotifyUrl("http://notify.com.cn/callback/XXXXX");//回调通知地址
onlineCreateAuthParam.setRedirectUrl("https://open.esign.cn");//重定向跳转地址
onlineCreateAuthParam.setValidDate(17085374740000L);//授权有效期截止时间（截止到当日0点）
OnlineCreateAuthResult onlineCreateAuthResult = getKHD.authService().createAuth(onlineCreateAuthParam);
if (onlineCreateAuthResult.getErrCode() != 0)
System.out.println("发起企业授权书签署任务失败：" + JSONObject.fromObject(onlineCreateAuthResult));
else
System.out.println("发起企业授权书签署任务成功," + JSONObject.fromObject(onlineCreateAuthResult));
响应示例
{
"msg": "",
"errCode": 0,
"errShow": false,
"authId": "1751905111811848"
}
我要纠错