SuperAPI AI 工具集

data-reconcile

办公与效率

查看项目

更新于 10-16 01:19

技能介绍

用途:用于财务对账,将 A(本方,如发票台账、现金账)与 B(对方,如总账、银行对账单、基金行政记录)逐条匹配,重点是把未对平项分类而非仅列出,并生成对账工作底稿供有资格人员复核签署。它是工作底稿,不是过账:只匹配与标注,不调整账目、不记更正、不写任何系统;未匹配项保持标注,绝不强行凑成匹配。匹配与分类在本机计算,引擎不发起外部调用;但驱动它的 AI 代理会把读取内容送入其上下文交由 AI 提供方,参见其数据与 PII 政策。

主要能力:两种匹配策略——键匹配(--mode key --key <col>)用于双方有共享引用(发票号、付款参考);金额+日期匹配(--mode amount_date)用于无干净键的银行对现金账场景,在金额容差内匹配最近日期,日期窗口默认 ±5 天(--date-window N)。窗口内的少量差额算时间性差异(在途),窗口外等额对不视为已对平,标为 ambiguous_match 待确认。金额按精确 Decimal 解析,比较币种(100 USD 不会匹配 100 SGD):可用 --currency <col> 指定币种列,否则从金额单元格符号读取,裸 $ 视为不明;开启 --strict-currency 时未知币种转为 currency_unknown 而非假定兼容。

其他能力:支持借方/贷方分列(--debit/--credit,有符号金额=借−贷)、反向符号(--flip-b)、期初+净变动=期末的完整性检查(--opening-a/--closing-a 等)、按 --as-of 计算未对平项账龄(age_days)、按预设(--preset)或通用方式运行、对未匹配残差做二次分类(重复、符号相反、金额不符等)。金额不符若差额为常见 GST/VAT/WHT 税率会给出净额对毛额提示(不改分类)。可选聚合:一方项对应另一方多项之和(sum-to-one)或双方批次总额对总额(sum-to-sum),属启发式,绝不自动接受,须先展示建议分组并取得用户确认后才应用(--auto-confirm 仅供无头/测试)。

用法:从技能目录运行。命令行示例:python scripts/reconcile.py A B --preset bank_vs_ledger --mode amount_date --out wp.xlsx。Python 调用可导入 reconcile_files、propose_aggregations、apply_aggregations、finalize、render_proposals、write_workpaper、render_report、PRESETS。金额日期模式务必传 --date <col>;无可用日期列时等额对会保留为 ambiguous_match 并告警。输出工作底稿 .xlsx 含 Summary/Exceptions/Matched/Aggregations 工作表,先给结论(RAG、对平率、已对平金额 vs 例外金额),再按重要性(escalate → material → immaterial)与类别排列例外,每项附可能原因与建议动作,动作由人执行。

限制与边界:仅做记录对记录的对账,不含预算/差异分析(无预算余量分析)、不含交易/资产分析(开发监控、资本回报等超出范围),不依赖其他工具包。是草稿而非建议,绝不臆造。预筛要求见 README 与 envcheck.py,需 Python 与 openpyxl(生成 .xlsx 工作底稿和读取 .xlsx 数据源),经共享引擎读取 CSV/PDF/.docx/.msg;代码无需网络、MS Office、凭据或连接器。对账常涉及银行信息与敏感账户数据,应保持本地,任何对账产物离开授权用途前用 redact() 遮蔽当事方与金额。其余预设、反馈格式与完整分类法见技能内 references/triage-taxonomy.md 等文件。

不提供的内容:本资料未给出具体价格、收费、平台适配清单或性能数据,暂未提供。