更新时间:2022-04-25 GMT+08:00
分享

查询客户月度消费账单

功能介绍

合作伙伴可查询客户的消费汇总账单,消费按月汇总。

消费汇总数据仅包含前一天24点前的数据。

该接口即将下线,“查询客户月度消费账单”接口请参考查询客户月度消费账单

Web UI

合作伙伴可以登录伙伴中心查看客户的消费汇总数据并导出客户的消费清单。

  1. 在伙伴中心左侧的导航栏中选择“客户业务 > 客户消费”。
  2. 单击“消费汇总”页签。
  3. 根据需要设置查询条件,查看客户的消费汇总信息。

    伙伴可以根据“消费时间”、“客户名称”、“客户经理姓名”以及“关联类型”查询客户的消费汇总信息。
    • 查看客户的消费金额、本月已优惠金额、退款金额、调账金额等。

      • 单击“本月已优惠”对应的金额值,可以进入“优惠详情”页面,查看本月优惠的详细信息。
      • 伙伴可以选择“按支付方式”查看消费信息,也可以选择“按关联类型”查看消费信息。
    • 查看客户的账单。
      • 消费账单

        选择“客户消费汇总”页签,可以查看客户相应月份的所有消费账单。

      • 退款账单

        选择“客户退款汇总”页签,可以查看客户相应月份的所有退款账单。

      • 调账账单

        选择“客户调账汇总”页签,可以查看客户相应月份的所有调账账单。

  4. 导出消费汇总清单。

    • 导出客户消费清单

      单击“导出 > 导出客户消费清单”,填写导出条件后单击“确定”,页面提示“导出任务创建成功”。

    • 查看导出记录
      1. 单击“导出 > 查看导出记录”,进入“导出记录”页面。
      2. 单击“操作”列的“下载”,下载并查看导出状态为“已完成”的消费清单。

REST API

伙伴在伙伴销售平台查询所有代售类客户或者某个代售类客户的消费汇总账单,消费按月汇总。每天刷新一次,更新前一天的数据。

该接口用于合作伙伴查询其代售类客户在华为的消费情况,如果输入某个客户ID,则是查询单个客户的,否则是查询该伙伴下所有使用伙伴拨款消费的客户的消费记录(包括退订记录)。

该接口只允许使用合作伙伴AK/SK或者Token调用。

  1. 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。

    limit

    Integer

    [1-100]

    每页个数。

    默认值为10。

    bill_type

    String

    最大长度:1

    账单类型。

    • 0:消费
    • 1:退订
    • 2:华为核销
  1. 请求消息

    请求参数

    无。

    请求示例

    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-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    参数类型

    描述

    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"
    		}]
    	}]
    }

  1. 状态码
    • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
    • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

    状态码

    描述

    CBC.5001

    非合作伙伴。

    CBC.0999

    其他错误。

    CBC.0151

    访问拒绝。

    CBC.0100

    参数错误。

分享:

    相关文档

    相关产品

关闭导读