- name
- bank-reconciliation-claw
- description
- |
银行流水对账虾
自动核对银行流水、系统订单、发票台账，秒级定位差异，对账时间从半天压缩到分钟级。全程本地处理，财务数据不外传。
工作流程
- 数据接收 — 接收用户上传的 Excel/CSV 文件（流水、订单、发票）
- 字段标准化 — 统一日期格式（YYYY-MM-DD）、金额格式（两位小数）、编号格式
- 智能匹配 — 精确匹配 + 模糊匹配 + 多对一匹配（见
references/reconciliation-rules.md） - 差异识别 — 标记四类异常：🔴未匹配 / 🟡金额差异 / 🟠重复条目 / 🔵日期偏差
- 输出报告 — 生成匹配汇总、明细表、异常清单；可选写入飞书多维表格
使用方式
快速对账（两表）
用户说："帮我核对这份银行流水和订单表"，然后提供文件路径或上传文件。
调用核心脚本：
python3 scripts/reconcile.py reconcile \
--bank <bank_file.xlsx> \
--orders <orders_file.csv> \
--output report.xlsx三表全核
python3 scripts/reconcile.py reconcile \
--bank <bank_file.xlsx> \
--orders <orders_file.csv> \
--invoices <invoices_file.xlsx> \
--date-tolerance 3 \
--output report.xlsx预览数据解析
python3 scripts/reconcile.py preview --file <any_file.xlsx>写入飞书多维表格
python3 scripts/reconcile.py export \
--report report.xlsx \
--bitable-url <飞书多维表格URL>输入要求
| 文件类型 | 必填字段 | 说明 |
|---|---|---|
| 银行流水 | 交易日期、金额、流水号 | 支持主流银行格式，见 field-mapping.md |
| 系统订单 | 支付时间、金额、订单号 | 支持金蝶/用友/SAP 导出格式 |
| 发票台账 | 开票日期、开票金额、发票号 | 增值税发票标准格式 |
- 文件编码建议 UTF-8
- 金额列不含货币符号（脚本会自动清理 ¥ $ ,）
- 单文件建议不超过 50MB（约 10 万行）
参考资料
references/reconciliation-rules.md— 匹配规则、容差配置、异常分级references/field-mapping.md— 各银行/ERP/开票平台字段映射references/desensitization-rules.md— 脱敏规则（账号、姓名等）
依赖
Python 3.8+
pandas
openpyxl安装：pip install pandas openpyxl
与其他虾的协作
- cross-platform-messenger-claw — 对账完成后推送报告摘要到财务群
- auto-data-analysis-claw — 对对账结果做趋势分析、异常归因
- feishu-bitable — 将对账报告写入飞书多维表格供团队协作处理