仓储费与库龄结算核对（免费版）

仓储费结算单与库龄明细表逐项核对（仓储费逐行复算、库龄天数−免租期=计费天数、超期附加费复算、合计行勾稽、重复与空缺检测），每条结论都带原文行号。本免费版执行 6 项免费检查。触发词包括 仓储费对不上、仓储费结算单核对、库龄明细表核对、免租期没扣、仓储费多算天数。

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

什么时候用

谁会在什么时候用：仓储 / 物流的财务与对账岗，每月收到第三方仓库（3PL）或自有仓的 仓储费结算单 + 库龄明细表、在付款之前，必须把这张表核一遍才能往下走。

为什么必须核：仓储费是乘出来的 —— 体积（或托盘数）× 单价 × 计费天数， 其中计费天数 = 库龄天数 − 免租期。免租期没扣干净、天数按自然月多算、单价被悄悄上调， 这三件事都会直接乘进金额，而且表面上"自己跟自己一致"，人工看一眼发现不了。 库龄超期附加费是超期占用天数 × 超期日费率，同样是乘出来的。

这张表会逐项核对什么：仓储费结算单与库龄明细表的逐行算术、合计行勾稽、重复与空缺检测。

每条结论都带原文行号与出处，可被第三方用同一份输入、同一口径复算； 材料不足时不给结论，会明确列出还缺什么。

这个免费版查什么

#	检查项
1	逐行复算仓储费：库存体积（或托盘数）× 结算单价 × 计费天数 = 仓储费；两种计价基础任一算平即通过，并按出入库日期复核库龄天数
2	计费天数复核：库龄天数 − 免租期 = 计费天数（表里第 G−H=I 列的关系）
3	库龄超期附加费复算：超期占用天数 × 超期日费率 = 库龄超期附加费
4	应付合计勾稽：仓储费 + 库龄超期附加费 = 应付合计；合计行 = 各明细行逐列相加
5	重复行与空缺列检测：同一仓库 + 同一客户 + 同一物料出现多行；仓库/客户/物料/库龄天数/计费天数/仓储费/应付合计为空或占位符
6	数量、单价或金额为负检测；计费天数出现小数检测

免费版只执行上面 6 项；引擎里 CHECKS_WITHHELD 如实列出未执行的那几项， 跑 --sample 会打印实际执行了哪些、没执行哪些。

怎么用

bash

node scripts/run.mjs --sample                       # 先看样例（一张算得平的干净表，用来确认格式）
node scripts/run.mjs --input 你的材料.json           # 跑自己的材料
node scripts/run.mjs --input 你的材料.json --json    # 机器可读输出

入参写法（把结算单含表头从 Excel 复制成文本贴进来，Tab 分隔最稳）：

json

{"text": "仓库\t客户\t物料\t入库日期\t出库日期\t库存体积\t托盘数\t库龄天数\t免租期\t计费天数\t计价基础\t体积费率\t结算单价\t仓储费\t超期占用天数\t超期日费率\t库龄超期附加费\t应付合计\n上海仓\tC001\t镀锌板卷\t2026-01-01\t2026-02-01\t100.00\t5\t31\t0\t31\t体积\t1.20\t1.20\t3720.00\t0\t0\t0.00\t3720.00"}

直接以文件形式放纯文本表格也可以（--input 会把它当纯文本材料处理）。 templates/sample.json 里就是这份样例，先跑通它再换成自己的数据。

出参

--json 输出一个对象，关键字段：

字段	含义
result.status	success 才代表真的执行了检查；材料不足时是 insufficient_input
result.findings[]	每条结论：level（P0/P1/P2）、category（结论类别）、line（原文行号）、message（中文说明 + 怎么自查）
result.summary	rows 明细行数、total 结论条数、p0/p1/p2、verdict（ERROR_FOUND / NEEDS_REVIEW / NO_ISSUE_FOUND）
result.scope	本次执行的检查项、未执行的检查项、tolerance 容差
result.checks_out_of_scope	本工具根本不做的判断
result.disclaimer	口径说明：只做表内可复算的关系，不规定仓库收费标准

