国税网络开票机接口规范标准.docx
《国税网络开票机接口规范标准.docx》由会员分享，可在线阅读，更多相关《国税网络开票机接口规范标准.docx（52页珍藏版）》请在冰点文库上搜索。
国税网络开票机接口规范标准
网络开票机接口设计
爱信诺航天信息科技
历史版本
版本
日期
作者
修改容
批准人
1.0
2010-07
方平
初始化版本
PM
1.1
2012-03
世科
接口eInfo增加减免信息
增加接口更新减免品目
Request报文增加isZip
1.2
2012-3-9
世科
支持税控机升级
接口eInfo增加减免信息限开标志
1.3
2012-3-21
世科
接口eInfo返回数据增加时间，格式：
yyyy-MM-ddhh:
mm:
ss，用于授时
2.0
2012-10-21
马晓龙
更新支持票种，增加接口
2.1
2012-12-04
马晓龙
增加作废接口
2.2
2012-12-17
马晓龙
下载发票明细接口名修改为fpPmnr
2.3
2012-12-24
马晓龙
修改上传发票加密需求
2.4
2013-01-04
马晓龙
1.增加分机接口
2.实现密码加密
3.修改购票请求接口
2.5
2013-1-16
马晓龙
增加zipMode结点，支持处理GZIP
2.6
2013-3-13
伟
3.2.2lgrq改成gpts
3.8.2发送报文改动
2.7
2013-4-1
伟
章节3.4.2和章节4.8.3的XML中增加
s_fp_dm（源发票代码）
s_fpqh（源发票）
2.8
2013-4-2
马晓龙
完善3.6升级接口
2.9
2013-4-11
马晓龙
章节3.4.2和4.8.3中增加userId
2.10
2013-4-16
马晓龙
增加3.12，修改3.6
2.11
2013-4-25
伟
增加3.13修改密码
2.12
2013-6-5
伟
3.2.3返回报文中增加mbfs（每本份数）字段
2.13
2013-11-5
伟
3.4上传发票请求接口中需要上传客户端的版本号
2.14
2013-11-7
伟
报文头中增加security\securityMode\interfaceVersion节点
1.开通流程6
2.交互说明7
2.1交互方式7
2.2交互URL7
2.3交互基本结构7
2.3.1提交报文7
3.报文说明9
3.1企业基本信息请求9
3.1.1功能描述9
3.1.2提交报文9
3.1.3返回报文9
3.2购票请求11
3.2.1功能描述11
3.2.2提交报文11
3.2.3返回报文11
3.3验证码请求13
3.3.1功能描述13
3.3.2提交报文13
3.3.3返回报文14
3.4上传发票请求14
3.4.1功能描述14
3.4.2提交报文14
3.4.3返回报文30
3.5更新减免品目30
3.5.1功能描述30
3.5.2提交报文30
3.5.3返回报文31
3.6网络开票机升级31
3.6.1功能描述31
3.6.2提交报文31
3.6.3返回报文31
3.7网络授时32
3.7.1功能描述32
3.7.2提交报文32
3.7.3返回报文32
3.8发票下载32
3.8.1功能描述32
3.8.2提交报文32
3.8.3返回报文33
3.9作废发票35
3.9.1功能描述35
3.9.2提交报文35
3.9.3返回报文35
3.10发票分发35
3.10.1功能描述35
3.10.2提交报文35
3.10.3返回报文38
3.11分机退票38
3.11.1功能描述38
3.11.2提交报文38
3.11.3返回报文39
3.12下载文件39
3.12.1功能描述39
3.12.2提交报文39
3.12.3返回报文39
3.13修改密码40
3.13.1功能描述40
3.13.2提交报文40
3.13.3返回报文40
4.附录40
3.14国税卷式票目录40
3.15国税平推式发票目录40
3.16实例42
3.16.1购票请求43
3.16.2上传发票请求43
5.其他45
1.开通流程
开通暂定由手工开通。
税控机厂商提供需开通的税控机（格式下文中描述），由我方开通后返回开通成功的税控机（含许可码）给税控机厂商。
开通简要流程：
税控机厂商提供如下格式的文本文件：
机器码,用户ID
（用户ID格式为税号+“_**”,**为两位分机号，取值01--99，如无分机，此处与税号一致）
如：
56780,0001
56790,0001_01
返回许可码如下：
许可码：
b7876850b8331a3
初始密码：
机器码后6位。
2.交互说明
1
2
2.1交互方式
终端访问CICSweb服务器（目前各地级市分别部署）的一个URL，通过HTTP协议连接，均采用POST方法，采用XML格式进行数据封装，提交一个XML，返回一个XML，HTTP协议版本1.1以上。
2.2交互URL
CICSURL格式：
｛cicsserver｝{:
port}/uamsService.htm
测试示例：
222.190.120.106:
7002/uamsService.htm,此处随地级市变动而变动。
升级URL:
222.190.120.106:
7001/service.htm，仅升级使用，此处唯一。
2.3交互基本结构
2.3.1提交报文
xmlversion="1.0"encoding="GBK"?
>
请求类型eInfo|fsInfo|upload
机器码
用户ID（新增）
纳税人识别号
许可码
登录密码（密码安全见下文）
厂商代码06
产品代码06
0-不压缩，默认1压缩
ZIP或GZIP（如无结点或结点为空，默认为ZIP）
密文
加密模式（规则见下文）
接口报文版本号，当前版本号为1.0
[CDATA[……]]>
1.请求类型：
type=[如下表所示]
序号
请求类型
说明
备注
1
eInfo
获取企业信息
2
fsInfo
获取购票信息
3
verifyUser
上传验证请求
上传发票前
4
upload
上传发票
5
updateJmpm
更新减免品目
6
updateSkj
升级税控机
注意服务器地址是升级URL
7
syncTime
时间同步
8
fpPmnr
下载发票
9
fpCancel
作废发票
10
dispense
发票分发
11
withdrawal
分机退票
12
downloadFile
下载文件
13
password
修改密码
2.password采用密文方式传输，
加密规则：
password+“JSAISINO”,使用MD5加密（16位），编码为GBK。
输入：
admin密码JSAISINO
输出：
7044199e707bd362
3.interfaceVersion
报文版本号，目前版本是1.0
3.securityMode规则
暂时只支持MD5（16位）方式加密
填写1或留空则为MD5（16位）加密，编码GBK
4.security
存放密文
例如，加密串：
2013110711，MD5加密后：
7e7e051d1c357eb1
7e7e051d1c357eb1
返回报文
服务端根据相应请求返回相关细细，返回的xml会写入如下结构CDATA中，并把如下整个xml返回。
xmlversion="1.0"encoding="GBK"?
>
请求类型
若STATUS为FATAL时在此处写入失败原因
[CDATA[]]>
3.报文说明
3
3.1企业基本信息请求
3.1.1功能描述
根据纳税人识别号返回企业基本信息。
3.1.2提交报文
发送时遵从2.3.1的结构请求类型（type）为eInfo,依次写入相关参数（param）。
3.1.3返回报文
xmlversion="1.0"encoding="GBK"?
>
纳税人识别号
纳税人名称
纳税人税务机关代码
开户银行
银行账号
生产经营地址
离线时间单位为天，例：
2
征前减免方式
减免数
减免原因代码
限开标志
征前减免方式
减免数
减免原因代码
限开标志
时间，格式：
yyyy-MM-ddhh:
mm:
ss
……
只支持单户企业下载
说明：
jmXx减免信息，没有减免就没有该节点，将来有多个减免种类时，可能多节点,有该节点时可以调用updateJmpm接口，下载减免品目。
zqjmfsDm征前减免方式:
01按幅度减免,02按额度减免,03优惠税率。
jms减免数，zqjmfsDm=01时，jms为减免百分比,0.3就是减免30%，1就是全免。
jmyyDm减免原因代码，如：
A_2011_137，财税[2011]137号免征蔬菜。
xkbz限开标志1限制只能开指定品目，0不限开。
3.2购票请求
3.2.1功能描述
根据参数获取企业购票信息。
3.2.2提交报文
发送购票请求根据2.3.1中定义，type为fsInfo，依次写入相关信息。
购票天数（数字，例如：
90）
3.2.3返回报文
xmlversion="1.0"encoding="GBK"?
>
发票代码
发票起
当前
发票止
用户ID
发票种类代码
发票名称
领购日期
领购ID
开票限额
间隔时间
每本份数
多条购票记录…
实例：
xmlversion="1.0"encoding="GBK"?
>
0
00698001
00698031
00702000
32060207WT06030
28053
通用机打平推式发票
2012-11-19
32060207WT06030_0_00698001
2
200
税控机开发商在开发时应注意一下几点：
1）该购票信息为实时购票信息，剔除了验旧缴销票；
2）用户第一次使用（即请求的gpts为空值时）返回该企业三个月前到现在的所有可开票记录；
3）非第一次使用（即请求的gpts有值时）返回从最后一次购票日期开始，到当前止的所有可开票记录
4）CTAIS的EJB取票时最小时间单位只精确到月。
因此在开发过程中应注意，下载购票信息时返回的票，有可能会与税控机前几次下载的票相等或有交集，开发商在开发过程中应注意比对。
5）kpxe如为空，则不限票面金额；如有值，票面金额不得大于限额。
6）jgsj如为空，默认为2。
7）购票记录返回的是该企业所有领购的发票，机具应根据自身票种支持性过滤其他种类发票；
3.3验证码请求
3.3.1功能描述
从后台服务器获取上传所需验证码。
3.3.2提交报文
上传发票前先上传一个验证的请求，获取返回验证码
xmlversion="1.0"encoding="GBK"?
>
verifyUser
机器码
纳税人识别号
登录密码
许可码
厂商代码06
产品代码06
[CDATA[……]]>
3.3.3返回报文
验证返回，如验证成功会在CDATA中返回一个验证码。
xmlversion="1.0"encoding="GBK"?
>
请求类型
若STATUS为FATAL时在此处写入失败原因
[CDATA[验证码]]>
3.4上传发票请求
3.4.1功能描述
将企业开具发票上传至后台服务器。
注：
801~804为限额票，金额不能大于10000元。
805~808不限额，但税局也可以对个别企业开票金额进行限制。
在购票请求中可以取到限额。
3.4.2提交报文
上传处理
为确保开票信息传输的效率与安全性，税控机开发商需把XML文件先压缩再加密，再采用Base64编码后放入CDATA中上传。
打包只针对上传发票请求，其他请求与返回不采用此方式。
之所以先压缩再加密，是因为直接对发票容XML压缩效率高。
采用标准ZIP算法压缩
采用对称加密DES算法
密钥：
NjtwxXmJ
密钥编码：
UTF8
由于DES算法采用的是64位加密方法，所以有8字节补齐的事项。
加密前：
数据字节长度对8取余，余数为m，若m>0,则补足8-m个字节，字节数值为8-m，即差几个字节就补几个字节，字节数值即为补充的字节数，若为0则补充8个字节的8
解密后：
取最后一个字节，值为m，则从数据尾部删除m个字节，剩余数据即为加密前的原文
比如差三个字节就要填补3个3:
XXXXX333
没有差就填补8个8:
88888888
采用BASE64编码
上传发票请求，存放在基本结构里的CDATA中，上传发票要等验证请求通过后才能上传，且上传时要把验证码加入上传xml中，存放在基本结构中作为的子节点，节点名称为code。
xmlversion="1.0"encoding="GBK"?
>
upload
机器码
纳税人识别号
登录密码（此处为新增容）
许可码
厂商代码06
产品代码06
验证码
密文
加密模式
报文版本号
[CDATA[……]]>
xmlversion="1.0"encoding="GBK"?
>
开票方纳税人识别号
客户端版本号
发票代码
发票起号
发票止号
3位发票代码，根据12位发票代码获取第8位到第10位
发票种类代码
份数
来源类型，类型为8
最大金额品名
最大金额数量
金额
日期（yyyyMMdd）
作废标志，1表示作废，0表示正常
售货方税号
售货方名称
售货方
售货方地址
售货方开户银行
售货方银行账号
购货方税号
购货方名称
购货方地址
购货方
购货方开户银行
购货方银行账号
开票人
收款人
实际开票方纳税人识别号
实际开票方名称
实际开票方税务机关代码
原发票代码（开具负数发票时需有值，正常发票留空即可）
原发票（开具负数发票时需有值，正常发票留空即可）
用户登录名（一般为税号，如果是分机用户，则为分机名称）
品名即项目
规格型号
计量单位
数量
单价
金额
多个发票明细...
多发票...
注意：
XML节点名称有大小写区分；
id.fpDm、id.fpqh由于是复合主键，注意这种点分隔的表达方式；
行政区划取意为CTAIS相关概念，尽量明细到开票方所在地区；
3位发票种类代码来自于《省国家税务局发票样本》2010年版本。
发票主体容数据类型描述：
名称
对应字段
数据类型
为主键
不能为空
发票代码
id.fpDm
varchar（12）
TRUE
TRUE
发票起号
id.fpqh
varchar（8）
TRUE
TRUE
发票止号
fpzh
varchar（8）
FALSE
FALSE
3位发票种类
fpzlDm3
varchar（3）
FALSE
TRUE
发票种类代码
fpzlDm
varchar（5）
FALSE
TRUE
份数
fs
numeric（10,0）
FALSE
TRUE
来源类型
lylx
int
FALSE
TRUE
最大金额品名
pm
varchar（128）
FALSE
FALSE
最大金额数量
sl
numeric（16,8）
FALSE
FALSE
金额
je
numeric（16,2）
FALSE
TRUE
开票日期
kprq
Datetime
FALSE
TRUE
作废标志
zfbz
Smallint
FALSE
TRUE
售货方税号
kpfNsrsbh
varchar（32）
FALSE
FALSE
售货方名称
kpfMc
varchar（128）
FALSE
FALSE
售货方
kpfLxdh
varchar（60）
FALSE
FALSE
售货方地址
kpfLxdz
varchar（200）
FALSE
FALSE
售货方开户银行
kpfKhyh
varchar（200）
FALSE
FALSE
售货方银行账号
kpfYhzh
varchar（50）
FALSE
FALSE
购货方税号
ghfNsrsbh
varchar（20）
FALSE
FALSE
购货方名称
ghfMc
varchar（128）
FALSE
FALSE
购货方地址
ghfLxdz
varchar（200）
FALSE
FALSE
购货方
ghfLxdh
varchar（60）
FALSE
FALSE
购货方开户银行
ghfKhyh
varchar（
升级会员 