接口描述
发起企业法定代表人授权书签署适用于以下两种情形：
- authType=1（授权至平台）：当企业用户的法定代表人印章需要委托平台方（应用ID所属的开发者企业）进行自动盖章时，需要先通过该接口发起授权书的授权签署任务（授权书需要法定代表人本人签署）。
- authType=2（授权至经办人）：当企业用户的法定代表人印章需要委托某个经办人进行代法人签署盖章时，需要先通过该接口发起授权书的授权签署任务（授权书需要法定代表人本人签署）。
注：
- 授权书模板底稿文件下载 点击跳转
- 授权有效期默认从发起当天开始的一年内有效，截止日期会展示在授权书内
- 发起该接口需要计费一次：身份核验认证服务的子服务项-法定代表人授权认证
接口名称
AuthService.createLegalAuth(OnlineCreateLegalRepAuthParam onlineCreateLegalRepAuthParam)
请求参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
onlineCreateLegalRepAuthParam | OnlineCreateLegalRepAuthParam | 是 | 创建法定代表人授权参数 | |
organizeId | String | 是 | 授权方企业账号ID（创建企业签署账号接口返回） | |
name | String | 是 | 法定代表人姓名 | |
idNoType | IdNoTypeEnum | 是 | 法定代表人身份证件类型，支持类型如下：
| |
idNo | String | 是 | 法定代表人证件号 | |
encrypt | boolean | 否 | 用户信息是否加密传输，默认 false
| |
contact | String | 是 | 法定代表人的联系方式：手机号或者邮箱 注意：请传入法定代表人的联系方式，会绑定e签宝SaaS官网的登录手机号/邮箱 | |
sendNotice | boolean | 否 | 是否给法定代表人联系方式发送e签宝通知链接，默认：true（发送通知） true - 发送通知 false - 不发送通知 | |
authType | int | 否 | 授权模式，默认为 1（授权至平台） 1 - 授权至平台，personId无需传递 2 - 授权至经办人，personId必传 | |
personId | String | 否 | 授权方经办人个人账号ID（创建个人签署账号接口返回） | |
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);
/** 发起企业授权书签署任务 */
OnlineCreateLegalRepAuthParam onlineCreateLegalRepAuthParam = new OnlineCreateLegalRepAuthParam();//创建授权参数
onlineCreateLegalRepAuthParam.setOrganizeId("AD12C9XXXXXBFA89BABDF6E8FA");//授权方企业账号ID
onlineCreateLegalRepAuthParam.setName("法人张三");//法定代表人姓名
onlineCreateLegalRepAuthParam.setIdNoType(IdNoTypeEnum.MAINLAND);//法定代表人身份证件类型
onlineCreateLegalRepAuthParam.setIdNo("3838184766290004923");//法定代表人证件号
onlineCreateLegalRepAuthParam.setAuthType(1);//授权模式，默认为 1（授权至平台）：1 - 授权至平台，personId无需传递；2 - 授权至经办人，personId必传
//onlineCreateLegalRepAuthParam.setPersonId("836534XXXXXX12345F4FAD90294432");//授权方经办人个人账号ID
onlineCreateLegalRepAuthParam.setContact("15300001111");//手机号或者邮箱
onlineCreateLegalRepAuthParam.setSendNotice(true);//是否发送通知
onlineCreateLegalRepAuthParam.setSealScope("法定代表人章");//自定义授权印章范围
onlineCreateLegalRepAuthParam.setFileType("物流条款");//自定义签署文件类型
onlineCreateLegalRepAuthParam.setNotifyUrl("http://notify.com.cn/callback/XXXXX");//回调通知地址
onlineCreateLegalRepAuthParam.setRedirectUrl("https://open.esign.cn");//重定向跳转地址
OnlineCreateAuthResult onlineCreateAuthResult = getKHD.authService().createLegalAuth(onlineCreateLegalRepAuthParam);
if (onlineCreateAuthResult.getErrCode() != 0)
System.out.println("发起企业法定代表人授权书签署任务失败：" + JSONObject.fromObject(onlineCreateAuthResult));
else
System.out.println("发起企业法定代表人授权书签署任务成功," + JSONObject.fromObject(onlineCreateAuthResult));
响应示例
{
"msg": "",
"errCode": 0,
"errShow": false,
"authId": "1751905111811848"
}
我要纠错