退出码：0 已执行检查 / 1 没给入参 / 3 材料不足（此时不给任何结论）/ 4 入参读不到或无法解析 / 9 未预期错误。

常见错法（本产品专属）

1. 免租期没扣、或扣错了列：计费天数是库龄天数 − 免租期，不是库龄天数本身。 免租期那一列空着时本工具按 0 天算（那就必须等于库龄天数）。免费项 2 专门盯这一条 —— 免租期错一天，仓储费与超期天数一起错。
2. 把「库存体积」和「托盘数」的单价混着用：仓储费 = 计价数量 × 单价 × 计费天数， 而 元/m³·天 与 元/托·天 差一个量级。同一行两列都填时，本工具按"哪种基础能算平就用哪种"， 两列都算不平才报；想让它只按一种口径核，就填「计价基础」列（体积 / 托盘）。
3. 把「仓库小计」行当成普通明细行：小计行 / 合计行的仓库列写的是「仓库小计」「合计」， 本工具会把它们从明细里摘出去、单独做勾稽。别把小计行删掉 —— 删了明细加总与合计行会天然对不上； 也别把小计行写成具体仓库名（那样它会被当成一条明细，费用凭空翻倍）。
4. 库龄天数与出入库日期对不上：日期差 31 天、库龄天数写 30 天，通常是把首日或末日算重/算漏。 库龄天数是免租期与超期天数的计算基础，它一错，仓储费与超期附加费会一起错。
5. 用 - / N/A / 待补 占位后忘了替换：占位符被当成"没填"，关键列一空这条明细就无法复算。 红字冲回也不要直接把负号塞进正常行 —— 应当单独列一行并注明原因，否则合计看着正常、明细却多扣了钱。
6. 天数带小数：计费天数出现 30.5 这类小数，通常是把半个计费周期四舍五入进了天数， 误差会被直接乘进金额（免费项 6 会指出来）。
7. 只贴了明细、没贴表头：认不出表头就不给结论（退出码 3），并且会告诉你哪些必需列没认出来 —— 这是故意的：宁可不出结论，也不用默认值编造一个"未发现问题"。

不包含什么

• 不规定仓库收费标准、免租期政策与超期附加费率（以双方合同与报价单为准，本工具只按表里的数字复算）
• 不核对出入库单、托盘流转记录、库存台账本身是否准确（需要你先导出成文本贴进来）
• 不处理税率、发票、付款账期与预付款抵扣
• 不读取 WMS / ERP / 结算系统导出的二进制文件（请先导出成文本或 JSON）
• 不做跨期比较（上月 vs 本月单价与天数）——需要你自己把两期贴成同一张表
• 核对过程不联网、不上传材料、不写任何文件

本免费版不执行下面这些检查（引擎里 CHECKS_WITHHELD 会如实列出、并在结果里标成"未执行"， 不会用默认值伪造结论）：

• 跨仓库 / 跨客户的汇总台账（按仓库、按客户双向汇总计费天数、体积、仓储费、超期附加费、应付合计）
• 仓库小计行逐行勾稽（本仓库明细逐列相加 = 表里那一行「仓库小计」）
• 超收金额处理清单（按超收金额从大到小排序，逐条给出"同款物料基准单价 → 应收 → 实收 → 超收"证据链）
• 费用差异归因（同仓库同客户同物料的两行，把差额拆成单价效应 / 天数效应 / 体积效应并各自配平）
• 库龄超期附加费超标清单（按加成率排序 + 按金额加权的超期费用占比）
• 同款物料计费口径不一致提示（表内出现两种以上结算单价，或两种以上超期日费率）
• 合计行数量列（体积 / 托盘数）勾稽
• 逐行的"空体积却有仓储费""库龄天数与出入库日期不符"清单

边界（请务必知道）

本工具不做引擎 CHECKS_OUT_OF_SCOPE 里列的那些判断； 材料不足时不给结论（既不做"一致"的认定，也不做"不一致"的认定）， 也不会输出「未发现问题」。 所有结论只是"表内数字对不上"的线索，是否付款、是否找仓库调账由你决定。