文档修订记录

第七十三次正式发布。

本次变更说明如下：

• 创建客户（旧）V1接口下线
• 查询伙伴月度消费账单 V1接口下线
• 退订包年/包月资源 V2接口删除错误码“ CBC.99003645-该类型的云服务不支持退订。"
• 续订包年/包月资源 V2接口删除错误码 “CBC.99003631-退订/删除/释放的资源不能续费。”
• 查询按需产品价格 V2接口删除错误码 "400 CBC.99006073项目不存在。"
• 批量查询客户预算 V2接口上线
• 查询订单列表 V2 & V1接口订单创建时间和订单支付时间修改：开始与结束时间间隔不能超过1年。

2024-4-28

第七十二次正式发布。

本次变更说明如下：

退订包年/包月资源V2接口新增错误码 “CBC.99003647 -该按需套餐包不支持退订。"

2024-2-23

第七十一次正式发布。

本次变更说明如下：

• 续订包年/包月资源 V2接口新增错误码“CBC.99000092 - 订购周期校验失败。”
• 取消待支付订单V1接口下线。
• 查询客户用量明细 （旧）接口新增字段“产品类型名称”和“资源类型名称”。
• 查询客户用量明细 接口新增字段“产品类型名称”和“资源类型名称”。
• 查询客户预算V2接口新增响应参数 “budget_type - 预算模式”。
• 设置客户预算V2接口新增请求参数 “budget_type - 预算模式”；

  新增错误码：“CBC.50000030 -云经销商预算额度已不足，无法进行设置预算。”

  “CBC.50000033 - 您授权云经销商预算设置权限已取消，云经销商无法进行预算设置。”

2024-1-29

第七十次正式发布。

• 支付包年/包月产品订单（旧）v1接口下线。
• 查询退款订单的金额详情 v1接口下线。
• 发送验证码（旧）v1接口下线。
• 查询客户按需资源列表 v1接口下线。

2023-12-26

第六十九次正式发布。

本次变更说明如下：

API调用授权（伙伴） 章节已新增权限项列。

2023-11-15

第六十八次正式发布。

本次变更说明如下：

根据产品规格查询价格（旧）v1接口下线。

2023-11-1

第六十七次正式发布。

本次变更说明如下：

查询伙伴月度消费账单明细接口生成的账单明细文件中，“计费模式”字段新增枚举“4：节省计划-订购”和“5：节省计划-按时计费”。

查询客户用量明细接口生成的用量明细文件中，“计费模式”字段新增枚举“11：节省计划”，“账单类型”字段新增枚举“23：消费-节省计划抵扣”。

查询优惠券列表接口响应参数“cycleType”新增枚举“11：节省计划”。

支付包年/包月产品订单接口新增错误码“CBC.99000088：抱歉，支付处理中，请勿重复操作。”

2023-6-29

第六十六次正式发布。

本次变更说明如下：

• 新增API调用授权（伙伴）的章节，伙伴操作员账号调用API需要经过授权，可通过伙伴中心对操作员赋予有权限项的角色来进行授权。
• 查询包年/包月资源的续订金额接口新增错误码“CBC.30050013：该产品不支持续费”。
• 同步客户实名认证信息v1接口下线。

2023-4-18

第六十五次正式发布。

本次变更说明如下：

新增查询包年/包月资源的续订金额接口，客户可以按照条件查询包年/包月资源续订时候的续订金额。

2023-3-30

第六十四次正式发布。

本次变更说明如下：

删除申请个人实名认证接口的“verified_type”字段的枚举值7：海外驾照。

2023-2-28

第六十三次正式发布。

本次变更说明如下：

续订包年/包月资源和退订包年/包月资源接口新增响应参数“fail_resource_infos”，用于查询失败的资源信息。

2023-2-9

第六十二次正式发布。

本次变更说明如下：

下线查询订单可用折扣接口。

2022-12-27

第六十一次正式发布。

本次变更说明如下：

