开具不动产租赁行业电子发票

更新时间:2025.09.03

商户完成收款后,调用本接口开具不动产租赁行业电子发票并插入微信用户的卡包。请求的交易信息必须真实存在。
注意:本接口成功返回仅代表开票请求已被受理,当开票完成时,微信支付会根据商户配置的回调地址进行回调通知,商户也可以通过【查询电子发票】接口获取开票结果及开票信息。

接口说明

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

请求方式:【POST】/v3/new-tax-control-fapiao/fapiao-applications/real-estate-leasing

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

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

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


 Content-Type  必填 string

请设置为application/json


 Wechatpay-Serial  必填 string

【微信支付公钥ID】或【微信支付平台证书序列号】  请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


body  包体参数

 sub_mchid  必填   string(32)

【子商户号】 微信支付分配的子商户号,具体请参考服务商模式开发必要参数说明


 fapiao_apply_id  必填   string(32)

【发票申请单号】 发票申请单号,唯一标识一次开票行为。当需要开具交易信息为非微信支付渠道的发票时,为调用【获取用户抬头填写链接】接口时指定的发票申请单号


 buyer_information  必填   object

【购买方信息】 购买方信息,即发票抬头。若商户使用微信官方抬头,可从【获取用户填写抬头信息】接口获取用户填写的抬头;也可自行收集发票抬头

属性

 fapiao_information  必填   object

【需要开具的数电发票信息】 需要开具的不动产租赁特定行业数电发票信息

属性

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/new-tax-control-fapiao/fapiao-applications/real-estate-leasing \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "sub_mchid" : "1900000109",
9    "fapiao_apply_id" : "4200000444201910177461284488",
10    "buyer_information" : {
11      "type" : "INDIVIDUAL",
12      "name" : "深圳市南山区测试企业",
13      "taxpayer_id" : "202003261233701778",
14      "address" : "深圳市南山区深南大道10000号",
15      "telephone" : "075512345678",
16      "bank_name" : "测试银行",
17      "bank_account" : "62001234567890",
18      "phone" : "mI7HGEJ4Q2B91IGjHrl7FNN9QuFPDfzeXoaJM4B8ZghZPzXK+vNotEZu/Gthm87Szv0MK2AoC0/3ZMDgltMtdoY6O0qZ4F1iXiwCuqkkBe+9M4ggvdzpPGM+fyed2QU1seUGbii5RVVVB9s+zLEQ8nv74vsgl77MZx14nd5obtCcfAvPfDJob3oG7FqlThmYKJqjiOwBvvQse7p9R8onj/POzSrbM8re8ZYGp4LcehXopTLdk2ZVWRv8bnJgKZWArAcqMdahq4jY2UVYeY4vpMmq4xuRTYk6xNXvowBBKK2SX8SqM+jm1USyoBIazLu4oaNFNdBO3fip1a1rFW0vRw==",
19      "email" : "NzJy3r0Z2u2Vs5l+WSH0A3CZ1oGlCZ66aa2wUlMXNmACbd4wU8LqqYCuTG4cYWxrVUSmviV59/Uy9vLdIwuHZVrMalYAZGtb8inWGhDj3wUqQnPkmBKBVGIWG5Y6XJmMvpXW6rIKsdzxs8NwWj30cRNfjanLxiWc0aIgl8Knwo0JcxlcYLo38T9ntsrRkQZMQEWHaMYnzjp7ysLbp6yW83OZb/NwEufERBdPnIbDbVE7DUd5MGhvO+tlr2YC1b4VCsrDmjryuTD5nvYYCGHyfXW2CM23hZdBm9tPc+mU18Z9d4XkasnfsecGWd2ISkpPmnk3DtapnD64Nw8JyLtkgw==",
20      "amount" : 1000,
21      "out_trade_no" : "order_20200701_123456",
22      "fapiao_bill_type" : "COMM_FAPIAO",
23      "user_apply_message" : "用户留言"
24    },
25    "fapiao_information" : {
26      "fapiao_id" : "20200701123456",
27      "total_amount" : 382895,
28      "items" : [
29        {
30          "tax_code" : "3010101020203000000",
31          "goods_name" : "*经营租赁*车辆停放服务",
32          "specification" : "米",
33          "unit" : "METER",
34          "quantity" : 100000000,
35          "total_amount" : 429900,
36          "tax_rate" : 1300,
37          "discount" : false,
38          "preferential_policy_code" : 1,
39          "real_estate_leasing_information" : {
40            "province" : "重庆市",
41            "city" : "涪陵区",
42            "address" : "xx街道xx小区",
43            "lease_period_start" : "2025-01-01T10:00:00+08:00",
44            "lease_period_end" : "2025-07-01T12:00:00+08:00",
45            "cross_city_flag" : true,
46            "certificate_no" : "OVgc/slzCvzSebaz46sUA4tJmm5GbNC0Tkp0oKmuHev9aTDzzcNIy5fKuywKWa0aYIWPyitr3wCYVPUw5Bnw1VUr6jn9eCeQPQye2t+zNuuCM0vmr1NNhdI3a2FNIx5HxkBrdM0XuiLt2/46UaWuzcUbZ52CCtZGgRzxeuj6oF/RKVG+dzT2HOm3kbYi1cUM10hARPKN+kV84I5WnFglX1cPM7s+OHkWvj38xEAfJBJfj3lf0UTRo",
47            "plate_no" : [
48              "渝A12345"
49            ]
50          }
51        }
52      ],
53      "export_business_policy_code" : 1,
54      "vat_refund_levy_code" : 1,
55      "billing_person_id" : "187776276864872",
56      "billing_person" : "张伟",
57      "fapiao_bill_type" : "COMM_FAPIAO",
58      "transaction_information" : [
59        {
60          "pay_channel" : "WECHAT_PAY",
61          "transaction_id" : "4200000008202508080512076713",
62          "out_trade_no" : "order_20200701_123456",
63          "amount" : 382895
64        }
65      ],
66      "remark" : "备注"
67    }
68  }'
69

