社保公积金核对(付费版)
单次 ¥0.99,在网页或对话里付款后立即返回结果。
> 完全本地运行:引擎已经打包在本技能里(engine/ 目录)。
什么时候用
谁会在什么时候用:财务、出纳、仓管等岗位在每月结账/发薪/对账/盘点这类固定节点上,必须把这张表核一遍才能往下走。
这张表会逐项核对什么:逐项算术与完整性核对。
每条结论都带原文行号与出处,可被第三方用同一口径复算;
材料不足时不给结论,会明确列出还缺什么,不会输出「未发现问题」。
这个完整版查什么
(检查项由引擎的 CHECKS_* 导出,跑 --sample 会打印实际执行了哪些。)
怎么用
node scripts/social-insurance-check-paid.mjs --sample
node scripts/social-insurance-check-paid.mjs --text "占位材料"
node scripts/social-insurance-check-paid.mjs --input templates/social-insurance-check-sample.json --json
node scripts/social-insurance-check-paid.mjs --help
三种真实结局
| HTTP | 含义 | 你会看到什么 |
|---|---|---|
| 200 | 已付款(或免费额度内) | 直接输出结果 |
| 402 | 需要付款 | 402账单下发:账单落盘 + 唯一一条 alipay-bot 交接命令 |
| 其他 | 入参错误 / 凭证无效 / 服务端故障 | 原样输出,不重试、不猜测 |
首次调用会拿到 Payment-Needed 账单(单次 ¥0.99):
{
"ok": false,
"code": "Payment-Needed",
"error": "payment_required",
"tier": { "price": "0.99", "endpoint": "/api/v1/pay/0.99" },
"capability": { "id": "social-insurance-check" },
"price": { "amount": "0.99", "currency": "CNY" }
}
退出码
| 码 | 含义 |
|---|---|
| 0 | 已执行(HTTP 200,结果已打印) |
| 1 | 没给入参 / 缺必填参数 / --input 文件读不到或不是合法 JSON(本地就能判断,不发注定失败的请求) |
| 2 | 网络或超时(不伪造结果) |
| 4 | 服务端返回其他状态(原样输出,不重试) |
| 42 | 待付款(HTTP 402,账单已交接,不是失败) |
| 9 | 未预期错误 |
关于付款(本技能不碰钱)
- 首次调用返回 HTTP 402 与一份
Payment-Needed账单(单次 ¥0.99),也就是 402账单下发; - 本脚本只做两件事:发起业务请求、把 402 账单落盘并交接出去;不实现付款、不实现签名、不携带任何密钥;
- 付款交给官方支付能力
alipay-bot(来自@alipay/agent-payment)—— 脚本会打印一条可直接执行的
402-buyer-pay命令,由 alipay-bot 完成验付调用(向服务端核实支付结果)与履约确认(付款后回执); - 付款成功后 alipay-bot 会携带凭证重试同一请求并取回结果;订单持久化与幂等:同一订单付款后复用,
不会重复扣费; - 单次价格以服务端登记价为准(http://110.40.221.75/api/v1/capabilities,生成本包时实测 ¥0.99 CNY),
本包不另立价目表; - 账单文件写在用户私有目录
~/.social-insurance-check-pay(权限 0700/0600),不落进技能包。
边界(请务必知道)
- 本包是薄客户端:包里没有规则实现(只有 SKILL.md、一个入口脚本、一份样例),核对全部在服务端完成;
- 材料不足时不给结论,也不会输出「未发现问题」;检查项口径以服务端为准;
- 「没报问题」不等于「没有问题」 —— 只执行服务端登记的那些检查项,超出范围的判断不在本能力内。