Lingxing
切换旧版

Temu本土 - 账务明细

POST/basicOpen/multiplatformFinance/temuLocal/bill/list

查询Temu本土账务明细列表,对应系统【财务】>【Temu半托管-本土店-账务明细】数据

接口信息

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

请求参数

sidsarray<any>
店铺 ID
currencyCodestring
目标展示币种。留空时按原始币种返回;传入后金额和币种按目标币种换算/展示
startDatestring
Settlement Time(结算时间)筛选开始时间,格式 yyyy-MM-dd HH:mm:ss
endDatestring
Settlement Time(结算时间)筛选结束时间,格式 yyyy-MM-dd HH:mm:ss;服务端按当天结束时间处理
transactionTypesarray<any>
交易类型页面编码数组。可选值:1=Order Payment,2=Refund,3=Shipping label purchase adjustment,4=Shipping label purchase,5=Shipping label for return purchase,6=Shipping label for return purchase adjustment,7=Seller repayment,8=Seller repayment failed,9=Return shipping fee reimbursement,10=Delayed fulfillment deduction,11=Out of stock deduction,12=Fraudulent fulfillment deduction,13=Aggravated fraudulent fulfillment deduction,14=Advertising service fee,15=Compensation due to problematic product qualificationmaterials,16=Chargeback processing fee,17=Return shipping credit,18=Transfer of funds unsuccessful,19=Transfer,20=其他交易类型
includedInSettlementboolean
可选值:true(仅查询已纳入结算的记录)、false(仅查询未纳入结算的记录);不传时不按此条件筛选
searchField1string
商品搜索字段,可选值:msku(MSKUName / MSKU)、mskuId(MSKU ID)
searchExactly1boolean
商品搜索是否精确匹配,可选值:true(精确匹配)、false(模糊匹配,默认)。传入对应的搜索数组时服务端会自动设为 true
productSearchValuestring
商品搜索值;多个值以英文逗号分隔
productSearchArrarray<any>
商品精确搜索值数组;传入后服务端自动按精确匹配处理
mskuListarray<any>
MSKUName(MSKU)列表
mskuIdListarray<any>
MSKU ID 列表
searchField2string
单号搜索字段,可选值:platformOrderNo(平台订单号)、platformOrderItemNo(平台订单子项号)、relatedId(关联单号)
searchExactly2boolean
单号搜索是否精确匹配,可选值:true(精确匹配)、false(模糊匹配,默认)。传入对应的搜索数组时服务端会自动设为 true
orderSearchValuestring
单号搜索值;多个值以英文逗号分隔
orderSearchArrarray<any>
单号精确搜索值数组;传入后服务端自动按精确匹配处理
platformOrderNoListarray<any>
平台订单号列表
platformOrderItemNoListarray<any>
平台订单子项号列表
relatedIdListarray<any>
关联单号/关联 ID 列表
sortFieldstring
排序字段,可选值:paymentDate(Settlement Time / 结算时间)、quantity(数量)、retailPrice(销售价)、platformDiscount(平台折扣)、sellerDiscount(卖家折扣)、serviceFee(服务费(含税))、platformIncentive(平台补贴)、subtotal(小计)、shipping(买家运费)、platformIncentiveShipping(运费补贴)、productTax(商品税)、shippingTax(运费税)、marketplaceWithheldTax(市场税)、withholdingTax(预扣税)、others(其他交易费)、total(总金额)、othersAll(其他)。不传时使用默认排序
sortTypestring
排序顺序,可选值:asc(升序)、desc(降序)
offsetinteger
分页起始位置,从 0 开始
lengthinteger
分页每页记录数

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatformFinance/temuLocal/bill/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "sids": [1, 2],
    "currencyCode": "CNY",
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "offset": 0,
    "length": 20
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-06-01 12:00:00
dataobject必填
响应数据
隐藏子属性
totalCountinteger必填
符合筛选条件的总记录数。
示例 100
listarray<object>必填
当前页明细记录列表。
隐藏子属性
idinteger必填
记录 ID。
示例 1001
isDeleteinteger必填
删除标记。
示例 0
reportIdinteger必填
报表 ID。
示例 2001
companyIdinteger必填
公司 ID;服务端从鉴权上下文写入,调用方无需传入。
示例 123
paymentDatestring必填
Settlement Time(结算时间)。
示例 2026-01-15
transactionTypestring必填
交易类型。
示例 sale
platformOrderNostring必填
平台订单号。
示例 ORD123456
platformOrderItemNostring必填
平台订单子项号。
示例 ITEM001
skuIdstring必填
SKU ID。
示例 10001
skustring必填
SKU。
示例 SKU001
quantityinteger必填
数量。
示例 10
retailPricenumber必填
零售价。
示例 100
platformDiscountnumber必填
平台折扣金额。
示例 5
sellerDiscountnumber必填
卖家折扣金额。
示例 3
serviceFeenumber必填
服务费金额。
示例 2
platformIncentivenumber必填
平台激励金额。
示例 1
shippingnumber必填
运费金额。
示例 10
platformIncentiveShippingnumber必填
平台运费激励金额。
示例 2
productTaxnumber必填
商品税金额。
示例 1.5
shippingTaxnumber必填
运费税金额。
示例 0.5
marketplaceWithheldTaxnumber必填
平台代扣税金额。
示例 1
withholdingTaxnumber必填
预扣税金额。
示例 0.8
othersnumber必填
其他金额。
示例 0.2
totalnumber必填
总金额。
示例 110
othersAllnumber必填
其他金额合计。
示例 0.2
subtotalnumber必填
小计金额。
示例 105
relatedIdstring必填
关联ID
示例 REL001
shipCitystring必填
收货城市。
示例 City
shipStatestring必填
收货州/省。
示例 State
gmtCreatestring必填
创建时间。
示例 2026-01-10 10:00:00
gmtModifiedstring必填
数据更新时间。
示例 2026-01-10 10:00:00
includedInSettlementboolean必填
是否包含在结算中。
示例 true
currencyIconstring必填
币种图标或符号。
示例 ¥
currencystring必填
币种代码。
示例 CNY
storeNamestring必填
店铺名称。
示例 MyStore
totalSumobject必填
符合筛选条件的汇总数据;字段结构见对应汇总模型。
隐藏子属性
quantityinteger必填
数量。
示例 1000
retailPricenumber必填
零售价。
示例 10000
platformDiscountnumber必填
平台折扣金额。
示例 500
sellerDiscountnumber必填
卖家折扣金额。
示例 300
serviceFeenumber必填
服务费金额。
示例 200
platformIncentivenumber必填
平台激励金额。
示例 100
shippingnumber必填
运费金额。
示例 1000
platformIncentiveShippingnumber必填
平台运费激励金额。
示例 200
productTaxnumber必填
商品税金额。
示例 150
shippingTaxnumber必填
运费税金额。
示例 50
marketplaceWithheldTaxnumber必填
平台代扣税金额。
示例 100
withholdingTaxnumber必填
预扣税金额。
示例 80
othersnumber必填
其他金额。
示例 20
totalnumber必填
总金额。
示例 11000
othersAllnumber必填
其他金额合计。
示例 20
subtotalnumber必填
小计金额。
示例 10500
totalCountinteger必填
符合筛选条件的总记录数。
示例 100
currencyIconstring必填
币种图标或符号。
示例 ¥
currencystring必填
币种代码。
示例 CNY
totalinteger必填
总数
示例 100

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-06-01 12:00:00",
    "data": {
        "totalCount": 1,
        "list": [
            {
                "id": 1001,
                "isDelete": 0,
                "reportId": 2001,
                "companyId": 123,
                "paymentDate": "2026-01-15",
                "transactionType": "sale",
                "platformOrderNo": "ORD123456",
                "platformOrderItemNo": "ITEM001",
                "skuId": "10001",
                "sku": "SKU001",
                "quantity": 10,
                "retailPrice": 100.00,
                "platformDiscount": 5.00,
                "sellerDiscount": 3.00,
                "serviceFee": 2.00,
                "platformIncentive": 1.00,
                "shipping": 10.00,
                "platformIncentiveShipping": 2.00,
                "productTax": 1.50,
                "shippingTax": 0.50,
                "marketplaceWithheldTax": 1.00,
                "withholdingTax": 0.80,
                "others": 0.20,
                "total": 110.00,
                "othersAll": 0.20,
                "subtotal": 105.00,
                "relatedId": "REL001",
                "shipCity": "City",
                "shipState": "State",
                "gmtCreate": "2026-01-10 10:00:00",
                "gmtModified": "2026-01-10 10:00:00",
                "includedInSettlement": true,
                "currencyIcon": "¥",
                "currency": "CNY",
                "storeName": "MyStore"
            }
        ],
        "totalSum": {
            "quantity": 10,
            "retailPrice": 100.00,
            "platformDiscount": 5.00,
            "sellerDiscount": 3.00,
            "serviceFee": 2.00,
            "platformIncentive": 1.00,
            "shipping": 10.00,
            "platformIncentiveShipping": 2.00,
            "productTax": 1.50,
            "shippingTax": 0.50,
            "marketplaceWithheldTax": 1.00,
            "withholdingTax": 0.80,
            "others": 0.20,
            "total": 110.00,
            "othersAll": 0.20,
            "subtotal": 105.00,
            "totalCount": 1,
            "currencyIcon": "¥",
            "currency": "CNY"
        }
    },
    "total": 1
}