2026-06-15 14:29:24 +08:00

8.4 KiB

Raw Blame History

name	description	category
account-reconciliation	收银稽核对账。核对企迈（QianMai）系统账单与外卖平台（京东到家 / 美团外卖 / 饿了么·淘宝闪购）账单是否一致。当用户提供「美团饿了么收银稽核口径」类 Excel、需要做收银稽核 / 平台对账 / 账单核对 / 结算金额比对时使用。讲清数据结构、读取陷阱与逐单对账口径，按实际表灵活适配。	Data & Retrieval

收银稽核对账 (Account Reconciliation)

核对企迈系统账单与外卖平台账单逐单是否一致，定位差异。覆盖京东到家、美团外卖、饿了么（淘宝闪购）三个平台。

When to use

用户提供「美团饿了么收银稽核口径」一类的对账 Excel，要求做收银稽核 / 平台对账 / 账单核对。
需要逐单比对「企迈系统结算金额」与「平台结算金额」是否一致、定位差异订单。
需要核对平台佣金、配送费、优惠等科目口径。

⚠️ 实际 Excel 不保证标准（表头会错位、字段名会变、订单号带特殊前缀）。 不要硬编码列号，要按下文方法按「值/语义」定位列。本文字段名是当前样本口径，遇到新表先做「数据探查」确认，再套用对账逻辑。

Excel 结构

通常 7 个 sheet：

sheet	角色	形态
`对账映射关系`	口径说明	三组（企迈↔京东 / 企迈↔饿了么 / 企迈↔美团）字段映射 + 汇总公式
`企迈-京东` / `企迈-美团` / `企迈-饿了么`	企迈系统侧	流水拆分表：一个订单 = 多行，每行一个「结账方式名称」+ 金额
`平台-京东` / `平台-美团` / `平台-饿了么`	平台侧	宽表：一个订单 = 一行，几十~上百列

企迈侧需按 三方订单号 聚合，对「结账方式名称」透视，金额取 营业额（元）。
平台侧一单一行，主键 订单号（饿了么为 订单编号）。

对账映射关系 sheet 里的汇总公式用了 C2/C3/H2/M2/M6 这类单元格引用，存在 off-by-one 偏移、部分越界，不可直接套用。一律以实际数据验证为准。

数据读取的 5 个坑（务必处理）

