为机构商户和普通商户提供数电发票开通和发票开具等相关api,业务流程及对应调用指引如下:
1.商户开通数电发票
(1)机构商户可通过调用api为普通商户开通
通过【2.5.1邀请二维码生成接口】获取邀请商户开通数电发票二维码,商户法人/财务联系人扫码授权开通数电发票。
通过【2.5.2.获取电票开通状态】查询商户开通状态。
(2)普通商户需线下开通数电发票,联系客户经理获取邀请开通二维码,商户法人/财务联系人扫码授权开通数电发票。
2.发票开具,提供以下2种发票开具模式
(1)模式一:商户获取开票二维码,并向用户展示,用户使用微信扫码开票,适用于通用基础行业。
- a.若商户自行维护开票商品,则可调用【2.5.4电票二维码生成接口】获取开票二维码,用户使用微信扫码开票。支持一张发票送多个发票行信息,目前最多支持8行。
- b.若商户不维护开票商品信息,可在好老板app中维护开票商品信息,则需先调用【2.5.6获取电票商户开票品类】获取商户已配置的开票信息列表,再通过【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发票开具接口(适用不动产租赁行业)】,上送交易及开票信息提交开票。
消费者可在微信账单页发起发票重开,此种情况下,商户会收到通过【2.5.9发票开具通知】接口的发送的通知,发票状态(status)为“发票待开(waitopen)”时,商户无需处理发票红冲,直接调用【2.5.10.1发票开具接口(适用成品油行业)】或【2.5.10.2发票开具接口(适用不动产租赁行业)】,上送交易及开票信息提交开票,无需送抬头信息。
3.发票开具状态获取
“发票开具成功”、“发票冲红成功”、“发票待开”状态下,收银宝会给商户推送发票状态通知,前提需要商户预先提供正确的通知地址;
商户也可通过【2.5.6发票状态查询】接口查询发票开具状态。
4.发票下载
商户调用接口【2.5.7获取电票下载地址】获取发票下载地址。
5.发票冲红
商户调用接口【2.5.8发票冲红】进行发票冲红。