个税年度汇算（综合所得）核对（免费版）

完全本地运行：引擎已经打包在本技能里（engine/ 目录）。 核对过程不需要联网、不需要 API Key、没有调用次数上限。

什么时候用

谁会在什么时候用：HR / 薪酬岗与员工本人，在每年 3~6 月个税年度汇算（综合所得）期间：

• 应纳税所得额 = 全年工资薪金 + 劳务报酬 − 减除费用 − 专项扣除 − 专项附加扣除 − 其他扣除（为负按 0）；
• 全年应纳税额 = 应纳税所得额 × 适用税率 − 速算扣除数（年度七级超额累进）；
• 应补(退)税额 = 全年应纳税额 − 已预缴税额。

与已有产品的区别：iit-withholding-check 核月度累计预扣；payroll-withholding-reconcile 核 工资表代扣 vs 申报数；本产品核年度汇算这一张表（含税率档位与速算扣除数是否匹配）。

这个免费版查什么

1. 合计行逐列复核（收入/各项扣除/应纳税所得额/应纳税额/已预缴/应补退；税率与速算扣除数不合计）；
2. 应纳税所得额 = 收入 − 各项扣除（为负按 0，P0）；
3. 全年应纳税额 = 应纳税所得额 × 税率 − 速算扣除数（P0）；
4. 应补(退)税额 = 全年应纳税额 − 已预缴税额（P0）；
5. 应纳税所得额为负（未按 0 处理，P1）；
6. 员工编号重复行检测；
7. 空白与占位符检测（含必需列缺失，仍照常给结论并报「列缺失」）。

怎么用

node scripts/run.mjs --sample                 # 先看样例
node scripts/run.mjs --input 你的材料.json     # 跑自己的材料

常见错法（这些表里真的会有人这么填）

1. 应纳税所得额为负却按负值算税：为负要按 0 处理，否则会算出负数税额。
2. 用月度预扣率表算年度汇算：年度汇算是年度七级超额累进（与月度预扣表不同），用错档位税额就错。
3. 专项附加扣除填成"年度总额 ÷ 12"：汇算表按年度合计填，填成月额会少扣 11 个月。
4. 劳务报酬直接按收入额进综合所得：劳务报酬要按收入减除 20% 费用后的余额计入，直接填收入会多算税基。
5. 应补(退)填成正数表示退税：本工具按"正数=应补、负数=应退"核对，符号写反会被直接点出来。

需要完整档时（可选）

本免费版是完整可用的核心产出，本版本不包含下面这些项：

• 适用税率与应纳税所得额不匹配（按 3%/10%/20%/25%/30%/35%/45% 七级超额累进速算表核对区间与速算扣除数）
• 已预缴税额为负检测
• 专项附加扣除超过 100000 提示（常见上限量级 60000~96000）
• 全年收入为 0 但已预缴税额大于 0 提示（核对是否错列）
• 应补退税额绝对值超过全年收入 20% 提示（异常量级）

同名工具的完整档是另一个独立商品（条款与条件以它自己的商品页为准）；两档的差别就是上面这些，没有别的。

边界（请务必知道）

• 不做税务判断：专项附加扣除能否享受、劳务报酬口径、税收优惠适用，请按现行税法与主管税务机关口径认定；
• 不代替纳税申报、不代填申报表，也不出具税务意见；
• 不核对收入凭证、扣除凭证的真伪，也不与自然人电子税务局明细比对；
• 不读取个税系统 / 工资系统的导出文件——需要你先导出成文本贴进来；
• 不判断特定人员的居民身份与减免税优惠（属于税务判断）。