底座 · 计算工具 / 归档 / 合规

个税专项附加扣除判断

【财友云】逐行判断专项附加扣除能不能享受、上限多少、是否报超,含七项扣除 + 个人养老金、互斥规则校验(房贷利息×住房租金),每条结论带条文号。报超部分显式调减。适用于个税汇算清缴自查、扣除填报核对、员工个税辅导等场景。

已上线 P2 L0

个税专项附加扣除判断

【财友云】逐行判断专项附加扣除能不能享受、上限多少、是否报超,含七项扣除 + 个人养老金、互斥规则校验(房贷利息×住房租金),每条结论带条文号。报超部分显式调减。适用于个税汇算清缴自查、扣除填报核对、员工个税辅导等场景。

这个包已上线。正文与用法以下方随包 SKILL.md 为准;安装则去 SkillHub 对应页面 →。装到本地即可离线运行,数据不出电脑。

标签

[个人所得税, 专项附加扣除, 汇算清缴, 扣除标准, 税务合规]

技能正文(随包 SKILL.md)

> **本地运行,零网络请求、免 API Key、不主动外发数据。**
> 四项诚实承诺:① 算不出就说算不出,绝不编造数字;② 高危动作强制人工确认;③ 幂等断点,绝不重复副作用;④ 全程留痕可审计。
> 边界说明:本包脚本自身不联网、不外发;若你把内容贴进 AI 对话,内容是否离开本机由你所使用的客户端决定,不由本包决定。
<!-- WB-CLAIM-BOUNDARY v1 -->

# 个人所得税专项附加扣除判断

专项附加扣除的错,几乎**不是算错,而是规则搞错**:
**赡养老人非独生子女按 3000 元/月报**(上限是 1500)、
**住房贷款利息和住房租金同时享受**(二者互斥)、
**大病医疗按全部自付报**(漏了 15000 起付线和 80000 封顶)。

本包逐项算出**法定上限**,把「报超了多少」直接判给你,每条结论带条文号。
扣除标准是**政策性变量**(2023 年三项标准提高即是例证)——本包把标准写进 `references/` 并标
`dataVersion`,**按半年复核**,不把会变的数字埋在代码里当常数。

## 运行方式

```bash
# 默认预览(不写盘)
python scripts/iit_special_deduction_check.py 扣除申报.csv --children 2 --rent-tier 1 --elderly share

# 确认无误后正式执行
python scripts/iit_special_deduction_check.py 扣除申报.csv \
  --children 2 --rent-tier 1 --elderly share --execute
```

| 参数 | 必填 | 说明 |
|---|---|---|
| `file` | ✅ | 扣除申报表(`.xlsx` / `.csv`),首行表头,含「扣除项目」+「申报金额」 |
| `--children` | — | 子女(含婴幼儿)人数,默认 `1`(也可在「辅助信息」列写「2人」) |
| `--rent-tier` | — | 住房租金城市档 `1`(1500)/ `2`(1100)/ `3`(800),默认 `1` |
| `--elderly` | — | 赡养老人:`only` 独生子女 / `share` 非独生子女,默认 `only` |
| `--months` | — | 扣除月数,默认 `12` |
| `--execute` | — | 真正写盘;不加则只预览 |

**退出码**:`0` 全部通过 / `3` 门禁未通过 / `4` 环境问题 / `8` 部分通过(有需人工核实行)。

## 何时不触发

- 只是要**算个税应纳税额**(累计预扣法)→ 属个税计算类技能,不是本包。
- 要办**经营所得**(个体户 / 个独)汇算 → 口径不同,属经营所得类技能。
- 只是**解释某项扣除政策**、无具体申报数据 → 直接回答即可。
- 要**填报系统操作指引** → 属操作指引类,不是判断包。

## 工作流(编号阶段)

