全部产品
云市场

账单查询服务

更新时间:2019-09-16 08:43:23

接口名

QueryBill

描述

查询用户某个账期内结算账单。

请求参数

名称 类型 是否必填 说明
Action String 要执行的操作,取值:QueryBill
BillingCycle String 账期,YYYY-MM。样例:2018-07
Type String 类型SubscriptionOrder/PayAsYouGoBill/Refund/Adjustment
ProductCode String 产品代码
ProductType String 产品类型
SubscriptionType String 订阅类型 Subscription/PayAsYouGo,必须和ProductCode参数一起使用
IsHideZeroCharge String True:是,False:否。根据原价(PretaxGrossAmount)是否为0做过滤,默认为否(兼容现有逻辑)
OwnerId Long 资源所有者的阿里云账号ID,通常为16位的数字。BID场景/分销场景OwnerID必须指定
PageNum Integer 页码,默认值为1
PageSize Integer 每页数量,默认值:20,最大值:300

返回参数

名称 类型 说明
TotalCount Integer 总记录数
BillingCycle String 账期,YYYY-MM
AccountID String 账号ID
AccountName String 账号
OwnerID String OwnerID
PageNum Integer 页码
PageSize Integer 每页数量
Items Item 账单详情

Item:

名称 类型 说明
OwnerID String 子账号AccountID(多账号代付场景)
Item String 账单类型:SubscriptionOrder/PayAsYouGoBill/Refund/Adjustment
ProductCode String 产品代码
ProductName String 产品名称(英文)
ProductType String 产品类型
ProductDetail String 产品明细(英文)
SubscriptionType String 订阅类型 Subscription/PayAsYouGo
PaymentTime String 订单支付时间
UsageStartTime String 账单开始时间
UsageEndTime String 账单结束时间
RecordID String 订单号/账单号
PretaxGrossAmount Double 原始金额
DeductedByCoupons Double 优惠券抵扣
InvoiceDiscount Double 优惠金额
RoundDownDiscount Double 抹零优惠
PretaxAmount Double 应付金额
DeductedByCashCoupons Double 代金券抵扣
DeductedByPrepaidCard Double 储值卡抵扣
PaymentAmount Double 现金支付
OutstandingAmount Double 未结清金额
Currency String 币种 CNY/USD/JPY
Status String 支付状态:已支付(PayFinish),未结清(PayUnclear),未结算(PayUnsettle),免结算(NoSettle)

请求示例

  1. &Action=QueryBill
  2. &BillingCycle=2018-10
  3. &公共参数

返回示例

  1. "Data": {
  2. "Items": {
  3. "Item": [
  4. {
  5. "SubscriptionType": "PayAsYouGo",
  6. "ProductCode": "slb",
  7. "RecordID": "2019080352963162",
  8. "ProductDetail": "负载均衡",
  9. "DeductedByPrepaidCard": 0,
  10. "PretaxAmount": 0,
  11. "DeductedByCoupons": 0,
  12. "RoundDownDiscount": 0,
  13. "UsageStartTime": "2019-08-08 12:00:00",
  14. "UsageEndTime": "2019-08-08 13:00:00",
  15. "Status": "NoSettle",
  16. "PaymentTime": "",
  17. "PaymentAmount": 0,
  18. "Item": "PayAsYouGoBill",
  19. "OutstandingAmount": 0,
  20. "ProductType": "",
  21. "DeductedByCashCoupons": 0,
  22. "OwnerID": "",
  23. "ProductName": "负载均衡",
  24. "Currency": "CNY",
  25. "PretaxGrossAmount": 0,
  26. "InvoiceDiscount": 0
  27. }
  28. ]
  29. "TotalCount": 7332,
  30. "BillingCycle": "2018-10",
  31. "AccountID": "16****13",
  32. "PageSize": 20,
  33. "AccountName": "zh****18",
  34. "PageNum": 1
  35. },
  36. "Message": "Successful!",
  37. "RequestId": "F1075667-CD01-4F7F-9041-17B4054CADC6",
  38. "Success": true,
  39. "Code": "Success"}