查询电子发票

更新时间：2024.11.28

商户调用【开具电子发票】接口或【冲红电子发票】接口或【将电子发票插入微信用户卡包】接口成功后，应调用本接口查询电子发票开具/冲红/插卡结果，并获取已开具/冲红/插卡的电子发票信息。

接口说明

支持商户：【普通服务商】

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

请求域名：【主域名】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 查询参数

sub_mchid 　选填 string(32)

【子商户号】微信支付分配的子商户号，服务商模式下必传

fapiao_id 　选填 string(32)

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

请求示例

GET

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

应答参数

200 OK

total_count 　必填 integer

【发票数量】发票数量

fapiao_information 　选填 array[object]

【发票信息】发票信息

属性

fapiao_id 　必填 string(32)

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

status 　必填 string

【发票状态】发票状态

可选取值：

ISSUE_ACCEPTED: 开票申请已受理
ISSUED: 发票已开具
REVERSE_ACCEPTED: 冲红申请已受理
REVERSED: 发票已冲红

blue_fapiao 　选填 object

【蓝字发票信息】蓝字发票信息，当发票状态不为ISSUE_ACCEPTED时存在

属性

red_fapiao 　选填 object

【红字发票信息】红字发票信息，当发票状态为REVERSED时存在

属性

card_information 　选填 object

【电子发票卡券信息】电子发票卡券信息

属性

card_appid 　必填 string(32)

【插卡公众号AppID】插入用户卡包的公众号AppID

card_openid 　必填 string(32)

【用户在插卡公众号下的OpenID】接收发票的用户在插卡公众号下的OpenID

card_id 　选填 string(32)

【电子发票卡券模板ID】电子发票卡券模板ID，当发票卡券状态不为INSERT_ACCEPTED时存在

card_code 　选填 string(32)

【电子发票在卡包中的编码】电子发票在卡包中的编码，当发票卡券状态不为INSERT_ACCEPTED时存在

card_status 　必填 string

【发票卡券状态】发票卡券状态

可选取值：

INSERT_ACCEPTED: 插卡申请已受理
INSERTED: 已插入用户卡包
DISCARD_ACCEPTED: 作废申请已受理
DISCARDED: 发票卡券已作废

total_amount 　必填 integer

【总价税合计】总价税合计，所有发票行单行金额合计的累加，单位：分

tax_amount 　必填 integer

【总税额】总税额，所有发票行单行税额的累加，单位：分

amount 　必填 integer

【总金额】总金额，所有发票行单行金额的累加，单位：分

seller_information 　必填 object

【销售方信息】销售方信息

属性

buyer_information 　必填 object

【购买方信息】购买方信息

属性

type 　必填 string

【购买方类型】购买方类型

可选取值：

INDIVIDUAL: 个人
ORGANIZATION: 单位

name 　必填 string(256)

【名称】购买方名称

taxpayer_id 　选填 string(32)

【纳税人识别号】购买方纳税人识别号，购买方类型为ORGANIZATION时必须存在

address 　选填 string(128)

【地址】购买方地址

telephone 　选填 string(32)

【电话】购买方电话

bank_name 　选填 string(128)

【开户银行】购买方开户银行

bank_account 　选填 string(32)

【银行账号】购买方银行账号

phone 　选填 string

【手机号】用户手机号。注意：该字段为密文字段，解密算法请参见《如何使用API证书解密敏感字段》

email 　选填 string

【邮箱地址】用户邮箱地址。注意：该字段为密文字段，解密算法请参见《如何使用API证书解密敏感字段》

extra_information 　必填 object

【附加信息】附加信息

属性

items 　选填 array[object]

【发票行信息】发票行信息

属性

tax_code 　必填 string(32)

【税局侧规定的货物或应税劳务、服务税收分类编码】税局侧规定的货物或应税劳务、服务税收分类编码

goods_name 　必填 string(128)

【货物或应税劳务、服务名称】由商户自定义的货物或应税劳务、服务名称

specification 　选填 string(20)

【规格型号】规格型号

unit 　选填 string(20)

【单位】单位

quantity 　必填 integer

【数量】数量，单位为10^-8，100000000表示数量为1

unit_price 　必填 integer

【单价】单价，单位为10^-6分，100000000表示1元

amount 　必填 integer

【单行金额】单行金额，单位：分

tax_amount 　必填 integer

【单行税额】单行税额，单位：分

total_amount 　必填 integer

【单行金额合计】单行金额和税费的和，单位:分

