Lingxing
切换旧版

查询LINE账单明细列表

POST/basicOpen/multiplatformFinance/lineBill/statement/list

查询结算中心对应页面的列表数据,支持筛选、排序、分页和汇总。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatformFinance/lineBill/statement/listHTTPSPOST1

请求参数

sidsarray<any>
店铺ID列表,不传或空数组表示不按店铺筛选;不是枚举
currencyCodestring
目标币种代码,不传或空字符串使用原币种
settlementStatusesarray<any>
结算状态
COMPLETED:已结算
PENDING_SETTLEMENT:待结算
OTHER:其他
orderStatusesarray<any>
订单状态
FINALIZED:FINALIZED
COMPLETED:COMPLETED
EXPIRED:EXPIRED
CANCELED:CANCELED
OTHER:其他
startDatestring
结算日期开始日期,格式yyyy-MM-dd;可不传,与页面清空日期时一致
endDatestring
结算日期结束日期,格式yyyy-MM-dd;可不传,与页面清空日期时一致
searchTypeinteger
单据搜索类型
1:平台订单
2:平台子单
3:结算编号
searchSingleValuestring
单据单值搜索内容,与searchMultiValue互斥
searchMultiValuearray<any>
单据批量搜索内容,最多500个;与searchSingleValue互斥
searchType1integer
商品搜索类型
11:MSKU
12:MSKU ID
searchSingleValue1string
商品单值搜索内容,与searchMultiValue1互斥
searchMultiValue1array<any>
商品批量搜索内容,最多500个;与searchSingleValue1互斥
sortFieldstring
排序字段
settlementDate:结算日期
quantity:数量
itemAmount:商品金额
itemDiscountAmount:商品折扣
buyerShippingFee:买家运费
orderDiscountAmount:订单折扣
buyerPaymentAmount:买家付款金额
platformSubsidyAmount:平台补贴
withholdingTaxAmount:预提税
transactionFeeAmount:交易费
serviceFeeAmount:服务费
vatAmount:增值税
otherAmount:其他
sellerReceivableAmount:卖家应收
sortTypestring
排序方向:0降序,1升序
使用字符串编码
offsetinteger
分页偏移量,默认0
lengthinteger
每页条数,默认20,范围1至200

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatformFinance/lineBill/statement/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
  "sids": [],
  "currencyCode": "",
  "settlementStatuses": [],
  "orderStatuses": [],
  "startDate": "2026-09-01",
  "endDate": "2026-10-22",
  "searchType": 1,
  "searchMultiValue": [],
  "searchType1": 11,
  "searchMultiValue1": [],
  "offset": 0,
  "length": 20
}'

返回结果

Json Object

codeinteger必填
状态码,0表示成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路ID
示例 example-request-id
response_timestring必填
响应时间
示例 2026-10-22 12:00:00
dataobject必填
响应数据
隐藏子属性
listarray<object>必填
列表数据
隐藏子属性
idinteger必填
主键ID
storeIdinteger必填
店铺ID
storeNamestring必填
店铺
settlementIdsstring必填
结算编号
settlementStatusstring必填
结算状态编码
settlementStatusNamestring必填
结算状态
settlementDatestring必填
结算日期
orderNumberstring必填
平台订单
lineItemIdstring必填
平台子单
mskustring必填
MSKU
mskuIdstring必填
MSKU ID
quantityinteger必填
数量
orderStatusstring必填
订单状态
shipmentStatusstring必填
发货状态
itemAmountnumber必填
商品金额
itemDiscountAmountnumber必填
商品折扣
buyerShippingFeenumber必填
买家运费
orderDiscountAmountnumber必填
订单折扣
buyerPaymentAmountnumber必填
买家付款金额
platformSubsidyAmountnumber必填
平台补贴
withholdingTaxAmountnumber必填
预提税
transactionFeeAmountnumber必填
交易费
serviceFeeAmountnumber必填
服务费
vatAmountnumber必填
增值税
otherAmountnumber必填
其他
sellerReceivableAmountnumber必填
卖家应收
currencystring必填
币种
currencyIconstring必填
币种符号
isMasterRowboolean必填
是否主行
childrenarray<any>必填
子行列表,字段结构与当前列表项相同
totalCountinteger必填
总记录数
totalSumobject必填
汇总数据
隐藏子属性
totalCountinteger必填
总记录数
currencystring必填
币种
currencyIconstring必填
币种符号
quantityinteger必填
数量
itemAmountnumber必填
商品金额
itemDiscountAmountnumber必填
商品折扣
buyerShippingFeenumber必填
买家运费
orderDiscountAmountnumber必填
订单折扣
buyerPaymentAmountnumber必填
买家付款金额
platformSubsidyAmountnumber必填
平台补贴
withholdingTaxAmountnumber必填
预提税
transactionFeeAmountnumber必填
交易费
serviceFeeAmountnumber必填
服务费
vatAmountnumber必填
增值税
otherAmountnumber必填
其他
sellerReceivableAmountnumber必填
卖家应收
totalinteger必填
总记录数,与data.totalCount相同
示例 1

