/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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | summaryField | 汇总维度 | string | — | 必填 | 汇总维度: 1=订单 2=店铺 3=MSKU 4=SKU 5=开发者 6=负责人 11=SPU |
| 2 | summaryType | 时间汇总维度 | integer | — | 可选 | 时间汇总维度,仅非订单维度(summaryField!=1)时生效: null/0=默认(不按时间聚合) 1=按月 2=按天 3=按周 |
| 3 | pageNum | 当前页码 | integer | — | 必填 | 当前页码,默认1 |
| 4 | pageSize | 每页大小 | integer | — | 必填 | 每页大小,默认20,最大200 |
| 5 | startDate | 开始日期 yyyy-MM-dd | string | — | 可选 | 开始日期 yyyy-MM-dd |
| 6 | endDate | 结束日期 yyyy-MM-dd | string | — | 可选 | 结束日期 yyyy-MM-dd |
| 7 | dateRangeType | 日期范围类型 | integer | — | 可选 | 日期范围类型: 0=结算时间 1=下单时间 默认为0 |
| 8 | sids | 店铺ID列表 | array<any> | — | 可选 | 店铺ID列表 |
| 9 | platformCodes | 平台代码列表 | array<any> | — | 可选 | 平台代码列表: 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> | — | 可选 | 站点/区域列表 |
| 11 | countries | 国家列表 | array<any> | — | 可选 | 国家列表 |
| 12 | brands | 品牌ID列表 | array<any> | — | 可选 | 品牌ID列表 |
| 13 | categories | 分类ID列表 | array<any> | — | 可选 | 分类ID列表 |
| 14 | developers | 开发人UID列表 | array<any> | — | 可选 | 开发人UID列表 |
| 15 | currency | 币种 | string | — | 可选 | 币种,默认为空展示原币种 |
| 16 | queryMode | 查询模式 | integer | — | 可选 | 查询模式: 1=列表 2=明细 |
| 17 | transactionTypes | 交易类型 | array<any> | — | 可选 | 交易类型: order=销售 refund=退款 return=退货 manual=手工 reshipment=补发 manual_add=加购 other=其他 |
| 18 | fulfilmentTypes | 发货类型筛选 | array<any> | — | 可选 | 发货类型筛选,仅汇总维度为订单(summaryField=1)时生效: 1=自发货 2=平台发货 3=部分自发货 |
| 19 | hasOriginalOrder | 有无源单 | integer | — | 可选 | 有无源单,仅汇总维度为订单时生效: 1=有源单 0=无源单 不传则不过滤 |
| 20 | searchField | 商品筛选字段 | integer | — | 可选 | 商品筛选字段: 1=MSKU 2=MSKU ID 3=品名 4=系统SKU |
| 21 | searchValues | 商品筛选值列表 | array<any> | — | 可选 | 商品筛选值列表,支持批量搜索 |
| 22 | orderSearchField | 单据筛选字段 | integer | — | 可选 | 单据筛选字段: 1=平台订单号 2=平台子单号 3=备货单号 4=业务单号 5=运单号 6=包裹 |
| 23 | orderSearchValues | 单据筛选值列表 | array<any> | — | 可选 | 单据筛选值列表,支持批量搜索 |
| 24 | sortField | 排序字段 | string | — | 可选 | 排序字段 |
| 25 | sortType | 排序类型 | string | — | 可选 | 排序类型:asc升序、desc降序 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-04-09 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | configList | 利润配置项列表 | array<object> | — | 必填 | 利润配置项列表,用于前端渲染动态列 |
| 6.1.1 | itemType | 类型 | integer | 1 | 必填 | 类型:1=收入,2=税费,3=费用,4=成本,5=利润 |
| 6.1.2 | itemTypeName | 类型名称 | string | 收入 | 必填 | 类型名称 |
| 6.1.3 | itemField | 二级利润项目字段名 | string | salesAmount | 必填 | 二级利润项目字段名 |
| 6.1.4 | itemName | 二级利润项目 | string | 销售额 | 必填 | 二级利润项目 |
| 6.1.5 | parentItemName | 一级利润项目 | string | 平台收入 | 必填 | 一级利润项目 |
| 6.1.6 | displayFormat | 显示格式 | integer | 2 | 必填 | 显示格式:1=整数,2=金额,3=百分比 |
| 6.1.7 | displayFormatName | 显示格式名称 | string | 金额 | 必填 | 显示格式名称 |
| 6.1.8 | sortOrder | 排序顺序 | integer | 1 | 必填 | 排序顺序 |
| 6.1.9 | tooltip | 气泡注释 | string | — | 必填 | 气泡注释 |
| 6.1.10 | fields | 关联的明细字段列表 | array<object> | — | 必填 | 关联的明细字段列表 |
| 6.1.10.1 | fieldName | 字段名称 | string | salesAmount | 必填 | 字段名称 |
| 6.1.10.2 | displayName | 显示名称 | string | 销售额 | 必填 | 显示名称 |
| 6.1.10.3 | platformCodes | 适用的平台代码列表 | array<any> | ["AMAZON"] | 必填 | 适用的平台代码列表 |
| 6.2 | dataList | 数据列表 | array<object> | — | 必填 | 数据列表 |
| 6.2.1 | platformCode | 平台代码 | string | AMAZON | 必填 | 平台代码 |
| 6.2.2 | platformName | 平台名称 | string | 亚马逊 | 必填 | 平台名称 |
| 6.2.3 | storeId | 多平台店铺ID | string | 123 | 必填 | 多平台店铺ID |
| 6.2.4 | storeName | 店铺名称 | string | 店铺A | 必填 | 店铺名称 |
| 6.2.5 | area | 站点(区域) | string | US | 必填 | 站点(区域) |
| 6.2.6 | country | 国家 | string | US | 必填 | 国家 |
| 6.2.7 | currency | 币种 | string | USD | 必填 | 币种 |
| 6.2.8 | currencyIcon | 币种图标 | string | $ | 必填 | 币种图标 |
| 6.2.9 | msku | msku | string | MSKU001 | 必填 | MSKU |
| 6.2.10 | mskuId | MSKU ID | string | 123456 | 必填 | MSKU ID |
| 6.2.11 | asin | asin | string | B0ABC12345 | 必填 | ASIN |
| 6.2.12 | localSku | localSku | string | SKU001 | 必填 | SKU |
| 6.2.13 | spuId | SPU ID | string | 789 | 必填 | SPU ID |
| 6.2.14 | skc | skc | string | SKC001 | 必填 | SKC |
| 6.2.15 | productName | 品名 | string | 示例产品 | 必填 | 品名 |
| 6.2.16 | brand | 品牌 | string | 品牌A | 必填 | 品牌 |
| 6.2.17 | category | 分类 | string | 分类A | 必填 | 分类 |
| 6.2.18 | developer | 开发人 | string | 张三 | 必填 | 开发人 |
| 6.2.19 | costSource | 成本来源 | string | 固定值 | 必填 | 成本来源: 固定值 销售出库单 WFS批次成本 平台发货仓 取消单无成本 多渠道配送 退货入库单 |
| 6.2.20 | platformOrderNo | 平台单号 | string | 111-1234567-1234567 | 必填 | 平台单号 |
| 6.2.21 | orderItemNo | 平台子单号 | string | 12345678901234 | 必填 | 平台子单号 |
| 6.2.22 | packageNo | 包裹号 | string | BG202501001 | 必填 | 包裹号 |
| 6.2.23 | stockOrderNo | 备货单号 | string | BH202501001 | 必填 | 备货单号 |
| 6.2.24 | waybillNo | 运单号 | string | YD202501001 | 必填 | 运单号 |
| 6.2.25 | transactionType | 交易类型 | string | order | 必填 | 交易类型: order=销售 refund=退款 return=退货 manual=手工 reshipment=补发 manual_add=加购 other=其他 |
| 6.2.26 | uniqueId | 订单维度唯一键 | string | 123456789 | 必填 | 订单维度唯一键 |
| 6.2.27 | purchaseDate | 下单时间 | string | 2025-11-01 | 必填 | 下单时间 |
| 6.2.28 | purchaseTime | 下单时间 | string | 2025-11-01 12:00:00 | 必填 | 下单时间,格式:yyyy-MM-dd HH:mm:ss |
| 6.2.29 | settlementTime | 结算日期 | string | 2025-11-15 | 必填 | 结算日期 |
| 6.2.30 | shipmentDate | 发货日期 | string | 2025-11-02 | 必填 | 发货日期 |
| 6.2.31 | shipmentTime | 标发时间 | string | 2025-11-02 12:00:00 | 必填 | 标发时间,格式:yyyy-MM-dd HH:mm:ss |
| 6.2.32 | hasOriginalOrder | 是否有原始订单 | boolean | true | 必填 | 是否有原始订单 |
| 6.2.33 | fulfilmentType | 发货类型 | string | 1 | 必填 | 发货类型: 1=自发货 2=平台发货 3=部分自发货 |
| 6.2.34 | profitItems | 利润项 | object | {"salesAmount":"100.00"} | 必填 | 利润项,key为小写驼峰字段名,value为格式化后的值 |
| 6.3 | total | 汇总数据 | object | — | 必填 | 汇总数据 |
| 6.3.1 | currency | 币种 | string | USD | 必填 | 币种 |
| 6.3.2 | currencyIcon | 币种图标 | string | $ | 必填 | 币种图标 |
| 6.3.3 | profitItems | 利润项 | object | {"salesAmount":"1000.00"} | 必填 | 利润项,key为小写驼峰字段名,value为格式化后的值 |
| 6.4 | totalCount | 总记录数 | integer | 100 | 必填 | 总记录数 |
| 7 | total | 总数 | integer | 100 | 必填 | 总数 |
领星ERP的接口:利润报表 - 明细列表查询(/basicOpen/finance/settlement/profitList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。