创建机构签署账号

接口描述

此接口用于与开发者的自身业务系统的机构/企业用户账号打通

调用此接口的唯一标识是thirdPartyUserId，开发者需确保传入的thirdPartyUserId唯一，可以是机构的证件号等，创建成功后接口将返回唯一的orgId，与传入的thirdPartyUserId对应。
返回的orgId请注意妥善保存，以便用于后续签署业务。

【提示】

(1) 证件号idNumber规则说明：

接口不对传入的证件号进行真实性校验，需开发者确保证件号准确、真实。
签署账号创建成功后不允许再对证件号 idNumber 进行修改。
若证件号错误，可【注销机构签署账号】后使用正确号码重新创建账号。
同一个应用（AppID）下，同一证件号最多只允许绑定100个 thirdPartyUserId ，若超过限制数量时接口报错“该证件号创建用户数已达最大数量100个，不允许再继续创建”。此时，需要开发者调整账号创建逻辑。
建议开发者尽量确保一个证件号 idNumber 仅对应一个 thirdPartyUserId 。

(2) 关于报错“code=53000000，message=账号已存在”的说明：

此报错表示已使用 thirdPartyUserId 创建过账号，开发者可调用【查询机构签署账号】接口来获取 thirdPartyUserId 对应的orgId、企业名称和证件号等信息，按实际情况做后续业务操作。

(3) 账号创建成功后e签宝会根据传入的姓名生成机构模板印章。

(4) 账号创建成功后e签宝会根据证件号及姓名申请数字证书，用于后续签署业务，以符合《电子签名法》要求。

接口Url

/v1/organizations/createByThirdPartyUserId

请求方式Method

POST

请求头Header

提供两种安全接入方式，开发者可选择其中一种方式进行对接，对应参数如何获取，参考文档【请点击】。

方式一：请求签名鉴权（优先推荐）

请求头入参示例如下：

参数名称	参数类型	必选	参数位置	参数说明
X-Tsign-Open-App-Id	string	是	Header	应用ID，通过开放平台创建获取
Content-Type	string	是	Header	application/json;charset=UTF-8
X-Tsign-Open-Ca-Timestamp	string	是	Header	API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击
Accept	string	是	Header	建议统一填写 /
X-Tsign-Open-Ca-Signature	string	是	Header	签名字符串
Content-MD5	string	是	Header	当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。
X-Tsign-Open-Auth-Mode	string	是	Header	选择请求方式进行鉴权，固定值，Signature

方式二：OAuth2.0鉴权（不推荐使用）

当安全接入选择OAuth2.0鉴权方式，请点击查阅详情，请求头入参示例如下：

参数名称	参数类型	必选	参数位置	参数说明
X-Tsign-Open-App-Id	string	是	Header参数	应用ID，通过开放平台创建获取
X-Tsign-Open-Token	string	是	Header参数	通过获取鉴权Token接口返回
Content-Type	string	是	Header参数	application/json; charset=UTF-8

请求参数

参数名称	参数类型	必选	参数位置	参数说明
thirdPartyUserId	string	是	body	创建机构账号的唯一标识。可将企业证件号、企业邮箱地址等作为此账号的唯一标识。注：（1）创建机构账号和机个人账号时，机构账号的唯一标识和个人账号的唯一标识不可重复；（2）开发者需保证字段thirdPartyUserId在平台方业务系统不可重复。
name	string	是	body	组织机构名称
idType	string	是	body	机构证件类型，默认CRED_ORG_USCC 类型枚举参考下表所示。
idNumber	string	是	body	机构证件号
orgLegalIdType	string	是	body	机构法定代表人证件类型，默认：CRED_PSN_CH_IDCARD （1）CRED_PSN_CH_IDCARD 大陆身份证，默认值（2）CRED_PSN_CH_TWCARD 台湾来往大陆通行证（台胞证）（3）CRED_PSN_CH_MACAO 澳门来往大陆通行证（回乡证）（4）CRED_PSN_CH_HONGKONG 香港来往大陆通行证（回乡证）（5）CRED_PSN_PASSPORT 护照
orgLegalIdNumber	string	否	body	机构法定代表人证件号注：接口不做法定代表人证件号格式校验，但后续如果需要发起机构实名认证，法定代表人非大陆身份证时，必须传入对应的法定代表人证件类型
orgLegalName	string	否	body	机构法定代表人名称
creator	string	否	body	自2021年11月15日起，此字段调整为非必填，建议不传此值。创建人的个人账号id（调用个人账号创建获取到的accountId）
realnameEvidencePointId	string	否	body	实名证据点ID（通过《创建企业实名证据点》接口获取）注：当不使用e签宝实名认证，需要将证据点上传到e签宝后，才能创建e签宝签署账号需确保证据点内的企业名称和企业证件号和当前账号信息保持一致需联系e签宝技术人员开启后才可使用

idType证件类型枚举说明

参数说明

类型枚举

idType

机构证件类型，默认CRED_ORG_USCC

（1）CRED_ORG_USCC 统一社会信用代码，默认值

（2）CRED_ORG_CODE 组织机构代码证

（3）CRED_ORG_REGCODE 工商注册号

（4）CRED_ORG_BUSINESS_REGISTTATION_CODE 工商登记证

（5）CRED_ORG_TAX_REGISTTATION_CODE 税务登记证

（6）CRED_ORG_LEGAL_PERSON_CODE 法人代码证

（7）CRED_ORG_ENT_LEGAL_PERSON_CODE 事业单位法人证书

（8）CRED_ORG_SOCIAL_REG_CODE 社会团体登记证书

（9）CRED_ORG_PRIVATE_NON_ENT_REG_CODE 民办非机构登记证书

（10）CRED_ORG_FOREIGN_ENT_REG_CODE 外国机构常驻代表机构登记证

（11）CRED_ORG_GOV_APPROVAL 政府批文

公共响应参数

参数名称	参数类型	必选	参数说明
code	int	是	业务码，0表示成功
message	string	否	业务描述信息
data	object	否	业务数据

响应参数

参数名称

参数类型

必选

参数说明

orgId

string

是

机构签署账号ID

注：用于实名认证、签署服务作为企业账号标识传入

请求示例

POST https://openapi.esign.cn/v1/organizations/createByThirdPartyUserId

{
    "thirdPartyUserId":"20190826110230222",
    "idNumber":"91XXXXXXXXXXXXXXX7",
    "idType":"CRED_ORG_USCC",
    "name":"杭州XX信息科技有限公司",
    "orgLegalIdNumber":"xxxxxxxxxxxxxxx",
    "orgLegalName":"xxxxx"
}

Postman请求示例

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "orgId": "277f63c****8a1614aff"
    }
}

错误码

错误码	错误描述	解决方案
53000000	账号已存在
53000001	账号不存在
53000002	账号类型不匹配
401		1.token过期了 2.header请求头不正确 3.apiurl和应用ID环境不对应，例如apiurl是模拟环境，应用ID是正式环境的