查询电子发票

更新时间:2025.09.03

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

接口说明

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

请求方式:【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)

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

请求示例

curl
Java
Go

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]

【发票信息】 发票信息

属性

应答示例

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" : "mI7HGEJ4Q2B91IGjHrl7FNN9QuFPDfzeXoaJM4B8ZghZPzXK+vNotEZu/Gthm87Szv0MK2AoC0/3ZMDgltMtdoY6O0qZ4F1iXiwCuqkkBe+9M4ggvdzpPGM+fyed2QU1seUGbii5RVVVB9s+zLEQ8nv74vsgl77MZx14nd5obtCcfAvPfDJob3oG7FqlThmYKJqjiOwBvvQse7p9R8onj/POzSrbM8re8ZYGp4LcehXopTLdk2ZVWRv8bnJgKZWArAcqMdahq4jY2UVYeY4vpMmq4xuRTYk6xNXvowBBKK2SX8SqM+jm1USyoBIazLu4oaNFNdBO3fip1a1rFW0vRw==",
48        "email" : "NzJy3r0Z2u2Vs5l+WSH0A3CZ1oGlCZ66aa2wUlMXNmACbd4wU8LqqYCuTG4cYWxrVUSmviV59/Uy9vLdIwuHZVrMalYAZGtb8inWGhDj3wUqQnPkmBKBVGIWG5Y6XJmMvpXW6rIKsdzxs8NwWj30cRNfjanLxiWc0aIgl8Knwo0JcxlcYLo38T9ntsrRkQZMQEWHaMYnzjp7ysLbp6yW83OZb/NwEufERBdPnIbDbVE7DUd5MGhvO+tlr2YC1b4VCsrDmjryuTD5nvYYCGHyfXW2CM23hZdBm9tPc+mU18Z9d4XkasnfsecGWd2ISkpPmnk3DtapnD64Nw8JyLtkgw==",
49        "amount" : 1000,
50        "out_trade_no" : "order_20200701_123456",
51        "fapiao_bill_type" : "COMM_FAPIAO",
52        "user_apply_message" : "用户留言"
53      },
54      "extra_information" : {
55        "payee" : "张三",
56        "reviewer" : "李四",
57        "drawer" : "王五"
58      },
59      "items" : [
60        {
61          "tax_code" : "3010101020203000000",
62          "goods_name" : "出租汽车客运服务",
63          "specification" : "A4",
64          "unit" : "次",
65          "quantity" : 100000000,
66          "unit_price" : 380442000000,
67          "amount" : 380442,
68          "tax_amount" : 49458,
69          "total_amount" : 429900,
70          "tax_rate" : 1300,
71          "tax_prefer_mark" : "NO_FAVORABLE",
72          "discount" : false
73        }
74      ],
75      "remark" : "备注",
76      "fapiao_error_code" : "BIZ_ERROR",
77      "fapiao_error_message" : "开票失败。授信额度不足,请联系主管税务机关或者登录电子税务局提额/申报。"
78    }
79  ]
80}
81

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

请求参数符合参数格式,但不符合业务规则

请使用正确的参数重新调用

403

NO_AUTH

商户无权限

请检查是否已经开通电子发票产品相关功能权限,并检查子商户是否接受了服务商的邀请

403

NO_AUTH

服务商无权限

请检查发票申请单是否属于服务商

404

RESOURCE_NOT_EXISTS

发票申请单不存在

请检查发票申请单号是否正确

404

RESOURCE_NOT_EXISTS

商户发票单号对应的发票不存在

请检查商户发票单号是否正确

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

 

 

反馈
咨询
目录
置顶