文档首页> 合作伙伴中心> API参考> 待下线接口> 管理账单> 查询客户月度消费账单(旧)
更新时间:2022-04-25 GMT+08:00
分享

查询客户月度消费账单(旧)

功能介绍

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

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

消费汇总数据仅包含前一天24点前的数据,最终消费数据以消费明细为准。

Web UI

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

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

    伙伴可以根据“消费时间”、“客户名称”、“业务员名称”以及“支付方式”查询客户的消费汇总信息。
    • 在“月度消费统计”区域,可以查看客户的消费金额、本月已优惠金额、退订金额、核销返还金额等。

      单击“本月已优惠”对应的金额值,可以进入“优惠详情”页面,查看本月优惠的详细信息。

    • 查看客户的账单。
      • 消费账单

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

      • 退订账单

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

      • 核销返还账单

        选择“华为核销返还”页签,可以查看客户相应月份的所有核销返还账单。

  4. 导出消费汇总清单。

    • 导出客户消费清单

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

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

REST API

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

用于合作伙伴查询其代售类客户在华为的消费情况,用于合作伙伴自身BSS系统的按需扣费或者合作伙伴和其代售类客户消费记录的查看。

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

  1. URI

    GET /v1.0/{partner_id}/partner/account-mgr/bill/detail

    参数说明请参见表1-1

    表1 URI参数说明

    参数

    是否必选

    取值范围

    描述

    partner_id

    最大长度:64

    合作伙伴ID(华为分配)。

    获取方法请参见如何获取合作伙伴ID(partner_id)

  1. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    customerId

    String

    最大长度:64

    客户帐号ID。

    period

    String

    最大长度:256

    消费时间。

    格式固定为YYYY-MM。

    示例:2017-08

    cloudServiceTypeCode

    String

    最大长度:256

    云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。

    payMethod

    String

    [0|1]

    消费类型。

    • 0:表示包年/包月
    • 1:表示按需
    • 10:预留实例

    pageNo

    Integer

    大于等于1的整数

    页码。

    默认值为1。

    pageSize

    Integer

    [1-100]

    每页个数。

    默认值为10。

    请求示例

    GET https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/account-mgr/bill/detail?period=2017-08 HTTP/1.1
    Content-Type: application/json
    X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

  1. 响应消息

    响应参数

    参数

    参数类型

    描述

    error_code

    String

    状态码。

    具体请参考4

    error_msg

    String

    错误描述信息。

    billSums

    List<BillSumInfo>

    账单记录,具体参考表2

    表2 BillSumInfo

    参数

    参数类型

    描述

    customerId

    String

    客户ID。

    resourceTypeCode

    String

    资源类型编码,例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。

    regionCode

    String

    云服务区,该字段预留,先不使用。

    cloudServiceTypeCode

    String

    云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。

    period

    String

    消费统计的时期。

    格式为YYYY-MM。

    示例:2017-08

    payMethod

    String

    消费类型。

    • 0:表示包年/包月
    • 1:表示按需
    • 10:预留实例

    consumeAmount

    Bigdecimal

    消费的金额,即从客户账户实际扣除的金额。

    debt

    Bigdecimal

    欠费金额,即从客户账户扣费的时候,客户账户金额不足,欠费的金额。

    discount

    Bigdecimal

    折扣金额。

    measureId

    Integer

    金额单位。

    • 1:元
    • 2:角
    • 3:分

    currency

    String

    货币编码。

    目前只支持CNY。

    accountDetails

    List<BalanceTypeDeductSum>

    按不同账户消费类型和付费方式区分的支付总金额。

    具体请参见表3

    表3 BalanceTypeDeductSum

    参数

    参数类型

    描述

    balanceTypeId

    String

    账户类型。

    • BALANCE_TYPE_DEBIT:余额
    • BALANCE_TYPE_CREDIT:信用
    • BALANCE_TYPE_BONUS:奖励
    • BALANCE_TYPE_COUPON:代金券
    • BALANCE_TYPE_DEBIT_RATE:按比例扣减奖励金的余额
    • BALANCE_TYPE_DEBT:欠款账户
    • BALANCE_TYPE_FOREGIFT:保证金账户,目前已经不用,始终为0,可以不对客户展示。
    • BALANCE_TYPE_BE_AVAILABLE:可拨款账户,用于合作伙伴给客户拨款的时候使用,只有合作伙伴有这个账户类型,合作伙伴的客户没有这个账户。
    • BALANCE_TYPE_BE_OTHER:其他账户,目前预留,始终为0,可以不对客户展示。
    • BALANCE_TYPE_STORED_VALUE_CARD:储值卡消费
    • BALANCE_TYPE_RCASH_COUPON:现金券消费
    • WRITEOFFDEBT:华为核销

    deductAmount

    bigdecimal

    支出金额。

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time
    
    {
      "billSums": [
        {
          "customerId": "c8c346e9d924403c9e87c1cfe9b0b13f",
          "resourceTypeCode": "hws.resource.type.vm",
          "regionCode": null,
          "cloudServiceTypeCode": "hws.service.type.ecs",
          "period": "2017-08",
          "payMethod": "1",
          "consumeAmount": 100,
          "debt": 0,
          "discount": 100,
          "measureId": 3,
          "currency": "CNY",
          "accountDetails": [
            {
              "balanceTypeId": "BALANCE_TYPE_DEBIT",
              "deductAmount": 0
            },
            {
              "balanceTypeId": "BALANCE_TYPE_CREDIT",
              "deductAmount": 0
            },
            {
              "balanceTypeId": "BALANCE_TYPE_BONUS",
              "deductAmount": 0
            },
            {
              "balanceTypeId": "BALANCE_TYPE_COUPON",
              "deductAmount": 0
            }
          ]
        },
        {
          "customerId": "c8c346e9d924403c9e87c1cfe9b0b13f",
          "resourceTypeCode": "hws.resource.type.vm",
          "regionCode": null,
          "cloudServiceTypeCode": "hws.service.type.ecs",
          "period": "2017-08",
          "payMethod": "0",
          "consumeAmount": 100,
          "debt": 0,
          "discount": 100,
          "measureId": 3,
          "currency": "CNY",
          "accountDetails": [
            {
              "balanceTypeId": "BALANCE_TYPE_DEBIT",
              "deductAmount": 0
            },
            {
              "balanceTypeId": "BALANCE_TYPE_CREDIT",
              "deductAmount": 0
            },
            {
              "balanceTypeId": "BALANCE_TYPE_BONUS",
              "deductAmount": 0
            },
            {
              "balanceTypeId": "BALANCE_TYPE_COUPON",
              "deductAmount": 0
            },
            {
              "balanceTypeId": "BALANCE_TYPE_DEBIT_RATE",
              "deductAmount": 0
            }
          ]
        }
      ],
      "error_code": "CBC.0000",
      "error_msg": "success"
    }

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

    状态码

    描述

    CBC.0000

    成功。

    CBC.5001

    非合作伙伴。

    CBC.5002

    合作伙伴的客户不存在。

    CBC.5004

    无对该客户的操作权限。

    CBC.0999

    其他错误。

分享:

    相关文档

    相关产品

关闭导读