• 创建客户V2接口和创建客户V1接口新增返回错误码“CBC.50010085-该伙伴企业目前处于受限状态，无法拓客创建关联关系。”和“CBC.50010086-该伙伴是云经销商，其关联的总经销商企业目前处于受限状态，无法拓客创建关联关系。”。
• 申请个人实名认证、申请企业实名认证和申请实名认证变更接口新增返回错误码“CBC.70600026-抱歉，华为云暂无法审核您提交的实名认证信息，请联系您的客户经理协助。”。

2022-12-13

第六十次正式发布。

本次变更说明如下：

• 设置包年/包月资源自动续费V1接口下线。
• 取消包年/包月资源自动续费V1接口下线。

2022-11-17

第五十九次正式发布。

本次变更说明如下：

• 查询伙伴月度消费账单明细接口“结算产品”类型参数新增枚举值“60：云商店转售折扣”。
• 设置自动续费V1接口下线。
• 取消自动续费V1接口下线。

2022-10-31

第五十八次正式发布。

本次变更说明如下：

新增支付包年/包月产品订单V3接口，支付包年/包月产品订单 V2接口移至待下线接口。

2022-09-27

第五十七次正式发布。

本次变更说明如下：

• 查询订单列表接口新增请求参数“indirect_partner_id”，用于支持查询云经销商的客户的订单列表。
• 查询订单详情接口新增请求参数“indirect_partner_id”，用于支持查询云经销商的客户的订单详情。
• 查询客户按需资源列表接口新增请求参数“indirect_partner_id”，用于支持查询云经销商的客户按需资源列表。
• 查询订单列表接口新增返回错误码“CBC.99000037”。
• 查询订单详情接口新增返回错误码“CBC.99000037”。
• 查询客户按需资源列表接口新增返回错误码“CBC.99000037”。

2022-08-30

第五十六次正式发布。

本次变更说明如下：

• 创建客户接口新增请求参数“indirect_partner_id”，用于支持创建云经销商的客户列表。
• 查询客户列表接口新增请求参数“indirect_partner_id”，用于支持查询云经销商的客户列表。
• 冻结客户账号接口新增请求参数“indirect_partner_id”，用于支持冻结云经销商的客户列表。
• 解冻客户账号接口新增请求参数“indirect_partner_id”，用于支持解冻云经销商的客户列表。
• 查询客户预算接口新增请求参数“indirect_partner_id”，用于支持查询云经销商的客户预算。
• 设置客户预算接口新增请求参数“indirect_partner_id”，用于支持设置云经销商的客户预算。

2022-08-16

第五十五次正式发布。

本次变更说明如下：

修改“精英服务商”为“云经销商”；修改“云市场”为“云商店”。

2022-08-10

第五十四次正式发布。

本次变更说明如下：

• 创建客户V1接口请求参数“password”的取值范围修改为：“长度[8-32]”。
• 创建客户V2接口请求参数“password”的取值范围修改为：“长度[8-32]”。

2022-08-02

第五十三次正式发布。

本次变更说明如下：

• 退订包年/包月资源接口新增返回错误码“CBC.30010035”。
• 创建客户V1接口新增返回错误码“CBC.50010059”。
• 创建客户V2接口新增返回错误码“CBC.50010059”。

2022-07-19

第五十三次正式发布。

本次变更说明如下：

退订包年/包月资源接口新增说明“您正在退订使用中的资源，请仔细确认资源信息和退款信息。未放入回收站的资源退订后无法恢复，若您要保留资源，仅退订未使用的续费周期，请退订续费周期。”

2022-07-05

第五十二次正式发布。

本次变更说明如下：

查询客户列表接口响应参数“is_frozen”新增枚举值“2：客户账号和资源冻结”，枚举值“1：是”修改为“1：客户账号冻结”。

2022-06-21

第五十一次正式发布。

本次变更说明如下：

