文档首页 > > API参考> 管理企业> 管理企业多账号> 创建企业子账号

创建企业子账号

分享
更新时间: 2020/05/29 GMT+08:00

功能介绍

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

注意事项:

该接口只允许使用企业主账号AK/SK或者Token调用。

URI

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

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

party_id

String

最大长度:20

企业子账号挂载的组织单元。

组织单元的Party ID,通过查询企业组织结构接口的响应获得。

display_name

String

最大长度:64

企业子账号的显示名称,不限制特殊字符。

sub_customer_association_type

Integer

-

子账号关联类型:1:同一法人。

关联类型目前只能是同一法人。

permission_ids

List<String>

-

申请的权限列表。

支持的权限项参见表2

new_sub_customer

NewCustomer

-

企业子账号信息。具体请参见表1

表1 NewCustomer

参数

是否必选

参数类型

取值范围

描述

customer_name

String

最大长度:32

企业子账号登录名。

mobile_phone

String

最大长度:20

企业管理员的手机号码。如果usePriMobilePhone取值为Y,则这个参数无效,否则必选。

use_pri_mobile_phone

String

最大长度:10

是否使用企业主账号手机号码作为子账号手机号码:

  • Y:是
  • N:否(默认值)

当为Y时,mobile_phone输入无效。

password

String

最大长度:32

企业子账号的登录密码。

verification_code

string

最大长度:6

验证码,只有输入企业子账号的手机号的情况下,才需要填写该字段。

表2 权限项定义列表

参数

描述

READ_FINANCE_INFO

查看企业子账号财务信息。

READ_CONSUME_BILL

查看企业子账号消费信息。

SUBSTITUTE-OPEN-INVOICE

管理关联账号发票。

TAKE-OVER-OPEN-INVOICE

禁止关联账号开发票。

SHARE-CREDIT-TO-SUB

企业子账号共享主账号信用额度。

SHARE-BIZ-DISCOUNT-TO-SUB

企业子账号继承主账号商务折扣。

请求示例

POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/sub-customers HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "party_id": "163",
  "display_name": "",
  "sub_customer_association_type": "1",
  "permission_ids": [
    "string"
  ],
  "new_sub_customer": {
    "customer_name": "",
    
    "mobile_phone": "17069622XXX",
    "use_pri_mobile_phone": "Y",
    "password": "password",
    "verification_code": "123456"
  }
}

响应消息

响应参数

参数

参数类型

取值范围

描述

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

个人客户不允许创建子账号。

响应示例

无。

状态码

HTTP状态码

错误码

错误描述

400

CBC.0100

输入参数校验失败。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

400

CBC.99000036

客户密码格式不合法。

400

CBC.99000026

验证码错误。

400

CBC.99000027

验证码过期。

400

CBC.99000029

手机号码已存在。

400

CBC.99000030

手机号码超出限制。

400

CBC.99000031

DomainName无效。

400

CBC.99000033

手机号码无效。

400

CBC.99000034

不支持当前国家。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问