tax_rate 　必填 integer

【税率】税率，单位为万分之一，如1300代表13%

tax_prefer_mark 　必填 string

【税收优惠政策标识】税收优惠政策标识

可选取值：

NO_FAVORABLE: 无优惠
OUTSIDE_VAT: 不征税
VAT_EXEMPT: 免税
NORMAL_ZERO_RATED: 普通零税率
EXPORT_ZERO_RATED: 出口零税率

discount 　必填 boolean

【是否折扣行】指定该发票行是否折扣行，折扣行一定是被折扣行的下一行

remark 　选填 string(200)

【备注信息】备注信息

应答示例

200 OK

1{
2  "total_count" : 5,
3  "fapiao_information" : [
4    {
5      "fapiao_id" : "20200701123456",
6      "status" : "ISSUE_ACCEPTED",
7      "blue_fapiao" : {
8        "fapiao_code" : "044001911211",
9        "fapiao_number" : "12897794",
10        "check_code" : "69001808340631374774",
11        "password" : "006>299-375/326>2+7/*0-+<351059<80<4*/5>+<11631+*3030/5*37+/-243159658+013>3409*044>4-/1+/9->*>69501*6++1997--21",
12        "fapiao_time" : "2020-07-01T12:00:00+08:00"
13      },
14      "red_fapiao" : {
15        "fapiao_code" : "044001911211",
16        "fapiao_number" : "12897794",
17        "check_code" : "69001808340631374774",
18        "password" : "006>299-375/326>2+7/*0-+<351059<80<4*/5>+<11631+*3030/5*37+/-243159658+013>3409*044>4-/1+/9->*>69501*6++1997--21",
19        "fapiao_time" : "2020-07-01T12:00:00+08:00"
20      },
21      "card_information" : {
22        "card_appid" : "wxb1170446a4c0a5a2",
23        "card_openid" : "plN5twRbHym_j-QcqCzstl0HmwEs",
24        "card_id" : "p4gLgvlAYSEOpeXGFVJRFxgop6iY",
25        "card_code" : "379550244162",
26        "card_status" : "INSERT_ACCEPTED"
27      },
28      "total_amount" : 382895,
29      "tax_amount" : 44050,
30      "amount" : 338845,
31      "seller_information" : {
32        "name" : "深圳市南山区测试公司",
33        "taxpayer_id" : "202003261233701778",
34        "address" : "深圳市南山区深南大道10000号",
35        "telephone" : "075512345678",
36        "bank_name" : "测试银行",
37        "bank_account" : "62001234567890"
38      },
39      "buyer_information" : {
40        "type" : "INDIVIDUAL",
41        "name" : "深圳市南山区测试企业",
42        "taxpayer_id" : "202003261233701778",
43        "address" : "深圳市南山区深南大道10000号",
44        "telephone" : "075512345678",
45        "bank_name" : "测试银行",
46        "bank_account" : "62001234567890",
47        "phone" : "18507550000",
48        "email" : "123110@qq.com"
49      },
50      "extra_information" : {
51        "payee" : "张三",
52        "reviewer" : "李四",
53        "drawer" : "王五"
54      },
55      "items" : [
56        {
57          "tax_code" : "3010101020203000000",
58          "goods_name" : "出租汽车客运服务",
59          "specification" : "A4",
60          "unit" : "次",
61          "quantity" : 100000000,
62          "unit_price" : 380442000000,
63          "amount" : 380442,
64          "tax_amount" : 49458,
65          "total_amount" : 429900,
66          "tax_rate" : 1300,
67          "tax_prefer_mark" : "NO_FAVORABLE",
68          "discount" : false
69        }
70      ],
71      "remark" : "备注"
72    }
73  ]
74}

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	请使用正确的参数重新调用
401	SIGN_ERROR	签名错误或签名信息不完整	请检查签名参数和方法是否都符合签名算法要求
403	NO_AUTH	商户无权限	请检查是否已经开通电子发票产品相关功能权限，若是服务商模式，还需确认子商户是否接受了服务商的邀请
403	NO_AUTH	服务商无权限查询该发票申请单（仅服务商模式）	请检查发票申请单是否属于服务商
404	RESOURCE_NOT_EXISTS	发票申请单不存在	请检查发票申请单号是否正确
404	RESOURCE_NOT_EXISTS	商户发票单号对应的发票不存在	请检查商户发票单号是否正确
429	FREQUENCY_LIMITED	频率超限	请降低请求接口频率

文档是否有帮助

更多支持

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