• 新增查询云服务类型列表接口，查询云服务类型列表（旧）接口移至待下线接口。
• 新增查询资源类型列表接口，查询资源类型列表（旧）接口移至待下线接口。
• 查询使用量类型列表、支付包年/包月产品订单、查询退款订单的金额详情、查询客户包年/包月资源列表、查询客户按需资源列表接口新增返回响应参数“service_type_name”和“resource_type_name”，用于返回云服务类型名称和资源类型名称。
• 查询订单详情、查询资源包列表接口新增返回响应参数“service_type_name”，用于返回云服务类型名称。

2022-04-12

第五十次正式发布。

本次变更说明如下：

合作伙伴生态交易模式名称变更，“推荐”模式更名为“顾问销售”模式，“垫付”模式更名为“代售”模式。

2022-03-25

第四十九次正式发布。

本次变更说明如下：

取消包年/包月资源自动续费V2接口新增返回错误码“CBC.99003605”。

2022-03-15

第四十八次正式发布。

本次变更说明如下：

• 续订包年/包月资源接口新增返回错误码“CBC.30010036”。
• 设置包年/包月资源自动续费接口新增返回错误码“CBC.99003602”。
• 查询客户用量明细接口文件参数“账单类型”新增枚举值“20：退款-变更”。
• 查询伙伴月度消费账单明细接口文件字段“结算产品类型”描述“11：商务结算”变更为“11：特价申请”。
• 附录新增如何订阅文件章节，伙伴可以在华为云伙伴中心订阅文件。

2022-01-25

第四十七次正式发布。

本次变更说明如下：

• 查询包年/包月产品价格接口新增返回错误码“CBC.0250”。
• 续订包年/包月资源接口新增返回错误码“CBC.30050006”。
• 支付包年/包月产品订单V2接口新增返回错误码“CBC.99003115”。
• 支付包年/包月产品订单V2接口新增返回错误码“CBC.99003156”。
• 支付包年/包月产品订单V1接口新增返回错误码“CBC.99003156”。

2022-01-11

第四十六次正式发布。

本次变更说明如下：

• 创建客户接口错误码“CBC.99000051”描述修改为“该手机号/邮箱已被华为报备，无法创建客户”。
• 创建客户（旧）接口新增错误码“CBC.99000051”。

2021-12-14

第四十五次正式发布。

本次变更说明如下：

续订包年/包月资源接口删除错误码“CBC.99003001”。

2021-11-30

第四十四次正式发布。

本次变更说明如下：

• 申请个人实名认证接口错误码“CBC.99005030”描述修改为“伙伴未开通实名认证功能或者桶鉴权失败”。
• 查询客户用量明细接口的文件参数“周期数”新增说明，用于支持非整数场景。

2021-11-16

第四十三次正式发布。

本次变更说明如下：

续订包年/包月资源接口错误码“CBC.99003016”描述修改为“资源已过期删除或不存在”。

2021-11-02

第四十二次正式发布。

本次变更说明如下：

查询客户用量明细接口的文件参数“资源名称”和“资源标签”新增防注入改造说明，用于保证无注入风险。

2021-10-19

第四十一次正式发布。

本次变更说明如下：

• 新增查询资源包列表 V3接口，查询资源包列表 V2接口移至待下线接口。
• 查询客户包年/包月资源列表接口新增请求参数“expire_time_begin”和“expire_time_end”，用于支持查询指定时间段内失效的资源列表。

2021-09-28

第四十次正式发布。

本次变更说明如下：

• 支付包年/包月产品订单接口新增错误码“CBC.30000010”。
• 查询客户用量明细接口的文件参数“单价单位”新增说明，用以区分线性产品和非线性产品的单价单位。

2021-08-31

第三十九次正式发布。

本次变更说明如下：

• 新增查询客户用量明细接口，调用该接口可查询客户用量明细。
• 查询客户用量明细（旧）移至待下线接口。

2021-08-13

第三十八次正式发布。

本次变更说明如下：

