接口描述
开发者通过该接口给当前需要签署的企业用户创建签署账号,并获取对应的企业签署账号id。
开发者在对接过程中,需注意:
电子签名SDK创建账户的接口只对证件号格式进行格式校验,不对企业信息的真实性进行校验,如果未单独对接e签宝的实名认证产品,则该签署企业身份信息的真实性需要由贵司负责核实并保存核实结果。
接口名称
AccountService.addAccount(OrganizeBean organize)
请求参数
展开全部参数参数名称 | 类型 | 必选 | 长度 | 参数说明 | |
organize | OrganizeBean | 是 | 企业信息详情 | ||
name | String | 是 | 60 | 企业名称 | |
regType | OrganRegType | 是 | 企业证件类型,支持的类型如下: MERGE - 统一社会信用代码 REGCODE - 企业工商注册码 NORMAL - 组织机构代码号 ORGAN_OTHER - 其它类型 | ||
organCode | String | 是 | 18 | 企业证件号 | |
organType | int | 否 | 单位类型,默认0 0-普通企业 1-社会团体 2-事业单位 3-民办非企业单位 4-党政及国家机构 | ||
mobile | String | 否 | 11 | 手机号码,用于接收签署验证码 | |
String | 否 | 30 | 邮箱地址 | ||
userType | int | 是 | 账户创建类型,默认1 0-无法获知法定代表人/代理人信息时填写 1-可以获知代理人信息时可填写 2-可以获知法定代表人信息时可填写 此字段所填写值不会影响后续签署操作, 建议统一填写0即可。 | ||
agentName | String | 否 | 20 | 代理人姓名,当userType为1时必填 | |
agentIdNo | String | 否 | 25 | 代理人证件号码,当userType为1时必填 | |
legalName | String | 否 | 20 | 法定代表人姓名,当userType为2时必填 | |
legalIdNo | String | 否 | 25 | 法定代表人证件号码,当userType为2时必填 | |
legalArea | int | 否 | 法定代表人证件号类型,默认0 (1)0-大陆 (2)1-香港 (3)2-澳门 (4)3-台湾 (5)4-外籍 | ||
address | String | 否 | 100 | 公司地址 | |
scope | String | 否 | 255 | 经营范围 | |
encrypt | Boolean | 否 | 用户信息是否加密传输,默认 false
|
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
addAccount | AddAccountResult | 是 | ||
errCode | int | 是 | 错误码,0标识成功,其他均标识失败 | |
msg | String | 否 | 错误信息,错误码对应的说明信息 | |
errorShow | boolean | 否 | 错误信息是否建议显示 | |
fingerprint | String | 否 | 指纹信息 | |
accountId | String | 否 | 账号标识,创建后账号在e签宝平台中的唯一标识 |
请求示例
public static void main(String[] args) {
//获取正式生成服务
//获取客户端的代码:ServiceClient getKHD = ServiceClientManager.get("您的pojectId");
AccountService service = getKHD.accountService();
// 创建企业账号
AddAccountResult addAccountResult = service.addAccount(addOrganizeAcct());
if (addAccountResult.getErrCode() != 0)
System.out.println("创建企业账号失败:" +addAccountResult.getMsg());
else
System.out.println("创建企业账号成功,e签宝平台对应的账号标识是:"+ JSONObject.fromObject(addAccountResult));
}
/**
* @description 创建企业账号
*/
private static OrganizeBean addOrganizeAcct() {
OrganizeBean organizeBean = new OrganizeBean();
organizeBean.setEmail("");//邮箱地址,可空
organizeBean.setMobile("");//用于接收签署验证码的手机号码,可空,可空
organizeBean.setName("*****科技有限公司");//机构名称,不可空
organizeBean.setOrganType(0);// 单位类型,0-普通企业,1-社会团体,2-事业单位,3-民办非企业单位,4-党政及国家机构
organizeBean.setOrganCode("5222******L62");// 组织机构代码号、社会信用代码号或工商注册号
// 注册类型,1-代理人注册,2-法人注册,0-缺省注册无需法人或代理人信息
int userType = 0;
switch (userType) {
case 0:
// 0-缺省注册无需法人或代理人信息
organizeBean.setUserType(0);
break;
case 1:
// 1-代理人注册
organizeBean.setUserType(1);
organizeBean.setAgentName("艾利");// 代理人姓名,当注册类型为1时必填
organizeBean.setAgentIdNo("220*****170035");// 代理人身份证号,当注册类型为1时必填
break;
case 2:
// 2-法人注册
organizeBean.setUserType(2);
organizeBean.setLegalName("天天");// 法定代表姓名,当注册类型为2时必填
organizeBean.setLegalArea(0);// 法定代表人归属地,0-大陆,1-香港,2-澳门,3-台湾,4-外籍,默认0
organizeBean.setLegalIdNo("220******0019");// 法定代表身份证号/护照号,当注册类型为2时必填
break;
}
// 企业注册类型,NORMAL:组织机构代码号,MERGE:多证合一,传递社会信用代码号,REGCODE:企业工商注册码,默认NORMAL
organizeBean.setRegType(OrganRegType.MERGE);
organizeBean.setAddress("杭州城****7号");// 公司地址,可空
organizeBean.setScope("");// 经营范围,可空
return organizeBean;
}
响应示例
{
"accountId":"746B076EF9D04AFC903445667E72354C4",
"errCode":0,
"errShow":false,
"fingerprint":"",
"msg":"成功"
}
错误码
错误码 | 错误描述 | 解决方案 |