Lingxing
切换旧版

查询eBay账单明细列表

POST/basicOpen/multiplatformFinance/ebayBill/statement/list

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

接口信息

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

请求参数

sidsarray<any>
店铺ID列表,不传或空数组表示不按店铺筛选;不是枚举
transactionTypesarray<any>
交易类型
EMPTY:空
SALE:SALE
DISPUTE:DISPUTE
CREDIT:CREDIT
NON_SALE_CHARGE:NON_SALE_CHARGE
REFUND:REFUND
SHIPPING_LABEL:SHIPPING_LABEL
ADJUSTMENT:ADJUSTMENT
TRANSFER:TRANSFER
OTHER:其他
currencyDisplayTypestring
币种展示方式
ORIGINAL:原币种
SETTLEMENT:结算币种
TRANSACTION:交易币种
exchangeRateFilterstring
汇率筛选
EQ_ONE:汇率为1
NE_ONE:汇率不为1
空字符串表示不筛选
transactionMemosarray<any>
费用描述
EMPTY:空
Promoted Listings - General fee:Promoted Listings - General fee
INSERTION FEE:INSERTION FEE
Promoted Listings - Priority fee:Promoted Listings - Priority fee
Promoted Offsite fee:Promoted Offsite fee
Promoted Stores Fee:Promoted Stores Fee
Return shipping label:Return shipping label
OTHER:其他
fundStatusesarray<any>
资金状态
FUNDS_AVAILABLE_FOR_PAYOUT:可提现
FUNDS_PROCESSING:处理中
FUNDS_ON_HOLD:冻结中
PAYOUT:已回款
COMPLETED:转账成功
FAILED:转账失败
OTHER:其他
timeZoneTypestring
时间筛选时区
MAIN_SITE:香港时间
UTC:UTC时间
UK:英国时间
US_WEST:美西时间
startDatestring
结算日期开始日期,格式yyyy-MM-dd;可不传,与页面清空日期时一致
endDatestring
结算日期结束日期,格式yyyy-MM-dd;可不传,与页面清空日期时一致
searchTypeinteger
单据搜索类型
1:订单号
2:结算ID
3:Payout ID
4:结算组ID
5:ItemID
6:商品标题
9:MSKU
7:子单号
8:费用描述
searchSingleValuestring
单据单值搜索内容,与searchMultiValue互斥
searchMultiValuearray<any>
单据批量搜索内容,最多500个;与searchSingleValue互斥
sortFieldstring
排序字段
storeName:店铺
transactionDate:结算日期
payoutId:Payout ID
transactionId:结算ID
transactionType:交易类型
orderId:订单号/调整ID
referenceId:关联单号映射,键为关联类型,值为关联编号
transactionMemo:费用描述
settlementAmount:结算金额
transactionSettlementAmount:交易结算小计
exchangeRate:平台汇率
lineItemId:子单号
quantity:数量
itemNetAmount:商品金额
lineItemEbayCollectedTax:税费
fvfFixedAmount:成交费(固定)
fvfVariableAmount:成交费(品类)
regulatoryOperatingFee:监管运营费
highInadFee:"物品与描述不符"指数非常高的费用
belowStandardFee:表现不合格的费用
internationalFee:跨国交易费用
lineItemOtherFeesAmount:订单其他费
sortTypestring
排序方向:0降序,1升序
使用字符串编码
fieldComparesarray<object>
金额比较条件,支持页面上的更多筛选
隐藏子属性
fieldstring必填
比较字段
settlementAmount:结算金额
itemNetAmount:商品金额
transactionSettlementAmount:交易结算小计
lineItemOtherFeesAmount:订单其他费
operatorstring必填
比较操作符:&gt;、&gt;=、=、&lt;、&lt;=
valuenumber必填
比较金额
offsetinteger
分页偏移量,默认0
lengthinteger
每页条数,默认20,范围1至200

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatformFinance/ebayBill/statement/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
  "sids": [],
  "transactionTypes": [],
  "currencyDisplayType": "ORIGINAL",
  "exchangeRateFilter": "",
  "transactionMemos": [],
  "fundStatuses": [],
  "timeZoneType": "MAIN_SITE",
  "startDate": "2026-09-01",
  "endDate": "2026-10-22",
  "searchType": 1,
  "searchMultiValue": [],
  "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
