lingxing-monthly-report

# 领星 ERP 运营月复盘全自动化工作流 (KovaScape 专属版) ## Overview 本 Skill 规范了南京欧洲组（KS 品牌）亚马逊店铺运营月度复盘数据的全自动拉取、聚合、校验与 3 大目标汇报表格的全 Sheet 自动化填报、终极真实毛利结算与滚动更新流程。 --- ## When to Use - 当用户需要生成、拉取、填报或更新**领星 ERP 运营月复盘**、**运营主管月复盘**或**当月销售分析**时。 - 触发关键词：`月报`、`月度复盘`、`主管月复盘`、`当月销售分析`、`生成 6 月月报`、`滚动月度数据`、`领星月报`。 --- ## Quick Reference (快速参考表) | 视角/维度 | 权威数据源 & MCP 工具 | 核心指标 & 适用规则 | | :--- | :--- | :--- | | **店铺边界** | `get_my_sids` | **严格限定「南京欧洲组KS」** (SIDs: 5018-5031, 5751)，忽略其他无关组。 | | **1. 订单预估利润** | `query_product_performance_asin_lists` (下单视角 `date_type="purchase"`) | ASIN级销售额、销量、广告费与预估订单利润。 | | **2. 差额修正项** | `get_profit_report_msku` (结算视角 `date_type="settlement"`) | 提取仓储费、赔偿金、FBA移除弃置、盘亏盘盈等调整数据。 | | **3. 终极真实毛利** | **核心公式合成** | `终极真实毛利 = 订单预估利润 + 仓储差异 + 杂费对冲 + 盘库调整` (详见下文)。 | | **有效链接去重** | `E:\#工作资料\备货计划\新品下单文件_*.xlsx` | 按负责人 + 父 ASIN 且**当月销售额 > 0**；多个国家同一产品只算 1 条链接。 | | **FBA 清货存量** | `FBA库存情况` Sheet | 91-180天目标=实际\*0.8；181-270天目标=实际\*0.5；271天以上目标=实际\*0.3。 | --- ## 终极真实毛利核算步骤与公式 为保证产品表现层面的“预估利润”与公司“结算利润”100%拉齐，必须执行三步法合成计算： ### 1. 提取基础订单预估利润 从 `query_product_performance_asin_lists` 汇总得到基础数据： $$\text{订单预估利润} = \text{销售额} - \text{平台佣金} - \text{FBA配送费} - \text{预估采购成本} - \text{预估头程成本} - \text{广告花费}$$ ### 2. 从 MSKU 利润表提取修正细项 调用 `get_profit_report_msku` 抓取对应的实际财务账单修正项： - **仓储差异** = $\text{fbaStorageFeeAccrual} (\text{预扣仓储}) - \text{fbaStorageFee} (\text{实际仓储})$ - **杂费对冲** = $\text{reimbursements} (\text{库存赔偿}) + \text{platformFee} (\text{实际平台调整}) - \text{others} (\text{其他退回对冲})$ - **盘库调整** = $\text{cgPriceTotal} (\text{盘点出入库采购}) + \text{cgTransportCostsTotal} (\text{盘点出入库物流}) - \text{sharedFbaRemovalFee} (\text{移除货损})$ ### 3. 合成最终指标 $$\text{终极真实毛利} = \text{订单预估利润} + \text{仓储差异} + \text{杂费对冲} + \text{盘库调整}$$ $$\text{真实毛利率} = \text{终极真实毛利} / \text{销售额}$$ --- ## Core Workflow (核心执行步骤) ```dot digraph monthly_report_flow { node [shape=box, style=filled, fillcolor="#f0f4f8", fontname="Microsoft YaHei"]; start [label="收到月报指令 (如: 生成7月月报)", fillcolor="#d9eefd"]; query_mcp [label="1. 优先调用 领星 MCP API\n拉取订单预估与 MSKU 修正项"]; calc_real [label="2. 根据修正公式合成\n终极真实毛利润与真实毛利率"]; dedup_links [label="3. 计算有效链接数 (销售>0 & 跨国去重)\n及 Top20 毛利占比 (全组≤20条为100%)"]; calc_fytd [label="4. 动态计算 财年累计完成度(4月~当月)\n(从4月起连续累加至当月实际毛利对比目标)"]; roll_month [label="5. 执行滚动前移更新\n(更新表头, 旧当月前移, 未发生月份留空)"]; fill_sheets [label="6. 自动化填报 3 大工作簿\n(对齐 Column 坐标: J=退款率, K=退货率, O=海运费占比, Q=问题, R=解决)"]; embed_kiss [label="7. 精确覆盖写入 KISS 原则复盘文案\n(王祎-当月销售分析 Sheet Row 46-94 Col B)"]; verify [label="8. 自动校验与路径输出\n(保存至 d:\\Zero Tools\\data\\ 避免覆盖原表)", fillcolor="#e6f4ea"]; start -> query_mcp -> calc_real -> dedup_links -> calc_fytd -> roll_month -> fill_sheets -> embed_kiss -> verify; } ``` --- ## 3 大目标汇报文件与 Sheet 坐标规约 ### 1. 《2026财年运营月复盘---运营六组 王祎-YYYYMM.xlsx》 - **`全年完成总表`**：Col E Row 4 (实际销售额)，Col E Row 8 (实际毛利额)。 - **`月度产品分析表`**：Col K (11) 为**月产品成本占比 (采购成本/销售额)**，必须赋值浮点数并应用 `0.0%` 百分比格式！ - **`总产品` Sheet 列坐标规约**： - Col E (5): `评分/评论数` (如 `4.4/55`) - Col F (6): `月销量` | Col G (7): `月销售额` | Col H (8): `月利润率` | Col I (9): `月毛利润` - Col J (10): `月退款率` | **Col K (11): `月退货率`** (数值，如 `0.034`) - Col L (12): `月广告费占比` | Col M (13): `月仓储费占比` | Col N (14): `月产品成本占比` - **Col O (15): `月海运费占比`** (如 `0.0515`) | **Col P (16): `月库销比`** (如 `11.0`) - **Col Q (17): `运营中问题总结`** (写入【异常诊断点】) - **Col R (18): `解决办法`** (写入【优化解决措施】) ### 2. 《2026年M月运营主管月复盘- 王祎.xlsx》 - **`链接数量汇总`**：填报有效链接数（化一博 8，王祎 5，全组 13），Top20 占比（100.0%）。**其他运营组保持留空**。 - **`月度销售数据`**：填报当月目标/实际销售额与毛利润；Col V-AA 填报 **财年累计完成情况（4月至当月累加）**。**原生 Row 17-21 备注切勿覆盖**。 - **`工厂端库存`**：**全表保持留空**。 ### 3. 《王祎-当月销售分析-YYYYMM.xlsx》 - **`王祎-当月销售分析` Sheet**： - 保留 Row 1 ~ Row 45 原生核心指标与公式。 - **清空未发生的未来月份**：将尚未到来的未来月份实际销售额与毛利率清空 (`None`)。 - **KISS 原则精细覆盖**：将包含 Keep / Improve / Stop / Start(含 1-2 分钟 AI 提效介绍) 的精制复盘段落，覆盖写入 **Row 46 ~ Row 94 Col B (合并单元格 B47:B94)**，切勿掩盖上文核心指标。 --- ## 财年累计与滚动更新规范 (Fiscal Year-to-Date & Rolling Rules) 1. **财年累计公式 (FYTD Cumulative Profit)**： - 财年周期为 **4月 至 次年 3 月**。 - 累加范围：`sum(4月实际订单毛利 ... 当月实际订单毛利)` vs `sum(4月目标毛利 ... 当月目标毛利)`。 2. **表头与数据前移**：每月制作新月报时，自动将上月表头与数据推移至“前一个月”，最新月份数据写入“当月”。 3. **新增产品 100% 自动检查机制**：7 月及未来月报执行时，必须自动扫描校验产品表里所有**新增/新上架 ASIN 的数据完整性**，确保零遗漏。 --- ## Common Red Flags & Mistakes (避坑指南) - ❌ **严禁固定为 Q1/3个月累加**：财年累计完成度必须按**4月至当前月**动态连续累加。 - ❌ **严禁直接使用订单预估利润代替真实毛利**：必须拉取 MSKU 利润表中的仓储差异、杂费对冲和盘库调整进行差额扣减后，再填入毛利额中。 - ❌ **严禁混淆 Col K 与 Col Q/R**：退货率数值在 Col K (11列)，诊断问题在 Col Q (17列)，解决办法在 Col R (18列)。 - ❌ **严禁使用 MergedCell 赋值报错**：赋值前需使用 `isinstance(cell, Cell)` 检查，防止合并单元格引发 AttributeError。 - ❌ **严禁把未来月份错填为历史数据**：未到来的月份实际值必须填 `None` 留空。 --- ## Implementation (一键执行脚本) ```bash # 运行月复盘全自动化主控脚本 python src/fill_all_sheets_master.py --month=202606 ```