1. **读表**:识别扣除项目列和申报金额列;缺列直接拒绝。
2. **匹配项目**:按七项 + 个人养老金匹配;认不出的进异常表。
3. **算上限**:按项目类型分别用「人头定额 / 城市定额 / 固定定额 / 起付封顶 / 年度限额」算上限。
4. **判超限**:`可扣除额 = min(申报金额, 上限)`,超出部分计入**调减额**。
5. **互斥校验**:住房贷款利息 与 住房租金 同时出现 → **告警**(二者不得同时享受)。
6. **出判断**:主表给「判定 / 可扣除额 / 调减额 / 上限 / 依据条文」。
7. **校验**:输入金额 = 主表 + 异常表,守恒差异 > 0.01 元即停止输出。

## 判断框架(三步)

```
第一步 · 匹配   属于七项专项附加扣除中的哪一项(或个人养老金)?
                → 认不出:进异常表,不猜
第二步 · 算上限 按项目类型算:
                · 人头定额(子女教育 / 婴幼儿照护):标准 × 人数 × 月数
                · 城市定额(住房租金):城市档标准 × 月数
                · 固定定额(房贷利息 / 学历继续教育):标准 × min(月数, 最长期限)
                · 起付封顶(大病医疗):min(max(自付−15000,0), 80000)
                · 年度限额(个人养老金):12000
第三步 · 互斥   房贷利息 与 住房租金 是否同时出现?→ 是则告警,需二选一
```

## 口径速查

| 扣除项目 | 标准 | 依据(详见 `references/01-legal-basis.md`) |
|---|---|---|
| 子女教育 | **2000 元/月/子女** | 国发〔2018〕41号第五条 + 2023 提高标准公告 |
| 3 岁以下婴幼儿照护 | **2000 元/月/婴幼儿** | 第十二条 + 2023 提高标准公告 |
| 继续教育(学历) | **400 元/月**,最长 48 个月 | 第八条 |
| 继续教育(职业资格) | **3600 元/年** 定额 | 第九条 |
| 大病医疗 | 自付超 **15000** 部分,封顶 **80000** | 第十一条 |
| 住房贷款利息 | **1000 元/月**,最长 240 个月 | 第十四条、第十五条 |
| 住房租金 | **1500 / 1100 / 800 元/月**(按城市档) | 第十七条、第十八条 |
| 赡养老人(独生) | **3000 元/月** | 第二十二条 + 2023 提高标准公告 |
| 赡养老人(非独生) | 分摊 3000,**每人 ≤ 1500 元/月** | 第二十二条 |
| 个人养老金 | **12000 元/年** 限额 | 财政部 税务总局公告 2022 年第 34 号 |

**互斥**:住房贷款利息 ✕ 住房租金 —— 一个纳税年度内**不得同时享受**。

## 输入 / 输出

**输入**(首行表头,列名兼容多种叫法;「辅助信息」列可选):

| 扣除项目 | 申报金额 | 辅助信息 |
|---|---|---|
| 子女教育 | 48000 | 2人 |
| 住房租金 | 18000 | 深圳 |
| 赡养老人 | 24000 | 非独生 |

**输出四件套**(`--execute` 后写入 `_out/`):

| 文件 | 内容 |
|---|---|
| `iit_主表.csv` | 每行的判定 / 可扣除额 / 调减额 / 上限 / 依据条文 |
| `iit_异常表.csv` | 扣除项目认不出、金额缺失的行 + 异常原因 + 风险等级 |
| `iit_校验表.csv` | 规则版本 / 人数 / 城市档 / 赡养口径 / **互斥校验** / **守恒差异** |
| `fin-log.jsonl` | 本次运行日志 |

## 真实输出

以 7 行扣除申报为例(`--children 2 --rent-tier 1 --elderly share`):

```
方案:扣除申报.csv(7 行)
规则版本:2026.10 | 子女数 2 | 租金档 1 | 赡养 share
⚠ 互斥告警:住房贷款利息 与 住房租金 同时申报 —— 二者不得同时享受。

--- 逐行判断(共 7 行)---
  #   扣除项目                        申报 判定                      可扣          调减          上限
  1   子女教育                  48000.00 可扣除                48000.0         0.0     48000.0
  2   住房租金                  18000.00 可扣除                18000.0         0.0     18000.0
  3   赡养老人                  24000.00 超限(调减)             18000.0      6000.0     18000.0
  4   住房贷款利息                12000.00 可扣除                12000.0         0.0     12000.0
  5   继续教育                   4800.00 可扣除                 4800.0         0.0      4800.0
  6   大病医疗                  50000.00 超限(调减)             35000.0     15000.0     35000.0
  7   个人养老金                 15000.00 超限(调减)             12000.0      3000.0     12000.0
```

