外卖订单错误日志查询
外卖订单从平台推送到 ERP 的过程中，可能因为商品没有绑定 SKU、分店资料异常等原因导致订单没有生成，或者订单生成了但商品明细对不上系统物料。外卖订单错误日志查询就是回查这些失败记录的报表：按日期、订单来源、订单号或分店筛出错误记录，从「错误信息」列直接看出该补哪一项资料。
功能路径：系统菜单 → O2O业务 → 外卖接口 → 外卖订单错误日志查询
一、功能概述
1. 功能简介
美团、饿了么的订单在生成过程中，系统会把异常情况写入错误日志，本报表按业务日期把这些记录列出来。记录分两类：
- 订单没有生成：推送过程中报错，订单未落入 ERP，日志记录报错原因，例如分店停用、分店合作期已过；
- 订单生成了但商品对不上：外卖端商品没有填写 SKU 码，或填写的 SKU 码在 ERP 中找不到对应物料，日志记录对应的商品信息与 SKU 码，便于回头补全绑定关系。
2. 核心用途
- 漏单排查：门店反映外卖平台有单但系统查不到时，先在本报表确认是否推送失败；
- 绑定补全：从「错误信息」中拿到商品名称与 SKU 码，到外卖商品中补齐映射；
- 资料纠错：定位分店状态、合作有效期等基础资料问题；
- 对账留痕：按日期导出失败清单，作为与外卖平台核对的依据。
3. 整体结构
窗口分为三个部分：
- 查询方案栏：左侧列出默认方案与自定义方案；
- 条件区：按日期、订单来源、订单号、分店组合查询条件；
- 查询结果表格：默认列出业务日期、订单类型、订单号、错误信息、时间五列，还可勾出分店名称；「时间」是该条错误写入库的时刻，与「业务日期」（下单日）分列。
二、界面布局说明
顶部工具栏
- 退出：关闭当前查询窗口；
- 操作：切换查询方案、维护自定义方案；
- 报表：设置显示方式与打印输出；
- 条件：设置本次查询的筛选条件；
- 帮助：打开功能说明。
左侧：查询方案
方案分为「默认方案」与「自定义方案」两组。默认方案直接按条件区设置查询；自定义方案可保存常用的条件组合，下次点击即取。
右侧：查询结果
结果表格上方工具栏提供展开与折叠分组、数据导出、预览与打印等按钮；拖动列标题到上方分组带可按分店或订单来源分组汇总。
三、业务操作步骤
步骤 1：打开功能入口
系统菜单 → O2O业务 → 外卖接口 → 外卖订单错误日志查询。
窗口打开后左侧显示「默认分组」与本报表方案，右侧为空的查询结果区。
步骤 2：设置查询条件
点【条件】设置筛选项：
- 日期：业务日期区间，该项为必填，不选日期无法查询；
- 订单来源：默认提供美团、饿了么两个选项，门店开通了其他外卖渠道时以实际下拉内容为准；
- 订单号：已知具体外卖订单号时精确查找；
- 分店：只看某几家门店的记录，不选则查全部有权限的门店。
步骤 3：执行查询
确认条件后执行查询，表格按行列出符合条件的错误记录，「错误信息」列直接写明失败原因，「时间」列为该条记录写入的时刻；表格还带「业务日期」「订单类型」「订单号」三列，分店名在可选字段清单里。
步骤 4：按错误类型分别处理
- 提示 SKU 码为空的，到外卖商家端补填 SKU，或在 ERP 的外卖商品中建立映射；
- 提示 SKU 码匹配不到系统商品的，核对该 SKU 码在 ERP 物料中是否存在、是否被停用或改过编码；
- 提示分店停用、分店合作期已过的，先恢复分店状态或续期，再让平台重新推单。
补齐资料后再次查询，同一订单不再出现新的记录，说明问题已解决；若订单仍未生成，需在外卖订单接收侧确认补推是否成功。
步骤 5：导出留档
需要与平台或总部核对时，用结果区工具栏的数据导出把清单导成表格，按门店分发整改。
四、字段详细说明
1）查询结果列
| 字段名 | 含义 |
|---|---|
| 业务日期 | 外卖订单的下单日期 |
| 订单号 | 外卖平台的订单编号 |
| 订单来源 | 订单来自哪个外卖平台 |
| 分店名称 | 该订单对应的外卖分店 |
| 错误信息 | 记录失败原因或缺失的商品信息 |
| 时间 | 该条错误记录的写入时间 |
2）查询条件项
| 条件 | 说明 |
|---|---|
| 日期 | 业务日期区间，必填 |
| 订单来源 | 美团、饿了么等外卖平台 |
| 订单号 | 外卖平台订单编号，支持精确查找 |
| 分店 | 按外卖分店筛选，受当前操作员的数据权限限制 |
3）常见错误信息类型
| 类型 | 典型提示 | 处理方向 |
|---|---|---|
| 商品未填 SKU | 商品名称为[某商品]的SKU码为空 | 在外卖商家端补填 SKU 码 |
| SKU 匹配不到物料 | 商品名称为[某商品]的SKU码为[Mstar…]，匹配不到系统商品 | 核对 ERP 物料上的 SKU 码，重建映射 |
| 分店异常 | 分店停用、分店合作期已过等 | 恢复分店状态或续期后重新推单 |
错误信息的具体文字由平台推送结果决定，以实际记录为准。
五、典型使用场景
场景 1：门店反映外卖平台有单、系统里查不到
店长在平台看到顾客已下单，ERP 订单列表却没有这笔单。运营在本报表按日期与分店查询，找到该订单号的一条记录，错误信息写明商品 SKU 码为空，说明订单在明细映射阶段被拦下。到外卖商品中补好该商品的 SKU 映射，再让平台重推，订单即正常接入。
场景 2：新开门店首日外卖全部失败
新店上线当天所有外卖订单都没进来。按分店查询，错误信息集中在分店状态一类提示上，检查该分店在外卖接口中的启用与合作有效期设置，纠正后重新查询，不再产生新记录。
六、权限控制与前置条件
- 需具备 O2O业务 → 外卖接口 → 外卖订单错误日志查询 的菜单权限；
- 门店外卖订单接入相关的零售特点需已开启，未开启时打开功能会提示「尚未启用外卖配送功能设置」，需先在零售特点中启用；
- 分店数据受操作员权限限制，只能看到自己有权限的门店记录；
- 本报表为查询功能，不修改任何订单数据，可放心反复查询。
七、常见问题
1. 打开功能时提示「尚未启用外卖配送功能设置」
- 原因：门店外卖订单接入的零售特点未开启，或当前账套读取零售特点失败；
- 处理：请先在零售特点中启用门店外卖相关设置，确认无误后再打开本报表。
2. 查询没有任何记录，但确实漏了单
- 原因：日期区间没有覆盖下单日期，或订单来源、分店筛选过窄；
- 处理：把日期放宽到下单当天前后，取消分店与来源限制再查一次。
3. 补好 SKU 后错误记录还在
- 原因：日志记录的是当时那次推送的结果，属于历史留痕，不会因为后续补绑定而自动消失；
- 处理：以「时间」列判断是否为新记录。补齐绑定后仍没有新记录，说明问题已解决，历史条目可继续保留备查。
4. 订单生成了，但明细显示为未定义 SKU 商品
- 原因：外卖端缺 SKU 的商品走的是兜底映射，订单能接入但明细对不上真实物料；
- 处理：参见修改外卖订单未定义Sku商品，开启允许门店修改的特点后在订单中心改回真实商品。
相关文档
附：本文档变更记录
| 日期 | 变更 |
|---|---|
| 2026-11-09 | 初稿 |