《【精编推荐】江苏国税网络开票机接口规范》由会员分享，可在线阅读，更多相关《【精编推荐】江苏国税网络开票机接口规范（61页珍藏版）》请在金锄头文库上搜索。
1、【精编推荐】江苏国税网络开票机接口规范网络开票机接口设计江苏爱信诺航天信息科技有限公司历史版本版本日期作者修改内容批准人1.02010-07李方平初始化版本PM1.12012-03张世科接口eInfo增加减免信息增加接口更新减免品目Request报文增加isZip1.22012-3-9张世科支持税控机升级接口eInfo增加减免信息限开标志1.32012-3-21张世科接口eInfo返回数据增加时间，格式：yyyy-MM-ddhh:mm:ss，用于授时2.02012-10-21马晓龙更新支持票种，增加接口2.12012-12-04马晓龙增加作废接口2.22012-12-17马晓龙下载发票明细接口
2、名修改为fpPmnr2.32012-12-24马晓龙修改上传发票加密需求2.42013-01-04马晓龙1.增加分机接口2.实现密码加密3.修改购票请求接口2.52013-1-16马晓龙增加zipMode结点，支持处理GZIP2.62013-3-13张伟3.2.2lgrq改成gpts3.8.2发送报文改动2.72013-4-1张伟章节3.4.2和章节4.8.3的XML中增加s_fp_dm（源发票代码）s_fpqh（源发票号码）2.82013-4-2马晓龙完善3.6升级接口2.92013-4-11马晓龙章节3.4.2和4.8.3中增加userId2.102013-4-16马晓龙增加3.12，修改
3、3.62.112013-4-25张伟增加3.13修改密码2.122013-6-5张伟3.2.3返回报文中增加mbfs（每本份数）字段2.132013-11-5张伟3.4上传发票请求接口中需要上传客户端的版本号2.142013-11-7张伟报文头中增加securitysecurityModeinterfaceVersion节点目录1.开通流程62.交互说明72.1交互方式72.2交互URL72.3交互基本结构72.3.1提交报文73.报文说明93.1企业基本信息请求93.1.1功能描述93.1.2提交报文93.1.3返回报文93.2购票请求113.2.1功能描述113.2.2提交报文113.2.
4、3返回报文113.3验证码请求133.3.1功能描述133.3.2提交报文133.3.3返回报文143.4上传发票请求143.4.1功能描述143.4.2提交报文143.4.3返回报文303.5更新减免品目303.5.1功能描述303.5.2提交报文303.5.3返回报文313.6网络开票机升级313.6.1功能描述313.6.2提交报文313.6.3返回报文313.7网络授时323.7.1功能描述323.7.2提交报文323.7.3返回报文323.8发票下载323.8.1功能描述323.8.2提交报文323.8.3返回报文333.9作废发票353.9.1功能描述353.9.2提交报文353.
5、9.3返回报文353.10发票分发353.10.1功能描述353.10.2提交报文353.10.3返回报文383.11分机退票383.11.1功能描述383.11.2提交报文383.11.3返回报文393.12下载文件393.12.1功能描述393.12.2提交报文393.12.3返回报文393.13修改密码403.13.1功能描述403.13.2提交报文403.13.3返回报文404.附录403.14江苏国税卷式票目录403.15江苏国税平推式发票目录403.16实例423.16.1购票请求433.16.2上传发票请求435.其他451. 开通流程开通暂定由手工开通。税控机厂商提供需开通的税
6、控机名单(格式下文中描述)，由我方开通后返回开通成功的税控机名单(含许可码)给税控机厂商。开通简要流程：税控机厂商提供如下格式的文本文件：机器码,用户ID（用户ID格式为税号+“_*”,*为两位分机号，取值01-99，如无分机，此处与税号一致）如：0712098123456780,3201010000000010712098123456790,320101000000001_01返回许可码如下：许可码：b7876850b8331a3初始密码：机器码后6位。2. 交互说明122.1 交互方式终端访问CICSweb服务器（目前各地级市分别部署）的一个URL，通过HTTP协议连接，均采用POST方法
7、，采用XML格式进行数据封装，提交一个XML，返回一个XML，HTTP协议版本1.1以上。2.2 交互URLCICSURL格式：http:/cicsserver:port/uamsService.htm测试示例：http:/222.190.120.106:7002/uamsService.htm,此处随地级市变动而变动。升级URL:http:/222.190.120.106:7001/service.htm，仅升级使用，此处唯一。2.3 交互基本结构2.3.1 提交报文请求类型eInfo|fsInfo|upload机器码用户ID（新增）纳税人识别号许可码登录密码（密码安全见下文）厂商代码06产
8、品代码060-不压缩，默认1压缩ZIP或GZIP(如无结点或结点为空，默认为ZIP)密文加密模式（规则见下文）接口报文版本号，当前版本号为1.01.请求类型：type=如下表所示序号请求类型说明备注1eInfo获取企业信息2fsInfo获取购票信息3verifyUser上传验证请求上传发票前4upload上传发票5updateJmpm更新减免品目6updateSkj升级税控机注意服务器地址是升级URL7syncTime时间同步8fpPmnr下载发票9fpCancel作废发票10dispense发票分发11withdrawal分机退票12downloadFile下载文件13password修改密
9、码2.password采用密文方式传输，加密规则：password+“JSAISINO”,使用MD5加密（16位），编码为GBK。输入：admin密码JSAISINO输出：7044199e707bd3623.interfaceVersion报文版本号，目前版本是1.03.securityMode规则暂时只支持MD5（16位）方式加密填写1或留空则为MD5（16位）加密，编码GBK4.security存放密文例如，加密串：2013110711，MD5加密后：7e7e051d1c357eb17e7e051d1c357eb1返回报文服务端根据相应请求返回相关细细，返回的xml会写入如下结构CDATA
10、中，并把如下整个xml返回。请求类型若STATUS为FATAL时在此处写入失败原因3. 报文说明33.1 企业基本信息请求3.1.1 功能描述根据纳税人识别号返回企业基本信息。3.1.2 提交报文发送时遵从2.3.1的结构请求类型(type)为eInfo,依次写入相关参数(param)。3.1.3 返回报文纳税人识别号纳税人名称纳税人税务机关代码开户银行银行账号生产经营地址电话号码离线时间单位为天，例：2征前减免方式减免数减免原因代码限开标志征前减免方式减免数减免原因代码限开标志时间，格式：yyyy-MM-ddhh:mm:ss只支持单户企业下载说明：jmXx减免信息，没有减免就没有该节点，将来
11、有多个减免种类时，可能多节点,有该节点时可以调用updateJmpm接口，下载减免品目。zqjmfsDm征前减免方式:01按幅度减免,02按额度减免,03优惠税率。jms减免数，zqjmfsDm=01时，jms为减免百分比,0.3就是减免30%，1就是全免。jmyyDm减免原因代码，如：A_2011_137，财税2011137号免征蔬菜。xkbz限开标志1限制只能开指定品目，0不限开。3.2 购票请求3.2.1 功能描述根据参数获取企业购票信息。3.2.2 提交报文发送购票请求根据2.3.1中定义，type为fsInfo，依次写入相关信息。购票天数（数字，例如：90）3.2.3 返回报文发票代码发票号码起当前号码/d
