进销项发票月度核对

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

# 进销项发票月度核对

申报表上「本期应补(退)税额」这一栏，是拿销项减进项算出来的。但这两个数从哪来，取决于你用**哪个口径**：

- **开票期**：票开在这个月，就算这个月的（勾选平台的统计逻辑）
- **所属期**： belonged 到这个月的收入与进项（会计的权责发生制口径）

两个口径不一致是正常的，很多公司就在打架——申报用的是开票期，账用的是所属期。本包**两种都算**，但不会替你选，也不会把两个数混成一个。

## 输出四件套 + 底稿

| 文件 | 内容 |
|---|---|
| `vat_主表.csv` | 逐票明细，附所属期标记与是否计入申报 |
| `vat_汇总.csv` | 按期间 + 方向 + 口径汇总：票量 / 不含税 / 税额 |
| `vat_异常表.csv` | 跨期、红字、税率异常、无税额 |
| `vat_申报底稿.csv` | 可直接拿去填申报表的数（分期间与方向） |
| `vat_校验表.csv` | 口径、范围、纳入申报的金额合计、人工复核声明 |
| `fin-log.jsonl` | 处理日志（追加） |

## 环境准备

```bash
PY="<python 3.8+ 路径>"   # 纯标准库
"$PY" <skill目录>/scripts/vat_recon.py <进项表> <销项表> [参数]
```

## 用法

### 双口径都算

```bash
vat_recon.py 进项明细.xlsx 销项明细.xlsx
```

真实输出：

```
方案：进项明细.xlsx + 销项明细.xlsx | 进项 218 张 / 销项 208 张
  统计口径：开票期 + 所属期(2026-09) 两种都算
--- 汇总（开票期）---
  期间      | 方向 | 票量 | 不含税金额      | 税额
  2026-09  | 进项 | 186  | 1,284,500.00    | 166,985.00
  2026-09  | 销项 | 172  | 2,015,300.00    | 261,989.00
--- 差异 ---
  销项税额 - 进项税额 = 94,004.00（开票期口径）
  销项税额 - 进项税额 = 91,250.00（所属期口径）
  ⚠ 跨期票 7 张：销项 4 张开在 9 月但所属期在 8 月
```

### 只按申报口径（开票期）

```bash
vat_recon.py 进项明细.xlsx 销项明细.xlsx --mode 开票期
```

### 指定所属期

```bash
vat_recon.py 进项明细.xlsx 销项明细.xlsx --period 2026-09
```

## 两条口径的区别

| | 开票期 | 所属期 |
|---|---|---|
| 定义 | 按开票日期归属月份 | 按"所属期"列归属，无该列时拒用 |
| 用于 | 增值税申报（勾选平台） | 会计期间的收入成本配比 |
| 风险 | 跨期会与账对不上 | 与勾选平台数不一致 |

**没有「所属期」列却指定了 `--period`**：本包拒绝运行并告诉你为什么——用开票期硬套所属期是最常见的错报源头。

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

- **源文件零改动**：输出进 `_out/`，原表一个字节不动
- **默认预览**：不加 `--execute` 不写盘
- **两个口径绝不混算**：汇总里每个数都标了口径
- **不算税负率**：不给你「税负率是否偏低」这类判断，那需要行业对标与政策口径

## 人工复核（必读）

- 申报前必须与**勾选平台**的统计数核对，差异要能逐票追溯
- 红字发票与原票的关联关系请单独确认，本包只标记不判断
- 异常表列出的跨期票，应当逐张确认是跨期还是错填

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 逐张票查重 | `invoice-duplicate-check` |
| 按客户税率汇总 | `invoice-book` |
| 申报表具体填列 | `tax-form-fill` |
| 三张主表勾稽 | `statement-cross-check` |

## 可直接复制的说法

```text
把进项明细和销项明细按两种口径都算一遍：开票期、所属期（2026-09）。
每个数标清口径，不要混。跨期票、红字票、税率异常的单独列出来。
给我一份能直接填申报表的底稿：分期间和方向，销项减进项的结果也写出来。
```

## 做完怎么算完成

- [ ] 两个口径的数都出来了，且都标了口径
- [ ] 申报底稿的分项合计与汇总表一致
- [ ] 跨期票已逐张确认
- [ ] 与勾选平台数据核对过

---

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

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

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