接口描述

请求地址：/invoice/obtainInvoiceData

http请求方式：POST

接口诞生版本：3.9.2

所属系统：π平台

接口说明：用于归集企业指定开票月份的红冲作废发票，需要在红冲作废发票归集任务处理成功之后调用

单次调用最大条数：1

使用场景

该接口和“申请作废，红冲发票归集任务”接口为一套异步接口，“申请作废，红冲发票归集任务”接口确认该任务是否可以发起。“获取红冲，作废发票归集数据”接口对企业指定开票月份红冲作废的全量发票全票面数据进行归集，需要在“获取已勾选发票归集任务状态”任务处理“成功”之后调用。

请求报文

参数名称	参数	参数类型	是否必填	说明	示例
企业纳税人识别号	nsrsbh	String	是	企业纳税人识别号
开票月份	kpyf	integer	是	格式YYYYMM
进销项标志	jxxbz	string	是	有效值：jx：进项 xx：销项
发票类型	fplx	String	是	有效值：见附录A.1
分页信息	page	object	是	分页信息，可选，不传返回所有数据，但从系统层面选择为必填，避免数据量大时的展示问题

分页信息说明

参数名称	参数	参数类型	是否必填	说明	示例
分页大小	pageSize	Integer	是	建议单页数据大小控制在1000	1000
当前页	currentPage	Integer	是		2

响应报文-增值税专用发票、增值税普通发票、增值税普通发票（电子）、增值税普通发票（卷票）

注意：红色字段为v2多字段，蓝色字段为v1多字段

增值税专用发票、增值税普通发票、增值税普通发票（电子）、增值税普通发票（卷票）返回示例及字段说明

当发票为农产品收购发票时，由于是企业自己开具的发票，所以在销项发票里。

发票云返回报文中字段:jym、xsfdzdh、xsfyhzh、gmfdzdh、gmfyhzh、skm、hwxx中的qdbz、xhqdBz暂不返回

参数名称	参数	参数类型	是否必填	说明
请求id	reqId	string	必需	由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位
错误码	code	string or null	必需	错误码
是否成功标记	success	boolean	必需	接口是否成功（是否发生业务异常）
错误信息	message	string or null	必需
业务数据	data	object {2}	必需	data包含page和list两部分字段集。
分页信息	page	object {4}	必需	Page的详细分页信息有pageSize、currentPage、totalPage、totalCount4个字段
分页大小	pageSize	integer	必需
当前页	currentPage	integer	必需
总页数	totalPage	integer	必需
总记录数	totalCount	integer	必需
发票列表	list	array[object {35}]	必需	发票列表list是具体的发票数据，包含以下所有字段。为发票主表字段。
发票代码	fpdm	string	可选
发票号码	fphm	string	可选
数电票号码	sdphm	string	可选
开票日期	kprq	string	可选	格式：YYYY-MM-DD HH:MM:SS
校验码	jym	string	可选
销方识别号	xfsbh	string	可选
销方名称	xfmc	string	可选
销售方地址电话	xsfdzdh	string	可选
销售方银行账号	xsfyhzh	string	可选
购方识别号	gfsbh	string	可选
购方名称	gfmc	string	可选
购买方地址电话	gmfdzdh	string	可选
购买方银行账号	gmfyhzh	string	可选
密码区	skm	string	可选
金额	je	number	可选	金额，最大长度13+2
税额	se	number	可选	金额，最大长度13+2
价税合计	jshj	number	可选	金额，最大长度13+2
备注	bz	string	可选
开票人	kpr	string	可选
收款人	skr	string	可选
复核人	fhr	string	可选
特殊票种代码	tspzDm	string	可选	有效值： 02：农产品收购发票 08：成品油发票
发票状态代码	fpztDm	string	可选	见附录A.4
货物信息	hwxx	array[object {14}]	可选	hwxx包含明细序号mxxh至零税率标识lslbs共14个字段。为发票明细字段。
明细序号	mxxh	integer	可选
税局编码/税收分类编码	spbm	string	可选
货物劳务名称	mc	string	可选
规格型号	ggxh	string	可选
数量	sl	string	可选
计量单位	jldw	string	可选
单价	dj	string	可选	金额，最大长度13+15
税率	slv	number	可选	数字格式，最大为1最小为0 例如：13%税率，传值为0.13
税额	se	number	可选	金额，最大长度13+2
金额	je	number	可选	金额，最大长度13+2
清单标志	qdbz	string	可选
含税单价 (卷票字段)	hsdj	string	可选	金额，最大长度13+2
含税金额 (卷票字段)	hsje	string	可选	金额，最大长度13+2
零税率标识	lslbs	string	可选	空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率
销货清单标识	xhqdBz	string	可选	有效值： Y：是销货清单 N：不是销货清单
开具类型	kjlx	string	可选	枚举值：说明 1：自开 2：代开 3：待办退税
盘号	kpjh	string	可选
推送流水号	tslsh	string	可选
开票月份	kpyf	integer	可选	格式：YYYYMM
销方地市税务机关代码	xfDsswjgDm	string	可选
销方区县税务机关代码	xfQxswjgDm	string	可选
销方省级税务机关代码	xfSjswjgDm	string	可选
发票来源	fply	string	可选	增值税发票管理系统,电子发票服务平台
发票风险等级	fpfxdj	string	可选
特定业务类型	tdywlx	string	可选	"01":"成品油发票","02":"稀土发票","03":"建筑服务发票","04":"货物运输服务发票","05":"不动产销售服务发票","06":"不动产经营租赁服务", "07": "代收车船税","08":"通行费","09":"旅客运输服务发票","10":"医疗服务（住院）发票","11":"医疗服务（门诊）发票","12":"自产农产品销售发票", "13":"拖拉机和联合收割机发票","14":"机动车","15":"二手车","16":"农产品收购发票","17":"光伏收购发票","18":"卷烟发票","19":"出口发票","20":"农产品"

