获取发票下载信息

更新时间：2024.09.20

商户在开具发票成功后，调用本接口获取电子发票的下载地址。仅在微信支付侧开具的电子发票才允许下载发票文件。
注意：开票状态为ISSUED的发票才能获取到发票文件下载链接。

接口说明

支持商户：【普通商户】

请求方式：【GET】/v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/fapiao-files

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

path 路径参数

fapiao_apply_id 　必填 string(32)

【发票申请单号】开票时指定的发票申请单号

query 查询参数

fapiao_id 　选填 string(32)

【商户发票单号】开票时指定的商户发票单号，唯一标识一张电子发票，若指定了该字段，则只会返回其对应的电子发票文件信息

请求示例

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/new-tax-control-fapiao/fapiao-applications/4200000444201910177461284488/fapiao-files?fapiao_id=20200701123456 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

fapiao_download_info_list 　选填 array[object]

【发票列表】发票列表

属性

fapiao_id 　选填 string(32)

【商户发票单号】商户发票单号，唯一标识一张发票

download_url 　选填 string(1024)

【发票文件下载地址】发票文件下载地址，仅当发票状态为ISSUED时存在

status 　选填 string

【发票状态】发票状态，仅能下载ISSUED状态的发票

可选取值：

ISSUE_ACCEPTED: 开票申请已受理

ISSUED: 发票已开具

REVERSE_ACCEPTED: 冲红申请已受理

REVERSED: 发票已冲红

ISSUE_FAILED: 发票开具已失败，数电发票模式特有字段

REVERSE_FAILED: 发票冲红已失败，数电发票模式特有字段

应答示例

200 OK

1{
2  "fapiao_download_info_list" : [
3    {
4      "fapiao_id" : "20200701123456",
5      "download_url" : "https://pay.wechatpay.cn/invoicing/fapiao/fapiao-file",
6      "status" : "ISSUE_ACCEPTED"
7    }
8  ]
9}
10

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	不是微信支付侧开具的电子发票	仅在微信支付侧开具的电子发票才允许下载发票文件
400	INVALID_REQUEST	OpenID与AppID不匹配	请检查传入的参数是否正确
403	NO_AUTH	商户无权限	开票申请单不是当前服务商创建，无权限进行当前操作
404	RESOURCE_NOT_EXISTS	发票申请单不存在	请检查发票申请单号是否正确
404	RESOURCE_NOT_EXISTS	商户发票单号对应的发票不存在	请检查商户发票单号是否正确

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服