接口名称
每日账单列表分页查询
接口地址
| 代码块 |
|---|
/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) |