响应报文-机动车销售统一发票

参数名称	参数	参数类型	是否必填	说明
请求id	reqId	string	必需	由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位
错误码	code	string or null	必需
是否成功标记	success	boolean	必需
错误信息	message	string or null	必需
业务数据	data	object {2}	必需	data包含page和list两部分字段集。
分页信息	page	object {4}	必需	Page的详细分页信息有pageSize、currentPage、totalPage、totalCount 4个字段。
分页大小	pageSize	integer	必需
当前页	currentPage	integer	必需
总页数	totalPage	integer	必需
总记录数	totalCount	integer	必需
发票列表	list	array [object {32}]	必需	发票列表list是具体的发票数据，包含以下所有字段。为发票主表字段。
发票代码	fpdm	string	可选
发票号码	fphm	string	可选
开票日期	kprq	string	可选	格式：YYYY-MM-DD HH:MM:SS
密码区	skm	string	可选
购方名称	gfmc	string	可选
身份证号码/组织机构代码	sfzhm	string	可选
购买方识别号	gfsbh	string	可选
商品编码	spbm	string	可选
车辆类型	cllx	string	可选
厂牌型号	cpxh	string	可选
产地	cd	string	可选
合格证号	hgzh	string	可选
进口证明书号	jkzmsh	string	可选
商检单号	sjdh	string	可选
发动机号码	fdjhm	string	可选
车架号码/车辆识别代码	cjhm	string	可选
价税合计	jshj	number	可选	金额，最大长度13+2
销货单位名称	xhdwmc	string	可选
电话	dh	string	可选
开户银行	khyh	string	可选
销货单位纳税人识别号	xhdwsbh	string	可选
账号	zh	string	可选
地址	dz	string	可选
税率	slv	number	可选	增值税税率或征收率数字格式，最大为1最小为0 例如：13%税率，传值为0.13
增值税税额	zzsse	number	可选	金额，最大长度13+2
金额	je	number	可选	金额，最大长度13+2
单位	dw	string	可选
限乘人数	xcrs	string	可选
开票人	kpr	string	可选
发票状态代码	fpztDm	string	可选	见附录A.4
推送流水号	tslsh	string	可选
开票月份	kpyf	integer	可选	格式：YYYYMM

响应报文-通行费发票

