外卖日报更新流程业务逻辑确认版

用于业务负责人确认流程、标准和异常处理口径。当前版本基于已跑通的本地自动化流程整理,正常成功路径不依赖影刀,也不消耗 Codex/LLM token。

一、流程总览

每天自动从 4 个平台下载报表,刷新日更工作簿,再写入飞书多维表。

执行时间
每日 08:00
日期范围
昨天往前 5 天
报表数量
必须 14 份
上传结果
6 张日更结果表
1. 启动任务Windows 计划任务按每日 08:00 启动日报流程。
2. 计算日期结束日期为昨天,开始日期为昨天往前 4 天,共连续 5 天。
3. 下载报表从饿了么/淘宝闪购、京东、美团、小匠人下载 14 份。
4. 验证完整必须集齐 14 份,且每份都不是空表。
5. 清洗合并分发到日数据存档处,规范化后刷新日更工作簿,并校验 6 张结果表日期。
6. 写入飞书清空当前 5 天范围后重建 6 张日更结果表,并逐唯一键校验。
flowchart TD
  A["每日 08:00 启动"] --> B["计算日期:昨天往前连续 5 天"]
  B --> C["清理上次暂存文件"]
  C --> D["下载 4 平台共 14 份报表"]
  D --> E{"14 份齐全且非空?"}
  E -- 否 --> F["停止上传,保留日志/截图,进入排查"]
  E -- 是 --> G["分发到日数据存档处"]
  G --> H["规范化表头/格式/日期"]
  H --> I["刷新外卖数据日更表-日.xlsx"]
  I --> I2{"6 张结果表日期与表对象校验通过?"}
  I2 -- 否 --> F
  I2 -- 是 --> J["飞书上传前维护:重复/空键/容量"]
  J --> J2["清空飞书当前 5 天范围"]
  J2 --> K["上传 6 张日更结果表"]
  K --> L["飞书上传后维护:重复/空键/容量"]
  L --> L2{"飞书与本机 Excel 唯一键完全一致?"}
  L2 -- 否 --> F
  L2 -- 是 --> M["清理分发源文件和关闭自动化浏览器"]
          

二、必须下载的 14 份报表

少一份、多一份、空一份,都不进入飞书上传。

饿了么 / 淘宝闪购

  • 门店下载
  • 订单下载
  • 商品下载
  • 评价下载
  • 商家成长

京东到家 / 京东秒送

  • 门店
  • 订单
  • 商品
  • 订单评价

美团外卖

  • 门店
  • 订单
  • 商品
  • 评价

小匠人

  • 渠道成本分析

三、各平台下载规则

这里是业务动作口径,用于核对平台入口、日期、门店和下载列表规则。

平台 进入位置 关键动作 验收标准
饿了么 / 淘宝闪购 数据下载 依次处理门店下载、订单下载、商品下载、评价下载、商家成长;设置统一 5 天日期,选择全部门店,点击下载数据。 5 份有效报表
京东到家 / 京东秒送 经营罗盘 → 报表下载;顾客管理 → 旧版评价管理 门店/订单/商品需要生成后到下载列表点击下载。订单评价必须进入旧版评价管理,评价类型切到订单评价,选择全部门店,设置日期,先筛选再导出。 4 份有效报表
美团外卖 经营罗盘 → 报表下载 顶部导航依次处理门店、订单、商品、评价;设置日期,勾选全选,点击下载数据;弹窗出现后前往下载列表,等待导出中变为下载后点击下载。 4 份有效报表
小匠人 6.14 渠道成本分析 确认左侧导航为 6.14 渠道成本分析,设置同样 5 天日期,点击直接导出。 1 份有效报表
下载后会检查是否为空表。若只有表头、无有效数据行、文件异常小或格式无法读取,判定为失败并重试;仍失败则停止后续上传。
口径项 确认规则 适用场景
饿了么 / 淘宝后台订单量 取「门店下载」表格中的「有效订单」字段;业务侧所说「后台订单量」等价于该字段。 外卖门店运营表、5 月历史数据核对、后续日更。
饿了么 / 淘宝补数方式 跨月或较长周期修正时按 5 天一段下载和刷新,避免一次拉取长周期造成后台导出缺口或字段错位。 2026-05-18 至 2026-05-20 补充、2026 年 5 月全月修正。
商品日表核对源 商品销售、销量、成本类结果以「商品成本表 / 渠道成本分析」进入日更工作簿后的结果为准,不直接用原始平台商品下载表做最终成本口径核对。 外卖商品日表-日更、成本字段准确性核查。

