2.5 电子发票业务流程及对应调用指引


为机构商户和普通商户提供数电发票开通和发票开具等相关api,业务流程及对应调用指引如下:

1.商户开通数电发票

(1)机构商户可通过调用api为普通商户开通
        通过【2.5.1邀请二维码生成接口】获取邀请商户开通数电发票二维码,商户法人/财务联系人扫码授权开通数电发票。
        通过【2.5.2.获取电票开通状态】查询商户开通状态。
(2)普通商户需线下开通数电发票,联系客户经理获取邀请开通二维码,商户法人/财务联系人扫码授权开通数电发票。


2.发票开具,提供以下2种发票开具模式

(1)模式一:商户获取开票二维码,并向用户展示,用户使用微信扫码开票,适用于通用基础行业。

  • a.若商户自行维护开票商品,则可调用【2.5.4电票二维码生成接口】获取开票二维码,用户使用微信扫码开票。支持一张发票送多个发票行信息,目前最多支持8行。
  • b.若商户不维护开票商品信息,可在好老板app中维护开票商品信息,则需先调用【2.5.5获取电票商户开票品类】获取商户已配置的开票信息列表,再通过【2.5.3电票二维码生成接口(简易)】获取开票二维码,用户使用微信扫码开票。


(2)模式二:商户自行调用开票接口,适用于成品油行业及不动产租赁行业

  • a.以下2种开票场景下,商户可调用【2.5.10.1发票开具接口(适用成品油行业)】或【2.5.10.2发票开具接口(适用不动产租赁行业)】提交开票申请:
    场景一:支付即开票,商户在交易完成后自行调用【2.5.10.1发票开具接口(适用成品油行业)】或【2.5.10.2发票开具接口(适用不动产租赁行业)】,上送交易及开票信息提交开票。
    场景二:消费者在微信账单页发起开票,商户收到通过【2.5.10发票开具通知】接口发送的通知,发票状态(status)为“发票待开(waitopen)”时,商户调用【2.5.1发票开具接口(适用成品油行业)】或【2.5.2发票开具接口(适用不动产租赁行业)】,上送交易及开票信息提交开票,此时无需传抬头信息,系统自动从渠道获取。
  • b.发票重开
    商户可自行向消费者提供发票重开功能,此种情况下,商户需调用【2.5.8发票冲红】接口冲红发票,待发票冲红后,再调用【2.5.10.1发票开具接口(适用成品油行业)】或【2.5.10.2发票开具接口(适用不动产租赁行业)】,上送交易及开票信息提交开票。
    对于微信支付的交易,若已自动开票(发票状态为“已开具”),消费者也可在微信账单页发起发票重开(商户需先在好老板APP打开【微信账单页开票】开关,路径:好老板app-首页-增值服务-全电发票-开票场景管理-微信账单页开票,默认关闭),此种情况下,收银宝自动处理重开流程,并通知商户开票状态,商户可通过【2.5.6.2发票详情查询接口】查询发票详情。

3.发票开具状态获取

“发票开具成功”、“发票冲红成功”、“发票待开”状态下,收银宝会给商户推送发票状态通知,前提需要商户预先提供正确的通知地址;
商户也可通过【2.5.6发票查询】接口查询发票开具状态。


4.发票下载

商户调用接口【2.5.7获取电票下载地址】获取发票下载地址。


5.发票冲红

商户调用接口【2.5.8发票冲红】进行发票冲红。

6.通知地址配置

(1) 在商户管理平台配置通知地址,用于接收开票状态通知,路径为:商户服务平台-账户中心-对接配置-通知配置-全电发票通知URL
(2) 若为机构商户对接,机构商户可通过接口2.12关联子商户,用于在非机构商户主动开票场景下(比如微信账单页开票),当发票状态变化时,收银宝将读取此配置来通知对应的机构商户。


yinjr 2026年4月22日 15:50 收藏文档