订单回款发票三方勾稽

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

# 订单回款发票三方勾稽

一笔业务要过三道关：**有没有单（订单/合同）→ 有没有货票（发票）→ 有没有钱（回款）**。三张表对着看，才能暴露经典问题：

- 有单无票无款 —— 签了没做
- 有单有票无款 —— 发货开票没收款
- 有票有款无单 —— 钱进来了找不到源头
- 票款不等 —— 开票金额和回款金额对不上

本包按**匹配键**把三张表对齐，逐组判定状态。

## 匹配键怎么定

```
优先：订单号（单据号）
退化：订单号为空时，用「客户 + 类型」组合
```

三表同一键的金额汇总后比对。

## 输出四件套

| 文件 | 内容 |
|---|---|
| `tw_主表.csv` | 逐组：匹配键 / 勾稽状态 / 订单金额 / 开票金额 / 回款金额 / 票-款差 |
| `tw_异常表.csv` | 差异明细：行号 + 状态 + 原因 |
| `tw_校验表.csv` | 匹配键规则、容差、各状态组数 |
| `fin-log.jsonl` | 处理日志（追加） |

## 环境准备

```bash
PY="<python 3.8+ 路径>"   # 纯标准库
"$PY" <skill目录>/scripts/three_way.py <订单表> <回款表> <发票表> [参数]
```

## 用法

```bash
three_way.py 订单表.xlsx 回款表.xlsx 开票表.xlsx
three_way.py 订单表.xlsx 回款表.xlsx 开票表.xlsx --tol 0.01 --execute
```

真实输出：

```
方案：订单 订单表.xlsx / 回款 回款表.xlsx / 发票 开票表.xlsx
  订单 订单表.xlsx：4 条可配，0 条作废
  回款 回款表.xlsx：5 条可配，0 条作废
  发票 开票表.xlsx：4 条可配，0 条作废
--- 三方勾稽 ---
  已勾稽    2 组
  多回款    1 组
  仅有订单   1 组
  无订单    2 组
  合计 6 组
```

常用参数：

| 参数 | 默认 | 说明 |
|---|---|---|
| `--tol` | 0.01 | 金额容差（元） |

## 八种状态

| 状态 | 判定 | 风险 |
|---|---|---|
| 已勾稽 | 有单有票有款，票-款差 ≤ 容差 | — |
| 少回款 | 回款 < 开票 | 高 |
| 多回款 | 开票 < 回款 | 高 |
| 未回款 | 有单有票无款 | 高 |
| 未开票 | 有单有款无票 | 高 |
| 仅有订单 | 有单无票无款 | 中 |
| 无订单 | 有款有票配不到单 | 高 |
| （作废行） | 源表标记作废，不参与 | — |

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

- **源文件零改动**：输出进 `_out/`，原表不动
- **默认预览**：不加 `--execute` 不写盘
- **不套对冲**：不配对的组就是不配对，不做"差额补平"
- **不作废金额**：源表没标作废的一律参与计算
- **不做业务判断**：回款迟到 3 天算不算异常，本包不代替你判断

## 人工复核（必读）

- 「多回款」可能是预收，也可能是**错付或超额付款**，要区分
- 「无订单」的回款要追查来源，可能是个人转账或走账
- 「未开票」在有预收账科的账套里很常见，别一律当问题
- 容差 0.01 元是技术容差，不是业务容差

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 两方往来勾对 | `ledger-reconcile` |
| 应收到期提醒 | `bill-due-remind` |
| 票款逐张匹配 | `invoice-payment-match` |
| 银行流水与日记账 | `bank-recon` |

## 可直接复制的说法

```text
把订单表、回款表、开票表三张做三方勾稽。
按订单号配对，订单号为空的退化成「客户+类型」。
每张表金额先汇总再比。
八种状态逐组判定：已勾稽、少回款、多回款、未回款、未开票、
仅有订单、无订单。多回款和少回款要分开列，不要对冲成一个数。
先预览给我看，确认后我再让你写盘。
```

## 做完怎么算完成

- [ ] 每种状态的组数已核对
- [ ] 「多回款」「无订单」两类的原因已查明
- [ ] 高风险的组已交业务追查

---

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

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

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