核心功能
rapprochement-bancaire 是 OpenClaw 财务自动化流水线的核心会计引擎,专精于银行-发票对账(bank reconciliation)。其设计哲学明确:状态可重建、逻辑不可复制——所有计算由 scripts/main.py 统一执行,禁止任何外部重实现。
工作流程
1. 输入依赖:严格读取 organisation-documents 分类后的 clients/<slug>/ 目录结构
2. 双阶段匹配:
3. TVA 交叉验证:自动比对发票声明税率与计算预期值,>5% 偏差触发异常
4. 输出产物:
- Pass 1:精确匹配(发票编号引用,±1€容差)
- Pass 2:模糊匹配(金额相近 + 交易对手名称相似度≥0.6)
followup.json(发票支付状态追踪)relances.json(阶梯式催款建议)anomalies.json(分级异常警报)compta_batch_report_<date>.json(合并报表)batch.lock.json(无异常期间自动锁定)
显著优势
- 确定性输出:脚本生成的 JSON 格式为下游技能(如
relances、仪表盘)的契约接口,杜绝手工格式偏差 - 智能容错:模糊匹配捕获遗漏引用;阶梯催款(30/60/90天+升级)自动化客户沟通
- 审计追踪:锁定期机制 + 哈希校验确保数据不可篡改;周期可完整重建
- 异常分级:明确区分"阻断性"(duplicata、TVA错误、大额孤儿付款)与"可忽略"异常
局限性与约束
- 强管道依赖:无法独立运行,必须等待
organisation-documents完成文档分类 - 无邮件处理能力:明确禁止触碰原始邮件,仅处理已落地文件
- 法语生态绑定:文件名解析、TVA 逻辑、银行格式预设均针对法国会计实践
- 不可干预性:用户/Agent 被禁止修改输出文件格式或重实现对账逻辑——任何偏离都会导致下游系统失效
适用场景
中型会计师事务所、企业财务共享中心的自动化日终批处理,尤其适合:
- 多客户并发对账(夜间批量运行)
- 需要严格审计轨迹的合规环境
- 已将文档分类流程标准化的成熟团队
风险管控
| 风险类型 | 缓解措施 |
|---------|---------|
| 格式契约破坏 | 强制脚本执行,禁止手工编辑 JSON |
| 误匹配(模糊阶段) | 0.6 相似度阈值 + 金额±1€双约束 |
| 大额资金孤儿 | >1000€ 无引用付款标记为阻断异常 |
| 重复付款 | 日期+金额+描述三重检测 |
| 脚本故障 | 要求直传 stderr,禁止手工补录 |
> 关键原则:此技能是"状态机"而非"编辑器"——它读取已分类事实,计算会计状态,输出标准化报告。所有 intelligence 封装在 main.py 中,Agent 仅负责触发与呈报。