/basicOpen/multiplatformFinance/temuHalf/return/fee/list{
"operation": {
"method": "POST",
"path": "/basicOpen/multiplatformFinance/temuHalf/return/fee/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatformFinance/temuHalf/return/fee/list?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"sids\": [1, 2],\n \"currencyCode\": \"USD\",\n \"startDate\": \"2026-01-01\",\n \"endDate\": \"2026-01-31\",\n \"offset\": 0,\n \"length\": 20\n}'",
"responseExample": {
"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,
"paymentTime": "2026-01-15"
}
],
"totalSum": {
"amount": 10,
"currency": "USD",
"currencyIcon": "$",
"totalCount": 1
}
},
"total": 1
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | sids | 店铺 ID | array<any> | — | Optional | 店铺 ID |
| 2 | currencyCode | 目标展示币种 | string | — | Optional | 目标展示币种。留空时按原始币种返回;传入后金额和币种按目标币种换算/展示 |
| 3 | startDate | 筛选开始时间 | string | — | Optional | 筛选开始时间,格式 yyyy-MM-dd HH:mm:ss |
| 4 | endDate | 筛选结束时间 | string | — | Optional | 筛选结束时间,格式 yyyy-MM-dd HH:mm:ss;服务端按当天结束时间处理 |
| 5 | financeTypes | 财务类型页面编码数组 | array<any> | — | Optional | 财务类型页面编码数组。可选值:1=支出,2=调整(支出),3=调整(退款),4=其他类型 |
| 6 | reportTypes | 报表类型页面编码数组 | array<any> | — | Optional | 报表类型页面编码数组。可选值:1=退货面单费-Temu仓,2=退货面单费-商家仓 |
| 7 | searchField2 | 单号搜索字段 | string | — | Optional | 单号搜索字段,可选值:shippingOrderNo(运单号)、platformOrderNo(平台订单号)、billingId(对账 ID) |
| 8 | searchExactly1 | 单号搜索是否精确匹配 | boolean | — | Optional | 单号搜索是否精确匹配,可选值:true(精确匹配)、false(模糊匹配,默认)。传入对应的搜索数组时服务端会自动设为 true |
| 9 | orderSearchValue | 单号搜索值 | string | — | Optional | 单号搜索值;多个值以英文逗号分隔 |
| 10 | orderSearchArr | 单号精确搜索值数组 | array<any> | — | Optional | 单号精确搜索值数组;传入后服务端自动按精确匹配处理 |
| 11 | shippingOrderNoList | 运单号列表 | array<any> | — | Optional | 运单号列表 |
| 12 | platformOrderNoList | 平台订单号列表 | array<any> | — | Optional | 平台订单号列表 |
| 13 | billingIdList | 对账 ID 列表 | array<any> | — | Optional | 对账 ID 列表 |
| 14 | sortField | 排序字段 | string | — | Optional | 排序字段,可选值:paymentTime(账务时间)、amount(金额)。不传时使用默认排序 |
| 15 | sortType | 排序顺序 | string | — | Optional | 排序顺序,可选值:asc(升序)、desc(降序) |
| 16 | offset | 分页起始位置 | integer | — | Optional | 分页起始位置,从 0 开始 |
| 17 | length | 分页每页记录数 | integer | — | Optional | 分页每页记录数 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-06-01 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | totalCount | 符合筛选条件的总记录数 | integer | 100 | Required | 符合筛选条件的总记录数。 |
| 6.2 | list | 当前页明细记录列表 | array<object> | — | Required | 当前页明细记录列表。 |
| 6.2.1 | storeName | 店铺名称 | string | MyStore | Required | 店铺名称。 |
| 6.2.2 | reportType | 报表类型 | string | return | Required | 报表类型。 |
| 6.2.3 | billingId | 对账 ID | string | BILL001 | Required | 对账 ID。 |
| 6.2.4 | shippingOrderNo | 运单号 | string | SHP001 | Required | 运单号。 |
| 6.2.5 | platformOrderNo | 平台订单号 | string | ORD123456 | Required | 平台订单号。 |
| 6.2.6 | feeType | 费用类型 | string | return_fee | Required | 费用类型。 |
| 6.2.7 | currency | 币种代码 | string | USD | Required | 币种代码。 |
| 6.2.8 | currencyIcon | 币种图标或符号 | string | $ | Required | 币种图标或符号。 |
| 6.2.9 | amount | 金额 | number | 10 | Required | 金额。 |
| 6.2.10 | paymentTime | 账务时间 | string | 2026-01-15 | Required | 账务时间。 |
| 6.3 | totalSum | 符合筛选条件的汇总数据 | object | — | Required | 符合筛选条件的汇总数据;字段结构见对应汇总模型。 |
| 6.3.1 | amount | 金额 | number | 1000 | Required | 金额。 |
| 6.3.2 | currency | 币种代码 | string | USD | Required | 币种代码。 |
| 6.3.3 | currencyIcon | 币种图标或符号 | string | $ | Required | 币种图标或符号。 |
| 6.3.4 | totalCount | 符合筛选条件的总记录数 | integer | 100 | Required | 符合筛选条件的总记录数。 |
| 7 | total | 总数 | integer | 100 | Required | 总数 |
The Temu半托 - 退货面单费 API (/basicOpen/multiplatformFinance/temuHalf/return/fee/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.