/basicOpen/finance/settlement/profitList{
"operation": {
"method": "POST",
"path": "/basicOpen/finance/settlement/profitList"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/finance/settlement/profitList?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"summaryField\": \"1\",\n \"pageNum\": 1,\n \"pageSize\": 20,\n \"startDate\": \"2025-11-01\",\n \"endDate\": \"2025-11-30\",\n \"fulfilmentTypes\": [1]\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "example-request-id-query-mode-1",
"response_time": "2026-09-04 09:22:59",
"data": {
"configList": [
{
"displayFormat": 2,
"displayFormatName": "金额",
"fields": null,
"itemField": "platformSettlement",
"itemName": "平台结算",
"itemType": 5,
"itemTypeName": "利润",
"parentItemName": "利润",
"sortOrder": 1000,
"tooltip": ""
},
{
"displayFormat": 2,
"displayFormatName": "金额",
"fields": [
{
"displayName": "商品金额",
"fieldName": "commonProductAmount",
"platformCodes": [
"10011"
]
}
],
"itemField": "salesAmount",
"itemName": "销售额",
"itemType": 1,
"itemTypeName": "收入",
"parentItemName": "平台收入",
"sortOrder": 3000,
"tooltip": ""
}
],
"dataList": [
{
"area": "美国",
"asin": null,
"brand": "示例品牌",
"category": "示例分类",
"costSource": "固定值",
"country": "美国",
"currency": "USD",
"currencyIcon": "$",
"developer": "示例开发人",
"hasOriginalOrder": true,
"localSku": "SKU-001",
"msku": "MSKU-001",
"mskuId": "example-msku-id",
"orderItemNo": "",
"packageNo": null,
"platformCode": "10011",
"platformName": "TikTok",
"platformOrderNo": "example-platform-order-no",
"productName": "示例商品",
"profitItems": {
"platformSettlement": 75.25,
"salesAmount": 100,
"platformCommission": -5,
"platformDeliveryFee": -10,
"productCost": -20,
"profit": 30,
"profitMargin": "30.00%"
},
"purchaseDate": "2026-08-01",
"purchaseTime": "2026-08-01 10:00:00",
"settlementTime": "2026-08-03",
"shipmentDate": null,
"shipmentTime": "2026-08-02 08:00:00",
"skc": "",
"spuId": "example-spu-id",
"stockOrderNo": null,
"storeId": "example-store-id",
"storeName": "示例店铺",
"transactionType": "销售",
"uniqueId": "example-unique-id",
"waybillNo": "",
"fulfilmentType": "平台发货"
}
],
"total": {
"currency": "USD",
"currencyIcon": "$",
"profitItems": {
"platformSettlement": 150.5,
"salesAmount": 200,
"platformCommission": -10,
"platformDeliveryFee": -20,
"productCost": -40,
"profit": 60,
"profitMargin": "30.00%"
}
},
"totalCount": 2
},
"total": 2
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | summaryField | 汇总维度 | string | — | Required | 汇总维度: 1=订单 2=店铺 3=MSKU 4=SKU 5=开发者 6=负责人 11=SPU |
| 2 | summaryType | 时间汇总维度 | integer | — | Optional | 时间汇总维度,仅非订单维度(summaryField!=1)时生效: null/0=默认(不按时间聚合) 1=按月 2=按天 3=按周 |
| 3 | pageNum | 当前页码 | integer | — | Required | 当前页码,默认1 |
| 4 | pageSize | 每页大小 | integer | — | Required | 每页大小,默认20,最大200 |
| 5 | startDate | 开始日期 yyyy-MM-dd | string | — | Optional | 开始日期 yyyy-MM-dd |
| 6 | endDate | 结束日期 yyyy-MM-dd | string | — | Optional | 结束日期 yyyy-MM-dd |
| 7 | dateRangeType | 日期范围类型 | integer | — | Optional | 日期范围类型: 0=结算时间 1=下单时间 默认为0 |
| 8 | sids | 店铺ID列表 | array<any> | — | Optional | 店铺ID列表 |
| 9 | platformCodes | 平台代码列表 | array<any> | — | Optional | 平台代码列表: 10002=Shopify 10003=eBay 10006=Shopee 10008=Walmart 10011=TikTok 10012=MercadoLibre 10021=SHEIN平台模式 10028=SHEIN半托管 10007=Lazada 10024=Temu半托管 10022=Temu全托管 10027=SHEIN代运营 |
| 10 | areas | 站点/区域列表 | array<any> | — | Optional | 站点/区域列表 |
| 11 | countries | 国家列表 | array<any> | — | Optional | 国家列表 |
| 12 | brands | 品牌ID列表 | array<any> | — | Optional | 品牌ID列表 |
| 13 | categories | 分类ID列表 | array<any> | — | Optional | 分类ID列表 |
| 14 | developers | 开发人UID列表 | array<any> | — | Optional | 开发人UID列表 |
| 15 | currency | 币种 | string | — | Optional | 币种,默认为空展示原币种 |
| 16 | queryMode | 查询模式 | integer | — | Optional | 查询模式: 1=列表 2=明细 |
| 17 | transactionTypes | 交易类型 | array<any> | — | Optional | 交易类型: order=销售 refund=退款 return=退货 manual=手工 reshipment=补发 manual_add=加购 other=其他 |
| 18 | fulfilmentTypes | 发货类型筛选 | array<any> | — | Optional | 发货类型筛选,仅汇总维度为订单(summaryField=1)时生效: 1=自发货 2=平台发货 3=部分自发货 |
| 19 | hasOriginalOrder | 有无源单 | integer | — | Optional | 有无源单,仅汇总维度为订单时生效: 1=有源单 0=无源单 不传则不过滤 |
| 20 | searchField | 商品筛选字段 | integer | — | Optional | 商品筛选字段: 1=MSKU 2=MSKU ID 3=品名 4=系统SKU |
| 21 | searchValues | 商品筛选值列表 | array<any> | — | Optional | 商品筛选值列表,支持批量搜索 |
| 22 | orderSearchField | 单据筛选字段 | integer | — | Optional | 单据筛选字段: 1=平台订单号 2=平台子单号 3=备货单号 4=业务单号 5=运单号 6=包裹 |
| 23 | orderSearchValues | 单据筛选值列表 | array<any> | — | Optional | 单据筛选值列表,支持批量搜索 |
| 24 | sortField | 排序字段 | string | — | Optional | 排序字段 |
| 25 | sortType | 排序类型 | string | — | Optional | 排序类型:asc升序、desc降序 |
| 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-04-09 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | configList | 利润配置项列表 | array<object> | — | Required | 利润配置项列表,用于前端渲染动态列 |
| 6.1.1 | itemType | 类型 | integer | 1 | Required | 类型:1=收入,2=税费,3=费用,4=成本,5=利润 |
| 6.1.2 | itemTypeName | 类型名称 | string | 收入 | Required | 类型名称 |
| 6.1.3 | itemField | 二级利润项目字段名 | string | salesAmount | Required | 二级利润项目字段名 |
| 6.1.4 | itemName | 二级利润项目 | string | 销售额 | Required | 二级利润项目 |
| 6.1.5 | parentItemName | 一级利润项目 | string | 平台收入 | Required | 一级利润项目 |
| 6.1.6 | displayFormat | 显示格式 | integer | 2 | Required | 显示格式:1=整数,2=金额,3=百分比 |
| 6.1.7 | displayFormatName | 显示格式名称 | string | 金额 | Required | 显示格式名称 |
| 6.1.8 | sortOrder | 排序顺序 | integer | 1 | Required | 排序顺序 |
| 6.1.9 | tooltip | 气泡注释 | string | — | Required | 气泡注释 |
| 6.1.10 | fields | 关联的明细字段列表 | array<object> | — | Required | 关联的明细字段列表 |
| 6.1.10.1 | fieldName | 字段名称 | string | salesAmount | Required | 字段名称 |
| 6.1.10.2 | displayName | 显示名称 | string | 销售额 | Required | 显示名称 |
| 6.1.10.3 | platformCodes | 适用的平台代码列表 | array<any> | ["AMAZON"] | Required | 适用的平台代码列表 |
| 6.2 | dataList | 数据列表 | array<object> | — | Required | 数据列表 |
| 6.2.1 | platformCode | 平台代码 | string | AMAZON | Required | 平台代码 |
| 6.2.2 | platformName | 平台名称 | string | 亚马逊 | Required | 平台名称 |
| 6.2.3 | storeId | 多平台店铺ID | string | 123 | Required | 多平台店铺ID |
| 6.2.4 | storeName | 店铺名称 | string | 店铺A | Required | 店铺名称 |
| 6.2.5 | area | 站点(区域) | string | US | Required | 站点(区域) |
| 6.2.6 | country | 国家 | string | US | Required | 国家 |
| 6.2.7 | currency | 币种 | string | USD | Required | 币种 |
| 6.2.8 | currencyIcon | 币种图标 | string | $ | Required | 币种图标 |
| 6.2.9 | msku | msku | string | MSKU001 | Required | MSKU |
| 6.2.10 | mskuId | MSKU ID | string | 123456 | Required | MSKU ID |
| 6.2.11 | asin | asin | string | B0ABC12345 | Required | ASIN |
| 6.2.12 | localSku | localSku | string | SKU001 | Required | SKU |
| 6.2.13 | spuId | SPU ID | string | 789 | Required | SPU ID |
| 6.2.14 | skc | skc | string | SKC001 | Required | SKC |
| 6.2.15 | productName | 品名 | string | 示例产品 | Required | 品名 |
| 6.2.16 | brand | 品牌 | string | 品牌A | Required | 品牌 |
| 6.2.17 | category | 分类 | string | 分类A | Required | 分类 |
| 6.2.18 | developer | 开发人 | string | 张三 | Required | 开发人 |
| 6.2.19 | costSource | 成本来源 | string | 固定值 | Required | 成本来源: 固定值 销售出库单 WFS批次成本 平台发货仓 取消单无成本 多渠道配送 退货入库单 |
| 6.2.20 | platformOrderNo | 平台单号 | string | 111-1234567-1234567 | Required | 平台单号 |
| 6.2.21 | orderItemNo | 平台子单号 | string | 12345678901234 | Required | 平台子单号 |
| 6.2.22 | packageNo | 包裹号 | string | BG202501001 | Required | 包裹号 |
| 6.2.23 | stockOrderNo | 备货单号 | string | BH202501001 | Required | 备货单号 |
| 6.2.24 | waybillNo | 运单号 | string | YD202501001 | Required | 运单号 |
| 6.2.25 | transactionType | 交易类型 | string | order | Required | 交易类型: order=销售 refund=退款 return=退货 manual=手工 reshipment=补发 manual_add=加购 other=其他 |
| 6.2.26 | uniqueId | 订单维度唯一键 | string | 123456789 | Required | 订单维度唯一键 |
| 6.2.27 | purchaseDate | 下单时间 | string | 2025-11-01 | Required | 下单时间 |
| 6.2.28 | purchaseTime | 下单时间 | string | 2025-11-01 12:00:00 | Required | 下单时间,格式:yyyy-MM-dd HH:mm:ss |
| 6.2.29 | settlementTime | 结算日期 | string | 2025-11-15 | Required | 结算日期 |
| 6.2.30 | shipmentDate | 发货日期 | string | 2025-11-02 | Required | 发货日期 |
| 6.2.31 | shipmentTime | 标发时间 | string | 2025-11-02 12:00:00 | Required | 标发时间,格式:yyyy-MM-dd HH:mm:ss |
| 6.2.32 | hasOriginalOrder | 是否有原始订单 | boolean | true | Required | 是否有原始订单 |
| 6.2.33 | fulfilmentType | 发货类型 | string | 1 | Required | 发货类型: 1=自发货 2=平台发货 3=部分自发货 |
| 6.2.34 | profitItems | 利润项 | object | {"salesAmount":"100.00"} | Required | 利润项,key为小写驼峰字段名,value为格式化后的值 |
| 6.3 | total | 汇总数据 | object | — | Required | 汇总数据 |
| 6.3.1 | currency | 币种 | string | USD | Required | 币种 |
| 6.3.2 | currencyIcon | 币种图标 | string | $ | Required | 币种图标 |
| 6.3.3 | profitItems | 利润项 | object | {"salesAmount":"1000.00"} | Required | 利润项,key为小写驼峰字段名,value为格式化后的值 |
| 6.4 | totalCount | 总记录数 | integer | 100 | Required | 总记录数 |
| 7 | total | 总数 | integer | 100 | Required | 总数 |
The 利润报表 - 明细列表查询 API (/basicOpen/finance/settlement/profitList) 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.