应答参数

无应答包体

应答示例

202 Accepted

1'无应答包体'
2

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

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

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

400

RESOURCE_ALREADY_EXISTS

发票申请单已存在

请稍后调用【查询电子发票】接口获取开票结果

400

INVALID_REQUEST

交易单已申请开票,两次申请的交易金额不相同

修改交易单金额重试

400

INVALID_REQUEST

当前发票开具中,不可申请重开发票

请在调用【查询电子发票】接口获取发票状态

400

INVALID_REQUEST

当前发票冲红中,不可申请重开发票

请在调用【查询电子发票】接口获取发票状态

400

INVALID_REQUEST

申请开票次数,超过最大限制

请在调用【查询电子发票】接口获取当前发票已冲红后,换发票申请单号重试开票

400

INVALID_REQUEST

开票请求已被受理,请调用【查询电子发票】接口获取开票结果

开票请求已被受理,请调用【查询电子发票】接口获取开票结果

400

INVALID_REQUEST

交易单已申请开票,两次申请的交易金额不相同

修改交易单金额重试

400

INVALID_REQUEST

交易可剩余开票金额不足

修改交易订单或者开票金额重试

403

NO_AUTH

商户乐企不动产租赁发票能力未授权

确认商户是否发起不动产租赁发票能力邀请授权,以及电子税局确认操作。确认无误,请稍后重试

403

NO_AUTH

商户无权限

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

403

RULE_LIMIT

商户尚未配置电子发票卡券模板信息

请先调用【创建电子发票卡券模板】接口成功后再重新调用

403

RULE_LIMIT

商户不可对该货物或应税劳务、服务编码开具发票

请检查参数中的货物或应税劳务、服务编码是否在【获取商品和服务税收分类对照表】接口返回的数据中

403

RULE_LIMIT

商户提交的购买方信息与用户填写的发票抬头不一致

请检查参数中的购买方信息与【获取用户填写抬头信息】接口返回的发票抬头信息是否一致

403

RULE_LIMIT

微信支付订单所属商户与当前商户不一致(仅微信支付场景)

请检查微信支付订单号是否属于子商户

404

RESOURCE_NOT_EXISTS

用户尚未完成发票抬头填写(仅非微信支付场景)

请在调用【获取用户填写抬头信息】接口成功后再以相同发票申请单号重新调用

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

 

 

反馈
咨询
目录
置顶