Lingxing
切换旧版

账单明细 - LazadaSettlement

POST/basicOpen/finance/lazada/settlement/list

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/finance/lazada/settlement/listHTTPSPOST1

请求参数

compareLogicstring
字段比较条件逻辑关系:
AND 所有条件都满足
OR 满足任一条件
默认 AND
currencyCodestring
目标货币代码(为空则使用原币种)
endDatestring
结束时间,支持 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss 格式,仅日期时自动补充 23:59:59
envKeystring
环境标识
exportFieldsarray<any>
导出字段值
feeNamesarray<any>
费用名称数组
fieldComparesarray<any>
字段比较条件列表(多个条件之间的逻辑关系由 compareLogic 指定)
isInSettlementnumber
是否计入结算:
0 否
1 是
null 全部
lengthnumber必填
分页大小,默认 20,最大不超过 200
offsetnumber必填
分页偏移,默认 0
paidStatusesarray<any>
回款状态数组
platformCodestring
平台码
searchExactlyboolean
是否精确匹配
searchExactly1boolean
商品搜索是否精确匹配
searchMultiValuearray<any>
多个搜索值(精确匹配)
searchMultiValue1array<any>
商品搜索值(多个,精确匹配)
searchSingleValuestring
单个搜索值(支持模糊匹配,多个值用逗号分隔)
searchSingleValue1string
商品搜索值(单个,支持模糊匹配,多个值用逗号分隔)
searchTypenumber
搜索类型:
1 平台单号
2 平台子单号
3 交易编号
4 支付参考编号
5 参考单号
searchType1number
商品搜索类型:
11 MSKU ID
12 MSKU
13 商品名称
sidsarray<any>
店铺 ID 数组
sitesarray<any>
站点数组
sortFieldstring
排序字段
sortTypestring
排序方向:
1 升序/ASC
0 降序/DESC
默认 0
startDatestring
开始时间,支持 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss 格式,仅日期时自动补充 00:00:00
storeTypesarray<any>
店铺类型数组:
1 跨境店
2 本土店
timeTypenumber
时间类型:
1 结算日期
2 结算周期
默认 1
transactionTypesarray<any>
交易类型数组

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/finance/lazada/settlement/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "compareLogic": "AND",
    "currencyCode": "USD",
    "startDate": "2026-03-01 00:00:00",
    "endDate": "2026-03-17 23:59:59",
    "length": 20,
    "offset": 0,
    "searchType": 1,
    "searchSingleValue": "ORDER001",
    "searchType1": 12,
    "searchSingleValue1": "MSKU001",
    "feeNames": ["Commission Fee"],
    "transactionTypes": ["Payment"],
    "sites": ["SG","MY"],
    "sids": [10001,10002],
    "storeTypes": [1,2],
    "timeType": 1
}'

返回结果

JSON Object

