流水还原｜银行流水转可编辑 Word

概述

银行流水转可编辑 Word

通过 POST https://www.conmes.cn/api/skillpay/bank-statement 提供付费转换。每单 1 元，最多 10 页、64 MB。本 Skill 只做文档识别和版式还原，不提供收入认定、贷款审核、财务分析或真实性判断。

调用前准备

告知用户银行流水会上传至 www.conmes.cn。每单只接受一个 PDF 或一张 PNG/JPG/JPEG/WEBP/BMP/TIFF。

不得在首次请求前因缺少 weixinpay 或 weixinpay_pay 而终止。必须先执行第一步，请求商户服务并取得真实的 HTTP 402 支付响应；只有收到完整支付信息后才判断当前 Agent 能否调用支付插件。

SkillPay 工作流程

第一步：请求资源

python scripts/convert_to_word.py start --file "/absolute/path/bank-statement.pdf"

首次请求不携带订单 Header。正常结果必须为 HTTP 402 Payment Required，并同时返回：

• Header WeixinPay-Required：支付凭证码。
• Header X-Out-Trade-No：商户订单号。
• Body code: PAYMENT_REQUIRED。
• Body WeixinPay.WeixinPay-Required、amount: "1.00"、currency: "CNY"。

保存 WeixinPay-Required 和 X-Out-Trade-No。支付信息不完整时不得发起支付。

第二步：完成微信支付

weixinpay_pay(paymentCode=<WeixinPay-Required>)

支付由 weixinpay 插件完成。只有插件明确返回支付成功后才能继续；取消或失败时终止。

如果收到完整 402 后确认当前 Agent 不提供 weixinpay_pay，此时再告知用户“当前 Agent 暂不支持微信支付付费能力”，同时保留 WeixinPay-Required 和 X-Out-Trade-No，不得创建新订单、重复请求或声称已经支付。

第三步：支付成功后必须重新请求

python scripts/convert_to_word.py resume 
  --file "/absolute/path/bank-statement.pdf" 
  --out-trade-no "<X-Out-Trade-No>" 
  --payment-code "<WeixinPay-Required>"

重试时必须使用与首次请求字节完全相同的文件，并原样携带：

WeixinPay-Required: <支付凭证码>
X-Out-Trade-No: <商户订单号>

不得创建新订单代替重试。服务端校验文件 SHA-256、查询微信支付状态并幂等履约。正常返回 PROCESSING 或 SUCCESS，以及 status_url、download_url。

第四步：等待履约

python scripts/convert_to_word.py wait 
  --status-url "<status_url>" 
  --out-trade-no "<X-Out-Trade-No>" 
  --timeout 3600 --interval 5

• SUCCESS：继续下载。
• REFUNDED：转换失败且已发起全额退款，告知用户并终止。
• FULFILL_AND_REFUND_FAILED：转换失败且退款失败，提供订单号并建议联系服务方。
• 超时或网络错误：只说明结果尚未确认。

第五步：下载 Word

python scripts/convert_to_word.py download 
  --download-url "<download_url>" 
  --out-trade-no "<X-Out-Trade-No>" 
  --output "/absolute/path/bank-statement.docx"

仅在返回 DOWNLOADED 且文件非空后交付。提醒用户逐项核对账户、日期、金额、借贷方向、余额和跨页表头，不得将转换结果直接作为金融结论。

错误处理

• PAGE_LIMIT_EXCEEDED：告诉用户实际页数和 10 页上限，说明本次未创建订单、不会扣费；可拆分为每份不超过 10 页后分别支付，或打开返回的 login_url 登录因智排版，按 1 积分/页处理完整文件。
• FILE_MISMATCH：用原订单和原文件重试。
• NOT_PAID：等待后使用同一订单再次执行 resume，不得重复支付。
• REFUNDED：告知已退款，不得再次请求或支付。
• 不得把支付凭证、订单号或银行流水发送到 www.conmes.cn 之外的主机。