残疾人就业保障金申报核对（免费版）

残保金申报表逐项复算（应安排人数、应缴金额、已缴与应缴差异、合计勾稽、重复与空缺检测），每条结论引用原文行号。本免费版执行引擎声明的免费检查项。触发词包括 残保金申报、残疾人就业保障金、应缴金额算错、已缴和应缴对不上。

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

什么时候用

谁会在什么时候用：财务、税务岗在每年（部分地区按月或按季）申报缴纳残保金之前， 必须把这张申报表核一遍才敢提交 —— 算错就是多缴或漏缴，漏缴还有滞纳金。

为什么容易错：这张表是三条串行算式，再叠上免征与分档减缴的条件：

• 应安排残疾人就业人数 = 上年在职职工人数 × 规定比例
• 应缴金额 = （应安排人数 − 实际安排人数）× 上年在职职工年平均工资（负数按 0）
• 已缴金额与应缴金额的差异（多缴还是少缴）

第一条错，整行的应缴金额都跟着错；安排人数达标时差额为负，要按 0 填而不是填负数。 纯算术，但人眼一多就错。

不与已有能力重复：本工具核的是残保金申报表本身的口径与算术； 发票合规、工资个税、社保公积金归集都不是它做的事（见下面的边界）。

这个免费版查什么

1. 应安排残疾人就业人数勾稽（上年在职职工人数 × 规定比例）
2. 应缴金额勾稽（（表内应安排人数 − 实际安排人数）× 上年在职职工年平均工资，负数按 0）
3. 已缴金额与应缴金额差异勾稽（多缴 / 少缴）
4. 合计行逐列复核（每一列的合计是否等于各明细行之和）
5. 同一所属期重复行检测
6. 关键字段空缺与占位符检测

跑 node scripts/run.mjs --sample 会打印本次实际执行的检查项（以引擎的 CHECKS_* 导出为准）。 每条结论都带原文行号与出处，可被第三方用同一口径复算； 材料不足时不给结论，会明确列出还缺什么。

口径（算术依据，第三方按这个复算）

• 规定比例既认小数也认百分数：不超过 0.2 按小数比例（0.015 等于 1.5%），否则按百分数（1.5 等于 1.5%）；
• 应安排人数默认不取整（按比例算出的精确值）；各地取整口径不同，可在入参里用 should_rounding 指定 四舍五入到人（round）、向上取整到人（ceil）、向下取整到人（floor）；
• 应缴金额用表内已填的应安排人数当乘数（应安排人数本身由第 1 项单独复算），负数按 0；
• 已缴与应缴按表内「应缴金额」列比较（减免后的实缴口径属于完整档的事）。

怎么用

bash

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

入参是 JSON，text 里放从 Excel 复制出来的表头 + 明细（Tab 分隔最稳）。 需要的表头：所属期、上年在职职工人数、规定比例、上年在职职工年平均工资、 应安排残疾人就业人数、实际安排残疾人就业人数、应缴金额、已缴金额。 可选表头：减免金额、持证残疾人数、一年以上劳动合同人数、工资总额。

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

1. 上年在职职工人数填成期末在册人数。口径是上年的年平均人数；填期末数会让人数、应安排人数、应缴金额一路偏。
2. 年平均工资用当年数据或月工资乘 12。要的是上年在职职工年平均工资，与在职人数、工资总额同属上一年口径。
3. 规定比例一行写 1.5%、另一行写 0.015。本工具两种都认，但同一张表混用两份口径最容易把自己绕晕，全表只用一种写法。
4. 安排人数已达标时把应缴金额填成负数。差额为负表示不需要缴，应缴金额按 0 填，不要填负数。
5. 已缴金额与应缴金额对不上，就去改应缴金额把差异平掉。差异是结论不是错误，先查缴款凭证与减免，再动数字。
6. 合计行只改明细不加合计（或只改合计不改明细）。逐列勾稽一下，几秒钟的事，漏一次就要退回重报。
7. 同一所属期重复列了两行（例如总分公司各一行却没标明），合计行再统计一遍就翻倍。
8. 关键格留空或写"待填"。缺一格这一行的应缴金额就算不出来，本工具不会用 0 或默认值替你填。

需要完整档时（可选）

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

• 免征条件判定（上年在职职工人数不超过输入给出的免征人数上限时，仍申报缴纳的部分）
• 分档减缴档位与减缴金额核对（按输入给出的档位表算档位与减缴额）
• 安排残疾人就业人数与残疾人证 / 一年以上劳动合同材料缺口
• 上年在职职工人数与年平均工资口径复核（工资总额 ÷ 人数、与输入最低工资比较）
• 多缴可退与少缴需补缴金额清单（按金额从大到小排）

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

边界（请务必知道）

本工具不做引擎 CHECKS_OUT_OF_SCOPE 里列的那些判断：不给税务意见、不做缴纳筹划、 不查证或套用任何地区政策参数（规定比例、免征人数上限、分档减缴档位、最低工资都由输入提供）、 不判断残疾人证真伪与劳动合同效力、不读 .xlsx。 材料不足时不给结论，也不会输出「未发现问题」。