codenumber必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路id
示例 ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035
response_timestring必填
响应时间
示例 2025-10-23 00:47:29
dataobject必填
响应数据
隐藏子属性
totalCountnumber必填
总记录数
示例 2
totalSumobject必填
汇总数据
隐藏子属性
amountstring必填
结算金额汇总
示例 1200.50
currencyCodestring必填
币种代码
示例 USD
currencyIconstring必填
币种图标
示例 $
refundQuantitynumber必填
退款数量汇总
示例 2
saleQuantitynumber必填
销售数量汇总
示例 10
totalCountnumber必填
总记录数
示例 2
vatInAmountstring必填
增值税金额汇总
示例 18.60
whtAmountstring必填
预提税金额汇总
示例 9.50
listarray<object>必填
列表数据
隐藏子属性
uniqueNostring必填
业务唯一键
示例 LAZADA-SETTLEMENT-001
isInSettlementnumber必填
是否计入结算
示例 1
whtAmountstring必填
预提税金额
示例 4.50
shippingSpeedstring必填
配送时效
示例 Standard
gmtModifiedstring必填
修改时间
示例 2026-03-17 15:20:00
whtIncludedInAmountstring必填
是否已计入金额的预提税
示例 Y
statementStartTimestring必填
结算周期开始时间
示例 2026-03-01 00:00:00
currencyIconstring必填
币种图标
示例 $
shipmentTypestring必填
发货类型
示例 Dropship
referencestring必填
参考单号
示例 REF20260317001
paidStatusstring必填
回款状态值
示例 paid
orderItemStatusstring必填
订单商品状态
示例 delivered
statementstring必填
账单名称
示例 Statement
lazadaSkustring必填
Lazada SKU
示例 LAZSKU001
detailsstring必填
明细说明
示例 Commission Fee
storeNamestring必填
店铺名
示例 Lazada-SG
idnumber必填
主键 ID
示例 1001
transactionDateOriginstring必填
原始交易日期
示例 2026-03-15
sellerSkustring必填
卖家 SKU
示例 SELLER-SKU-001
storeTypenumber必填
店铺类型:1-跨境店, 2-本土店
示例 1
amountstring必填
结算金额
示例 600.25
orderNostring必填
平台单号
示例 ORDER001
refundQuantitynumber必填
退款数量
示例 1
saleQuantitynumber必填
销售数量
示例 5
vatInAmountstring必填
增值税金额
示例 9.30
transactionNumberstring必填
交易编号
示例 TXN20260317001
paidStatusDisplaystring必填
回款状态展示
示例 已回款
siteDisplaystring必填
站点中文展示
示例 新加坡
feeTypestring必填
费用类型
示例 Commission
storeIdnumber必填
店铺 ID
示例 10001
transactionDatestring必填
交易日期
示例 2026-03-15
gmtCreatestring必填
创建时间
示例 2026-03-17 12:00:00
transactionTypestring必填
交易类型
示例 Payment
sitestring必填
站点代码
示例 SG
sourceTypenumber必填
数据来源:1-接口, 2-报表导入
示例 1
storeTypeDisplaystring必填
店铺类型展示
示例 跨境店
orderItemNostring必填
平台子单号
示例 ORDER001-1
feeNamestring必填
费用名称
示例 Commission Fee
commentstring必填
备注
示例 正常结算
currencyCodestring必填
币种代码
示例 USD
platformCodestring必填
平台码
示例 lazada
statementEndTimestring必填
结算周期结束时间
示例 2026-03-15 23:59:59

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035",
    "response_time": "2025-10-23 00:47:29",
    "data": {
        "totalCount": 2,
        "totalSum": {
            "amount": "1200.50",
            "currencyCode": "USD",
            "currencyIcon": "$",
            "refundQuantity": 2,
            "saleQuantity": 10,
            "totalCount": 2,
            "vatInAmount": "18.60",
            "whtAmount": "9.50"
        },
        "list": [
            {
                "uniqueNo": "LAZADA-SETTLEMENT-001",
                "isInSettlement": 1,
                "whtAmount": "4.50",
                "shippingSpeed": "Standard",
                "gmtModified": "2026-03-17 15:20:00",
                "whtIncludedInAmount": "Y",
                "statementStartTime": "2026-03-01 00:00:00",
                "currencyIcon": "$",
                "shipmentType": "Dropship",
                "reference": "REF20260317001",
                "paidStatus": "paid",
                "orderItemStatus": "delivered",
                "statement": "Statement",
                "lazadaSku": "LAZSKU001",
                "details": "Commission Fee",
                "storeName": "Lazada-SG",
                "id": 1001,
                "transactionDateOrigin": "2026-03-15",
                "sellerSku": "SELLER-SKU-001",
                "storeType": 1,
                "amount": "600.25",
                "orderNo": "ORDER001",
                "refundQuantity": 1,
                "saleQuantity": 5,
                "vatInAmount": "9.30",
                "transactionNumber": "TXN20260317001",
                "paidStatusDisplay": "已回款",
                "siteDisplay": "新加坡",
                "feeType": "Commission",
                "storeId": 10001,
                "transactionDate": "2026-03-15",
                "gmtCreate": "2026-03-17 12:00:00",
                "transactionType": "Payment",
                "site": "SG",
                "sourceType": 1,
                "storeTypeDisplay": "跨境店",
                "orderItemNo": "ORDER001-1",
                "feeName": "Commission Fee",
                "comment": "正常结算",
                "currencyCode": "USD",
                "platformCode": "lazada",
                "statementEndTime": "2026-03-15 23:59:59"
            }
        ]
    }
}