接口地址清单-储扣分析和店长三项指标.md 7.66 KB

Edit Raw Blame History


接口地址清单
一、门店驾驶舱服务（LqStoreDashboard）
基础路径：/api/Extend/LqStoreDashboard
1. 获取门店驾驶舱统计数据（含储扣分析）

接口地址：POST /api/Extend/LqStoreDashboard/GetStatistics
功能说明：获取指定门店在指定月份的统计数据，包括开单业绩、消耗业绩、完成率、净业绩、储扣分析等
请求参数：
json
{
"storeId": "门店ID",
"statisticsMonth": "202601"
}

返回字段（新增储扣相关）：


DeductAmount：储扣总金额
DeductCount：储扣次数（按开单计数）
DeductDetailCount：储扣明细次数
DeductPenetrationRate：储扣渗透率
DeductAmountRatio：储扣金额占比
AvgDeductAmount：平均储扣金额
DeductMemberCount：储扣会员数
LifeBeautyDeductAmount：生美储扣金额
MedicalBeautyDeductAmount：医美储扣金额
TechBeautyDeductAmount：科美储扣金额
ProductDeductAmount：产品储扣金额
StorageCardDeductAmount：储值卡类型储扣金额
ItemDeductAmount：品项类型储扣金额


2. 获取门店各分类月度业绩（近12个月）

接口地址：POST /api/Extend/LqStoreDashboard/GetCategoryMonthlyPerformance
功能说明：获取指定门店近12个月各分类（生美、医美、科美、产品）的消耗业绩数据

3. 获取门店会员转化漏斗数据

接口地址：POST /api/Extend/LqStoreDashboard/GetMemberConversionFunnel
功能说明：获取指定门店在指定月份的会员转化漏斗数据（拓客-邀约-预约-开单链路）

4. 获取门店客单价与项目数关系数据

接口地址：POST /api/Extend/LqStoreDashboard/GetCustomerPriceProjectRelation
功能说明：获取指定门店在指定月份的客单价与项目数关系数据（用于散点图）

5. 获取门店一周运营热力图数据

接口地址：POST /api/Extend/LqStoreDashboard/GetWeeklyHeatmap
功能说明：获取指定门店在指定月份的一周运营热力图数据（周一到周日，每个时间段9:00-21:00的客流量）


二、店长三项指标统计服务（LqStatistics）
基础路径：/api/Extend/LqStatistics
1. 获取当月全部店长三项指标对比

接口地址：POST /api/Extend/LqStatistics/get-store-manager-indicators-comparison
功能说明：统计指定月份所有店长的三项指标完成情况，包括业绩、人头、消耗指标的完成度和底薪信息
请求参数：
json
{
"statisticsMonth": "202601",
"storeIds": ["门店ID1", "门店ID2"],  // 可选
"isNewStore": null,  // 可选，true=新店，false=老店，null=全部
"storeType": null,  // 可选，门店类型
"indicatorStatus": null  // 可选，"all_reached"=全部达标，"partial"=部分达标，"all_unreached"=全部未达标，null=全部
}

返回结构：
json
{
"code": 200,
"msg": "操作成功",
"data": {
"list": [
  {
    "StoreId": "门店ID",
    "StoreName": "门店名称",
    "EmployeeId": "员工ID",
    "EmployeeName": "员工姓名",
    "PerformanceIndicator": {
      "Target": 180000.0,
      "Actual": 22728.0,
      "CompletionRate": 12.63,
      "Reached": "否"
    },
    "HeadCountIndicator": {
      "Target": 0.0,
      "Actual": 81,
      "CompletionRate": 0.0,
      "Reached": "是"
    },
    "ConsumeIndicator": {
      "Target": 0.0,
      "Actual": 55634.56,
      "CompletionRate": 0.0,
      "Reached": "是",
      "IsAssessed": true
    },
    "BaseSalary": {
      "FixedSalary": 4000.0,
      "UnreachedIndicatorCount": 1,
      "AssessmentDeduction": 500.0,
      "FlagshipStoreDeduction": 800.0,
      "ActualSalary": 2700.0
    }
  }
],
"summary": {
  "TotalCount": 29,
  "AllReachedCount": 0,
  "PartialReachedCount": 29,
  "AllUnreachedCount": 0,
  "AveragePerformanceCompletionRate": 50.49,
  "AverageHeadCountCompletionRate": 0.0,
  "AverageConsumeCompletionRate": 0.0
}
}
}


