数电发票接口

1. 概述

1.1. 安全机制

安全机制：

1、公共报文通过RSA 类型验签进行验证，简要规则如下：

a. 生成秘钥为1024bit,秘钥格式为PKCS8，的秘钥对，第三方平台与 互相提供公钥为对方。

b. 按照content, format, platformCode, serialNo, signType, timestamp, version 字段名称字母升序的顺序将所有参数用&连接起来，通过公钥进行验签；

待签名串示例：

content=Base64.(3DES(content))&format=JSON&platformCode=platformCode&serialNo=DEMO201705 数电发票接口文档04145147zEm9cQ05&signType=RSA&timestamp=2017-05-04 14:51:47&version=1.0

2、业务报文通过3DES 进行加解密，加密模式为ECB，编码统一为UTF-8 密钥不在报文中体现。

JAVA 对接 提供签名、加密等工具的SDK 和接口调用Demo(Java 版)。

1.2. 调用方式

采用HTTP/HTTPS 作为通信协议，报文格式为json。

全局公共参数说明如下：

请求参数-公共部分：字段名称长度必填说明

platformCode 第三方平台编码

8 位是 分配给开发者的第三方平台编码

signType 加密类型10 位是目前支持RSA

sign 签名串256 位是商户请求参数的签名串

format 业务报文格式10 位否目前支持JSON

timestamp 请求时间19 位是yyyy-MM-dd HH:mm:ss

version 版本号4 位是调用接口版本，固定为1.0

serialNo 交易请求流水号26 位是4 位平台简称＋ 14 位日期

yyyymmddhhmmss)+8 位随机数（通过SDK 生成）

content 业务报文内容不定长是业务报文3DES 加密，除公共参数外所有请求参数都必须放在这个参数中传递

请求报文示例：

{

"platformCode": "XXXXXXXX",

"signType ": "RSA",

"sign": "XXXXXX",

"format": "JSON",

"timestamp": "2022-09-28 08:08:08",

"version": "1.0",

"serialNo": "DEMO20161212082056ADB34DF3",

"content": 业务报文3DES 加密

}

响应参数-公共部分：字段名称长度必填说明

code 响应状态4-6 位是业务返回码。

0000：成功；

9999：验签失败；

9998：平台编码无效；

8996：业务异常；

8995：数据校验不通过；

其他：见各个业务接口错误码

说明

msg 响应消息0-60 位否业务返回码描述

sign 签名串256 位是签名串

serialNo 交易请求流水号26 位是交易请求流水号

content 业务报文内容不定长是业务报文3DES 加密

响应报文示例：

{

"code": "0000",

"msg": "成功",

"sign": "XXXXXXXX",

"serialNo": "XXXXXXXX",

"content":业务报文3DES 加密

}

2. 业务接口说明

接口详见下表：

编号接口名称调用关系接口描述

2.1 主要流程说明描述说明用户登记、发票开具、发票冲红等流程

2.2 注册企业第三方平台或集团企业—— 通过该接口注册企业

2.3 用户登记第三方平台或集团企业—— 登记税局账户信息

2.4 获取登录短信验证码第三方平台或集团企业—— 通过该接口获取登录电子税局的短信验证码

2.5 短信登录第三方平台或集团企业—— 通过该接口登录电子税局

2.6 获取实名认证二维码第三方平台或集团企业—— 通过该接口获取实名认证二维码

2.7查询实名认证二维码扫码状态第三方平台或集团企业—— 通过该接口查询实名认证二维码扫码状态

2.8 查询全电账号认证状态第三方平台或集通过该接口查询全电账号的认证状态团企业——

2.9 开具数电蓝字发票第三方平台或集团企业—— 通过该接口开具数电蓝字发票

2.10 快捷冲红数电发票第三方平台或集团企业—— 通过该接口完成申请红字发票确认单并开红字发票

2.11 查询发票主要信息第三方平台或集团企业—— 查询发票主要信息，开票成功返回代码、号码等，失败返回失败原因

2.12 查询发票全票面信息第三方平台或集团企业—— 查询发票全票面信息，开票成功返回代码、号码及全票面信息，失败返回失败原因

2.13 推送发票主要信息 ——第三方平台或集团企业开票成功或失败向第三方推送发票信息

2.14 推送发票全票面信息 ——第三方平台或集团企业开票成功或失败向第三方推送发票全票面信息2.15 获取全电发票文件第三方平台或集团企业—— 通过该接口获取全电发票文件

2.16 获取开票二维码第三方平台或集团企业——通过该接口获取开票二维码，消费者扫码开票

2.17 批量作废开票二维码第三方平台或集团企业—— 通过该接口批量作废开票二维码

2.18 查询二维码开票信息第三方平台或集团企业—— 通过该接口查询二维码开票信息

2.19 重新发送邮件或短信第三方平台或集团企业—— 通过该接口重新发送发票交付邮件或短信

2.20 蓝字开票统计查询第三方平台或集团企业—— 通过该接口查询企业当月已开蓝字发票数量、金额、税额及授信额度

2.21发票领用及开票数据统计查询第三方平台或集团企业—— 通过该接口查询发票领用及开票数据统计

2.22 发票数据获取第三方平台或集团企业—— 通过该接口从局端获取发票信息

2.23开具不动产租赁蓝字全电发票第三方平台或集团企业—— 通过该接口开具不动产租赁蓝字全电发票

2.24开具旅客运输服务蓝字全电发票第三方平台或集团企业——通过该接口开具旅客运输服务蓝字全电发票

2.25开具货物运输服务蓝字全电发票第三方平台或集团企业—— 通过该接口开具货物运输服务蓝字全电发票

2.26开具建筑服务蓝字全电发票第三方平台或集团企业——通过该接口开具建筑服务蓝字全电发票

2.27开具不动产销售蓝字全电发票第三方平台或集团企业—— 通过该接口开具不动产销售蓝字全电发票

2.28 红字发票确认单申请第三方平台或集团企业—— 申请红字发票确认单，对发票进行冲红前需要先申请确认单

2.29 查看红字发票确认单第三方平台或集团企业—— 通过该接口查询某个红字发票确认单详情

2.30 开具全电红字发票第三方平台或集团企业—— 开具全电红字发票

2.31 红字发票确认单审核第三方平台或集团企业—— 审核或拒绝红字发票确认单

2.32 红字发票确认单撤销第三方平台或集团企业—— 撤销红字发票确认单

2.33红字发票确认单查询（下载）第三方平台或集团企业—— 从局端查询红字发票确认单

2.34获取红字发票确认单查询（下载）结果第三方平台或集团企业—— 通过改接口查询红字确认单查询结果__