文档修订记录

第五十一次正式发布。

本次变更说明如下：

查询成本数据V4接口维度分组条件新增分拆项：“SPLIT_ITEM_NAME：分拆项”；

成本类型为“ORIGINAL_COST：原始成本”时，不支持按“SPLIT_ITEM_NAME：分拆项”维度查询。

2024-3-29

第五十次正式发布。

本次变更说明如下：

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

2024-2-23

第四十九次正式发布。

本次变更说明如下：

• 续订包年/包月资源 V2接口新增错误码“CBC.99000092 - 订购周期校验失败。”
• 取消待支付订单V1接口下线。

2024-1-25

第四十八次正式发布。

支付包年/包月产品订单（旧）v1接口下线。

2023-12-26

第四十七次正式发布。

本次变更说明：

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

2023-10-25

第四十六次正式发布。

本次变更说明如下：”

• 支付包年/包月产品订单接口新增错误码“CBC.99000088：抱歉，支付处理中，请勿重复操作。”。
• 查询资源消费记录和查询资源详单接口，请求和响应参数“charge_mode”新增枚举“11：节省计划”，请求和响应参数“bill_type”新增枚举“23：消费-节省计划抵扣”。
• 查询汇总账单接口响应参数“promotion_type”新增枚举“611：节省计划”。
• 查询优惠券列表接口响应参数“cycleType”新增枚举“11：节省计划”。

2023-06-29

第四十五次正式发布。

本次变更说明如下：

• 查询资源详单接口新增响应参数“pre_order_id”、“az_code_infos“和“az_code“，用于查询原订单ID、可用区信息列表和可用区编码。

• 新增API调用授权（客户）的章节，客户账号调用API需要经过授权，可通过用户中心统一身份认证修改权限进行授权。
• 查询包年/包月资源的续订金额接口新增错误码“CBC.30050013：该产品不支持续费”。

2023-4-18

第四十四次正式发布。

本次变更说明如下：

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

2023-3-30

第四十三次正式发布。

本次变更说明如下：

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

2023-2-9

第四十二次正式发布。

本次变更说明如下：

• 新增查询资源包使用明细接口，可查询客户的资源包使用明细。
• 查询资源详单和查询资源消费记录接口新增返回响应参数：

  "sub_service_type_code"、"sub_service_type_name"、"sub_resource_type_code"、"sub_resource_type_name"、"sub_resource_id"和"sub_resource_name"。

2022-12-27

第四十一次正式发布。

本次变更说明如下：

• 查询成本数据接口修改请求参数“groupby”的取值范围为：“最大个数：2”。
• 查询资源消费记录接口新增返回响应参数“formula”。

2022-11-29

第四十次正式发布。

本次变更说明如下：

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

2022-11-17

第三十九次正式发布。

本次变更说明如下：

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

2022-09-27

第三十八次正式发布。

本次变更说明如下：

查询资源详单接口新增响应参数“root_resource_id”、“parent_resource_id”、“trade_id”和“product_spec_desc”。

2022-09-13

第三十七次正式发布。

本次变更说明如下：

查询资源消费记录接口响应参数“feeSourceOperation”修改枚举值描述为“20：退款-变更(整机)”和新增枚举值“21： 退款-变更(降配)”。

2022-08-30

第三十六次正式发布。

本次变更说明如下：

新增查询成本数据接口，调用该接口客户可在自建平台查询成本分析数据。

2022-08-16

第三十五次正式发布。

本次变更说明如下：

修改“云市场”为“云商店”。

2022-08-10

第三十四次正式发布。

本次变更说明如下：

• 退订包年/包月资源接口新增返回错误码“CBC.30010035”。

2022-07-19

第三十三次正式发布。

本次变更说明如下：

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

2022-07-05

第三十二次正式发布。

本次变更说明如下：

• 查询资源详单接口新增返回响应参数“period_type”，用于支持查看资源的详细周期类型。
• 新增查询云服务类型列表接口，查询云服务类型列表（旧）接口移至待下线接口。
• 新增查询资源类型列表接口，查询资源类型列表（旧）接口移至待下线接口。
• 查询使用量类型列表、支付包年/包月产品订单、查询退款订单的金额详情、查询客户包年/包月资源列表、查询汇总账单接口新增返回响应参数“service_type_name”和“resource_type_name”，用于返回云服务类型名称和资源类型名称。
• 查询资源详单、查询资源消费记录接口新增返回响应参数“cloud_service_type_name”和“resource_type_name”，用于返回云服务类型名称和资源类型名称。
• 查询订单详情、查询资源包列表接口新增返回响应参数“service_type_name”，用于返回云服务类型名称。

2022-04-12

第三十一次正式发布。

本次变更说明如下：

• 合作伙伴生态交易模式名称变更，“推荐”模式更名为“顾问销售”模式。
• 查询账户余额V2接口响应参数“account_type”新增枚举值“7：保证金”。

