创建企业子账号-CreateSubEnterpriseAccount

功能介绍

企业主账号在自建平台创建企业子账号。

企业主账号创建企业子账号请参见这里。

接口约束

该接口只允许使用企业主账号AK/SK或者Token调用。
自2022年8月1日起，密码长度至少为8个字符。
合作伙伴销售平台创建财务独立企业子客户的页面必须体现并同意华为云企业管理服务使用声明、华为云用户协议和隐私政策声明。
合作伙伴销售平台创建财务托管企业子客户的页面必须体现并同意华为云账号托管协议、华为云用户协议和隐私政策声明。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见策略授权参考。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
描述
访问级别
资源类型（*为必须）
条件键
别名
businessUnitCenter:businessUnit:view
授予查看组织与账号的权限
read
-
-
-

授权项	描述	访问级别	资源类型（*为必须）	条件键	别名
businessUnitCenter:businessUnit:view	授予查看组织与账号的权限	read	-	-	-

URI

POST /v2/enterprises/multi-accounts/sub-customers

请求消息

请求参数

参数	是否必选	参数类型	取值范围	描述
party_id	是	String	最大长度：20	企业子账号挂载的组织单元。组织单元的Party ID，通过查询企业组织结构-ListEnterpriseOrganizations接口的响应获得。
new_sub_customer	是	NewSubCustomer Object	-	企业子账号信息。具体请参见表2。
display_name	否	String	最大长度：64	企业子账号的显示名称，不能包含特殊字符。此参数不携带或携带值为null时，不被赋值；携带值为空串时，赋值空串。
sub_customer_association_type	是	Integer	-	子账号关联类型：1：同一法人。关联类型目前只能是同一法人。
permission_ids	否	List<String>	-	申请的权限列表。支持的权限项请参见表1 权限项定义列表。此参数不携带或携带值为空数组或携带值为null时，不被赋值。说明：当financial_custody为1时，此参数不生效，默认指定权限项：READ_FINANCE_INFO、READ_CONSUME_BILL、SHARE-BIZ-DISCOUNT-TO-SUB。
financial_custody	否	Integer	-	是否开通财务托管。 0：不开通（默认值） 1：开通此参数不携带或携带值为null时，取默认值0。

表1 权限项定义列表
参数	描述
READ_FINANCE_INFO	查看企业子账号财务信息。
READ_CONSUME_BILL	查看企业子账号消费信息。
SUBSTITUTE-OPEN-INVOICE	管理关联账号发票。
TAKE-OVER-OPEN-INVOICE	禁止关联账号开发票。
SHARE-CREDIT-TO-SUB	企业子账号共享主账号信用额度。
SHARE-BIZ-DISCOUNT-TO-SUB	企业子账号继承主账号商务折扣。

表2 NewCustomer
参数	是否必选	参数类型	取值范围	描述
customer_name	是	String	最大长度：32	企业子账号登录名。
password	是	String	最大长度：32	企业子账号的登录密码。
mobile_phone	否	String	最大长度：20	企业管理员的手机号码。如果use_pri_mobile_phone取值为Y，则这个参数无效，否则必选。当use_pri_mobile_phone取值Y时，此参数不携带或携带值为空串或携带值为null时，参数无效。
use_pri_mobile_phone	否	String	最大长度：10	是否使用企业主账号手机号码作为子账号手机号码： Y：是 N：否（默认值）当为Y时，mobile_phone输入无效。此参数不携带或携带值为null时，取默认值N；不支持携带值为空串。
verification_code	否	String	最大长度：6	验证码，只有输入企业子账号的手机号的情况下，才需要填写该字段。除上述情况外，此参数不携带或携带值为空串或携带值为null时，不做处理。具体请参见发送短信验证码-SendSmsVerificationCode。

请求示例

POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/sub-customers HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
    "new_sub_customer": {
        "password": "*******",
        "mobile_phone": "188****8888",
        "customer_name": "sub***003",
        "use_pri_mobile_phone": "N",
        "verification_code": "625***"
    },
    "permission_ids": [
        "READ_FINANCE_INFO",
        "READ_CONSUME_BILL",
        "SUBSTITUTE-OPEN-INVOICE",
        "TAKE-OVER-OPEN-INVOICE",
        "SHARE-CREDIT-TO-SUB",
        "SHARE-BIZ-DISCOUNT-TO-SUB"
    ],
    "party_id": "99920",
    "display_name": null,
    "sub_customer_association_type": 1,
    "financial_custody": 0
}

响应消息

响应参数

状态码：204

默认返回：Success

状态码：400/500

参数	参数类型	取值范围	描述
error_code	String	最大长度：20	状态码。具体请参考状态码。只有失败才返回该字段。
error_msg	String	最大长度：1000	错误描述信息。只有失败才返回该字段。
fail_check_items	List<String>	-	不满足的业务规则检查项。当错误码为CBC.7004时返回。

参数

参数类型

取值范围

描述

error_code

String

最大长度：20

状态码。具体请参考状态码。只有失败才返回该字段。

error_msg

String

最大长度：1000

错误描述信息。只有失败才返回该字段。

fail_check_items

List<String>

不满足的业务规则检查项。

当错误码为CBC.7004时返回。

表3 企业主账号创建企业子账号检查项
检查项ID	检查项名称
MAX_SUB_CUSTOMER_NUM	超过最大子账号数量。
IND_CUST_NOT_CREATE_SUB_CUST	个人客户不允许创建子账号。
VERIFIED_NUMBER_OVER_MAX_LIMIT	同个证件号实名认证数量超过限制。
MAX_SUB_FINANCE_NUM	超过最大财务托管子账号数量。
MAX_SUB_INDEPENDENT_NUM	超过最大财务独立子账号数量。
PRI_CUSTOMER_FORBID_INDEPENDENT_SUB	企业主账号是经销商代售子客户，则不能以财务独立模式邀请企业子账号。

响应示例

HTTP/1.1 204 Not Content
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time

状态码

状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

HTTP状态码	错误码	错误描述
400	CBC.0100	参数错误。
400	CBC.70900002	您的账号需要通过华为云HIS平台创建企业子账号。
400	CBC.99007490	您的账号关联的是退出中的云经销商，禁止创建企业子。
500	CBC.7004	发起的业务操作存在不满足的业务检查项。
400	CBC.99000026	验证码错误。
400	CBC.99000027	验证码过期。
400	CBC.99000029	手机号码已存在。
400	CBC.99000030	手机号码超出限制。
400	CBC.99000031	DomainName无效。
400	CBC.99000036	客户密码格式不合法。
400	CBC.99000051	该手机号/邮箱已被华为报备，无法创建客户。
400	CBC.99007173	该显示名称与其他子账号显示名重复。
400	CBC.99007197	您的IP已经被限流。
403	CBC.0151	访问拒绝。
500	CBC.0999	其他错误。