查询伙伴月度消费账单
Web UI
伙伴可以登录合作伙伴中心查询伙伴月度消费账单。
- 在伙伴中心顶部的导航栏中选择“销售 > 伙伴账务 > 伙伴账单”。
- 在“应还金额”区域，可以查看到伙伴的应还金额，包括“本月未还金额”和“往期未还金额”。
REST API
伙伴在伙伴销售平台基于伙伴月度消费账单，展示伙伴每月消费数据，并与华为进行结算。
- 该接口只允许使用合作伙伴账号AK/SK或者Token调用。
- 北京时间每月5号12:00前会生成上个月伙伴账单。
- URI
GET /v1.0/{partner_id}/partner/account-mgr/postpaid-bill-summary
参数说明请参见下表。
表1 路径参数 参数
是否必选
取值范围
描述
partner_id
是
最大长度：64
合作伙伴ID（华为分配）。
获取方法请参见如何获取合作伙伴ID（partner_id）。
表2 查询参数 参数
是否必选
参数类型
取值范围
描述
consume_month
是
String
最大长度：10
查询月份，yyyy-MM格式。
- 请求消息
无。
请求示例
GET https://bss-intl.myhuaweicloud.com/v1.0/{partner_id}/partner/account-mgr/postpaid-bill-summary?consume_month=2019-01 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
- 响应消息
参数
是否必选
参数类型
取值范围
描述
error_code
否
String
最大长度：16
状态码，具体请参考4。只有失败才会返回这个参数。
error_msg
否
String
最大长度：1024
错误描述信息。只有失败才会返回这个参数。
billCycle
否
String
最大长度：10
结算周期，只有成功才返回这个参数。表示某年某月的账单汇总。
格式：YYYY-MM
creditDebtAmount
否
BigDecimal
-
账单金额，该金额已经计算过伙伴的特殊商务的优惠比例。只有成功才返回这个参数。不含税。
consumeAmount
否
BigDecimal
-
消费金额，该金额已经计算过伙伴的特殊商务的优惠比例。只有成功才返回这个参数。不含税。
writeoffdebt
否
BigDecimal
-
核销返还金额（负值），该金额已经计算过伙伴的特殊商务的优惠比例。只有成功才返回这个参数。不含税。
unsubscribeAmount
否
BigDecimal
-
退订返还金额（负值），该金额已经计算过伙伴的特殊商务的优惠比例。只有成功才返回这个参数。不含税。
measureId
否
Integer
-
单位，只有成功才返回这个参数。
1：元
currency
否
String
最大长度：8
只有成功才返回这个参数。
美金：USD
taxAmount
否
BigDecimal
-
税的金额，针对creditDebtAmount字段的税的金额，目前该字段预留，暂时不返回值。
unclearedAmount
否
BigDecimal
-
本账期未结清金额，该金额已经计算过伙伴的特殊商务的优惠比例。只有成功才返回这个参数。
dueDate
否
String
最大长度：32
还款截止日期，只有成功才返回这个参数。
billList
否
List<PostpaidBillInfo>
-
账单列表，具体参考表3，只有成功才返回这个参数。
表3 PostpaidBillInfo 参数
是否必选
参数类型
取值范围
描述
billType
是
String
最大长度：1
账单类型：
- 0：消费
- 1：退订
- 2：华为核销
cloudServiceTypeCode
是
String
最大长度：100
云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。
resourceTypeCode
是
String
最大长度：100
资源类型编码，例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。
payMethod
是
String
最大长度：1
计费模式：
0：包年/包月；
1：按需；
2：预留实例-订购；
3：预留实例-按时计费。
creditDebtAmount
是
BigDecimal
-
子客户成交/退订/返还金额（含券含卡，劵包含代金券和现金券，卡包含储值卡。暂时不支持现金券和储值卡）。
对于billType=1、2的账单，该金额为负值。
customerAmountDue
是
BigDecimal
-
子客户成交/退订/返还金额（不含券不含卡，劵包含代金券和现金券，卡包含储值卡。暂时不支持现金券和储值卡）。
对于billType=1、2的账单，该金额为负值。
settlementType
是
Integer
-
产品结算类型：
0：普通商品；
1：促销商品；
2：混托；
5：储值卡；
6：云商店；
7：竞价实例；
8：FCS（预留）。
partnerRatio
否
Bigdecimal
-
伙伴优惠比例。仅partnerPreferentialType为0时存在。
partnerAmount
是
Bigdecimal
-
伙伴应还/退还金额。
对于billType=1、2的账单，该金额为负值。
periodType
否
Integer
-
包年/包月单位。
0：包天
1：包周
2：包月
3：包年
periodNum
否
Integer
-
包年/包月数量。
categoryCode
否
String
64
产品分类编码。
salePrice
否
BigDecimal
-
固定单价。
仅partnerPreferentialType为1时存在。
stepNum
否
Integer
-
固定单价步长。
仅partnerPreferentialType为1时存在。
stepNumMeasureId
否
Integer
-
固定单价步长单位。
仅partnerPreferentialType为1时存在。
partnerPreferentialType
否
Integer
[0-1]
伙伴优惠类型。
- 0：产品折扣
- 1：固定单价，如果不出现，默认为产品折扣
响应示例
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "billCycle": "2019-01", "creditDebtAmount": 22500, "consumeAmount": 22500, "writeoffdebt": 0, "unsubscribeAmount": 0, "measureId": 1, "currency": "USD", "taxAmount": null, "unclearedAmount": 10, "dueDate": "2019-02-15", "billList": [ { "billType": "0", "cloudServiceTypeCode": "hws.service.type.kms", "resourceTypeCode": "hws.resource.type.dev.codehub", "payMethod": "1", "creditDebtAmount": 30000, "customerAmountDue": 30000, "settlementType": 0, "partnerRatio": 0.75, "partnerAmount": 22500, "periodType":3, "periodNum":1, "categoryCode": "hws.resource.storage1.evs", "salePrice": null, "stepNum": null, "stepNumMeasureId": null, "partnerPreferentialType": 0 } ] }