• 下线“申请个人实名认证（旧）”、“申请企业实名认证（旧）”、“申请实名认证变更（旧）”和“退订开通或变更失败的包年/包月产品”接口。
• 查询订单详情接口新增响应参数“user_name”，用于查询订单详情时返回订单创建者名称。

2021-07-13

第三十七次正式发布。

本次变更说明如下：

• 新增查询资源包列表接口，调用该接口可查询客户的资源包列表。
• 新增查询资源包使用量接口，调用该接口可查询客户的资源包使用量。
• 查询伙伴月度消费账单明细接口新增字段“伙伴优惠类型”，并变更“应还金额”计算方式。
• 查询伙伴月度消费账单接口新增响应参数“salePrice”“stepNum” “stepNumMeasureId”“partnerPreferentialType” 用于返回伙伴优惠类型取值为1时的固定单价。

2021-06-15

第三十六次正式发布。

本次变更说明如下：

新增查询订单可用折扣接口，调用该接口可在支付订单时查看可使用的折扣。

2021-04-28

第三十五次正式发布。

本次变更说明如下：

查询伙伴月度消费账单明细接口新增字段“结算金额、伙伴代金券金额、是否退券、现金结算金额、税金”，这些字段亚太地区合作伙伴暂不展示。

2021-02-08

第三十四次正式发布。

本次变更说明如下：

修改查询客户列表响应参数新增“xaccount_id”和“xaccount_type”，用于返回伙伴销售平台的用户标识和合作伙伴销售平台的平台标识；新增“customer_level”，用于返回客户等级。

2021-01-28

第三十三次正式发布。

本次变更说明如下：

新增查询度量单位列表和查询度量单位进制接口。

2020-12-30

第三十二次正式发布。

本次变更说明如下：

• 新增查询伙伴月度消费账单 V2接口，查询伙伴月度消费账单 V1接口移至待下线接口。
• 修改支付包年/包月产品订单接口，新增请求参数“discount_infos”及表 DiscountSimpleInfo，用于支付包年包月订单时查询可使用的折扣。

2020-12-16

第三十一次正式发布。

本次变更说明如下：

修改查询客户用量明细（旧），系统每天12:00~20:00之间（最晚每天24:00前）生成用量明细。

2020-12-01

第三十次正式发布。

本次变更说明如下：

• 新增查询使用量类型列表接口，用于查询使用量类型。
• 新增设置或取消包年/包月资源到期转按需接口，用于查询资源类型。
• 查询订单列表、查询订单详情接口及待下线接口中查询订单列表、查询订单详情的响应参数“discount_type”新增枚举值“610：免单金额”。

2020-11-18

第二十九次正式发布。

本次变更说明如下：

新增查询云服务类型列表（旧）接口，用于查询云服务类型。

新增查询资源类型列表（旧）接口，用于查询资源类型。

新增根据云服务类型查询资源列表接口，可以根据云服务类型查询对应的资源列表。

2020-11-04

第二十八次正式发布。

本次变更说明如下：

• 创建客户接口新增请求参数“include_association_result”，调用时可返回子客户的关联结果。
• 14.1.4.6.12-查询订单的资源开通详情移至待下线接口。

2020-10-21

第二十七次正式发布。

本次变更说明如下：

查询客户按需资源列表接口新增查询参数表1，支持按语种查询；响应参数新增“product_spec_desc”，调用时可返回产品的规格描述。

2020-09-28

第二十六次正式发布。

本次变更说明如下：

• 查询订单详情接口新增响应参数“product_owner_service”和“commercial_resource”。
• 以下接口中“measure_id”参数的默认值由“分”修改为“元”，涉及金额的字段值将同步换算单位为“元”，调用时请确认金额的单位。
  • 查询订单列表
  • 查询订单详情
  • 查询退款订单的金额详情

2020-09-16

第二十五次正式发布。

本次变更说明如下：