校验表关键项:互斥校验「⚠ 住房贷款利息与住房租金同时申报,二者不得同时享受,需二选一」、
`守恒差异(入-主-异) = 0.0`(输入 171800 = 主表 171800)。

> 解读:第 3 行非独生子女赡养老人上限为 1500×12=18000,报 24000 超出 6000;
> 第 6 行大病医疗自付 50000,扣 15000 起付线后 35000(未触 80000 封顶),超出 15000;
> 第 7 行个人养老金年度限额 12000,超出 3000。

## 拒绝权(什么情况下不给判断)

| 情形 | 本包怎么做 |
|---|---|
| 输入文件不存在 | **直接退出**,报「找不到输入文件」 |
| 缺「扣除项目」或「申报金额」列 | **拒绝**,列出可接受的列名清单 |
| 扣除项目认不出 | 进异常表,标「需人工核实」——**不猜能不能享受** |
| 城市档 / 赡养口径未给 | 用参数默认值,但**在校验表显式写明所用口径**,不隐式假设 |
| 金额不守恒(差 > 0.01 元) | **停止输出** |

## 关键设计(容易踩的坑)

- **互斥是硬规则**:住房贷款利息与住房租金一个年度内只能享受一项。本包命中即告警,**不替你选**。
- **家庭分配是选择权**:子女教育(各 50% 或一方 100%)、赡养老人分摊方式属纳税人的选择,
  本包只判**上限**,不替纳税人分配。
- **大病医疗两道线**:起付线 15000 + 封顶线 80000,且**只在汇算清缴时办**。
- **非独生赡养上限 1500/月**:这是**每人**的上限,兄弟姐妹合计不超过 3000/月。
- **扣除标准是政策变量**:2023 年子女教育、婴幼儿照护、赡养老人三项均由原标准提高——
  标准写在 `references/` 并标 `dataVersion`,**升级标准须同步升版本**。

## 人工复核(必读)

本包给出的是**判断辅助**,不是申报数据。以下**必须由本人 / 税务岗位人工确认**:

- 家庭分配安排(父母、夫妻之间如何分摊);
- 被赡养人身份与年龄(仅限本人父母及子女均去世的祖父母外祖父母);
- 住房是否首套、是否有自有住房;
- 大病医疗「医保目录范围内自付」的口径(需医保结算单明细);
- 职业资格证书是否属国家职业资格目录。

## 相邻路线转交

| 需求 | 转交 |
|---|---|
| 算个税应纳税额(累计预扣) | 个税计算类技能 |
| 经营所得汇算 | 经营所得类技能 |
| 工资表个税批量复核 | 薪酬 / 工资表核对类技能 |
| 个税申报表填报操作 | 申报指引类技能 |

## 可直接复制的说法

> 本次共核对专项附加扣除 N 项,其中**合规 A 项**、**超限(调减)B 项**,调减金额合计 ¥C。
> 另有 **M 项需人工核实**。`住房贷款利息` 与 `住房租金` 存在互斥冲突,需二选一。
> 每条结论均附条文号,可回原文核对。

## 做完怎么算完成

- [ ] 主表每行都有**判定 + 上限 + 依据条文**
- [ ] 互斥规则(房贷利息 × 住房租金)已校验并告警
- [ ] 大病医疗用了**起付线 15000 + 封顶 80000**
- [ ] 赡养老人按**独生 3000 / 非独生每人 ≤ 1500** 判
- [ ] 认不出的项目**进了异常表**
- [ ] 校验表**守恒差异 = 0**,且显式写明所用口径

## 参考资料(渐进式披露)

| 文件 | 何时读 |
|---|---|
| `references/01-legal-basis.md` | 核对条文号、各项适用条件与限度时 |
| `references/02-standards-table.md` | 查标准速查、互斥规则、高频误判清单时 |
| `references/03-verification-checklist.md` | 判断前确认信息齐备性、排查高风险情形时 |

