外贸单证单单一致核对（付费版）
> 一句话：交单前把整套单据逐张核一遍，每条结论都带原文行号，可被第三方复算。
> 按次计费：单次 ¥0.99，在对话内完成支付后立即返回结果。
为什么值得
信用证项下出现不符点，银行会拒付并收不符费（通常每笔 USD 50~100），
货还可能压港产生滞箱费。单次 ¥0.99 换一次交单前扫一遍。
查什么（13 项）
- 关键字段跨单据一致：发票号 / 合同号 / 信用证号
- 金额与币种跨单据一致
- 数量 / 件数 / 重量跨单据一致
- 港口 / 船名 / 唛头跨单据一致
- 模板占位符残留
- 行内算术：单价 × 数量 = 金额
- 分项金额加总与总额一致
- 毛重 − 皮重 = 净重
- 日期顺序：发票 ≤ 提单 ≤ 信用证有效期 / 最迟装运期
- 信用证金额上限与溢短装比例核对
- 单据份数与正副本份数核对
- 唛头逐行与箱号区间连续性
- 原产地证 / 保险单与发票的关联字段核对
怎么用
node scripts/trade-doc-consistency-paid.mjs --sample
node scripts/trade-doc-consistency-paid.mjs --text "占位材料"
node scripts/trade-doc-consistency-paid.mjs --input templates/docs-sample.json --json
node scripts/trade-doc-consistency-paid.mjs --help
payload.json 形如：
{ "documents": [
{ "type": "商业发票", "text": "发票号: INV-2026-0088\n信用证号: LC-8891-2026" },
{ "type": "装箱单", "text": "发票号: INV-2026-0088\n信用证号: LC-8891-2026" }
] }
关于付款（本技能不碰钱）
- 首次调用返回 HTTP 402 与一份
Payment-Needed账单（单次 ¥0.99）； - 付款成功后 alipay-bot 会自动携凭证重发同一请求并取回结果。
边界（本工具不做的事）
- 不判断单证是否会被银行接受 —— 那是银行与信用证条款的事；
- 不判断单据真实性、印章真伪或货权归属；
- 不给法律、税务或报关意见；
- 不做 OCR：需要你先从扫描件/图片里把文字贴进来；
- 「没报问题」不等于「没有问题」：超出上述 13 项的检查不执行；
- 材料不足时不给结论，绝不用默认值编一个「没问题」出来。
三种真实结局
| 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": "trade-doc-consistency" },
"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），
本包不另立价目表； - 账单文件写在用户私有目录
~/.trade-doc-consistency-pay（权限 0700/0600），不落进技能包。
边界（请务必知道）
- 本包是薄客户端：包里没有规则实现（只有 SKILL.md、一个入口脚本、一份样例），核对全部在服务端完成；
- 材料不足时不给结论，也不会输出「未发现问题」；检查项口径以服务端为准；
- 「没报问题」不等于「没有问题」 —— 只执行服务端登记的那些检查项，超出范围的判断不在本能力内。
