360 Secure SkillHub
360 安全技能中心

电商退货退款与库存回冲核对（免费版）

对含表头的退货退款与库存回冲明细表执行 5 类本地核对：退款金额复算、单号重复、回冲数量勾稽、状态与到账金额自洽、关键字段空缺；结果带原文行号，材料不足时明确不给结论。

chenqg618
chenqg618
热度 17.58
最近更新 2026-09-20 20:05:53
分类：数据依赖：代码执行 / 读写文件应用场景：财务 / 数据处理 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add ecom-return-refund-check-free
Metadata
slug
ecom-return-refund-check-free
displayName
电商退货退款与库存回冲核对（免费版）
version
1.0.5
summary
退货退款与库存回冲明细表逐项核对，每条结论都带原文行号，不需要付款，也不需要注册。
tags
["电商退货退款与库存回冲核对","退货退款与库存回冲明细表","核对","对账","免费"]
license
Proprietary
name
ecom-return-refund-check-free
display_name
电商退货退款与库存回冲核对（免费版）
display_name_en
Ecommerce Return Refund Check (Free)
description
退货退款与库存回冲明细表逐项核对（退款金额逐行复算、退款与退货单号一一对应、库存回冲数量勾稽、退款状态与到账金额自洽、关键字段空缺），每条结论引用原文行号。本免费版执行引擎声明的 5 项检查。触发词包括 电商退货退款与库存回冲核对、退货退款与库存回冲明细表对不上、退款金额算错、库存回冲数量不对。
description_zh
退货退款与库存回冲明细表逐项核对（退款金额逐行复算、退款与退货单号一一对应、库存回冲数量勾稽、退款状态与到账金额自洽、关键字段空缺），每条结论引用原文行号。本免费版执行引擎声明的 5 项检查。触发词包括 电商退货退款与库存回冲核对、退货退款与库存回冲明细表对不上、退款金额算错、库存回冲数量不对。
description_en
A free deterministic check for an e-commerce return refund and restock sheet. Every finding cites the source row. No payment, no registration, no API key, no network.
category
business-ops
author
WorkBuddy 开放平台开发者
allowed-tools
Read, Bash

电商退货退款与库存回冲核对（免费版）

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

什么时候用

谁在什么时候用：电商财务 / 会计 / 仓储在对账日、月末结账、盘点差异复核这类固定节点上， 必须先把「退货退款与库存回冲明细表」核一遍，才能确认退款付得对不对、退回来的货有没有真的入回库存。 这张表出错的后果是双向的：多退 / 重复退（钱出去了、货没回来）和少退 / 漏回冲 （买家投诉、库存被系统性少计）。两者都会在平台账单、库存账和月报上暴露，而且结完账就很难倒查。

这张表会逐项核对什么（免费版执行 5 类，逐条都带原文行号）：

  1. 退款金额逐行复算 —— 退款金额 = 实收金额 − 运费扣除 − 包装扣除 − 折旧扣除，差 1 分钱也报。
  2. 退款单号与退货单号一一对应 —— 同一退货单号或同一退款单号在表里出现两次以上即报 （重复录入会让退款合计被重复统计、库存被回冲两次）。
  3. 库存回冲数量与退货数量勾稽 —— 回冲数量 > 退货数量是硬错（P0）； 回冲数量 < 退货数量只提示（P2，部分入库属正常，但要写清原因）。
  4. 退款状态与到账金额自洽 —— 状态说已完成却查不到到账金额、状态还没完成却已经填了到账金额、 到账金额 ≠ 退款金额，三种都报。
  5. 关键字段空缺 —— 退货单号 / 退款单号 / 退货日期 / 退货数量 / 退款金额 为空或写占位符（待填、无、-）。

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

不包含什么