## 输出规范

1. **每行判断必须带条文号**(形如「国发〔2018〕41号第二十二条」)。
2. **金额保留 2 位小数**,可扣除额 = min(申报, 上限)。
3. **判定用词固定**:`可扣除` / `超限(调减)` / `不可计算`;互斥情形在提示区单列告警。
4. **异常项必须进异常表**,不得静默丢弃。
5. **产物进 `_out/`**,源文件零改动。
6. **校验表必含**规则版本、人数、城市档、赡养口径、互斥校验、守恒差异。

## 免责声明

本技能提供的判断结果仅供参考,不构成税务意见。个人所得税专项附加扣除涉及家庭分配安排与
个人具体情况,最终申报结论应由纳税人本人或具备资质的税务专业人员依据现行有效法规确认。
本包**不联网**,不替代「个人所得税」官方 App / 网页版的申报功能。

## 反例对照(避开这些写法)

| ❌ 错误写法 | ✅ 正确写法 | 为什么 |
|---|---|---|
| 「赡养老人可扣 3000 元/月」 | 「**独生子女** 3000/月;**非独生子女**分摊 3000,**每人 ≤ 1500/月**」 | 非独生按 3000 报必超限 |
| 「房贷利息和租金都能扣」 | 「二者**互斥**,一个年度内只能享受一项」 | 违反互斥规则 |
| 「大病医疗按实际自付扣」 | 「扣 **15000 起付线**后据实,封顶 **80000**」 | 漏起付线/封顶会报超 |
| 「子女教育夫妻都能扣 2000」 | 「一个子女合计不超 2000/月,父母各 50% 或一方 100%」 | 双方各按定额 = 报超 |
| 「扣除标准是固定的」 | 「标准属**政策性变量**,须核对现行有效版本(2023 年已提高三项)」 | 用旧标准会少扣 |

<!-- WB-SELFCHECK v1 -->

## 交付前自检(必跑)

本包自带可执行自检脚本。**在交付 / 打包 / 发布之前,必须运行并通过**:

```bash
python scripts/selfcheck.py
```

退出码语义(与本节末尾「退出码(脚本契约)」一致):

| 码 | 含义 | 你要做的事 |
|---|---|---|
| 0 | 全部通过 | 可以交付 |
| 2 | 用法错误 | 检查运行路径,用包根目录下 `scripts/selfcheck.py` |
| 3 | **门禁未通过** | 按 FAIL 项逐条修好再交付,**不要带病交付** |
| 4 | 环境问题 | 检查 Python 版本(需 3.8+)与入口脚本是否可运行 |
| 8 | 部分通过 | 无 FAIL,但有 WARN;建议先修警告项再交付 |

自检覆盖:SKILL.md 与 frontmatter(`name`·`description`)/ 合规声明(frontmatter `license` **或** `ATTRIBUTION.md`,二者其一即可——第三方转化包常以后者记录归属)/ 必备章节 / 打包卫生(禁止 .pyc·__pycache__·.bak·.zip)/ 脚本可编译 / 入口脚本 `--help` 可运行。
<!-- /WB-SELFCHECK -->

## 退出码(脚本契约)

| 退出码 | 含义 | 触发条件 |
|---|---|---|
| `0` | 全部通过 | 全部行判断完成,无异常 |
| `2` | 用法错误 | 参数缺失、缺输入文件、缺列(拒绝权触发) |
| `3` | 门禁未通过 | 金额不守恒,停止输出 |
| `4` | 环境问题 | Python 版本不符、文件不可读 |
| `8` | 部分通过 | 有行进异常表(需人工核实),主表正常产出 |

## 状态与断点

- 本包**不写任何状态文件**到源目录;唯一落盘是 `--execute` 时的 `_out/` 四件套。
- 重复执行**幂等**:同样输入 + 同样参数,产物完全一致。
- 中断后重跑:直接重跑即可,无需清理。
这个包已在 SkillHub 上线,可一键安装。
在 SkillHub 上查看完整说明、版本记录与安装方式,支持一键装到你的 AI 客户端。

常见问题

按真实会被问到的顺序排,每条答案都给得出可核对的依据,不含含糊其辞的部分。

