记账分录合法性校验

> **本地运行，零网络、免 API Key、数据不出电脑。**
> 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。

# 记账分录合法性校验

凭证审核的核心就五件事。人眼在几百行分录里过，抓不全这五类：

1. **借贷不平**——同一凭证内借方合计 ≠ 贷方合计
2. **科目级次错**——科目编码位数不符（一级 4 位，下级应为同级数字）
3. **辅助核算缺失**——往来类科目 1122 应付账款、2202 预收账款等没挂往来对象
4. **红字方向存疑**——红字冲销的方向与常规相反，可能冲错方向
5. **异常金额**——单笔超过阈值的大额凭证，需要重点关注

本包把这五类逐分录跑一遍，附原始行号，并做**金额守恒断言**——校验前后钱不能多也不能少。

## 输出四件套

| 文件 | 内容 |
|---|---|
| `ec_主表.csv` | 正常分录（保留可入账的记录） |
| `ec_异常表.csv` | 五类命中：行号 + 类型 + 原因 |
| `ec_校验表.csv` | 判定口径、命中统计、守恒差异 |
| `fin-log.jsonl` | 处理日志（追加） |

## 环境准备

```bash
PY="<python 3.8+ 路径>"   # 纯标准库
"$PY" <skill目录>/scripts/entry_check.py <凭证明细表> [参数]
```

## 用法

```bash
entry_check.py 凭证明细.xlsx
entry_check.py 凭证明细.xlsx --amount-warn 500000 --aux-codes 1122,2202 --execute
```

真实输出：

```
方案：凭证明细.xlsx | 分录 12 行 | 科目级次 4 位
--- 校验结果 ---
  借贷不平     2
  辅助核算缺失   1
  红字方向存疑   2
  异常金额     2
--- 校验表 ---
  主表金额合计 | 1840400.0
  异常表金额合计 | 55000.0
  守恒差异（入-主-异） | 0.0
```

常用参数：

| 参数 | 默认 | 说明 |
|---|---|---|
| `--level-len` | 4 | 一级科目编码位数 |
| `--amount-warn` | 0（不启用） | 单笔金额预警阈值 |
| `--aux-codes` | 空 | 需强制辅助核算的科目代码，逗号分隔 |

## 输入表

凭证分录明细表，列：`凭证号 / 科目代码 / 科目名称 / 方向（借/贷）/ 金额`，可选 `辅助核算 / 往来对象 / 摘要`。

支持自动识别的列名见脚本顶部常量，列名不同时按实际表头调整。

## 金额守恒断言

本包会强制断言：

```
输入金额 = 主表金额 + 异常表金额
```

**关键：输入口径必须包含异常行金额**。异常行的钱也是钱，漏算会报"输入 ≠ 主表 + 异"。差异超 0.01 元直接拒绝输出——财税场景，算错比不做更危险。

## 安全与边界（拒绝权）

- **源文件零改动**：输出进 `_out/`，原表不动
- **默认预览**：不加 `--execute` 不写盘
- **不代替审核决定**：命中只是待核实，最终由审核人处理
- **不校验业务合理性**：科目用得对不对、摘要写得清不清楚，不在本包范围

## 人工复核（必读）

- 「借贷不平」的凭证**一定不能入账**，要先查是否有分录漏录
- 「辅助核算缺失」在启用往来管理的账套会导致对账困难，需补挂
- 「红字方向存疑」要看原始冲销单据，方向反了等于做了一笔反向错账
- 金额阈值和辅助核算科目清单要按本公司会计政策维护

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 业务单据批量出凭证 | `voucher-batch-generate` |
| 往来账两方勾对 | `ledger-reconcile` |
| 月末结转凭证检查 | `month-end-close-check` |

## 可直接复制的说法

```text
把这张凭证分录明细按五类过一遍：借贷不平、科目级次错、
辅助核算缺失、红字方向存疑、异常金额。
每条命中带上原始行号和具体原因。
再做一次金额守恒断言：输入金额 = 主表金额 + 异常表金额，
差异超过 0.01 元就拒绝输出，不要给我一个看起来合理的数。
```

## 做完怎么算完成

- [ ] 五类命中项都能在原凭证找到依据
- [ ] 借贷不平的凭证已全部追回处理
- [ ] 金额阈值与辅助核算科目清单与本公司会计政策一致

---

本 Skill 采用 BUSL-1.1 许可（源码可见，可自由使用）。

版权所有 © 2026 律令科技（深圳）有限公司（@lexord-technology）。
本技能由律令科技（深圳）有限公司开发，**财友云（caiyouyun.cn）**发布与展示。

允许个人及企业内部免费使用、复制、修改，包括内部生产环境。
未经书面许可，不得将本 Skill 或其修改版作为商业服务对外销售、转售或提供托管服务。
各版本发布之日起 4 年后自动转为 Apache License 2.0。详见随包 `LICENSE.md`。