数电发票冲红接口

 1. 快捷冲红数电发票
此接口为了简化全电冲红操作，将申请全电红字发票确认单、开具红字全电发票接口集成，
票通平台将自动申请全电红字发票确认单并开具红字全电发票。此接口只针对销方冲红发票使
用。
主要流程说明：
（1）业务方调用后，票通校验系统内是否存在该发票的红字确认单，若已存在该发票的红
字确认单（状态为无需确认或购销双方已确认），将会直接使用该红字发票确认单进行冲红；若
红字发票确认单状态为“销方录入待购方确认”，将会查询税局红字发票确认单状态，若为“购
销双方已确认”将会冲红发票。
（2）票通收到冲红请求后，如没有冲红，票通将保存红票信息，红票状态为“红字发票确
认单申请中”；
（3）接下来票通帮助企业自动申请红字发票确认单，
如返回“无需确认”将自动进行开具红票；开具成功推送结果给业务系统。
如返回“销方录入待购方确认”将会修改红票状态为“红字确认单审核中”并通过发票
开具结果推送接口推送给业务系统，业务系统也可以主动查询该红票状态，处于“红字确
认单审核中”状态时，销方需要联系购方进行确认处理，购方确认后可以再次调用该接口
票通数电发票接口文档
进行冲红，票通平台使用步骤1 进行冲红处理；处于“红字确认单审核中”状态的确认单，
票通也会使用定时任务每小时一次主动查询审核结果，审核通过票通将自动冲红，如超过
72 时，电子税务局将自动作废该确认单，等同购方审核驳回操作，票通将冲红状态置为失
败，推送结果给业务系统。
如返回其他状态，均会把红票作为失败处理，失败原因会通过推送发票或查询发票返
回给接口调用方，待失败问题解决后可以调用该接口进行冲红操作。
2.10.1. 调用说明
项目说明内容备注
调用关系第三方平台调用
调用方式https POST 方式提交
接口地址测试地址：
http://fpkj.testnw.vpiaotong.cn/tp/openapi/invoiceRed.pt
正式地址：
https://fpkj.vpiaotong.com/tp/openapi/invoiceRed.pt
字符编码UTF-8
2.10.2. 请求报文
请求参数-业务报文部分：字段名称类型必填说明
taxpayerNum 销售方纳税人识别号
String(15-20) 是销售方纳税人识别号
invoiceReqSerialNo 发票请求流水号String(20) 是红票请求流水号4 位平台简称+16 位随机数
invoiceCode 发票代码String(12) 否需冲红原发票代码，冲红增值税发票管理系统开具的发票时必填
invoiceNo 发票号码String(8) 否需冲红原发票号码，冲红增值税发票管理系统开具的发票时必填
blueAllEleInvNo 原全电发票号码String(20) 否需冲红原全电发票号码，冲红全电发票时必填
blueInvoiceDate 蓝字发票开票日期String(8) 否蓝字发票开票日期， 格式yyyyMMdd。冲红非平台开具的发票时必填，需要使用该字段及全电发票号码从税局拉数电发票接口文档取发票
redReason 冲红原因String(1-100) 是冲红原因，不传默认01
01：开票有误
02：销货退回
03：服务中止
04：销售折让
amount 价税合计金额10 位(精确到2位小数)是原发票的价税合计金额的负数值
account 电子税局登录账号
String(50) 否电子税局登录账号（手机号或身份证号），必须是通过2.1接口进行用户登记的账号。如果不填，取蓝票的开票账号，若蓝票的开票账号不再使用，取企业现有的。
invoiceKind 发票种类代码String（2） 否开具红字发票种类。
81：全电发票（增值税专用发票）
82：全电发票（普通发票）。默认蓝票的发票种类代码。此字段目的解决全电发票冲红增值税发，只有企业不再使用增值税系统时才可以跨票种冲红。
全电发票（普通发票）可以冲红全电发票（普通发票）、增值税电子普通发票、增值税纸
质普通发票。全电发票（增值税专用发票）以冲红全电发票（增值税专用发票）、增值税电子专用发票、增值税纸质专用发票。
definedData 自定义数据String(0-200) 否自定义数据，在发票推送接口中会按照定义返回，长度校验规则为字符长度
报文示例：
{
"taxpayerNum": "9120931023801231",
"invoiceReqSerialNo": "XXXX5678901234567891",
"invoiceCode": "123456789012",
"invoiceNo": "12345678",
"redReason": "01",
"amount": "-100",
"account": "zhangsan",数电发票接口文档
"definedData": "自定义数据"
}
2.10.3. 响应报文
响应参数-业务报文部分：字段名称类型必填说明
invoiceReqSerialNo 发票请求流水号
String(20) 是4 位平台简称+16 位随机数
qrCodePath 二维码url String 是不定长，Base64 字符串
qrCode 二维码图片Base64String 否扫码打开查看发票开票状态
报文示例：
{
"invoiceReqSerialNo": "XXXX5678901234567890",
"qrCodePath": "XXXXXXXXXXXXXXXXXXXXXXXX",
"qrCode": "XXXXXXXXXXXXXXXXXXXXXXXX"
}
4. 业务错误码
从业务中抽取代码并进行定义
错误码（code） 含义说明（msg）
0000 成功
9999 验签失败
9998 平台编码无效
9997 纳税人识别号无效
8996 业务异常，请联系运维
8995 数据校验不通过(对应参考详细信息)
8001 开票处理失败,开票企业不存在
8002 找不到对应的税号信息
8003 找不到对应的发票
8004 找不到对应的开票企业信息，请检查税号
6005 该蓝票已经冲红，不可冲红
3001 电子税局账号尚未在平台登记，请先在平台登记