客户运营能力客户运营能力

更新时间:2021/09/08 GMT+08:00
分享

创建企业子账号

功能介绍

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

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

接口约束

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

调试

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

URI

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

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

party_id

String

最大长度:20

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

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

new_sub_customer

NewSubCustomer Object

-

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

display_name

String

最大长度:64

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

sub_customer_association_type

Integer

-

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

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

permission_ids

List<String>

-

申请的权限列表。

支持的权限项参见表2

表1 NewCustomer

参数

是否必选

参数类型

取值范围

描述

customer_name

String

最大长度:32

企业子账号登录名。

password

String

最大长度:32

企业子账号的登录密码。

mobile_phone

String

最大长度:20

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

use_pri_mobile_phone

String

最大长度:10

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

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

当为Y时,mobile_phone输入无效。

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
{
    "new_sub_customer": {
        "password": "Huawei@123",
        "mobile_phone": "15055556663",
        "customer_name": "subtom003",
        "use_pri_mobile_phone": "N",
        "verification_code": "625009"
    },
    "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.99007004时返回。

表3 企业主账号创建企业子账号检查项

检查项ID

检查项名称

MAX_SUB_CUSTOMER_NUM

超过最大子账号数量。

IND_CUST_NOT_CREATE_SUB_CUST

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

响应示例

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

状态码

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

400

CBC.7004

发起的业务操作存在不满足的业务检查项。

400

CBC.99000026

验证码错误。

400

CBC.99000027

验证码过期。

400

CBC.99000029

手机号码已存在。

400

CBC.99000030

手机号码超出限制。

400

CBC.99000031

DomainName无效。

400

CBC.99000033

手机号码无效。

400

CBC.99000034

不支持当前国家。

400

CBC.99000036

客户密码格式不合法。

400

CBC.99007197

您的IP已经被限流。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品