创建企业签署账户

更新时间:2024-01-23 17:35:23

接口描述

开发者通过该接口给当前需要签署的企业用户创建签署账号,并获取对应的企业签署账号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

手机号码,用于接收签署验证码

email

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

  • true - 加密
  • 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":"成功"
}

错误码

错误码

错误描述

解决方案



我要纠错