67 lines
4.2 KiB
Markdown
67 lines
4.2 KiB
Markdown
# 服务商电子发票接口体系对比
|
||
|
||
## 结论
|
||
|
||
Gitee Issue `IDMETW` 补充的官方链接
|
||
[获取开通服务商电子发票能力邀请链接](https://pay.weixin.qq.com/doc/v3/partner/4015941495)
|
||
与 GitHub Issue [#4066](https://github.com/binarywang/WxJava/issues/4066) 给出的
|
||
[开发接入准备](https://pay.weixin.qq.com/doc/v3/partner/4015792554) 是**同一套**微信支付
|
||
V3 服务商电子发票产品文档：前者是 API 列表中的具体接口，后者是该产品的接入总览。
|
||
|
||
但是，当前 `weixin-java-mp` 的 `WxMpMerchantInvoiceService` 是另一套旧的公众号
|
||
`/card/invoice/*` 接口；不能把它当作这两个 Issue 所要求的支付 V3 能力实现。
|
||
|
||
## 当前仓库既有的公众号体系
|
||
|
||
- 当前代码将该能力归入公众号模块：
|
||
`weixin-java-mp` 的
|
||
`WxMpMerchantInvoiceService`。
|
||
- 该接口的 Javadoc 明确引用公众号官方文档：
|
||
[商户开票模式说明](https://developers.weixin.qq.com/doc/offiaccount/WeChat_Invoice/E_Invoice/Vendor_and_Invoicing_Platform_Mode_Instruction.html)
|
||
和
|
||
[商户开票接口列表](https://developers.weixin.qq.com/doc/offiaccount/WeChat_Invoice/E_Invoice/Vendor_API_List.html)。
|
||
后者当前重定向至
|
||
[新版服务号文档](https://developers.weixin.qq.com/doc/service/guide/product/weixin_invoice/E_Invoice/Vendor_API_List.html)。
|
||
- 代码实际请求公众号 API：`/card/invoice/getauthurl`、
|
||
`/card/invoice/getauthdata`、`/card/invoice/makeoutinvoice`、
|
||
`/card/invoice/clearoutinvoice`、`/card/invoice/queryinvoceinfo` 等；见
|
||
`WxMpApiUrl.Invoice`。这套接口围绕授权页、获取用户授权数据、开票、冲红和
|
||
查询发票信息。
|
||
- 历史提交 `058ce62a2b932633931e30762f44c561481dde5f` 将该服务及其请求/响应
|
||
Bean 加入 `weixin-java-mp`；提交说明关联 #1305。
|
||
|
||
> 说明：调研时 Gitee 页面/API 的 TLS 连接失败，未能独立读取 IDMETW 的评论；
|
||
> 但用户随后提供的 `4015941495` 链接已明确该 Issue 实际指向支付 V3 服务商电子发票。
|
||
|
||
## 两个 Issue 共同指向的支付 V3 体系
|
||
|
||
- #4066 链接的[开发接入准备](https://pay.weixin.qq.com/doc/v3/partner/4015792554)
|
||
属于
|
||
“微信电子发票”产品，要求在**微信支付服务商号**申请“服务商电子发票”权限，
|
||
并提到数电发票资源。
|
||
- IDMETW 链接的[获取开通服务商电子发票能力邀请链接](https://pay.weixin.qq.com/doc/v3/partner/4015941495)
|
||
位于相同产品的“API 列表”下，路径为
|
||
`GET /v3/new-tax-control-fapiao/fapiaomerchant/getspinviteurl`。
|
||
- 同一官方文档导航的 API 列表包含：邀请子商户开通、检查子商户开票状态、创建电子
|
||
发票卡券模板、配置开发选项、抬头填写链接/信息、各行业开票、冲红、查询、下载/上传
|
||
发票文件、插入用户卡包，以及多个异步通知。
|
||
- 例如“开具通用行业电子发票”接口为
|
||
`POST /v3/new-tax-control-fapiao/fapiao-applications/issue-general`，请求域名为
|
||
`https://api.mch.weixin.qq.com`，并要求微信支付 API 证书签名、服务商模式的
|
||
`sub_mchid` 和唯一开票申请单号 `fapiao_apply_id`；官方文档：
|
||
[开具通用行业电子发票](https://pay.weixin.qq.com/doc/v3/partner/4015792574)。
|
||
该页还规定敏感字段使用微信支付公钥或平台证书加密。
|
||
|
||
## 直接差异
|
||
|
||
| 维度 | 既有公众号能力 | 两个 Issue 指向的微信支付能力 |
|
||
| --- | --- | --- |
|
||
| SDK 模块 | `weixin-java-mp` | 应位于 `weixin-java-pay` |
|
||
| 官方文档产品线 | `developers.weixin.qq.com` 的公众号电子发票 | `pay.weixin.qq.com/doc/v3/partner` 的微信支付合作伙伴电子发票 |
|
||
| API 形态 | `/card/invoice/*` | `/v3/new-tax-control-fapiao/*` |
|
||
| 身份/鉴权上下文 | 公众号 access token、用户授权页/授权数据 | 微信支付服务商号、子商户号、V3 签名与敏感字段加密 |
|
||
| 覆盖范围 | 授权、开票、冲红、查询及公众号商户配置 | 子商户邀约/状态、模板/开发配置、行业开票、文件和卡包、通知 |
|
||
|
||
因此，两个 Issue 都是同一个微信支付 V3 服务商电子发票接入需求，当前由
|
||
`weixin-java-pay` 的 `PartnerInvoiceService` 提供对应的 `new-tax-control-fapiao` API 实现。
|