银行流水转可编辑 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之外的主机。