Agent Skills
返回列表
微信支付数电发票开票助手

微信支付数电发票开票助手

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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崩溃问题

适合人员

  • 微信支付服务商的运营,需要批量邀请子商户开通电子发票能力
  • 企业的财务人员,每月处理多张电子发票的开具、下载和状态追踪
  • 后端开发者,要将微信支付电子发票能力集成进现有业务系统,并解决环境依赖问题