# 销售统计(需求 6.7)- 前端联调方案 ## 涉及页面 - 营销管理 → 数据统计 → 销售统计(`erp/sale/statistics/index`,组件名 `ErpSaleStatistics`,权限 `erp:sale-statistics:query`) - 页面结构:顶部查询表单(按页签变化)→ 五个页签 → 图表(ECharts)→ 明细表格(不分页) ## 业务流程与数据带入 1. 页签切换:切换页签时重建查询表单、重置条件、重建表格列,再用默认条件查一次。 2. 查询表单 → 接口参数:日期区间统一转成 `beginTime`(开始日 00:00:00)与 `endTime`(结束日 23:59:59),覆盖所选日期全天。 3. 接口响应 → 图表与表格:同一次响应同时驱动图表和表格,表格不分页直接渲染全部行。 ## 页签与接口对应关系 | 页签 | 统计口径 | 接口 | |------|----------|------| | 销售款统计 | 按客户汇总销售金额、已收款、未收款 | GET /erp/sale-statistics/customer-summary | | 产品销售统计 | 按产品汇总销量、销售额、成本、毛利 | GET /erp/sale-statistics/product-summary | | 客户销售统计 | 按客户汇总订单数与金额、最近下单时间 | GET /erp/sale-statistics/customer-summary | | 分拣出库统计 | 按仓库汇总已完成分拣任务数与计划/已分拣数量 | GET /mes/wm/sales-statistics/sort-summary | | 销售出库统计 | 按物料汇总已完成销售出库单数与出库数量 | GET /mes/wm/sales-statistics/outbound-summary | ## API | 方法 | 路径 | 说明 | |------|------|------| | GET | /erp/sale-statistics/summary | 今日/昨日/本月/本年销售额(不做日期筛选) | | GET | /erp/sale-statistics/customer-summary | 客户维度销售统计 | | GET | /erp/sale-statistics/product-summary | 产品维度销售统计 | | GET | /erp/sale-statistics/time-summary | 近 N 个月销售额趋势 | | GET | /mes/wm/sales-statistics/sort-summary | 分拣出库统计 | | GET | /mes/wm/sales-statistics/outbound-summary | 销售出库统计 | **customer-summary 请求参数:** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | customerId | Long | 否 | 客户编号,不传为全部客户 | | beginTime | String | 否 | 下单时间开始 `yyyy-MM-dd HH:mm:ss` | | endTime | String | 否 | 下单时间结束 | 响应字段:`customerId`、`customerName`、`orderCount`(订单数)、`saleAmount`(销售金额,含税合计)、`receiptAmount`(已收款金额)、`unreceivedAmount`(未收款金额)、`lastOrderTime`(最近下单时间)。 **product-summary 请求参数:** `productId`、`beginTime`、`endTime`。 响应字段:`productId`、`productName`、`orderCount`、`totalCount`(销售数量合计)、`saleAmount`(销售金额合计)、`costAmount`(成本金额合计)、`profitAmount`(毛利)。 **sort-summary 请求参数:** `warehouseId`、`beginTime`、`endTime`。 响应字段:`warehouseId`、`warehouseName`、`taskCount`、`planQuantity`、`sortedQuantity`。 **outbound-summary 请求参数:** `itemId`、`beginTime`、`endTime`。 响应字段:`itemId`、`itemCode`、`itemName`、`salesCount`(出库单数)、`quantity`(出库数量)。 **time-summary 请求参数:** `count`(默认 6,近 6 个月);响应字段:`time`(`yyyy-MM`)、`price`。 ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | 客户名称 / 产品名称 | 表格、图表坐标轴 | 后端已解析名称,直接用名称展示,不再展示 ID | | 金额类字段(销售金额/已收款/未收款/成本/毛利) | 表格、图表 | 单位元,两位小数;毛利可为负数 | | 数量类字段 | 表格 | 销售数量/出库数量/分拣数量,按原精度展示 | | 最近下单时间 lastOrderTime | 客户页签表格 | 只展示到天 | ## 业务规则说明 | 场景 | 规则 | |------|------| | 统计范围 | 销售金额来源于 ERP 销售订单(含税合计),分拣出库与销售出库分别来源于 MES 仓库模块的已完成单据 | | 日期筛选 | 所有带区间的接口按 `beginTime`/`endTime` 过滤;不传则统计全部 | | 空结果 | 接口返回空数组时图表要清空而非残留上次数据,表格展示空状态 | | 权限 | 菜单权限 `erp:sale-statistics:query`;数据权限沿用各单据的归属规则 | ## 注意事项 - 表格为统计结果,不分页、不提供工具栏,直接用一次性数据渲染(`pagerConfig.enabled=false`、`toolbarConfig.enabled=false`)。 - 切换到分拣/出库页签时,筛选条件字段不同(仓库/物料),必须重建表单 schema 并清空原条件,避免把客户条件带到仓库接口。 - 图表与表格共用同一次响应,不要为图表单独再发一次请求。 - 日期区间只选一天时也要正确带上 00:00:00 ~ 23:59:59,否则当天数据会被漏统计。