全部产品
Search
文档中心

阿里云交易和账单管理API:QueryEvaluateList - 待开票对象查询服务

更新时间:Mar 01, 2024

查询待开票对象信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
bss:QueryEvaluateREAD
  • 全部资源
    *

请求参数

名称类型必填描述示例值
Typeinteger

类型,取值:

  • 1:搜索可开票金额负值。
  • 2:搜索可开票金额为正值。
  • 3:搜索所有不为 0 代开票信息。
  • 4:已开金额>0。
说明 默认为空则搜索全部。
1
OutBizIdstring

外部订单号。

2387432832696
PageNuminteger

页码。

1
PageSizeinteger

每页条数。

10
StartAmountlong

查询开始金额。

100
EndAmountlong

查询终止金额。

1000
StartBizTimestring

支付成功时间开始区间。格式:yyyy-mm-dd hh:mm:ss。

2020-02-02 12:00:00
EndBizTimestring

支付成功时间结束区间。格式:yyyy-mm-dd hh:mm:ss。

2020-02-02 15:00:00
SortTypeinteger

排序类型,取值:

  • 1:按 ID 进行倒排。
  • 2:按代开票类型倒排,id 倒序二排序。
  • 3:按代开票类型顺排,id 倒序二排序。
1
StartSearchTimestring

搜索开始时间。

2020-02-02 12:00:00
EndSearchTimestring

搜索结束时间。

2020-03-02 12:00:00
BillCyclestring

账期。

202003
BizTypeListarray

发票市场类型列表。

说明 默认为空表示全部类型。
string

发票市场类型。取值:

  • ALIYUN:阿里云产品。
  • MARKETPLACE:云市场产品。
ALIYUN

返回参数

名称类型描述示例值
object
Codestring

状态码。

Success
Messagestring

错误信息。

Successful!
RequestIdstring

请求 ID。

D35FF10E-1B2E-4ABA-8401-0AE17725F50B
Successboolean

是否成功。

true
Dataobject

返回数据。

PageNuminteger

页码。

1
TotalUnAppliedInvoiceAmountlong

查询条件内可开票金额,单位分。

12344
PageSizeinteger

每页条数。

10
TotalCountinteger

总记录数。

2
TotalInvoiceAmountlong

查询条件内总开票金额,单位分。

12344
HostIdstring

主机 ID。

cn
EvaluateListobject []

返回数据列表。

Typeinteger

类型,取值:

  • 1:搜索可开票金额负值。
  • 2:搜索可开票金额为正值。
  • 3:搜索所有不为 0 代开票信息。
  • 4:已开金额>0。
说明 默认为空则搜索全部。
1
Statusinteger

状态。

1
BillIdlong

汇金 ID。

234543254325
UserIdlong

用户 ID。

2738543
BillCyclestring

账期。

202002
CanInvoiceAmountlong

可以开发票的金额。

123213
OffsetAcceptAmountlong

由于存在其他退订,降配等类型订单带来的退款行为,退订金额抵扣到本次开票记录的金额。与退款数据的 OffsetCostAmount 对应。

500
ItemIdlong

科目 ID。

23453245
OutBizIdstring

外部订单号。

124324213421
UserNickstring

用户昵称。

test
GmtModifiedstring

修改时间。

2018-10-10 18:05:44
OpIdstring

外部对象 ID。

12341
BizTypestring

业务类型。取值:

  • ALIYUN:阿里云产品。
  • MARKETPLACE:云市场产品。
ALIYUN
OriginalAmountlong

原始金额。

-10000
InvoicedAmountlong

发票金额。

10000
GmtCreatestring

创建时间。

2018-10-10 18:05:44
PresentAmountlong

余额。

-10000
BizTimestring

时间。

2018-10-10 18:05:44
Namestring

待开票对象名称。

有价代金券退款
OffsetCostAmountlong

由于存在其他退订,降配等类型订单带来的退款行为,退订金额抵扣到本次开票记录的金额。与退款数据的 OffsetAcceptAmount 对应。

500
Idlong

发票 ID。

1325321532

示例

正常返回示例

JSON格式

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "D35FF10E-1B2E-4ABA-8401-0AE17725F50B",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "TotalUnAppliedInvoiceAmount": 12344,
    "PageSize": 10,
    "TotalCount": 2,
    "TotalInvoiceAmount": 12344,
    "HostId": "cn",
    "EvaluateList": {
      "Evaluate": [
        {
          "Type": 1,
          "Status": 1,
          "BillId": 234543254325,
          "UserId": 2738543,
          "BillCycle": "202002",
          "CanInvoiceAmount": 123213,
          "OffsetAcceptAmount": 500,
          "ItemId": 23453245,
          "OutBizId": "124324213421",
          "UserNick": "test",
          "GmtModified": "2018-10-10 18:05:44",
          "OpId": "12341",
          "BizType": "ALIYUN",
          "OriginalAmount": -10000,
          "InvoicedAmount": 10000,
          "GmtCreate": "2018-10-10 18:05:44",
          "PresentAmount": -10000,
          "BizTime": "2018-10-10 18:05:44",
          "Name": "有价代金券退款",
          "OffsetCostAmount": 500,
          "Id": 1325321532
        }
      ]
    }
  }
}

错误码

访问错误中心查看更多错误码。