参数名称	参数	参数类型	是否必填	说明
请求id	reqId	string	必需	由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位
错误码	code	string or null	必需
是否成功标记	success	boolean	必需	接口是否成功（是否发生业务异常）
错误信息	message	string or null	必需
业务数据	data	object {2}	必需	data包含page和list两部分字段集。
分页信息	page	object {4}	必需	Page的详细分页信息有pageSize、currentPage、totalPage、totalCount 4个字段。
分页大小	pageSize	integer	必需
当前页	currentPage	integer	必需
总页数	totalPage	integer	必需
总记录数	totalCount	integer	必需
发票列表	list	array[object {24}]	必需	发票列表list是具体的发票数据，包含以下所有字段。为发票主表字段。
发票代码	fpdm	string	可选
发票号码	fphm	string	可选
开票日期	kprq	string	可选	格式：YYYY-MM-DD HH:MM:SS
校验码	jym	string	可选
销方识别号	xfsbh	string	可选
销方名称	xfmc	string	可选
销售方地址电话	xsfdzdh	string	可选
销售方银行账号	xsfyhzh	string	可选
购方识别号	gfsbh	string	可选
购方名称	gfmc	string	可选
购买方地址电话	gmfdzdh	string	可选
购买方银行账户	gmfyhzh	string	可选
密码区	skm	string	可选
金额	je	number	可选	金额，最大长度13+2
税额	se	number	可选	金额，最大长度13+2
价税合计	jshj	number	可选	金额，最大长度13+2
备注	bz	string	可选
开票人	kpr	string	可选
收款人	skr	string	可选
复核人	fhr	string	可选
发票状态代码	fpztDm	string	可选	见附录A.4
货物信息	hwxx	array [object {9}]	可选
税局编码/税收分类编码	spbm	string	可选
货物劳务名称	mc	string	可选
规格型号/车牌号	ggxh	string	可选
数量（运行日期起）	sl	string	可选	格式：YYYYMMDD
计量单位	jldw	string	可选
单价（运行日期止）	dj	string	可选	格式：YYYYMMDD
金额	je	number	可选	金额，最大长度13+2
税率	slv	number	可选	数字格式，最大为1最小为0 例如：13%税率，传值为0.13
税额	se	number	可选	金额，最大长度13+2
设备编号	sbbh	string	可选
开票月份	kpyf	integer	可选
运行日期止(通行费发票)	txrqz	string	可选	格式：YYYYMMDD
运行日期起(通行费发票)	txrqq	string	可选	格式：YYYYMMDD

响应报文-二手车统一销售发票

参数名称	参数	参数类型	是否必填	说明
请求id	reqId	string	必需	由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位
错误码	code	string or null	必需
是否成功标记	success	boolean	必需
错误信息	message	string or null	必需
业务数据	data	object {2}	必需	data包含page和list两部分字段集。
分页信息	page	object {4}	必需	Page的详细分页信息有pageSize、currentPage、totalPage、totalCount 4个字段。
分页大小	pageSize	integer	必需
当前页	currentPage	integer	必需
总页数	totalPage	integer	必需
总记录数	totalCount	integer	必需
发票列表	list	array[object {32}]	必需	发票列表list是具体的发票数据，包含以下所有字段。为发票主表字段。
开票月份	kpyf	integer	可选	格式：YYYYMM
经营拍卖单位纳税人识别号	jyPmSbh	string	可选
车价合计	cjhj	number	可选	金额，最大长度13+2
转入地车辆管理所名称	zrdclglsMc	string	可选
经营、拍卖单位名称	jyPmMc	string	可选
经营、拍卖单位地址	jyPmDz	string	可选
开票日期	kprq	string	可选	格式：YYYY-MM-DD HH:MM:SS
车架号/车辆识别代码	clsbdm	string	可选
二手车市场识别号	escSbh	string	可选
备注	bz	string	可选
登记证号	djzh	string	可选
车辆类型	cllx	string	可选
卖方单位/个人名称	xfMc	string	可选
卖方单位/个人地址	xfDz	string	可选
二手车市场电话	escDh	string	可选
发票状态代码	fpztDm	string	可选	见附录A.4
经营、拍卖单位电话	jyPmDh	string	可选
发票代码	fpdm	string	可选
买方单位/个人名称	gfMc	string	可选
买方单位/个人地址	gfDz	string	可选
卖方单位/个人电话	xfDh	string	可选
开票人	kpr	string	可选
二手车市场名称	escMc	string	可选
二手车市场地址	escDz	string	可选
卖方单位/个人代码	xfDm	string	可选
买方单位/个人电话	gfDh	string	可选
厂牌型号	cpxh	string	可选
车牌照号	cpzh	string	可选
经营、拍卖单位开户银行账号	jyPmYhzh	string	可选
买方单位/个人代码	gfDm	string	可选
二手车市场开户行账号	escYhzh	string	可选
发票号码	fphm	string	可选
商品编码	spbm	string	可选
设备编号	sbbh	string	可选

