版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

接口名称

每日账单列表分页查询

接口地址

代码块
/api/shipper/v1/finance/dailyBilling/selectPage

请求方式

代码块
POST

请求头

参数

类型

必填

说明

sessionId

String

登录会话ID

language

String

语言

Content-Type

String

application/json;charset=UTF-8

Accept

String

application/json, text/plain, /

语言取值:

说明

zh_CN

中文

en_US

英文

请求参数

字段

类型

必填

说明

keywordType

String

关键字类型,默认 trackingNo,跟踪号传值:trackingNo,账单编号传值:billingNo

keywordList

Array

关键字列表(跟踪号/账单编号)

startDate

String

出单日期开始时间,格式:yyyy-MM-dd HH:mm:ss

endDate

String

出单日期结束时间,格式:yyyy-MM-dd HH:mm:ss

monthlyBill

Boolean

是否月账单,默认 false

billingType

String

账单类型ID

pageNum

Integer

页码,默认 1

pageSize

Integer

每页大小,默认 100

keywordType 字段说明

说明

trackingNo

跟踪号

billingNo

账单编号

请求示例

代码块
curl 'https://tracking-qa.etowertech.com/api/shipper/v1/finance/dailyBilling/selectPage' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'language: zh_CN' \
  -H 'sessionId: 0HgJ-EO-Sq_ZQ6u93rjMnA' \
  --data-raw '{"keywordType":"billingNo","keywordList":["2026031300665","2026030600664"],"startDate":"","endDate":"","monthlyBill":false,"billingType":"","pageNum":1,"pageSize":100}'

返回示例

代码块
{
  "success": true,
  "code": "0",
  "data": {
    "content": [
      {
        "billingDate": "2026-03-13 00:00:00",
        "billingNo": "2026031300665",
        "currency": "CAD",
        "status": 1,
        "total": 0.0
      },
      {
        "billingDate": "2026-03-06 00:00:00",
        "billingNo": "2026030600664",
        "currency": "CAD",
        "status": 1,
        "total": 0.78
      }
    ],
    "total": 2,
    "keywordsTotal": 0,
    "missingTotal": 0,
    "missingKeywords": [],
    "numberOfElements": 2
  },
  "errors": []
}

返回字段说明

字段

类型

说明

success

Boolean

请求是否成功

code

String

响应状态码,"0"表示成功

data

Object

返回数据对象

errors

Array

错误信息列表

data 字段说明

字段

类型

说明

content

Array

每日账单列表数据

total

Number

总记录数

keywordsTotal

Number

匹配的关键字总数

missingTotal

Number

未找到的关键字数量

missingKeywords

Array

未找到的关键字列表

numberOfElements

Number

当前页元素数量

data.content 字段说明

字段

类型

说明(国际化key)

billingNo

String

账单编号(financeSetting.billingNo)

billingDate

String

出单日期(financeSetting.billingDate)

currency

String

币种(currency)

status

Number

状态

total

Number

总金额(finance.total)