个税专项附加扣除判断 这个技能,具体能帮我做什么?

【财友云】逐行判断专项附加扣除能不能享受、上限多少、是否报超,含七项扣除 + 个人养老金、互斥规则校验(房贷利息×住房租金),每条结论带条文号。报超部分显式调减。适用于个税汇算清缴自查、扣除填报核对、员工个税辅导等场景。

常见的触发场景有:子女教育能扣多少、赡养老人非独生子女怎么分摊、住房租金和房贷利息能不能同时扣。

完整说明、版本记录和安装方式在 SkillHub 上的「个税专项附加扣除判断」页面 →。

跑完之后我会拿到什么东西?

输出会落在 _out/ 目录,主要包括:

1.iit_主表.csv每行的判定 / 可扣除额 / 调减额 / 上限 / 依据条文
2.iit_异常表.csv扣除项目认不出、金额缺失的行 + 异常原因 + 风险等级
3.iit_校验表.csv规则版本 / 人数 / 城市档 / 赡养口径 / 互斥校验 / 守恒差异
有没有算不了、它明确拒绝的情况?

有。下面几种情况它会明确拒绝,而不是硬给答案:

·输入文件不存在:直接退出,报「找不到输入文件」
·缺「扣除项目」或「申报金额」列:拒绝,列出可接受的列名清单

总之是算不出就说算不出,不会给你一个看着合理、实际没依据的数字。

用之前我得注意什么?容易踩哪些坑?

这几条是设计时就写进去的口径,不知道会直接算错,不是「留意一下」那种套话:

互斥是硬规则:住房贷款利息与住房租金一个年度内只能享受一项。本包命中即告警,不替你选。
家庭分配是选择权:子女教育(各 50% 或一方 100%)、赡养老人分摊方式属纳税人的选择,
大病医疗两道线:起付线 15000 + 封顶线 80000,且只在汇算清缴时办。
跑完的数能不能直接用?我还要核什么?

不能直接拿去报。它给的是建议和依据,最终判断还是得你来做。下面这几条是它要求你逐条过的:

·家庭分配安排(父母、夫妻之间如何分摊);
·被赡养人身份与年龄(仅限本人父母及子女均去世的祖父母外祖父母);
·住房是否首套、是否有自有住房;
数据会不会传出去?我自己怎么验证?

不会。运行时不发一个网络包。你自己就能验证,三条路任选:

把网断掉再跑一遍,功能照常——它本来就没打算联网。

打开包里的 SKILL.md,权限声明写的是 network: none,不声明就没有联网能力。

直接翻 scripts/ 下的源码,全站都是 Python 标准库写成,没有一行网络代码。

要付费吗?要不要配 API Key?

都不要。免费使用,不需要任何 API Key,不联网就不需要 Key,也不存在额度这回事。开源协议 BUSL-1.1,发布满 4 年后自动转为 Apache License 2.0。

装上之后怎么用?

安装后,在支持 SkillHub 的 AI 客户端(如 WorkBuddy)里直接使用即可。

触发方式:对话里提到「子女教育能扣多少、赡养老人非独生子女怎么分摊、住房租金和房贷利息能不能同时扣」等场景,或上传相关表格/凭证,它就会自动响应。

典型用法:把原始文件发给 AI,说『帮我跑 个税专项附加扣除判断』或『处理一下这个』,结果会输出到当前目录的 _out/iit_主表.csv。

也可以从客户端的「已安装技能」列表里手动唤起。

什么环境能跑?需要装依赖吗?

Windows / macOS / Linux 都能跑,不需要 pip install 任何东西。

运行只依赖 Python 3 标准库:全站 345 个脚本的首行都是 #!/usr/bin/env python3,没有第三方依赖,也就没有环境冲突要调。

装在哪个客户端上?会不会弄坏我原来的文件?

在 SkillHub 上一键安装即可,主流 AI 客户端都能装。运行是只读 + 输出到 _out/,你原来的账套和表格一个字节都不会被动。

相邻技能

规划中 P2 底座

政策时效提醒