响应报文-海关缴款书

参数名称	参数	参数类型	是否必填	说明
请求id	reqId	string	必需	由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位
错误码	code	string or null	必需
是否成功标记	success	boolean	必需
错误信息	message	string or null	必需
业务数据	data	object {2}	必需	data包含page和list两部分字段集。
分页信息	page	object {4}	必需	Page的详细分页信息有pageSize、currentPage、totalPage、totalCount 4个字段。
分页大小	pageSize	integer	必需
当前页	currentPage	integer	必需
总页数	totalPage	integer	必需
总记录数	totalCount	integer	必需
发票列表	list	array [object {32}]	必需	发票列表list是具体的发票数据，包含以下所有字段。为发票主表字段。
缴款书号码	jkshm	string	可选
填发日期	tfrq	string	可选	格式：YYYY-MM-DD HH:MM:SS
缴款单位一税号	jkdw1nsrsbh	string	可选
缴款单位一名称	jkdw1mc	string	可选
缴款单位二税号	jkdw2nsrsbh	string	可选
缴款单位二名称	jkdw2mc	string	可选
进口口岸代码	jkkadm	string	可选
税款金额	skje	number	可选	金额，最大长度13+2
货物信息	hwxx	array [object {7}]	可选	hwxx包含税号信息shxx至税款金额skje共7个字段。为发票明细字段。
税号信息	shxx	string	可选
货物名称	hwmc	string	可选
数量	sl	string	可选
单位	dw	string	可选
完税价格	wsjg	number	可选	金额，最大长度13+2
税率	slv	number	可选	数字格式，最大为1最小为0 例如：13%税率，传值为0.13
税款金额	skje	number	可选	金额，最大长度13+2
收入机关	srjg	string	可选
预算科目代码	yskmdm	string	可选
收款国库代码	skgkdm	string	可选
贸易方式	myfs	string	可选
申请单位编码	sqdwbm	string	可选
报关单编号	bgdbh	string	可选
合同（批文）号	hth	string	可选
运输工具（号）	ysgj	string	可选
缴款期限	jkqx	string	可选	格式：YYYY-MM-DD HH:MM:SS
提运单号	tydh	string	可选
填发月份	tfyf	integer	可选	格式：YYYYMM

响应报文-全电发票

参数名称	参数	参数类型	是否必填	说明
请求id	reqId	string	必需	由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位
错误码	code	string or null	必需
是否成功标记	success	boolean	必需
错误信息	message	string or null	必需
业务数据	data	object {2}	必需	data包含page和list两部分字段集。
分页信息	page	object {4}	必需	Page的详细分页信息有pageSize、currentPage、totalPage、totalCount 4个字段。
分页大小	pageSize	integer	必需
当前页	currentPage	integer	必需
总页数	totalPage	integer	必需
总记录数	totalCount	integer	必需
发票列表	list	array [object {32}]	必需	发票列表list是具体的发票数据，包含以下所有字段。为发票主表字段。
销售方识别号	xfsbh	string	可选
开票月份	kpyf	integer	可选	格式：YYYYMM
购买方名称	gfmc	string	可选
购买方银行账号	gmfyhzh	string	可选
销售方地址电话	xsfdzdh	string	可选
税额	se	number	可选	金额，最大长度13+2
税控码/密码区	skm	string	可选
开票日期	kprq	string	可选	格式：YYYY-MM-DD HH:MM:SS
备注	bz	string	可选
明细条数	mxts	integer	可选
开具类型标识	kjlx	string	可选
收款人	skr	string	可选
发票状态代码	fpztDm	string	可选	见附录A.4
购买方识别号	gfsbh	string	可选
发票代码	fpdm	string	可选
开票人	kpr	string	可选
复核人	fhr	string	可选
购买方地址电话	gmfdzdh	string	可选
销售方银行账号	xsfyhzh	string	可选
价税合计	jshj	integer	可选	金额，最大长度13+2
金额	je	number	可选	金额，最大长度13+2
销售方名称	xfmc	string	可选
税率	slv	number	可选	数字格式，最大为1最小为0 例如：13%税率，传值为0.13
特殊票种代码	tspzDm	string	可选	有效值： 02：农产品收购发票 08：成品油发票
货物信息列表	hwxx	array [object {10}]	可选	hwxx包含规格型号hwxx至零税率标识lslbs共10个字段。为发票明细字段。
规格型号	ggxh	string	可选
计量单位	jldw	string	可选
单价	dj	string	可选	金额，最大长度13+15
税额	se	number	可选	金额，最大长度13+2
货物劳务名称	mc	string	可选
数量	sl	string	可选
金额	je	number	可选	金额，最大长度13+2
税率	slv	number	可选	数字格式，最大为1最小为0 例如：13%税率，传值为0.13
税局编码/税收分类编码	spbm	string	可选
零税率标识	lslbs	string	可选	有效值：说明0：出口零税 1：免税 2：不征税 3：普通零税率为空:非零税率
发票号码	fphm	string	可选
校验码	jym	string	可选

