文档首页> 合作伙伴中心> API参考> 管理账单> 管理伙伴账单> 查询伙伴月度消费账单明细
更新时间:2024-02-05 GMT+08:00

查询伙伴月度消费账单明细

功能介绍

伙伴可以查询伙伴月度消费账单明细。

伙伴在伙伴中心查询伙伴月度消费账单明细请参见这里

文件方式

伙伴在华为云伙伴中心订阅“子客户用量明细级伙伴账单”,如何订阅文件请参见这里。基于该账单,伙伴销售平台对客户进行批价,生成客户账单明细;同时伙伴可与华为云完成对账。

  1. 文件获取地址

    https://bucketname.obs.Endpoint.myhuaweicloud.com/customerBill/filename

    表1 参数说明

    参数

    描述

    bucketname

    OBS桶名称。仅支持使用在华为云香港区域购买的OBS桶。如何创建桶请参见创建桶

    说明:

    伙伴账号无法购买资源,可以使用任意客户账号购买OBS桶资源

    Endpoint

    指定承载REST服务端点的服务器域名或IP,从地区和终端节点获取。

    customerBill

    系统上传伙伴账单明细文件的文件夹名称。

    filename

    文件名称。

    • 文件命名方式为:customerBill_YYYYMM.tar.gz

      其中customerBill_YYYYMM.tar.gz为压缩包,里面包含的文本文件命名为:customerBill_YYYYMM_xxxx.csv,xxxx为序列号,每100000条记录一个csv文件。

  1. 文件生成周期

    按自然月生成文件。

    北京时间每月5号12:00前生成上个月的文件并上传至伙伴创建的OBS桶。如果当天上传失败,隔天重新上传,若依旧失败,再隔天上传,最多可上传5次,每次上传失败系统会发上传失败邮件至伙伴邮箱。

  1. 文件字段说明

    参数

    参数类型

    取值范围

    描述

    客户ID

    String

    最大长度:64

    客户的domainID。

    产品ID

    String

    最大长度:64

    产品ID。

    产品类型编码

    String

    最大长度:64

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

    资源类型编码

    String

    最大长度:100

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

    云服务区编码

    String

    最大长度:64

    云服务区编码,例如:“ap-southeast-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。

    计费模式

    String

    最大长度:2

    0:包年/包月;

    1:按需;

    2:预留实例-订购;

    3:预留实例-按时计费。

    4:节省计划-订购。

    5:节省计划-按时计费。

    6:节省计划-抵扣。

    官网页面价

    BigDecimal

    -

    客户在华为云购买的官网价或者官网促销价,单位为美元。

    费用生成时间

    String

    最大长度:32

    费用的计费时间,格式为YYYY-MM,表示某年某月。

    订单ID

    String

    最大长度:64

    订单ID,只有包年/包月产品才有这个字段。

    使用量

    BigDecimal

    -

    使用量(不包含套餐内使用量和预留实例使用量),只有按需产品才有这个字段。

    使用量单位

    Integer

    -

    使用量的单位,您可以调用查询度量单位列表接口获取。

    是否竞价实例

    String

    最大长度:1

    2:竞价实例。

    代金券金额

    BigDecimal

    -

    代金券金额,单位为美元。客户消费的时候使用的代金券的金额。

    现金券金额

    BigDecimal

    -

    现金券金额,预留。

    储值卡金额

    BigDecimal

    -

    储值卡金额,预留。

    结算产品类型

    Integer

    -

    0:普通商品

    1:促销商品

    2:混托

    5:储值卡

    6:云市场

    7:竞价实例

    8:FCS(预留)

    11:特价申请

    60:云商店转售折扣

    伙伴优惠比例

    BigDecimal

    -

    每种结算类型对应的优惠比例。“伙伴优惠类型”字段取值为“1:固定单价”的时候,该字段为空。

    币种

    String

    最大长度:3

    USD。

    账期

    String

    最大长度:32

    详单对应的账期,格式为YYYY-MM。

    客户登录名称

    String

    最大长度:64

    客户的华为云账号名称。

    客户名称

    String

    最大长度:192

    客户的实名认证名称,若客户没有进行实名认证,该字段为空。

    产品名称

    String

    最大长度:576

    产品名称。

    产品类型名称

    String

    最大长度:192

    产品的云服务名称,您可以调用查询云服务类型列表接口获取。

    资源类型名称

    String

    最大长度:192

    产品的资源类型名称,您可以调用查询资源类型列表接口获取。

    云服务区名称

    String

    最大长度:96

    产品的云服务区名称,具体请参见地区和终端节点对应云服务的“区域名称”列的值。

    套餐内使用量

    BigDecimal

    -

    匹配到套餐内的使用量。该使用量不参与按需的价格计算。

    套餐内使用量单位

    Integer

    -

    套餐内使用量单位,具体参考“使用量单位”字段。如果套餐内使用量为0,该字段为空。

    预留实例使用量

    BigDecimal

    -

    匹配到预留实例内的使用量。该使用量不参与按需的价格计算。

    预留实例使用量单位

    Integer

    -

    预留实例内使用量单位,具体参考“使用量单位”字段。如果预留实例内使用量为0,该字段为空。

    费用类别

    String

    最大长度:1

    账单中费用的类别。

    • 0:消费
    • 1:退订
    • 2:华为核销

    商务ID

    String

    最大长度:64

    商务ID。

    商务条款ID

    String

    最大长度:64

    商务条款ID。

    券后消费金额

    BigDecimal

    -

    客户消费金额(不含代金券,现金券,储值卡金额)。

    应还金额

    BigDecimal

    -

    伙伴应该支付的账单金额。

    规格

    String

    最大长度:256

    产品规格,例如:

    General Computing|s2.small.1|1vCPUs|1GB|linux

    使用量类型

    String

    最大长度:256

    使用量类型。您可以调用查询使用量类型列表接口获取。

    取值和话单中的使用量类型一致,云服务和使用量因子对应关系如下(举例):

    • 云服务器:Duration
    • 云硬盘:Duration
    • 弹性IP:Duration
    • 带宽:Duration(按带宽询价)或upflow(按流量询价)
    • 市场镜像:Duration

    单价

    BigDecimal

    -

    产品的单价。

    • 按需产品的单价,只有是按需话单并且是统一价格的情况下该字段才有值;如果不是按需话单或者是按需分档计费时则该字段为空。
    • 包周期产品的单价,只有包周期的如下场景会返回:
      • 包周期订购/续订/降配/升配/扩容
      • 简单定价,不分档
    • 预留实例的单价,只有如下场景下会返回:
      • 订购/续订/降配/升配/扩容/按时计费
      • 简单定价,不分档

    单价单位

    String

    最大长度:256

    单价单位。

    例:对于那种按步长定价的, 比如0.6元/10000次; 单价为0.6, 单价单位为元,步长为10000,步长单位为次;给用户呈现时单价为0.6,单价单位为元/10000次。

    结算金额

    BigDecimal

    -

    • “伙伴优惠类型”字段取值为“0:产品折扣”时结算金额为产品的官网页面价*伙伴优惠比例后的金额。
    • “伙伴优惠类型”字段取值为“1:固定单价”时结算金额为使用固定单价算出的包含代金券不包含税金的金额。

    单位:美元。

    仅伙伴用券会返回此字段。

    伙伴代金券金额

    BigDecimal

    -

    使用伙伴优惠比例之后抵扣的伙伴代金券金额。单位:美元。

    是否退券

    String

    -

    是否退还退款产生的伙伴代金券金额。单位:美元。

    • Y:退还
    • N:不退还

    仅伙伴用券会返回此字段。

    现金结算金额

    BigDecimal

    -

    扣除伙伴代金券以后的金额。单位:美元。

    仅伙伴用券会返回此字段。
    说明:
    • 是否退券为退还时,现金结算金额= 结算金额-伙伴代金券金额
    • 是否退券为不退还时,现金结算金额 = 结算金额

    税金

    BigDecimal

    -

    税金金额,不计税或者税基为0时金额为0。单位:美元。

    仅伙伴用券会返回此字段。

    使用量类型名称

    String

    -

    使用量类型名称。您可以调用查询使用量类型列表接口获取。

    伙伴优惠类型

    String

    -

    伙伴优惠类型:

    • 0:产品折扣
    • 1:固定单价

    组合交易号

    String

    最大长度:256

    客户下单时生成的组合交易号。仅包年/包月产品存在,其他情况下为空。

    • “伙伴优惠类型”字段取值为“0:产品折扣”时:应还金额 = 官网页面价*伙伴优惠比例-伙伴代金券金额+税金
    • “伙伴优惠类型”字段取值为“1:固定单价”时:应还金额 = 结算金额-伙伴代金券金额+税金
  1. 文件样例

    客户ID,产品ID,产品类型编码,资源类型编码,云服务区编码,计费模式,官网页面价,费用生成时间,订单ID,使用量,使用量单位,是否竞价实例,代金券金额,现金券金额,储值卡金额,结算产品类型,伙伴优惠比例,币种,账期,客户登陆名称,客户名称,产品名称,产品类型名称,资源类型名称,云服务区名称,套餐内使用量,套餐内使用量单位,预留实例使用量,预留实例使用量单位,费用类别,商务ID,商务条款ID,券后消费金额,应还金额,规格,使用量类型,单价,单价单位,结算金额,伙伴代金券金额,是否退券,现金结算金额,税金, 使用量类型名称,伙伴优惠类型,组合交易号。

    05876442ca80d5cc0f2dc01c66d6d0c0,00301-25435-0--0,hws.service.type.ebs,hws.resource.type.volume,cn-east-2,0,30.3,Jan-21,CS2008210926C178U,2664000,6,2,0,0,0,11,0.75,USD,Jan-21,xiajing_zs_hff,艾********公司,GD3 linear EVS Ondemand,Elastic Volume Service,Volume,CN North- Ulanqab3,0,6,0,6,0,1100886031001,0310015570361001_ONDEMAND,210.1008,147.07056,mon IO|4056.000000GB,Duration,0.00007,Dollar/GB/Hour,147.07056,0,N,147.07056,0,Duration,0,BO2023050900011。