查询客户月度消费账单
Web UI
合作伙伴可以登录伙伴中心查看客户的消费汇总数据并导出客户的消费清单。
REST API
伙伴在伙伴销售平台查询所有代售类客户或者某个代售类客户的消费汇总账单,消费按月汇总。每天刷新一次,更新前一天的数据。
该接口用于合作伙伴查询其代售类客户在华为的消费情况,如果输入某个客户ID,则是查询单个客户的,否则是查询该伙伴下所有使用伙伴拨款消费的客户的消费记录(包括退订记录)。
该接口只允许使用合作伙伴AK/SK或者Token调用。
- URI
GET /v1.0/{partner_id}/partner/account-mgr/subcustomer-bills
参数说明请参见下表。
表1 路径参数 参数
是否必选
取值范围
描述
partner_id
是
最大长度:64
合作伙伴ID(华为分配)。
获取方法请参见如何获取合作伙伴ID(partner_id)。
表2 查询参数 参数
是否必选
参数类型
取值范围
描述
customerId
否
String
最大长度:64
客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。
此参数不携带或携带值为空时,不作为筛选条件;携带值为空串时,作为筛选条件。
period
是
String
最大长度:256
消费时间。
格式固定为YYYY-MM。
示例:2018-08
cloudServiceTypeCode
否
String
最大长度:256
云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。
此参数不携带或携带值为空时,不作为筛选条件;携带值为空串时,作为筛选条件。
payMethod
否
String
[0|1]
消费类型。
- 0:表示包年/包月
- 1:表示按需。
此参数不携带或携带值为空时,不作为筛选条件;携带值为空串时,作为筛选条件。
offset
否
Integer
大于等于1的整数
页码。
默认值为1。
此参数不携带或携带值为空或携带值为null时,取值为1;不支持携带值为空串。
limit
否
Integer
[1-100]
每页个数。
默认值为10。
此参数不携带或携带值为空或携带值为null时,取值为10;不支持携带值为空串。
bill_type
否
String
最大长度:1
账单类型。
- 0:消费
- 1:退订
- 2:华为核销
此参数不携带或携带值为空时,不作为筛选条件;携带值为空串时,作为筛选条件。
- 请求消息
无。
请求示例
GET https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/account-mgr/subcustomer-bills?period=2018-08 HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
- 响应消息
参数
参数类型
描述
error_code
String
状态码。
具体请参考4。
error_msg
String
错误描述信息。
count
Integer
总记录数。
billSums
List<BillSumInfo>
账单记录,具体参考表3。
表3 BillSumInfo 参数
参数类型
描述
customerId
String
客户ID。
cloudServiceTypeCode
String
云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。
billType
String
费用类型。
0:消费;
1:退订;
2:华为核销。
payMethod
String
消费类型。
- 0:表示包年/包月;
- 1:表示按需。
amount
Bigdecimal
消费的金额,即从客户账户实际扣除的金额。
对于billType=1或者2的账单,该金额为负值。
debtAmount
Bigdecimal
欠费金额,指从客户账户扣费的时候,客户账户金额不足,欠费的金额,华为核销或者退订的时候没有该字段。
writeoffDebtAmount
Bigdecimal
核销欠款,华为核销或者退订的时候没有该字段。
discountAmount
Bigdecimal
折扣金额,华为核销或者退订的时候没有该字段。
measureId
Integer
金额单位。
- 1:元;
- 2:角;
- 3:分
currency
String
货币编码。
目前只支持CNY。
accountDetails
List<BalanceTypeDeductSum>
按不同账户消费类型和付费方式区分的支付总金额。
具体请参见表4。
表4 BalanceTypeDeductSum 参数
参数类型
描述
balanceTypeId
String
账户类型。
- BALANCE_TYPE_DEBIT:余额
- BALANCE_TYPE_CREDIT:信用
- BALANCE_TYPE_BONUS:奖励
- BALANCE_TYPE_COUPON:代金券BALANCE_TYPE_RCASH_COUPON 现金券。
- BALANCE_TYPE_STORED_VALUE_CARD:储值卡消费
amount
bigdecimal
金额。
对于billType=1或者2的账单,该金额为负值。
billType
String
费用类型。
0:正常;
1:退订;
2:华为核销。
响应示例
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "count": 0, "billSums": [{ "customerId": "c8c346e9d924403c9e87c1cfe9b0b13f", "cloudServiceTypeCode": "hws.service.type.ecs", "billType": "0", "payMethod": "1", "amount": 56, "debtAmount": 0, "writeoffDebtAmount": 0, "discountAmount": 0, "measureId": 1, "currency": "CNY", "accountDetails": [{ "balanceTypeId": "BALANCE_TYPE_DEBIT", "amount": 56, "billType": "1" }] }] }