四、分发、清洗与日更工作簿

14 份原始报表不是直接上传飞书,而是先刷新成本地日更结果。

步骤 业务说明 成功条件
数据下载包 所有下载文件先进入 数据下载包 正好 14 份有效报表。
分发到日数据存档处 按平台和报表类型移动到对应文件夹,例如美团订单、京东评价、饿了么商品、商品成本表。 14 份全部匹配到目标文件夹,无未识别文件。
规范化 统一 xls/xlsx/csv 差异、表头、日期字段、部分格式差异。 所有源文件可被工作簿正常读取。
刷新工作簿 刷新 外卖数据日更表-日.xlsx 6 张日更结果 Sheet 都刷新成功;每张都保留 Excel 表对象;日期范围严格等于本次 5 天。
上传前结果修正 工作簿刷新后执行上传前校验:饿了么/淘宝「顾客实付」为空时由「顾客实付总额」补齐;美团订单缺失唯一键时生成稳定指纹键。 上传前 6 张结果 Sheet 不存在空唯一键,关键金额字段不因工作簿字段差异变空。

五、飞书多维表上传与维护

最终写入飞书的是 6 张日更结果表,并在上传前后做数据维护。

上传的 6 张表

  • 外卖时段订单-日更
  • 外卖商品日表-日更
  • 外卖评价表-日更
  • 外卖门店运营表-日更
  • 饿了么运营分指标-日更
  • 美团运营分指标-日更

新增/更新判断

  • 按当前 5 天日期范围读取飞书已有数据。
  • 用唯一键判断新增或更新。
  • 美团订单等缺失唯一键的行生成稳定指纹键,避免漏传或重复累计。

上传前维护

  • 清理当前 5 天重复唯一键。
  • 删除当前 5 天空唯一键记录。
  • 若表行数超过安全阈值,先删除最早日期数据。
  • 上传前清空 6 张飞书日表的当前 5 天范围,再从本机工作簿重建。

上传后维护

  • 再次检查重复行。
  • 再次检查空唯一键。
  • 再次检查容量,保证后续日更可继续运行。
  • 逐表比对本机工作簿与飞书的唯一键集合,必须完全一致。
维护项目 当前规则 说明
行数容量 超过 195000 行触发 按日期从最早的数据开始删除,目标降到约 190000 行,给新数据预留空间。
重复数据 当前 5 天内按唯一键去重 重复时保留 1 条,删除多余记录。
空唯一键 当前 5 天内删除 不全表盲删历史空行,避免误删非本次流程产生的数据。
空白行 按空唯一键异常记录处理 业务上最关键的是不能留下无法比对的记录;完全空白行不做无差别全表删除。
当前日期范围重建 上传前必须清空再重建 避免飞书保留“日期正确但本轮 Excel 已不存在”的旧记录,防止假成功。
上传后逐键校验 6 张表唯一键集合必须完全一致 本机 Excel 与飞书任意一张表出现缺失、额外、空唯一键或重复唯一键,都判定失败。

六、异常与停止规则

失败时不上传半套数据,优先保留证据供排查。