【财友云】输入政策文件/文号清单,比对政策有效期与废止状态,输出「即将到期/已废止/仍有效」提醒与转交建议,严守"以主管机关口径为准"的边界。

规划中 P2 底座

财税法规原文速查

【财友云】内置国家税务总局税收法规库的法规条目索引离线快照(约 5,473 条),按法规名称、关键词或税种检索,逐条给出时效性(全文有效/已修改/全文失效/全文废止/尚未生效)、效力等级(法律/行政法规/部门规章/规范性文件)、发布日期、修订沿革注释与官方原文链接,并支持按「有效」或「废止」等时效性、按效力等级筛选。适用于下结论前先确认依据文件还生不生效、某一税种有哪些现行文件、文号文件被谁替代等场景。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

商品归类结构指引

【财友云】内置出口退税率文库商品码表快照(约 3.2 万个 8/10 位商品代码),把待查编码按 HS 规则拆成「章 / 品目 / 子目 / 本国子目」四层,做 8/10 位位数校验,并在码表里命中官方商品名称与计量单位,同时给出《进出口税则》归类总规则(GRI 1–6)的方法论提示。适用于外贸 / 财税人员核对编码层级写对没写对、按名称反查可能的编码、编码位数自检等场景。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

进出口关税税率速查

【财友云】内置国务院关税税则委员会《2026年关税调整方案》五张附表离线快照(进口商品暂定税率表 935 条、关税配额商品税目税率表 47 条、出口商品税率表 107 条,另有税目调整表与本国子目注释调整表),按税则号列或商品名称查进口最惠国税率、2026 年暂定税率、关税配额税率与出口税率,并提示该税则号列是否涉及税目调整 / 子目注释变化。适用于进出口报价前核税率、判断「出口要不要交关税」、核对进口暂定税率适用等场景。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

关税政策追踪

【财友云】内置财政部关税司(国务院关税税则委员会办公室)政策发布公告索引离线快照(497 条,2008–2026 年),按关键词或年份检索关税税则委员会公告,输出标题、发布日期与原文链接,并按发布日期倒序。适用于追踪「美国 / 加征 / 零关税 / 暂定税率 / 税则」等主题的最新关税政策、核对某年度关税公告清单、定位政策原文链接等场景。数据为离线快照、版本可查,运行时零联网;本包只做公告索引检索与定位,不做政策解读。

规划中 P2 底座

出口退税率速查

【财友云】内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码),按商品代码或商品名称查出口退税率、征税率、计量单位与生效期,并支持「退税率 13% 的商品有哪些」这类反向清单查询。适用于外贸企业报价前核税率、出口退税申报前核对商品退税率、财务复核退税额计算口径等场景。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

财税官方问答检索

【财友云】把一句财税问题检索到权威官方口径——在内置的国家税务总局「互动交流」官方问答语料(394 条,跨 2021–2026)上做本地 BM25 检索,返回命中的官方问答原文要点 + 依据文号 + 发布日期 + 原文链接。检索不到就说检索不到并给官方入口,绝不拿「看起来相关」的问答凑答案。

规划中 P2 底座

原产地规则与协定税率速查

【财友云】内置两套官方数据:① 国家税务总局「税收条约」栏目索引快照(142 条,含条约/协定名称与原文链接);② 国务院关税税则委员会《2026 年关税调整方案》附 6「自贸协定和优惠贸易安排实施税率表」(8,931 个税则号列 × 32 个协定/优惠安排)。按协定或国家名定位条约原文,按税则号列摘录各协定优惠税率。适用于查某国/某协定有没有税收协定、条约原文在哪、某税则号列在东盟/RCEP/韩国等协定下适用什么优惠税率等场景。只做条款与税率的定位与摘录,不做原产地判定。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

法规效力核验

【财友云】逐条核验财税法规的效力状态——现行有效、尚未生效、已修改、条款废止、条款失效、部分废止、条款修订、全文失效、全文废止等,判定依据以**官方时效性字段**为第一级来源(内置国家税务总局法规库效力快照,去重后 5,386 条),每条结论标注来源与置信分级,官方库未标注或未收录的一律标「须回官方核验」不猜。适用于引法前的效力自查、政策清理、存量制度梳理等场景。