冲红电子发票

更新时间：2024.09.20

商户对已开具的电子发票进行冲红（开具红票），并将其从微信用户的卡包中删除。<strong>仅在微信支付侧开具的电子发票才允许发起冲红。</strong>
注意：本接口成功返回仅代表冲红请求已被受理，当冲红完成时，微信支付会根据商户配置的回调地址进行回调通知，商户也可以通过【查询电子发票】接口获取冲红结果及红票信息。

接口说明

支持商户：【普通商户】

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

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

path 路径参数

fapiao_apply_id 　必填 string(32)

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

body 包体参数

reverse_reason 　必填 string(200)

【冲红原因】冲红原因

fapiao_information 　选填 array[ReverseFapiaoInfo]

【需要冲红的发票信息】需要冲红的发票信息

属性

请求示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/new-tax-control-fapiao/fapiao-applications/4200000444201910177461284488/reverse \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "reverse_reason" : "退款",
8    "fapiao_information" : [
9      {
10        "fapiao_id" : "20200701123456",
11        "fapiao_code" : "044001911211",
12        "fapiao_number" : "12897794"
13      }
14    ]
15  }'
16

应答参数

无应答包体

应答示例

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	发票冲红请求已被受理	请稍后调用【查询电子发票】接口获取冲红结果
401	SIGN_ERROR	签名错误或签名信息不完整	请检查签名参数和方法是否都符合签名算法要求
403	NO_AUTH	商户无权限	请检查是否已经开通电子发票产品相关功能权限，若是服务商模式，还需确认子商户是否接受了服务商的邀请
403	NO_AUTH	服务商无权限操作该发票申请单（仅服务商模式）	请检查发票申请单是否属于服务商
403	RULE_LIMIT	发票当前状态不允许冲红	请检查发票状态是否为“发票已开具”，可调用【查询电子发票】接口获取当前的发票状态
404	RESOURCE_NOT_EXISTS	发票申请单不存在	请检查发票申请单号是否正确
404	RESOURCE_NOT_EXISTS	要冲红的发票不存在	请检查商户发票单号、发票代码、发票号码是否正确
429	FREQUENCY_LIMITED	频率超限	请降低请求接口频率

文档是否有帮助

更多支持

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