江苏国税网络开票机接口规范Word文档下载推荐.docx
《江苏国税网络开票机接口规范Word文档下载推荐.docx》由会员分享，可在线阅读，更多相关《江苏国税网络开票机接口规范Word文档下载推荐.docx（44页珍藏版）》请在冰豆网上搜索。
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.开通流程
开通暂定由手工开通。
税控机厂商提供需开通的税控机名单（格式下文中描述），由我方开通后返回开通成功的税控机名单（含许可码）给税控机厂商。
开通简要流程：
税控机厂商提供如下格式的文本文件：
机器码,用户ID
（用户ID格式为税号+“_**”,**为两位分机号，取值01--99，如无分机，此处与税号一致）
如：
0712********
0712098123456790,320101000000001_01
返回许可码如下：
许可码：
b7876850b8331a3
初始密码：
机器码后6位。
2.交互说明
1
2
2.1交互方式
终端访问CICSweb服务器（目前各地级市分别部署）的一个URL，通过HTTP协议连接，均采用POST方法，采用XML格式进行数据封装，提交一个XML，返回一个XML，HTTP协议版本1.1以上。
2.2交互URL
CICSURL格式：
http:
//｛cicsserver｝{:
port}/uamsService.htm
测试示例：
http:
//222.190.120.106:
7002/uamsService.htm,此处随地级市变动而变动。
升级URL:
7001/service.htm，仅升级使用，此处唯一。
2.3交互基本结构
2.3.1提交报文
<
?
xmlversion="
1.0"
encoding="
GBK"
?
>
request>
type>
请求类型eInfo|fsInfo|upload<
/type>
param>
id>
机器码<
/id>
userId>
用户ID（新增）<
/userId>
nsrsbh>
纳税人识别号<
/nsrsbh>
key>
许可码<
/key>
password>
登录密码（密码安全见下文）<
/password>
csDm>
厂商代码06<
/csDm>
cpDm>
产品代码06<
/cpDm>
isZip>
0-不压缩，默认1压缩<
/isZip>
zipMode>
ZIP或GZIP（如无结点或结点为空，默认为ZIP）<
/zipMode>
security>
密文<
/security>
securityMode>
加密模式（规则见下文）<
/securityMode>
interfaceVersion>
接口报文版本号，当前版本号为1.0<
/interfaceVersion>
/param>
content>
!
[CDATA[……]]>
/content>
/request>
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<
/security>
返回报文
服务端根据相应请求返回相关细细，返回的xml会写入如下结构CDATA中，并把如下整个xml返回。
RESPONSESTATUS=”SUCCESS|FATAL”>
TYPE>
请求类型<
/TYPE>
ALERT>
若STATUS为FATAL时在此处写入失败原因<
/ALERT>
CONTENT>
[CDATA[]]>
/CONTENT>
/RESPONSE>
3.报文说明
3
3.1企业基本信息请求
3.1.1功能描述
根据纳税人识别号返回企业基本信息。
3.1.2提交报文
发送时遵从2.3.1的结构请求类型（type）为eInfo,依次写入相关参数（param）。
3.1.3返回报文
business>
group>
<
nsrmc>
纳税人名称<
/nsrmc>
nsrSwjgDm>
纳税人税务机关代码<
/nsrSwjgDm>
khyh>
开户银行<
/khyh>
yhzh>
银行账号<
/yhzh>
scjydz>
生产经营地址<
/scjydz>
dhhm>
电话号码<
/dhhm>
lxsj>
离线时间单位为天，例：
2<
/lxsj>
jmXx>
zqjmfsDm>
征前减免方式<
/zqjmfsDm>
jms>
减免数<
/jms>
jmyyDm>
减免原因代码<
/jmyyDm>
xkbz>
限开标志<
/xkbz>
/jmXx>
sj>
时间，格式：
ss<
/sj>
……
/group>
只支持单户企业下载
说明：
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，依次写入相关信息。
gpts>
购票天数（数字，例如：
90）<
/gpts>
3.2.3返回报文
business>
fpDm>
发票代码<
/fpDm>
fpqh>
发票号码起<
/fpqh>
dqhm>
当前号码<
/dqhm>
fpzh>
发票号码止<
/fpzh>
userId>
用户ID<
/userId>
fpzlDm>
发票种类代码<
/fpzlDm>
fpzlMc>
发票名称<
/fpzlMc>
lgrq>
领购日期<
/lgrq>
jobId>
领购ID<
/jobId>
kjlx>
/kjlx>
kpxe>
开票限额<
/kpxe>
jgsj>
间隔时间<
/jgsj>
mbfs>
每本份数<
/mbfs>
多条购票记录…
/group>
/business>
实例：
businessJSAISINO_QR="
TRUE"
fp_dm>
132061280530<
/fp_dm>
00698001<
00698031<
00702000<
32060207WT06030<
fpzl_dm>
28053<
/fpzl_dm>
fpzl_mc>
通用机打平推式发票<
/fpzl_mc>
2012-11-19<
jxqx>
/jxqx>
32060207WT06030_132061280530_00698001<
200<
税控机开发商在开发时应注意一下几点：
1）该购票信息为实时购票信息，剔除了验旧缴销票；
2）用户第一次使用（即
升级会员 