更新时间:2023-12-22 GMT+08:00
分享

创建企业子账号

功能介绍

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

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

接口约束

  • 该接口只允许使用企业主账号AK/SK或者Token调用。
  • 自2022年8月1日起,密码长度至少为8个字符。

调试

您可以在API Explorer中调试该接口。

URI

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

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

party_id

String

最大长度:20

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

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

new_sub_customer

NewSubCustomer Object

-

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

display_name

String

最大长度:64

企业子账号的显示名称,不能包含特殊字符。

此参数不携带或携带值为null时,不被赋值;携带值为空串时,赋值空串。

sub_customer_association_type

Integer

-

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

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

permission_ids

List<String>

-

申请的权限列表。

支持的权限项请参见下表。

此参数不携带或携带值为空数组或携带值为null时,不被赋值。

表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时,不做处理。

具体请参见发送短信验证码

请求示例

POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/sub-customers HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...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
}

响应消息

响应参数

状态码:204

默认返回:Success

状态码:400

参数

参数类型

取值范围

描述

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_INDEPENDENT_NUM

超过最大财务独立子账号数量。

响应示例

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.99007197

您的IP已经被限流。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品