2022-03-25

第三十次正式发布。

本次变更说明如下：

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

2022-03-15

第二十九次正式发布。

本次变更说明如下：

查询资源详单接口参数“bill_type”新增枚举值“20：退款-变更”。

2022-02-15

第二十八次正式发布。

本次变更说明如下：

• 续订包年/包月资源接口新增返回错误码“CBC.30010036”。
• 设置包年/包月资源自动续费接口新增返回错误码“CBC.99003602”。
• 查询资源消费记录（旧）接口响应参数“feeSourceOperation”新增枚举值“19：变更-增配”和“20：变更-减配”。

2022-01-25

第二十七次正式发布。

本次变更说明如下：

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

2022-01-11

第二十六次正式发布。

本次变更说明如下：

• 查询资源详单接口新增请求参数“statistic_type”和响应参数“bill_date”，用于支持查询按天统计的资源详单。
• 续订包年/包月资源接口删除错误码“CBC.99003001”。

2021-11-30

第二十五次正式发布。

本次变更说明如下：

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

2021-11-02

第二十四次正式发布。

本次变更说明如下：

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

2021-09-28

第二十三次正式发布。

本次变更说明如下：

• 支付包年/包月产品订单接口新增错误码“CBC.30000010”。
• 查询资源消费记录接口的响应参数“unit”新增说明，用以区分线性产品和非线性产品的单价单位。

2021-08-31

第二十二次正式发布。

本次变更说明如下：

查询套餐内使用量移至待下线接口。

2021-08-10

第二十一次正式发布。

本次变更说明如下：

查询订单详情接口新增响应参数“user_name”，用于查询订单详情时返回订单创建者名称。

2021-07-13

第二十次正式发布。

本次变更说明如下：

• 新增查询资源包列表接口，调用该接口可查询客户的资源包列表。
• 新增查询资源包使用量接口，调用该接口可查询客户的资源包使用量。

2021-06-15

第十九次正式发布。

本次变更说明如下：

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

2021-04-28

第十八次正式发布。

本次变更说明如下：

• 修改查询资源详单，新增“sku_code”和“region_name 字段”，用于调用接口时响应消息中返回产品的SKU属性和云服务区名称。

• 修改查询资源消费记录 ，请求参数新增“bill_date_begin”和“bill_date_end” 用于调用接口时可以在账期内自定义查询消费记录的具体日期；响应参数新增“region_name”用以返回返回云服务区名称。

2021-01-13

第十七次正式发布。

本次变更说明如下：

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

• 修改“查询资源消费记录” V2接口：查询参数charge_mode由必选改为可选；请求与响应参数bill_type新增枚举“17：消费-保底差额”。

2020-12-25

第十六次正式发布。

本次变更说明如下：

修改支付包年/包月产品订单接口，新增请求参数“discount_infos”及表 DiscountSimpleInfo，用于支付包年包月订单时查询可使用的折扣。

2020-12-16

第十五次正式发布。

本次变更说明如下：

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

2020-11-18

第十四次正式发布。

本次变更说明如下：

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

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

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

2020-11-04

第十三次正式发布。

本次变更说明如下：

查询资源消费记录接口新增请求及响应参数“trade_id”，用以标识交易ID或订单ID。

2020-10-21

第十二次正式发布。

本次变更说明如下：

• 查询资源消费记录接口新增查询参数“method”和“sub_customer_id”。
• 查询资源详单接口新增查询参数“method”和“sub_customer_id”，响应参数新增“customer_id”。

新增以上参数，支持查询账单时只查询客户自己或某企业子客户的数据。

2020-09-28

第十一次正式发布。

本次变更说明如下：

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

2020-09-16

第十次正式发布。

本次变更说明如下：

• 修改查询资源消费记录接口，响应消息中表3新增参数“enterprise_project_name”和“product_spec_desc”。
• 查询按需产品价格和查询包年/包月产品价格接口新增错误码CBC.99006006、CBC.99006055、CBC.99006074。

2020-09-02

第九次正式发布。

本次变更说明如下：

新增查询账户余额 V2接口。

2020-08-12

第八次正式发布。

本次变更说明如下：

• 新增查询退款订单的金额详情 V2接口。
• 新增查询客户包年/包月资源列表 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接口，下线查询资源消费记录（旧）接口。
• 上线查询资源详单 V2接口，下线查询资源详单（旧）接口。

2020-04-22

第五次正式发布。

本次变更说明如下：

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

2020-03-25

第四次正式发布。

本次变更说明如下：

新增查询套餐内使用量。

2020-01-17

第三次正式发布。

本次变更说明如下：

新增查询发票列表。

2020-01-15

第二次正式发布。

本次变更说明如下：

查询汇总账单的响应参数新增total_amount、debt_amount、coupon_amount、cashcoupon_amount、storedcard_amount、debit_amount、credit_amount、measure_id。

2019-12-25

第一次正式发布。

2019-09-17