返回成功示例

{
  "code": 0,
  "message": "success",
  "error_details": [],
  "request_id": "example-request-id",
  "response_time": "2026-10-22 12:00:00",
  "data": {
    "list": [
      {
        "id": 1234567890123457,
        "storeId": 1234567890123456,
        "storeName": "Example Store",
        "settlementIds": "EXAMPLE-001",
        "settlementStatus": "",
        "settlementStatusName": "",
        "settlementDate": "2026-10-22 12:00:00",
        "orderNumber": "EXAMPLE-001",
        "lineItemId": "EXAMPLE-001",
        "msku": "",
        "mskuId": "EXAMPLE-001",
        "quantity": 1,
        "orderStatus": "",
        "shipmentStatus": "",
        "itemAmount": 0,
        "itemDiscountAmount": 0,
        "buyerShippingFee": 0,
        "orderDiscountAmount": 0,
        "buyerPaymentAmount": 0,
        "platformSubsidyAmount": 0,
        "withholdingTaxAmount": 0,
        "transactionFeeAmount": 0,
        "serviceFeeAmount": 0,
        "vatAmount": 0,
        "otherAmount": 0,
        "sellerReceivableAmount": 0,
        "currency": "USD",
        "currencyIcon": "$",
        "isMasterRow": true,
        "children": [
          {
            "id": 1234567890123458,
            "storeId": 1234567890123456,
            "storeName": "Example Store",
            "settlementIds": "EXAMPLE-001",
            "settlementStatus": "",
            "settlementStatusName": "",
            "settlementDate": "2026-10-22 12:00:00",
            "orderNumber": "EXAMPLE-001",
            "lineItemId": "EXAMPLE-001",
            "msku": "",
            "mskuId": "EXAMPLE-001",
            "quantity": 1,
            "orderStatus": "",
            "shipmentStatus": "",
            "itemAmount": 0,
            "itemDiscountAmount": 0,
            "buyerShippingFee": 0,
            "orderDiscountAmount": 0,
            "buyerPaymentAmount": 0,
            "platformSubsidyAmount": 0,
            "withholdingTaxAmount": 0,
            "transactionFeeAmount": 0,
            "serviceFeeAmount": 0,
            "vatAmount": 0,
            "otherAmount": 0,
            "sellerReceivableAmount": 0,
            "currency": "USD",
            "currencyIcon": "$",
            "isMasterRow": false,
            "children": null
          }
        ]
      }
    ],
    "totalCount": 1,
    "totalSum": {
      "totalCount": 1,
      "currency": "USD",
      "currencyIcon": "$",
      "quantity": 1,
      "itemAmount": 0,
      "itemDiscountAmount": 0,
      "buyerShippingFee": 0,
      "orderDiscountAmount": 0,
      "buyerPaymentAmount": 0,
      "platformSubsidyAmount": 0,
      "withholdingTaxAmount": 0,
      "transactionFeeAmount": 0,
      "serviceFeeAmount": 0,
      "vatAmount": 0,
      "otherAmount": 0,
      "sellerReceivableAmount": 0
    }
  },
  "total": 1
}

附加说明

  • 店铺ID是业务标识,不是枚举。筛选数组为空时表示不限制对应条件。
  • 排序字段和金额比较条件与页面可用控件一致;排序方向请使用当前接口文档列出的编码。
  • 同一搜索组的单值与批量搜索互斥;LINE支持同时组合单据搜索组与商品搜索组。
  • 响应保留list、totalCount和totalSum,外层total等于data.totalCount。金额字段使用JSON数值;订单号、MSKU等业务编号使用字符串。
  • 示例中的业务标识和金额均为虚构数据。
  • 复现页面默认日期范围时,将startDate设为上个月第一天,endDate设为今天。本接口不自动补充日期。
  • children中的每一项与list列表项结构相同;null或空数组表示没有返回子行。