Blame view

项目文档相关/docs/科技部驾驶舱GetStatistics接口新增字段清单.md 2.6 KB
fd65ae16   “wangming”   feat: inventory a...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
  # 科技部驾驶舱 GetStatistics 接口新增字段清单
  
  ## 接口地址
  `POST /api/Extend/LqTechDepartmentDashboard/GetStatistics`
  
  ## 新增返回字段
  
  | 字段名 | 类型 | 说明 |
  |--------|------|------|
  | `BillingAmount` | decimal | 开单金额(科美开单实付金额) |
  | `DeductAmount` | decimal | 储扣金额(科美开单的储扣金额) |
  | `RefundAmount` | decimal | 退款金额(科美退卡金额) |
  | `ConsumeAmount` | decimal | 消耗金额(科技部老师消耗业绩) |
  | `HandworkFee` | decimal | 手工费(科技部老师手工费) |
  
  ## 字段说明
  
  ### BillingAmount(开单金额)
  - **含义**:科美开单的实付金额总和
  - **数据来源**`lq_kd_kdjlb` 表的 `sfyj` 字段(实付业绩)
  - **筛选条件**:通过关联 `lq_kd_kjbsyj` 表,筛选 `F_ItemCategory = '科美'` 的开单记录
  
  ### DeductAmount(储扣金额)
  - **含义**:科美开单的储扣金额总和
  - **数据来源**`lq_kd_deductinfo` 表的 `F_Amount` 字段
  - **筛选条件**:通过关联 `lq_xmzl` 表,筛选 `qt2 = '科美'` 的储扣记录
  
  ### RefundAmount(退款金额)
  - **含义**:科美退卡的总金额
  - **数据来源**`lq_hytk_hytk` 表的 `F_ActualRefundAmount` 或 `tkje` 字段
  - **筛选条件**:通过 `EXISTS` 子查询,筛选包含科美品项的退卡记录(避免重复计算)
  
  ### ConsumeAmount(消耗金额)
  - **含义**:科技部老师的消耗业绩总和
  - **数据来源**`lq_xh_kjbsyj` 表的 `kjblsyj` 字段(科技部老师业绩)
  - **筛选条件**`F_ItemCategory = '科美'`,门店在指定范围内
  
  ### HandworkFee(手工费)
  - **含义**:科技部老师的手工费总和
  - **数据来源**`lq_xh_kjbsyj` 表的 `F_LaborCost` 字段
  - **筛选条件**`F_ItemCategory = '科美'`,门店在指定范围内
  
  ## 返回示例
  
  ```json
  {
    "code": 200,
    "msg": "操作成功",
    "data": {
      "TraceabilityAmount": 473157.0,
      "CellAmount": 31730.0,
      "TotalKemeiIncome": 504887.0,
      "ManagedStoreCount": 18,
      "ActiveStoreCount": 18,
      "BillingTraceabilityAmount": 474157.0,
      "RefundTraceabilityAmount": 1000.0,
      "BillingCellAmount": 31730.0,
      "RefundCellAmount": 0.0,
      "BillingAmount": 1529046.0,
      "DeductAmount": 340158.47,
      "RefundAmount": 3529.0,
      "ConsumeAmount": 859984.91,
      "HandworkFee": 18039.0
    }
  }
  ```
  
  ## 注意事项
  
  1. 所有金额字段类型为 `decimal`,保留2位小数
  2. 所有统计都基于科美类型的数据
  3. 时间范围:根据 `statisticsMonth` 参数计算(YYYYMM格式)
  4. 门店范围:根据 `techDepartmentId` 或 `storeIds` 参数确定