companyIdinteger必填
公司ID
storeIdinteger必填
店铺ID
storeNamestring必填
店铺
platformCodestring必填
平台编码
sitestring必填
站点
dataVersioninteger必填
数据版本
isLatestVersioninteger必填
是否最新版本
hasLineItemsinteger必填
是否有子单
lineItemCountinteger必填
子单数量
transactionDatestring必填
结算日期
timeZonestring必填
时区
payoutIdstring必填
Payout ID
payoutReferencestring必填
关联ID
settlementGroupIdstring必填
结算组ID
payoutDetailsJsonstring必填
回款明细JSON字符串
transactionIdstring必填
结算ID
transactionTypestring必填
交易类型
transactionStatusstring必填
资金状态
bookingEntrystring必填
记账方向
orderIdstring必填
订单号/调整ID
referenceIdobject必填
关联单号映射,键为关联类型,值为关联编号
transactionMemostring必填
费用描述
amountnumber必填
金额
originalAmountnumber必填
原始金额
settlementAmountnumber必填
结算金额
transactionSettlementAmountnumber必填
交易结算小计
totalFeeAmountnumber必填
费用总额
totalFeeBasisAmountnumber必填
总计费基数
currencystring必填
结算币种
currencyIconstring必填
币种符号
ebayCollectedTaxnumber必填
eBay代缴税费
lineItemEbayCollectedTaxnumber必填
税费
lineItemIdstring必填
子单号
itemIdstring必填
ItemID
itemTitlestring必填
商品标题
skustring必填
SKU
mskuIdstring必填
MSKU
productNamestring必填
内部品名
quantityinteger必填
数量
feeBasisAmountnumber必填
子单计费基数
itemGrossAmountnumber必填
商品含税金额
itemNetAmountnumber必填
商品金额
fvfFixedAmountnumber必填
成交费(固定)
fvfVariableAmountnumber必填
成交费(品类)
regulatoryOperatingFeenumber必填
监管运营费
highInadFeenumber必填
"物品与描述不符"指数非常高的费用
belowStandardFeenumber必填
表现不合格的费用
internationalFeenumber必填
跨国交易费用
totalMarketplaceFeenumber必填
子单市场费用总额
adFeeAmountnumber必填
广告费
insertionFeeAmountnumber必填
刊登费
shippingLabelFeenumber必填
物流标签费
otherFeesAmountnumber必填
订单其他费用
otherFeesDescstring必填
其他费用说明
lineItemOtherFeesAmountnumber必填
订单其他费
lineItemOtherFeesDescstring必填
订单其他费说明
originalCurrencystring必填
交易币种
originalCurrencyIconstring必填
交易币种符号
exchangeRatenumber必填
平台汇率
gmtCreatestring必填
创建时间
gmtModifiedstring必填
修改时间
isDeleteinteger必填
删除标记
uniqueNostring必填
业务唯一键
isMasterRowboolean必填
是否主行
childrenarray<any>必填
子行列表,字段结构与当前列表项相同
totalCountinteger必填
总记录数
totalSumobject必填
汇总数据
隐藏子属性
totalCountinteger必填
总记录数
currencystring必填
结算币种
currencyIconstring必填
币种符号
settlementAmountnumber必填
结算金额
settlementAmountDetailsarray<object>必填
结算金额按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
transactionSettlementAmountnumber必填
交易结算小计
transactionSettlementAmountDetailsarray<object>必填
交易结算小计按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
ebayCollectedTaxnumber必填
eBay代缴税费
ebayCollectedTaxDetailsarray<object>必填
eBay代缴税费按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
lineItemEbayCollectedTaxnumber必填
税费
lineItemEbayCollectedTaxDetailsarray<object>必填
税费按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
feeBasisAmountnumber必填
子单计费基数
feeBasisAmountDetailsarray<object>必填
子单计费基数按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
itemGrossAmountnumber必填
商品含税金额
itemGrossAmountDetailsarray<object>必填
商品含税金额按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
itemNetAmountnumber必填
商品金额
itemNetAmountDetailsarray<object>必填
商品金额按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
fvfFixedAmountnumber必填
成交费(固定)
fvfFixedAmountDetailsarray<object>必填
成交费(固定)按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
fvfVariableAmountnumber必填
成交费(品类)
fvfVariableAmountDetailsarray<object>必填
成交费(品类)按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
regulatoryOperatingFeenumber必填
监管运营费
regulatoryOperatingFeeDetailsarray<object>必填
监管运营费按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
highInadFeenumber必填
"物品与描述不符"指数非常高的费用
highInadFeeDetailsarray<object>必填
"物品与描述不符"指数非常高的费用按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
belowStandardFeenumber必填
表现不合格的费用
belowStandardFeeDetailsarray<object>必填
表现不合格的费用按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
internationalFeenumber必填
跨国交易费用
internationalFeeDetailsarray<object>必填
跨国交易费用按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
otherFeesAmountnumber必填
订单其他费用
otherFeesAmountDetailsarray<object>必填
订单其他费用按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
lineItemOtherFeesAmountnumber必填
订单其他费
lineItemOtherFeesAmountDetailsarray<object>必填
订单其他费按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
totalMarketplaceFeenumber必填
子单市场费用总额
totalMarketplaceFeeDetailsarray<object>必填
子单市场费用总额按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
adFeeAmountnumber必填
广告费
adFeeAmountDetailsarray<object>必填
广告费按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
insertionFeeAmountnumber必填
刊登费
insertionFeeAmountDetailsarray<object>必填
刊登费按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
shippingLabelFeenumber必填
物流标签费
shippingLabelFeeDetailsarray<object>必填
物流标签费按币种汇总
隐藏子属性
currencystring必填
结算币种
currencyIconstring必填
币种符号
amountnumber必填
金额
quantityinteger必填
数量
originalCurrencystring必填
交易币种
originalCurrencyIconstring必填
交易币种符号
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,
        "companyId": 1234567890123457,
        "storeId": 1234567890123456,
        "storeName": "Example Store",
        "platformCode": "",
        "site": "",
        "dataVersion": 0,
        "isLatestVersion": 0,
        "hasLineItems": 0,
        "lineItemCount": 0,
        "transactionDate": "2026-10-22 12:00:00",
        "timeZone": "UTC",
        "payoutId": "EXAMPLE-001",
        "payoutReference": "",
        "settlementGroupId": "EXAMPLE-001",
        "payoutDetailsJson": "[]",
        "transactionId": "EXAMPLE-001",
        "transactionType": "",
        "transactionStatus": "",
        "bookingEntry": "",
        "orderId": "EXAMPLE-001",
        "referenceId": {
          "ITEM_ID": "EXAMPLE-ITEM"
        },
        "transactionMemo": "",
        "amount": 0,
        "originalAmount": 0,
        "settlementAmount": 0,
        "transactionSettlementAmount": 0,
        "totalFeeAmount": 0,
        "totalFeeBasisAmount": 0,
        "currency": "USD",
        "currencyIcon": "$",
        "ebayCollectedTax": 0,
        "lineItemEbayCollectedTax": 0,
        "lineItemId": "EXAMPLE-001",
        "itemId": "EXAMPLE-001",
        "itemTitle": "",
        "sku": "",
        "mskuId": "EXAMPLE-001",
        "productName": "",
        "quantity": 1,
        "feeBasisAmount": 0,
        "itemGrossAmount": 0,
        "itemNetAmount": 0,
        "fvfFixedAmount": 0,
        "fvfVariableAmount": 0,
        "regulatoryOperatingFee": 0,
        "highInadFee": 0,
        "belowStandardFee": 0,
        "internationalFee": 0,
        "totalMarketplaceFee": 0,
        "adFeeAmount": 0,
        "insertionFeeAmount": 0,
        "shippingLabelFee": 0,
        "otherFeesAmount": 0,
        "otherFeesDesc": "",
        "lineItemOtherFeesAmount": 0,
        "lineItemOtherFeesDesc": "",
        "originalCurrency": "USD",
        "originalCurrencyIcon": "$",
        "exchangeRate": 0,
        "gmtCreate": "2026-10-22 12:00:00",
        "gmtModified": "2026-10-22 12:00:00",
        "isDelete": 0,
        "uniqueNo": "EXAMPLE-001",
        "isMasterRow": false,
        "children": null
      }
    ],
    "totalCount": 1,
    "totalSum": {
      "totalCount": 1,
      "currency": "USD",
      "currencyIcon": "$",
      "settlementAmount": 0,
      "settlementAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "transactionSettlementAmount": 0,
      "transactionSettlementAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "ebayCollectedTax": 0,
      "ebayCollectedTaxDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "lineItemEbayCollectedTax": 0,
      "lineItemEbayCollectedTaxDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "feeBasisAmount": 0,
      "feeBasisAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "itemGrossAmount": 0,
      "itemGrossAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "itemNetAmount": 0,
      "itemNetAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "fvfFixedAmount": 0,
      "fvfFixedAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "fvfVariableAmount": 0,
      "fvfVariableAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "regulatoryOperatingFee": 0,
      "regulatoryOperatingFeeDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "highInadFee": 0,
      "highInadFeeDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "belowStandardFee": 0,
      "belowStandardFeeDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "internationalFee": 0,
      "internationalFeeDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "otherFeesAmount": 0,
      "otherFeesAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "lineItemOtherFeesAmount": 0,
      "lineItemOtherFeesAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "totalMarketplaceFee": 0,
      "totalMarketplaceFeeDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "adFeeAmount": 0,
      "adFeeAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "insertionFeeAmount": 0,
      "insertionFeeAmountDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "shippingLabelFee": 0,
      "shippingLabelFeeDetails": [
        {
          "currency": "USD",
          "currencyIcon": "$",
          "amount": 0
        }
      ],
      "quantity": 1,
      "originalCurrency": "USD",
      "originalCurrencyIcon": "$"
    }
  },
  "total": 1
}

附加说明

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