订单号带前导反引号：企迈侧订单号/三方订单号以 ` 前缀存为文本（如 `3365287004676962），平台侧多为纯数字。关联前两边都要 lstrip('').strip()，统一转字符串再比较（平台侧 int 大数 str()` 后无精度问题）。
企迈-京东表头与数据错位 ~2 列：该 sheet 表头标签与列内容对不上（表头第 0 列写「门店名称」实际放门店编码；表头第 15 列写「优惠拉动营业额」实际放结账方式名称）。 不能信任 企迈-京东 的表头标签。美团/饿了么表头一般正常。
「结账方式名称」列要按值定位，避开干扰列：企迈侧同时存在 结账方式拆分 和 结账方式名称 两列，两列都可能含「XX支付」。正确的「结账方式名称」列应同时包含 结算行的值（如 美团外卖支付）和佣金行的值（平台佣金）。定位方法：
```
遍历每一列，取该列所有去重值集合；
选「同时包含 pay_name 且包含 '平台佣金'」的那一列；
找不到再退化为「只包含 pay_name」的列。
```
这样京东（表头错位）和美团/饿了么（表头正常）都能正确命中。
平台字段名有全角/半角括号、尾部空格差异：如饿了么的 平台服务费（含技术服务费和配送服务费） （全角括号 + 尾部空格）。匹配平台列时用「包含」而非「精确相等」，必要时去空格再比。
平台侧佣金/服务费是负数（扣项）：平台账单里佣金、平台服务费多为负值（从结算款里扣）。与企迈「平台佣金」（正值）比对时两边取绝对值。

关联键

企迈.三方订单号  ==  平台.订单号        # 京东、美团
企迈.三方订单号  ==  平台.订单编号      # 饿了么

清洗后取交集；不在交集的订单单独列出（「仅企迈有」「仅平台有」常见于售后单、跨日结算、未同步）。

对账口径（已用样本逐单验证，差异 = 0.00）

判定阈值：|企迈金额 − 平台金额| < 0.01 视为一致。

1) 结算金额（核心，必对）

企迈侧取「结账方式名称 = XX支付」那一行的 营业额，对平台结算字段：

平台	企迈侧（结账方式名称）	=	平台侧字段
京东	`京东支付`	=	`应结金额`
美团	`美团外卖支付`	=	`商家应收款`
饿了么	`淘宝闪购支付`	=	`结算金额`

2) 佣金（企迈「平台佣金」= 平台收取的全部服务费合计，取绝对值）

企迈侧「平台佣金」是平台收取的全部服务费（佣金 + 配送等打包），所以平台侧要用「含佣金和配送的平台服务费」整体比对，而非只看佣金分项：

平台	企迈侧	= \|Σ平台字段\|
京东	`平台佣金`	`总佣金(货款佣金+运费佣金+餐盒费佣金)(可开票)`
美团	`平台佣金`	`平台服务费(含佣金和配送服务费)`
饿了么	`平台佣金`	`平台服务费（含技术服务费和配送服务费）` + `增值服务费（店铺推广）`

很多订单没有「平台佣金」行（企迈侧缺该行）且平台佣金为 0，此时两边都是 0，一致。

3) 配送费 / 优惠（口径较模糊，建议「展示并人工核对」而非硬判定）

企迈侧配送/优惠类结账方式名称（如 满减配送费、折扣商品、使用红包、满减、 取件服务费、商家承担配送费、京东秒送货款优惠、优惠劵、淘宝闪购商家优惠、 店铺满减 等）与平台侧多个补贴/配送字段是多对多关系，映射表组合公式不可靠。 建议把企迈这些行的明细 + 平台对应字段并列展示，标出差额供人工判断，不强行下「一致/不一致」结论。

对账步骤

探查（每个新 Excel 必做）：打印各 sheet 行列数；打印企迈侧前几行带列索引的原始值，确认「三方订单号 / 营业额 / 结账方式名称」真实列位置（注意京东错位）；打印平台侧表头，确认结算/佣金字段真实列名（注意全角/空格）。
建企迈索引：按 三方订单号 分组（清洗反引号），对「结账方式名称」透视 营业额 求和，得到每单 {结账方式名称: 金额}。
建平台索引：按 订单号/订单编号 分组（清洗反引号），取结算字段、佣金字段（佣金可能多个字段求和）。
逐单比对：对交集订单，比「结算」「佣金」（取绝对值），算差额，<0.01 判一致；配送/优惠并列展示明细。
输出：
- 报告（markdown）：每平台订单数对比、仅单边存在的订单、逐单核对表（企迈结算 / 平台结算 / 差 / 一致；企迈佣金 / 平台佣金 / 差 / 一致）、企迈侧结账方式名称分布。
- 明细（CSV，用 utf-8-sig 便于 Excel 打开）：逐单各科目金额 + 企迈拆分串。

运行环境

本仓库用 poetry，读 Excel 用 openpyxl：load_workbook(path, data_only=True) 取计算值。
临时脚本放 /tmp，运行 poetry run python /tmp/xxx.py。
注意：用 heredoc 写脚本在本环境可能不落盘，用文件写入工具创建脚本更可靠。

排查

关联数为 0：订单号没对上 —— 检查反引号清洗、int/str 类型、是否取错 key 列（平台侧有「订单序号」「结算id」等多个像 key 的列，认准「订单号/订单编号」）。
某字段全为 NA：平台 sheet 实际列名与配置不符，用「包含」匹配并核对全角/空格。
结算对得上但佣金对不上：先确认企迈「平台佣金」列是否被「结账方式拆分」干扰列顶替（见读取坑第 3 点）；再确认平台侧佣金是否需多字段求和、是否取绝对值。
新平台 / 列名变化：先做「探查」确认结算、佣金字段真实列名，再按对账口径表配置；佣金若多字段组合，用「Σ后取绝对值」与企迈「平台佣金」比。

8.4 KiB Raw Blame History Unescape Escape