• 新增冻结客户账号 V2接口，冻结客户账号 V1接口移至待下线接口。
• 新增解冻客户账号 V2接口，解冻客户账号 V1接口移至待下线接口。
• 新增查询客户预算 V2接口，查询客户预算 V1接口移至待下线接口。
• 新增设置客户预算 V2接口，设置客户预算 V1接口移至待下线接口。
• 查询按需产品价格和查询包年/包月产品价格接口新增错误码CBC.99006006、CBC.99006055、CBC.99006074。

2020-09-02

第二十四次正式发布。

本次变更说明如下：

• 新增查询退款订单的金额详情 V2接口，查询退款订单的金额详情 V1接口移至待下线接口。
• 新增查询客户包年/包月资源列表 V2接口，查询客户包年/包月资源列表 V1接口移至待下线接口。
• 新增设置包年/包月资源自动续费 V2接口，设置包年/包月资源自动续费（已废弃） V1接口移至待下线接口。
• 新增取消包年/包月资源自动续费 V2接口，取消包年/包月资源自动续费（已废弃） V1接口移至待下线接口。
• 新增查询客户按需资源列表 V2接口，查询客户按需资源列表 V1接口移至待下线接口。

2020-06-30

第二十三次正式发布。

本次变更说明如下：

• 新增查询订单列表 V2接口，查询订单列表 V1接口移至待下线接口。
• 新增查询订单详情 V2接口，查询订单详情 V1接口移至待下线接口。
• 新增支付包年/包月产品订单 V2接口，支付包年/包月产品订单（旧） V1接口移至待下线接口。
• 新增取消待支付订单 V2接口，取消待支付订单 V1接口移至待下线接口。
• 新增续订包年/包月资源 V2接口，续订包年/包月资源 V1接口移至待下线接口。
• 新增退订包年/包月资源 V2接口，退订包年/包月资源 V1接口移至待下线接口。

2020-06-17

第二十二次正式发布。

本次变更说明如下：

新增校验客户注册信息 V2接口，校验客户注册信息（旧） V1接口移至待下线接口。

新增发送验证码 V2接口，14.1.2.1.2-发送验证码（旧） V1接口移至待下线接口。

2020-06-03

第二十一次正式发布。

本次变更说明如下：

新增申请个人实名认证 V2接口，12.1.2.2.1-申请个人实名认证（旧） V1接口移至待下线接口。

新增申请企业实名认证 V2接口，12.1.2.2.2-申请企业实名认证（旧） V1接口移至待下线接口。

新增申请实名认证变更 V2接口，12.1.2.2.3-申请实名认证变更（旧） V1接口移至待下线接口。

新增查询实名认证审核结果 V2接口，查询实名认证审核结果（旧） V1接口移至待下线接口。

新增查询客户列表 V2接口，响应参数新增account_managers，查询实名认证审核结果（旧） V1接口移至待下线接口。

2020-05-20

第二十次正式发布。

本次变更说明如下：

新增创建客户 V2接口，下线创建客户（旧）接口。

2020-04-22

第十九次正式发布。

本次变更说明如下：

新增查询按需产品价格和查询包年/包月产品价格。

下线 根据产品规格查询价格（旧）接口。

2020-03-25

第十八次正式发布。

本次变更说明如下：

新增查询发票列表。

2020-01-15

第十七次正式发布。

本次变更说明如下：

创建客户（旧）请求参数新增cooperationType字段。

发送验证码的状态码修改CBC.4004和CBC.4005的描述。

2019-12-18

第十六次正式发布。

本次变更说明如下：

续订包年/包月资源新增错误码“CBC.3016”，该错误码表示存在过期资源。

2019-11-20

第十五次正式发布。

本次变更说明如下：

• 新增冻结客户账号。
• 新增解冻客户账号。
• 查询客户列表（旧）新增响应参数“isFrozen”，用来标识客户是否处于冻结状态。
• 设置客户预算新增请求参数“cancelPartnerFrozen”，用来标识是否在设置客户预算的同时解除客户账号冻结。
• 查询伙伴月度消费账单明细新增“券后消费金额”和“应还金额”文件字段。

