微信支付数电发票开票助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-p9b3qunr/wechatpay-einvoice。
技能介绍
解决的问题
电子发票场景常见痛点是:财务或开票员需要在微信支付商户平台、税局和企业系统之间来回切换;研发即使只想“给 XX 公司开一张技术服务费发票”,也要先摸清签名、加密、异步轮询和 PDF 下载,再写一次性脚本。更现实的问题是,wxpay 的命令行壳依赖 yargs,在 Node 22+ 下执行 req 子命令会直接崩(ERR_ASSERTION / SIGSEGV),和参数无关,导致本来不复杂的一次开票被卡在运行环境上。该 skill 的目标就是用自然语言驱动一套稳定的微信支付数电发票操作。
它是怎么工作的
开票与交付
- 先确认本次服务商模式下的
sub_mchid,再提取购买方、金额(单位为分)、税率(6% 传 60000)、商品名和税收分类编码;要素不全时继续追问,不臆造。 - 生成本地唯一
fapiao_apply_id,调用issue发起开票;支持通用、成品油、不动产租赁、旅客运输各自的独立接口与前置校验。 - 开票是异步的,用
query轮询status:SUCCESS拿fapiao_id,处理中则稍后再查,FAIL读fail_reason;download先取download_url,再用-b二进制模式落盘 PDF。
服务商开通与配置
invite-url生成邀请链接,list-invite按时间范围拉回已确认商户和sub_mchid,check-status查看digital_tax_mode.status,确认ENABLED后再开票。dev-config设置回调地址和支付账单开票入口;card-template创建电子发票卡券模板,这是开票前置依赖,否则会返回RULE_LIMIT。
运行方式
脚本统一通过 node scripts/wxreq.js 调用 wechatpay-axios-plugin 的编程式 API,不经过 wxpay 的 yargs 命令行壳;私钥、公钥、证书以文件路径经环境变量传入。加签验签可选微信支付公钥模式(推荐)或平台证书模式;敏感字段需要 RSA-OAEP 加密,并在 fapiao.config 中配好对应序列号。
适用边界与注意点
- 能力严格锁定
/v3/new-tax-control-fapiao/*;下单、支付、转账、退款、分账等资金操作一律拒绝。 - 纯服务商模式,所有请求都必须带
sub_mchid,且子商户开票状态应为ENABLED,否则常见NO_AUTH/403是产品权限问题,不是代码 bug。 card-template会覆盖旧模板;invite_url包含时效性invite_param,每次结果都不同;返回 JSON 字符串而不是对象时,需要在 catch 中按 HTTP 200 处理。- 证书模式约 5 年有效,到期要重新下载;若不想处理
wxpay crt在 Node 22+ 的风险,优先使用公钥模式。
使用场景
- 服务商生成开通邀请链接,邀请子商户开通数电发票能力
- 财务每月开具企业技术服务费电子发票,并下载PDF存档
- 开发者在Node22环境下调用微信支付开票接口,规避yargs崩溃问题
适合人员
- 微信支付服务商的运营,需要批量邀请子商户开通电子发票能力
- 企业的财务人员,每月处理多张电子发票的开具、下载和状态追踪
- 后端开发者,要将微信支付电子发票能力集成进现有业务系统,并解决环境依赖问题