2. 获取店长全年三项指标数据

接口地址：POST /api/Extend/LqStatistics/get-store-manager-yearly-indicators
功能说明：统计指定店长在指定年份的所有月份的三项指标完成情况
请求参数：
json
{
"employeeId": "店长ID",
"year": 2026
}

返回结构：
json
{
"code": 200,
"msg": "操作成功",
"data": {
"EmployeeId": "19983587302",
"EmployeeName": "曾玉莲",
"Year": 2026,
"MonthlyData": [
  {
    "Month": "202601",
    "StoreName": "绿纤犀浦店",
    "PerformanceIndicator": {...},
    "HeadCountIndicator": {...},
    "ConsumeIndicator": {...},
    "BaseSalary": {...}
  }
],
"YearlySummary": {
  "TotalMonths": 12,
  "WorkedMonths": 3,
  "AveragePerformanceCompletionRate": 7.61,
  "AverageHeadCountCompletionRate": 0.0,
  "AverageConsumeCompletionRate": 0.0,
  "AllReachedMonths": 2,
  "PartialReachedMonths": 1,
  "AllUnreachedMonths": 0,
  "AverageActualSalary": 3833.33,
  "TotalAssessmentDeduction": 500.0
}
}
}


三、接口调用示例
示例1：查询门店驾驶舱统计数据（含储扣分析）
curl -X POST "http://localhost:2011/api/Extend/LqStoreDashboard/GetStatistics" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "storeId": "1649328471923847193",
    "statisticsMonth": "202601"
  }'

示例2：查询当月全部店长三项指标对比
curl -X POST "http://localhost:2011/api/Extend/LqStatistics/get-store-manager-indicators-comparison" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "statisticsMonth": "202601",
    "indicatorStatus": "all_reached"
  }'

示例3：查询店长全年三项指标数据
curl -X POST "http://localhost:2011/api/Extend/LqStatistics/get-store-manager-yearly-indicators" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "employeeId": "19983587302",
    "year": 2026
  }'


四、接口快速索引


功能
接口地址
方法


门店驾驶舱统计（含储扣）
/api/Extend/LqStoreDashboard/GetStatistics
POST


当月全部店长对比
/api/Extend/LqStatistics/get-store-manager-indicators-comparison
POST


店长全年数据
/api/Extend/LqStatistics/get-store-manager-yearly-indicators
POST


门店分类月度业绩
/api/Extend/LqStoreDashboard/GetCategoryMonthlyPerformance
POST


会员转化漏斗
/api/Extend/LqStoreDashboard/GetMemberConversionFunnel
POST


客单价项目数关系
/api/Extend/LqStoreDashboard/GetCustomerPriceProjectRelation
POST


一周运营热力图
/api/Extend/LqStoreDashboard/GetWeeklyHeatmap
POST


五、注意事项

认证：所有接口都需要在Header中携带 Authorization: Bearer {TOKEN}
Content-Type：POST请求需要设置 Content-Type: application/json
时间格式：


统计月份格式：YYYYMM（如：202601）
时间范围格式：yyyy-MM-dd HH:mm:ss

服务地址：默认 http://localhost:2011（根据实际部署环境调整）


六、测试数据参考
测试门店ID

绿纤南湖店：1649328471923847193
其他门店：1649328471923847173

测试月份

202601（2026年1月）
202512（2025年12月）

测试店长ID

曾玉莲：19983587302
肖静梅：13551112519