2019-10-23

第十四次正式发布。

本次变更说明如下：

新增管理工单。

2019-09-25

第十三次正式发布。

本次变更说明如下：

• 校验客户注册信息新增响应参数“uplimit”，该参数用来标识发送验证码次数是否达到上限。
• 新增12.1.2.2.3-申请实名认证变更（旧）。

2019-09-17

第十二次正式发布。

本次变更说明如下：

• 查询客户列表（旧）新增响应参数“customerType”，该参数用来标识客户类型。
• 新增12.1.2.2.1-申请个人实名认证（旧）。
• 新增12.1.2.2.2-申请企业实名认证（旧）。
• 新增查询实名认证审核结果（旧）。
• 同步客户实名认证信息（已废弃）接口移至待下线接口。

2019-09-04

第十一次正式发布。

本次变更说明如下：

• 新增查询退款订单的金额详情接口。
• 查询伙伴月度消费账单接口的响应消息新增“periodType”、“periodNum”和“categoryCode”参数。

2019-08-21

第十次正式发布。

本次变更说明如下：

• 新增14.1.4.6.12-查询订单的资源开通详情接口。
• 查询客户用量明细（旧）接口的文件字段新增“项目ID”和“项目标签”。

2019-08-14

第九次正式发布。

本次变更说明如下：

• 查询客户包年/包月资源列表新增“CBC.0100”错误码。
• 将查询客户列表（旧）接口移至待下线接口，对应的新接口请参见查询客户列表（旧）。

2019-07-24

第八次正式发布。

本次变更说明如下：

• 查询订单详情的响应参数表5新增“categoryCode”参数。
• 查询伙伴月度消费账单明细的3新增“费用类别”字段。
• “查询客户信用额度”的接口名称变更为查询客户预算。
• “设置客户信用额度”的接口名称变更为设置客户预算。

2019-07-10

第七次正式发布。

本次变更说明如下：

• 查询订单列表：
  • 响应参数表2新增“currencyOfficial”，“amountInfo”，“serviceType”参数；
  • 响应参数新增表3和表4；
  • 状态码新增“CBC.0100”，“CBC.0101”，“CBC.0151”，“CBC.0155”。
• 查询订单详情：
  • 表1新增“offset”，“limit”参数；
  • 响应参数表4新增“currencyOfficial”，“amountInfo”，“currencyType”，“serviceType”参数；
  • 响应参数新增表5，表6和表7。
  • 状态码新增“CBC.0100”，“CBC.0101”，“CBC.0151”，“CBC.0155”。
• 创建客户（旧）新增状态码“CBC.7254”。

2019-06-26

第六次正式发布。

本次变更说明如下：

• 创建客户（旧）的请求参数新增“isCloseMarketMs”参数。

2019-06-14

第五次正式发布。

本次变更说明如下：

• 新增管理客户用量。
• 新增状态码。
• 新增错误码。

2019-05-22

第四次正式发布。

本次变更说明如下：

• 将管理客户、管理交易、管理账单的子章节按照合作伙伴运营能力API简介（转售交易模式）中的业务场景进行调整。
• 新增查询订单详情。
• 新增支付包年/包月产品订单。
• 新增取消待支付订单。
• 新增查询客户按需资源列表。

2019-05-10

第三次正式发布。

本次变更说明如下：

• 新增2.1.2.1-同步客户实名认证信息。
• 新增14.1.1.2.1-根据产品规格查询价格（旧）。
• 新增查询订单列表。
• 新增查询客户包年/包月资源列表。
• 新增续订包年/包月资源。
• 新增退订包年/包月资源。
• 新增设置包年/包月资源自动续费。
• 新增取消包年/包月资源自动续费。

2019-04-29

第二次正式发布。

本次变更说明如下：

合作伙伴运营能力API简介（转售交易模式）增加待上线的API列表及描述。

2019-04-13

第一次正式发布。

2019-03-22