请求报文范例

{

"appId": "ztefssc",

"format": "json",

"sign": "xHoDHfBC1OOeJP41jR0ZANJutwk=",

"version": "V2.0",

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

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

"data": {

"nsrsbh": "xxx",

"kpyf": 202011,

"jxxbz": "jx",

"fplx": "01",

"page": {

"pageSize": 20,

"currentPage": 1

}

}

}

响应报文范例

增值税专用发票、增值税普通发票、增值税普通发票（电子）、增值税普通发票（卷票）返回示例及字段说明

当发票为农产品收购发票时，由于是企业自己开具的发票，所以在销项发票里

{

"result": {

"success": true,

"req_id": "6dd110823a33447b9944a8bd23b1cb17",

"timestamp": 1606786781629,

"time": 214

},

"value": {

"page": { -- 分页信息，当分页信息参数没有传时不返回

"pageSize": 20,

"currentPage": 1,

"totalPage": 1, -- 总页数

"totalCount": 18 -- 总记录数

},

"list": [{ -- 发票信息列表

"fpdm": "4400202130", -- 发票代码

"fphm": "42657366", -- 发票号码

"kprq": "2020-10-09 14:58:24", -- 开票日期

"jym": "15092472377816055866", -- 校验码

"xfsbh": "91441900663373086B", -- 销售方识别号

"xfmc": "东莞市XX仪器有限公司", -- 销售方名称

"xsfdzdh": "东莞市常平镇居民社区西兴三街68号C栋1、2楼0769-81691361", -- 销售方地址电话

"xsfyhzh": "东莞农村商业银行股份有限公司常平支行", -- 销售方银行账号

"gfsbh": "914413007946752601", -- 购买方识别号

"gfmc": "XX(惠州)有限公司", -- 购买方名称

"gmfdzdh": "惠州市博罗县罗阳镇", -- 购买方地址电话

"gmfyhzh": "中国工商银行博罗县支行", -- 购买方银行账号

"skm": "", -- 税控码/密码区

"je": 792.92, -- 金额

"se": 103.08, -- 税额

"jshj": 896.0, -- 价税合计

"bz": "", -- 备注

"kpr": "曾晚霞", -- 开票人

"skr": "曾利娟", -- 收款人

"fhr": "缪钰如", -- 复核人

"tspzDm": "", -- 特殊票种代码，02农产品收购发票 08成品油发票

"fpztDm": "0", -- 发票状态代码

"hwxx": [{ -- 货物信息列表

"mxxh": 1, -- 明细序号

"spbm": "1099900000000000000", -- 税局编码/税收分类编码

"mc": "*其他机械设备*触控式拉力试验机（步进电机）", -- 货物劳务名称

"ggxh": "", -- 规格型号

"sl": "1", -- 数量

"jldw": "台", -- 计量单位

"dj": "792.920353982300885", -- 单价

"slv": 0.13, -- 税率

"se": 103.08, -- 税额

"je": 792.92, -- 金额

"qdbz": "00", -- 清单标识

"hsdj":"1.23", ---含税单价(卷票的字段)

"hsje":"30.35", ----含税金额(卷票的字段

"lslbs": ""--- 空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率

}],

"xhqdBz": "N", -- 销货清单标识

"kjlx": "1",

"kpjh": "499911561971",

"tslsh": "4400202010091500214345202117", -- 推送流水号

"kpyf": 202010, -- 开票月份

"xfDsswjgDm": "144190000", -- 销方地市税务机关代码

"xfQxswjgDm": "144192100", -- 销方区县税务机关代码

"xfSjswjgDm": "144000000" -- 销方省级税务机关代码

}]

}

}

机动车销售统一发票返回示例及字段说明

{

"result": {

"success": true,

"req_id": "3680cf18c4944ab5a44ae5aece463dcf",

"timestamp": 1606795011477,

"time": 289

},

"value": {

"page": { -- 分页信息，当分页信息参数没有传时不返回

"pageSize": 20,

"currentPage": 1,

"totalPage": 1, -- 总页数

"totalCount": 18 -- 总记录数

},

"list": [{ -- 发票信息列表

"fpdm": "144001924160", -- 发票代码

"fphm": "00168986", -- 发票号码

"kprq": "2019-06-21 00:00:00", -- 开票日期

"skm": "037>935<74646<43+/*+41+913-267-25**0<71493+0>+6-0>3<-0+/38>10/6-4**28<6<-19812<1/9*11/<+3/<1>62+/4194*9345284</5/+<>122/>95693<-7+*870->126<8*-41>932+//264524/>2+8+0-987<->/990710150810449/2", -- 税控码

"gfmc": "广州XX设备有限公司", -- 购买方名称

"sfzhm": "", -- 身份证号码/组织机构代码

"gfsbh": "9144010106867524XK", -- 购买方识别号

"spbm": "1090305010100000000", -- 商品编码

"cllx": "多用途乘用车", -- 车辆类型

"cpxh": "雪佛兰牌/CHEVROLETSGM6479DAA1", -- 厂牌型号

"cd": "武汉", -- 产地

"hgzh": "WAE202190683558", -- 合格证号

"jkzmsh": "", -- 进口证明书号

"sjdh": "", -- 商检单号

"fdjhm": "190773178", -- 发动机号码

"cjhm": "LSGXC8350KV302216", -- 车架号码/车辆识别代码

"jshj": 149900.0, -- 价税合计

"xhdwmc": "广州XX服务有限公司", -- 销货单位名称

"dh": "020-22222222", -- 电话

"xhdwsbh": "91440101769504224R", -- 销货单位纳税人识别号

"zh": "630139577", -- 账号

"dz": "广州市黄埔区南云五路8号L栋301", -- 地址

"khyh": "", -- 开户银行

"slv": 0.13, -- 增值税税率或征收率

"zzsse": 17245.13, -- 增值税税额

"je": 132654.87, -- 不含税价

"dw": "", -- 吨位

"xcrs": "5", -- 限乘人数

"kpr": "管理员", -- 开票人

"fpztDm": "2", -- 发票状态代码

"tslsh": "14400000003201906222413",-- 推送流水号

"kpyf": 201906

}]

}

}

通行费发票返回示例及字段说明

{

"result": {

"success": true,

"req_id": "b8186ea06adb418ab81d8fecf65a91db",

"timestamp": 1606792656796,

"time": 225

},

"value": {

"page": { -- 分页信息，当分页信息参数没有传时不返回

"pageSize": 20,

"currentPage": 1,

"totalPage": 1, -- 总页数

"totalCount": 18 -- 总记录数

},

"list": [{ -- 发票信息列表

"fpdm": "032001700212", -- 发票代码

"fphm": "40055988", -- 发票号码

"kprq": "2020-07-29 00:00:00", -- 开票日期

"jym": "10614167016792203232", -- 校验码

"xfsbh": "91320000134767063W", -- 销售方识别号

"xfmc": "江苏XX有限公司", -- 销售方名称

"xsfdzdh": "江苏省南京市玄武区", -- 销售方地址电话

"xsfyhzh": "工商银行南京城南支行", -- 销售方银行账号

"gfsbh": "91320115302341302G", -- 购买方识别号

"gfmc": "南京XX有限公司", -- 购买方名称

"gmfdzdh": "南京市江宁区科技园", -- 购买方地址电话

"gmfyhzh": "南京银行江宁支", -- 购买方银行账号

"skm": "03*705018714/9+99481>*-44></5453/+-3/27*3<20/>4+735455/+1/4647<<225*61-15-89-92172+-*50881/0<401340-19*<*//37488", -- 税控码/密码区

"je": 18.15, -- 金额

"se": 0.54, -- 税额

"jshj": 18.69, -- 价税合计

"bz": "汇总开具", -- 备注

"kpr": "陈佩", -- 开票人

"skr": "王皎", -- 收款人

"fhr": "李剑羽", -- 复核人

"fpztDm": "0", -- 发票状态代码

"hwxx": [{ -- 货物信息列表

"spbm": "3040502020301000000", -- 税局编码/税收分类编码

"mc": "*经营租赁*通行费", -- 货物劳务名称

"ggxh": "苏A3HE63", -- 车牌号

"sl": "20200724", -- 运行日期起

"jldw": "客车", -- 类型

"dj": "20200724", -- 运行日期止

"je": 18.15, -- 金额

"slv": 0.03, -- 税率

"se": 0.54, -- 税额

"txrqz":"20200724",-- (通行费发票)运行日期止

"txrqq":"20200724" -- (通行费发票)运行日期起

}],

"sbbh": "499098892654",

"kpyf": 202007

}]

}

}

二手车统一销售发票返回示例及字段说明

{

"result": {

"success": true,

"req_id": "267971738ea0465893e2242692d31723",

"timestamp": 1606803461005,

"time": 188

},

"value": {

"page": { -- 分页信息，当分页信息参数没有传时不返回

"pageSize": 20,

"currentPage": 1,

"totalPage": 1, -- 总页数

"totalCount": 18 -- 总记录数

},

"list": [{ -- 发票信息列表

"kpyf": 202104, --开票月份

"jyPmSbh": "", --经营拍卖单位纳税人识别号

"cjhj": 28000.0, --车价合计

"zrdclglsMc": "成都市", --转入地车辆管理所名称

"jyPmMc": "", --经营、拍卖单位名称

"jyPmDz": "", --经营、拍卖单位地址

"kprq": "2021-04-22 00:00:00", --开票日期

"clsbdm": "LFPH4ACC7B1A23794", --车架号/车辆识别代码

"escSbh": "成都高新区新盛路28号", --二手车市场识别号

"bz": "", --备注

"djzh": "510011290965", --登记证号

"cllx": "小型轿车", --车辆类型

"xfMc": "周吉方", --卖方单位/个人名称

"xfDz": "成都市成华区玉双路8号7栋1单元2楼3号", --卖方单位/个人地址

"escDh": "02885756138", --二手车市场电话

"fpztDm": "0", --（电子底账用）发票状态代码：发票状态代码 0正常 2作废 3已红冲

"jyPmDh": "", --经营、拍卖单位电话

"fpdm": "051002000117", --发票代码

"gfMc": "四川安居兴业置业有限公司", --买方单位/个人名称

"gfDz": "成都市成华区羊子山路68号4栋2单元20层21号", --买方单位/个人地址

"xfDh": "0", --卖方单位/个人电话

"kpr": "何奕昕", --开票人

"escMc": "成都嘉喻田园二手车交易市场管理有限公司", --二手车市场名称

"escDz": "91510100MA6DFJQC7Q", --二手车市场地址

"xfDm": "513822198303044184", --卖方单位/个人代码

"gfDh": "0", --买方单位/个人电话

"cpxh": "红旗牌CA7204MT4", --厂牌型号

"cpzh": "", --车牌照号

"jyPmYhzh": "", --经营、拍卖单位开户银行账号

"gfDm": "915101083320084471", --买方单位/个人代码

"escYhzh": "中国建设银行股份有限公司双流航空港分理处51050110203400000206",--二手车市场开户行账号

"fphm": "00980026" --发票号码

}]

}

}

海关缴款书返回示例及字段说明

{

"result": {

"success": true,

"req_id": "7f142148cd1b492c9f4e48608ca6ee99",

"timestamp": 1606794234986,

"time": 164

},

"value": {

"page": { -- 分页信息，当分页信息参数没有传时不返回

"pageSize": 20,

"currentPage": 1,

"totalPage": 1, -- 总页数

"totalCount": 18 -- 总记录数

},

"list": [{ -- 发票信息列表

"jkshm": "222520201000199034-L02", -- 缴款书号码

"tfrq": "2020-08-10 00:00:00", -- 填发日期

"jkdw1nsrsbh": "913101073242855915", -- 缴款单位一税号

"jkdw1mc": "上海XX有限公司", -- 缴款单位一名称

"jkdw2nsrsbh": "91320691MA1R8G3E40", -- 缴款单位二税号

"jkdw2mc": "XX（南通）有限公司", -- 缴款单位二名称

"jkkadm": "2225", -- 进口口岸代码

"skje": 4646.93, -- 税款金额

"hwxx": [{

"shxx": "3403990000", -- 税号信息

"hwmc": "润滑剂", -- 货物名称

"sl": "544", -- 数量

"dw": "035", -- 单位

"wsjg": 35745.62, -- 完税价格

"slv": 0.13, -- 税率

"skje": 4646.93 -- 税款金额

}],

"srjg": "中央金库", -- 收入机关

"yskmdm": "101010201", -- 预算科目代码

"skgkdm": "0900110000", -- 收款国库代码

"myfs": "0110", -- 贸易方式

"sqdwbm": "3117980008", -- 申请单位编码

"bgdbh": "222520201000199034", -- 报关单编号

"hth": "20DL004673", -- 合同（批文）号

"ysgj": "2031W", -- 运输工具（号）

"jkqx": "2020-08-25 00:00:00", -- 缴款期限

"tydh": "JJCOSSHSNC08817*07", -- 提运单号

"tfyf": 202008, -- 填发月份

}]

}

}

全电发票返回示例及字段说明

{

"result": {

"req_id": "b8f8c257344c4b1ca480a2c3743e1d46",

"success": true,

"time": 33,

"timestamp": 1654073177216

},

"value": {

"list": [

{

"xfsbh": "91310118MA1JPDDL2G", -- 销售方识别号

"kpyf": 202112, -- 开票月份

"gfmc": "xxxxx技术有限公司", -- 购买方名称

"gmfyhzh": "", -- 购买方银行账号

"xsfdzdh": "", -- 销售方地址电话

"se": 56.6, -- 税额

"skm": "", -- 税控码/密码区

"kprq": "2021-12-20 00:00:00", -- 开票日期

"bz": "", -- 备注

"mxts": 1, -- 明细条数

"kjlx": "1", -- 开具类型标识

"skr": "", -- 收款人

"fpztDm": "8", -- 发票状态代码

"gfsbh": "91310115MA1K3R189Q", -- 购买方识别号

"fpdm": "", -- 发票代码

"kpr": "祝敏", -- 开票人

"fhr": "", -- 复核人

"gmfdzdh": "", -- 购买方地址电话

"xsfyhzh": "", -- 销售方银行账号

"jshj": 1000, -- 价税合计

"je": 943.4, -- 金额

"xfmc": "xxxx（上海）信息有限公司", -- 销售方名称

"slv": 0.06, -- 税率

"tspzDm": "", -- 特殊票种代码，02农产品收购发票 08成品油发票

"hwxx": [ -- 货物信息列表

{

"ggxh": "", -- 规格型号

"jldw": "", -- 计量单位

"dj": "943.39622642", -- 单价

"se": 56.6, -- 税额

"mc": "*信息技术服务*技术服务费", -- 货物劳务名称

"sl": "1", -- 数量

"je": 943.4, -- 金额

"slv": 0.06, -- 税率

"spbm": "3040201990000000000", -- 税局编码/税收分类编码

"lslbs": "" --- 空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率

}

],

"fphm": "21311000000000000063", -- 发票号码

"jym": "" -- 校验码

}

]

}

}

//失败返回结果

{

"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	全额红冲

获取红冲，作废发票归集数据接口

获取红冲，作废发票归集数据接口

关于作者

目录