异常类型 处理方式 是否继续上传
未集齐 14 份报表 标记失败,指出缺失或多出的报表。 不上传
报表为空或读取异常 自动重试;多次仍失败则停止。 不上传
登录失效、验证码、滑块、人机验证 保留截图和日志,进入人工处理或后续排查。 不上传
普通弹窗、公告、活动提示 识别后点击关闭、我知道了、取消、跳过等安全按钮。 可继续
飞书接口异常或容量异常 上传前后维护;仍失败则停止并保留日志。 视结果停止
工作簿刷新结果不完整 若 6 张结果表任意一张缺失 Excel 表对象、日期不是本次 5 天、或 SheetOk 不等于 6,立即失败并停止上传。 不上传
上传后飞书与本机 Excel 不一致 逐表比对唯一键集合;任何缺失、额外、重复、空键都视为数据未校对成功。 标记失败

七、校对成功硬规则

以下条件全部满足,才允许把任务判定为成功;任何一项不满足都必须报错并停止。

校对节点 硬规则 失败时处理
报表下载 数据下载包必须正好集齐 14 份报表,且每份可读取、非空、日期范围为本次连续 5 天。 重试对应报表;仍失败则不分发、不刷新、不上传。
日更工作簿刷新 外卖数据日更表-日.xlsx 的 6 张上传结果表必须全部刷新成功;SheetOk=6;每张结果表必须仍是 Excel 表对象/ListObject。 判定工作簿损坏或刷新失败,停止上传;必要时用干净模板恢复后重跑。
结果表日期 6 张结果表的 日期 字段必须严格等于本次 5 天范围,不能出现旧日期、缺日期或超范围日期。 停止上传,避免把旧数据当成本日更新结果。
上传前飞书处理 6 张飞书目标表必须先删除当前 5 天日期范围内的旧记录,再按本机工作簿重建。 删除失败则停止上传;不允许在旧范围上直接增量叠加。
唯一键 本机 6 张结果表与飞书 6 张目标表都不能存在空唯一键;当前 5 天范围内不能存在重复唯一键。 上传前修复可修复项;仍有空键或重复则失败。
上传后逐键校验 逐表比较本机 Excel 与飞书当前 5 天的唯一键集合:行数、唯一键数、每一个唯一键必须完全一致。 任何差异都判定为假成功风险,任务报错并进入排查。
收尾清理 上传校验通过后,才允许清理分发源文件、关闭自动化 Chrome,并写入成功日志。 若前面任意校验失败,保留源文件、日志、截图用于排查。
关键原则:不能只看脚本退出码或“上传接口返回成功”。业务成功必须以本机 6 张日更结果表和飞书 6 张目标表在当前 5 天范围内逐唯一键完全一致为准。

八、耗时预估与成功判定

基于当前已跑通流程估算,实际时间受平台导出队列影响。

阶段 预计耗时 备注
14 份报表下载 约 11 分钟 美团下载列表等待时间波动最大。
分发、规范化、刷新工作簿 约 1.5 分钟 依赖本地 Excel 刷新速度。
飞书上传 约 1-2 分钟 按当前 5 天日期范围比对,不全表扫描。
飞书上传前/后维护 约 7-9 分钟 检查重复、空唯一键和容量;上传前清空当前 5 天范围后重建。
上传后逐键校验 约 1.5-2 分钟 逐表比较本机工作簿与飞书唯一键集合。
本地清理、关闭浏览器 1 分钟以内 清空分发源文件,关闭自动化专用 Chrome。
全流程正常预估 约 25-32 分钟 新硬校验会增加耗时,但能避免“脚本成功、业务数据未更新”的假成功。
最终成功条件:14 份报表齐全且非空;6 张日更结果表刷新成功且 SheetOk=6;6 张结果表日期严格等于本次 5 天;飞书当前 5 天范围已清空并重建;本机 Excel 与飞书逐唯一键完全一致;重复唯一键为 0;空唯一键为 0;表容量低于安全阈值;分发源文件已清理;自动化浏览器已关闭。