接口描述

请求地址：/invoice/initiateVoidRedCharge

http请求方式：POST

接口诞生版本：3.9.2

所属系统：π平台

接口说明：用于申请企业指定开票月份、发票类型、进销项、红冲作废发票归集任务，或者获取红冲作废发票归集任务的状态

单次调用最大条数：1

使用场景

用于获取企业指定开票月份红冲作废的全量发票全票面数据，通过自动化的数据导入，提高发票管理的效率和准确性。

请求报文

参数名称	参数	参数类型	是否必填	说明
企业纳税人识别号	nsrsbh	String	是	企业纳税人识别号
开票月份	kpyf	integer	是	格式：YYYYMM
进销项标志	jxxbzs	array	是	有效值：jx：进项 xx：销项传多个值时用英文逗号隔开
发票类型代码	fplxs	array	是	有效值见附录A.1，传多个值时用英文逗号隔开
是否发起下载任务	addJob	boolean	是	true（发起下载任务）false（不发起下载任务）
强制更新	collectType	string	否	0 强制重新发起历史月份任务（当需要申请历史月份任务数据时，此项为必填，值为0）
账号唯一标识	accountId	string	否	账号唯一标识，多账号下的账号唯一标识

响应报文

参数名称	参数	参数类型	是否必填	说明
请求id	reqId	string	必需	由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位
错误码	code	string or null	必需
是否成功标记	success	boolean	必需
错误信息	message	string or null	必需
业务数据	data	object {2}	必需	data是具体的发票数据，包含以下所有字段。为发票主表字段。
开票月份	kpyf	integer	否	格式：YYYYMM
提示信息	msg	string	否
发票类型代码	fplx	string	否	见附录A.1
错误码	errorCode	string or null	否
进销项标志	jxxbz	string	否	有效值：jx：进项 xx：销项
错误信息	errorMsg	string	否
纳税人识别号	nsrsbh	string	否
创建时间	time	string	否	格式：YYYY-MM-DD HH:MM:SS
状态	status	string	否	见附录A.4
税款所属期	skssq	integer or null	否	格式：YYYYMM

请求报文范例

{

"appId": "ztefssc",

"format": "json",

"sign": "xHoDHfBC1OOeJP41jR0ZANJutwk=",

"version": "V2.0",

"noncestr": "e3e862c8-8405-4245-82c1-9973f1ef8386",

"timestamp": "2023-02-17 02:10:00",

"data": {

"nsrsbh": "************PDDL2G",

"kpyf": 50,

"jxxbzs": [

"jx"

],

"fplxs": [

"14",

"12",

"16",

"18"

],

"addJob": true

}

}

响应报文范例

{

"reqId": "40948605e9534556ae7d3a48bacebfcc",

"code": "2000",

"success": true,

"data": [

{

"createTime": 1678104124000,

"errorCode": "2000",

"fplx": "04",

"id": 453405742520576,

"jxxbz": "xx",

"kpyf": 202203,

"msg": "开始处理销项票、增值税普通发票，不存在符合条件的发票发票下载结果保存成功",

"nsrsbh": "91440101MA5AP37T1U",

"sjlyDm": "FPYXZ101",

"status": "processed",

"time": 1678104124000

},

{

"errorCode": "2000",

"errorMsg": "发票下载不支持销项海关缴款书",

"fplx": "17",

"jxxbz": "xx",

"kpyf": 202203,

"msg": "发票下载不支持销项海关缴款书",

"nsrsbh": "91440101MA5AP37T1U",

"status": "notSupported"

}

]

}

//失败返回结果

{

"result": {

"req_id": "f7005a7d9351462e8d5c569d4f36124c",

"success": false,

"time": 41,

"timestamp": 1670323665906

},

"error": {

"code": "xxxx",

"message": "xxx"

}

}

附录A

A.1 发票类型

财务云系统编码	发票类型
14	增值税专用发票
12	机动车销售统一发票
16	增值税普通发票
21	增值税电子专用发票
17	增值税电子普票发票
11	增值税普票发票（卷票）
18	增值税电子普票发票（通行费）
13	二手车统一销售发票
35	海关缴款书
32	全电发票(增值税专用发票)
31	全电发票(普通发票)
14	全电纸票(增值税专用发票)
16	全电纸票(普通发票)

A.2 发票任务状态代码

代码	名称
toProcess	已发起申请，待处理
processing	处理中
processed	处理完成
failed	处理失败
disabled	不支持（根据不同地区发票通道的不同情况，可能会返回此状态代码。例如浙江地区当小规模纳税人发起更新发票勾选状态任务时，因为小规模纳税人没有勾选发票的功能，最终会返回此状态，并且再发起当月的更新发票勾选状态任务也不会再处理）
notSupported	接口不支持如: 发票下载不支持的发票类型/ 取票月份大于当前时间/销项不支持海关缴款书等

A.3 发票任务异常状态代码

代码	说明
2000	发送成功
4000	没有符合条件的记录！
4001	用户名密码不正确
4002	企业未注册、停用、注销
4003	风险纳税人
4004	企业信息或身份不符
4005	非办税小号
4006	必填项为空
4007	全电发票异常
4008	当前税号在税局有正在执行的任务
4009	综服：身份权限
4010	实名登录人信息不全
4036	没有找到对应页面菜单返回
4038	申报发票明细抵扣联查询没有找到《发票数据下载》按钮
4048	没有勾选统计信息,请做勾选确认

A.4 发票状态代码

代码	名称
0	正常
2	作废
3	已红冲
7	部分红冲
8	全额红冲

申请作废，红冲发票归集任务接口

申请作废，红冲发票归集任务接口

关于作者

目录