🚀 一、微信小程序获取发票抬头（原生 API）

接口名称：wx.chooseInvoiceTitle(Object object)，微信小程序官方原生接口，用于快速调取用户已保存的发票抬头信息。

官方文档：https://developers.weixin.qq.com/miniprogram/dev/api/open-api/invoice/wx.chooseInvoiceTitle.html

基础支持说明

• 基础库要求：1.5.0 及以上，低版本小程序需做版本兼容处理
• 调用方式：支持 Promise 风格调用
• 插件支持：小程序插件使用需基础库 2.16.1 及以上

接口返回字段说明

接口调用成功后，success 回调返回完整发票抬头信息：

• type：抬头类型（0 = 单位，1 = 个人）
• title：发票抬头名称
• taxNumber：企业税号/统一社会信用代码
• companyAddress：企业地址
• telephone：联系电话
• bankName：开户银行名称
• bankAccount：银行账号

完整调用代码示例

 wx.chooseInvoiceTitle({
   success: (res) => {
     console.log('获取发票抬头成功', res);
     // 业务逻辑：将返回字段填充至表单
     const invoiceInfo = {
       type: res.type,
       title: res.title,
       taxNumber: res.taxNumber,
       address: res.companyAddress,
       phone: res.telephone,
       bankName: res.bankName,
       bankAccount: res.bankAccount
     }
   },
   fail: (err) => {
     console.error('接口调用失败', err);
   },
   complete: () => {
     console.log('接口调用结束');
   }
 });
 

🚀 二、微信公众号 H5 获取发票抬头（JS-SDK）

微信公众号网页无法直接调用原生接口，必须依托 微信 JS-SDK 完成签名授权、接口调用。同时 iOS / Android 设备 URL 识别规则不同，需做跨平台适配。

官方文档：https://developers.weixin.qq.com/doc/service/guide/product/weixin_invoice/Quick_issuing/Interface_Instructions.html

整体流程

引入JS-SDK库 → 后端生成签名 → 前端初始化配置 → 适配双端URL → 调用接口 → 解析返回数据

1. 引入微信 JS-SDK

 
 <script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>
 

2. JS-SDK 初始化与权限配置

签名参数（appId、timestamp、nonceStr、signature）需由后端通过微信签名算法生成，前端不可伪造。

 // 后端返回签名配置参数
 const wxConfig = {
   appId: "公众号AppID",
   timestamp: "时间戳",
   nonceStr: "随机字符串",
   signature: "签名值"
 };
 
 // 初始化 JS-SDK
 wx.config({
   beta: true,
   debug: false, // 生产环境关闭调试模式
   appId: wxConfig.appId,
   timestamp: wxConfig.timestamp,
   nonceStr: wxConfig.nonceStr,
   signature: wxConfig.signature,
   // 必须声明当前页面需要使用的接口
   jsApiList: ["chooseInvoiceTitle"]
 });
 
 // 配置验证成功回调
 wx.ready(() => {
   console.log("JS-SDK 初始化完成，可调用接口");
 });
 
 // 配置验证失败回调
 wx.error((err) => {
   console.error("JS-SDK 配置失败：", err);
 });
 

3. 跨平台 URL 适配（关键避坑）

 // Vue 路由守卫：全局存储页面首次入口URL
 router.beforeEach((to, from, next) => {
   if (!window.entryUrl) {
     window.entryUrl = location.href.split('#')[0];
   }
   next();
 });
 
 // 根据设备类型选择签名URL
 const userAgent = navigator.userAgent;
 const isAndroid = userAgent.indexOf('Android') > -1 || userAgent.indexOf('Adr') > -1;
 let signUrl = "";
 
 if (isAndroid) {
   signUrl = location.href.split('#')[0];
 } else {
   signUrl = window.entryUrl;
 }
 // 将 signUrl 传给后端生成签名
 

4. 调用接口并解析发票抬头数据

 // JS-SDK 通过 invoke 调用发票抬头接口
 wx.invoke('chooseInvoiceTitle', { scene: '1' }, function(res) {
   if (res.err_msg !== "chooseInvoiceTitle:ok") {
     console.log("用户取消选择或调用失败");
     return;
   }
   // 解析嵌套格式的发票数据
   const rawInfo = res.choose_invoice_title_info;
   const invoice = JSON.parse(rawInfo);
 
   // 字段映射
   const invoiceData = {
     title: invoice.title,
     taxNumber: invoice.taxNumber,
     companyAddress: invoice.companyAddress,
     telephone: invoice.telephone,
     bankName: invoice.bankName,
     bankAccount: invoice.bankAccount,
     titleType: invoice.type
   };
   console.log("最终发票抬头信息：", invoiceData);
 });
 

常见问题汇总

• invalid signature：签名错误，检查URL、签名算法、时间戳
• 权限失效：公众号未认证、jsApiList 未声明接口
• iOS 签名必败：入口URL未正确捕获

🚀 三、第三方接口智能查询发票抬头

适用于无微信生态环境、用户未保存发票抬头的场景，通过企业名称/税号模糊查询完整购方发票信息。

第三方平台：开放平台 https://open.fa-piao.com

文档地址 智能查询发票抬头

接口基础信息

• 请求地址：POST /v5/enterprise/smartBuyer
• 请求方式：POST
• 必传参数：
  • kpdwdm：销方统一社会信用代码（开票方税号）
  • nsrmc：购方企业名称（支持关键字模糊查询）

接口成功返回示例

 {
     "code": 200,
     "data": [
         {
             "ghdwdm": "9150010776594xxxx",
             "ghdwdzdh": "重庆市九龙坡区xxxx楼 02368679xxx",
             "ghdwmc": "重庆xxxx有限公司",
             "ghdwyhzh": "建设银行xxx分行 500010344000xxxx"
         }
     ],
     "msg": "成功",
     "total": 1
 }
 

返回字段释义

• ghdwdm：购方企业税号
• ghdwmc：购方企业名称
• ghdwdzdh：企业地址 + 联系电话
• ghdwyhzh：开户银行 + 银行账号

🚀 四、三种方案综合对比