Lingxing
切换旧版

Temu半托 - 退货面单费

POST/basicOpen/multiplatformFinance/temuHalf/return/fee/list

查询Temu半托退货面单费列表，对应系统【财务】>【Temu半托管-跨境店-账单明细-退货面单费】数据

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatformFinance/temuHalf/return/fee/listHTTPSPOST1

请求参数

sidsarray<any>
店铺 ID
currencyCodestring
目标展示币种。留空时按原始币种返回；传入后金额和币种按目标币种换算/展示
startDatestring
筛选开始时间，格式 yyyy-MM-dd HH:mm:ss
endDatestring
筛选结束时间，格式 yyyy-MM-dd HH:mm:ss；服务端按当天结束时间处理
financeTypesarray<any>
财务类型页面编码数组。可选值：1=支出，2=调整（支出），3=调整（退款），4=其他类型
reportTypesarray<any>
报表类型页面编码数组。可选值：1=退货面单费-Temu仓，2=退货面单费-商家仓
searchField2string
单号搜索字段，可选值：shippingOrderNo（运单号）、platformOrderNo（平台订单号）、billingId（对账 ID）
searchExactly1boolean
单号搜索是否精确匹配，可选值：true（精确匹配）、false（模糊匹配，默认）。传入对应的搜索数组时服务端会自动设为 true
orderSearchValuestring
单号搜索值；多个值以英文逗号分隔
orderSearchArrarray<any>
单号精确搜索值数组；传入后服务端自动按精确匹配处理
shippingOrderNoListarray<any>
运单号列表
platformOrderNoListarray<any>
平台订单号列表
billingIdListarray<any>
对账 ID 列表
sortFieldstring
排序字段，可选值：paymentTime（账务时间）、amount（金额）。不传时使用默认排序
sortTypestring
排序顺序，可选值：asc（升序）、desc（降序）
offsetinteger
分页起始位置，从 0 开始
lengthinteger
分页每页记录数

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatformFinance/temuHalf/return/fee/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "sids": [1, 2],
    "currencyCode": "USD",
    "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>必填
当前页明细记录列表。
隐藏子属性
storeNamestring必填
店铺名称。
示例 MyStore
reportTypestring必填
报表类型。
示例 return
billingIdstring必填
对账 ID。
示例 BILL001
shippingOrderNostring必填
运单号。
示例 SHP001
platformOrderNostring必填
平台订单号。
示例 ORD123456
feeTypestring必填
费用类型。
示例 return_fee
currencystring必填
币种代码。
示例 USD
currencyIconstring必填
币种图标或符号。
示例 $
amountnumber必填
金额。
示例 10
paymentTimestring必填
账务时间。
示例 2026-01-15
totalSumobject必填
符合筛选条件的汇总数据；字段结构见对应汇总模型。
隐藏子属性
amountnumber必填
金额。
示例 1000
currencystring必填
币种代码。
示例 USD
currencyIconstring必填
币种图标或符号。
示例 $
totalCountinteger必填
符合筛选条件的总记录数。
示例 100
totalinteger必填
总数
示例 100

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-06-01 12:00:00",
    "data": {
        "totalCount": 1,
        "list": [
            {
                "storeName": "MyStore",
                "reportType": "return",
                "billingId": "BILL001",
                "shippingOrderNo": "SHP001",
                "platformOrderNo": "ORD123456",
                "feeType": "return_fee",
                "currency": "USD",
                "currencyIcon": "$",
                "amount": 10.00,
                "paymentTime": "2026-01-15"
            }
        ],
        "totalSum": {
            "amount": 10.00,
            "currency": "USD",
            "currencyIcon": "$",
            "totalCount": 1
        }
    },
    "total": 1
}