免费版不执行下面这几类（引擎的 CHECKS_WITHHELD 会如实列出，跑 --sample 也能看到）：

  • 跨店铺 / 跨期间的汇总台账（按店铺与月份汇总笔数、退款金额合计与回冲数量）；
  • 按退款金额排序的追损清单（把应追回 / 应补退的差额降序排列，≥2 条才出清单）；
  • 差异归因（把退款金额差异归到扣款规则、运费承担、折旧计提三类）。

怎么用

node scripts/run.mjs --sample                    # 先看样例（样例本身就是一张自洽的表）
node scripts/run.mjs --input 你的材料.json        # 跑自己的材料
node scripts/run.mjs --input 你的材料.json --json # 机器可读输出

入参两种写法都行：

  • {"text": "（把表的**表头**和若干行一起复制进来，Tab 分隔最稳）"}
  • 直接把「退货退款与库存回冲明细表」（含表头）从 Excel 复制成文本粘进 .json 里； 文件不是合法 JSON 时会整体按纯文本材料处理。

必需列（缺任何一列就不给结论）：退货单号、退款单号、店铺、退货日期、退货数量、回冲数量、 实收金额、运费扣除、包装扣除、折旧扣除、退款金额、退款状态、到账金额。

出参

  • status：success 才有结论；insufficient_input 表示材料不足，此时没有 result、没有 findings。
  • result.findings[]：每条含 level（P0/P1/P2）、category、line（原文行号）、 message（含算式与差额）、advice、evidence（原文片段）。
  • result.summary：rows / total / p0 / p1 / p2 / omitted / by_category / verdict （NO_ISSUE_FOUND | NEEDS_REVIEW | ERROR_FOUND）。
  • result.scope：本次执行的 checks、未执行的 checks_not_run、executed_locally: true、network_used: false。
  • result.checks_out_of_scope：本工具根本不做的判断清单（边界诚实）。
  • CLI 退出码：0 已执行检查 / 1 没给入参 / 3 材料不足 / 4 入参读不到或无法解析 / 9 未预期错误。

常见错法（本产品专属）

  1. 扣除项的口径一边含费一边扣费：实收金额取的是买家实付（已含运费）， 运费扣除却按"平台向我收的运费"填 —— 两边口径不同，退款金额整列都会差一个运费。 先定：实收金额是买家实付还是订单净额，然后全表统一。
  2. 折旧被算了两次：商品折旧已经体现在退款金额里，又在「折旧扣除」列填一遍，于是复算时再减一次。 本工具逐行复算会把它抓成"退款金额复算不符"，但口径本身要先定死。
  3. 分次打款挤在一行：一笔退款分两次到账，全填在「到账金额」里凑了总额 —— 状态一改就对不上。正确做法是拆成两行（同一退款单号会出现两次，本工具会提示单号重复， 这属于"如实提示"而非误报）。
  4. 回冲数量按"件数"和按"箱数"混填：同一个表里两种单位混用， 回冲数量会整片偏离退货数量。单位写在表头或备注里，不要靠人记。
  5. 状态栏用自己发明的写法：例如「已打款待确认」「部分到账」。本工具只按 表内已认得的「已完成 / 未完成」两类写法核对自洽性，认不出的写法会被跳过 —— 宁可统一成两种写法，也不要让关键行静默不参与核对。

需要完整档时（可选）

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

  • 跨店铺/跨期间汇总台账（按店铺与月份汇总笔数、退款金额合计与回冲数量）
  • 按退款金额排序的追损清单（把应追回/应补退的差额降序排列，≥2 条才出清单）
  • 差异归因（把退款金额差异归到扣款规则、运费承担、折旧计提三类）

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

边界（请务必知道）

本工具不判断该不该退、该退多少（退款政策与平台规则本身对不对）， 也不核对退回的商品是否真的收到、质检结论是否成立，更不判断折旧率 / 包装费 / 运费标准定得对不对 —— 表里填多少就以多少为准；也不读电商后台 / ERP / 进销存 / 库存系统（需要你先导出成文本贴进来）。

完整清单见引擎的 CHECKS_OUT_OF_SCOPE；材料不足时不给结论，也不会输出「未发现问题」。