国税网络开票机接口规范标准.docx

1、国税网络开票机接口规范标准网络开票机接口设计爱信诺航天信息科技历 史 版 本版本日期作者修改容批准人1.02010-07方平初始化版本PM1.12012-03世科接口eInfo增加减免信息增加接口更新减免品目Request报文增加isZip1.22012-3-9世科支持税控机升级接口eInfo增加减免信息限开标志1.32012-3-21世科接口eInfo返回数据增加时间，格式：yyyy-MM-dd hh:mm:ss，用于授时2.02012-10-21马晓龙更新支持票种，增加接口2.12012-12-04马晓龙增加作废接口2.22012-12-17马晓龙下载发票明细接口名修改为fpPmnr2.3

2、2012-12-24马晓龙修改上传发票加密需求2.42013-01-04马晓龙1.增加分机接口2.实现密码加密3.修改购票请求接口2.52013-1-16马晓龙增加zipMode结点，支持处理GZIP2.62013-3-13伟3.2.2 lgrq 改成 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.62.1120

3、13-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 交互URL 72.3 交互基本结构 72.3.1 提交报文 73. 报文说明 93.1 企业基本信息请求 93.1.1 功能描述 93.1.2 提交报文 93.1.3 返回报文 93.2 购票请求 113.2.1 功能描述 113.

4、2.2 提交报文 113.2.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 功

5、能描述 323.8.2 提交报文 323.8.3 返回报文 333.9 作废发票 353.9.1 功能描述 353.9.2 提交报文 353.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.

6、 附录 403.14 国税卷式票目录 403.15 国税平推式发票目录 403.16 实例 423.16.1 购票请求 433.16.2 上传发票请求 435. 其他 451.开通流程开通暂定由手工开通。税控机厂商提供需开通的税控机(格式下文中描述)，由我方开通后返回开通成功的税控机(含许可码)给税控机厂商。开通简要流程：税控机厂商提供如下格式的文本文件：机器码,用户ID（用户ID格式为税号+“_*”,*为两位分机号，取值01-99，如无分机，此处与税号一致）如：56780,000156790, 0001_01返回许可码如下：许可码：b7876850b8331a3初始密码：机器码后6位。2.交

7、互说明122.1交互方式终端访问CICS web服务器（目前各地级市分别部署）的一个URL，通过HTTP协议连接，均采用POST方法，采用XML格式进行数据封装，提交一个XML，返回一个XML，HTTP协议版本1.1以上。2.2交互URLCICS URL格式： cicsserver:port/uamsService.htm测试示例：222.190.120.106:7002/uamsService.htm,此处随地级市变动而变动。升级URL: 222.190.120.106:7001/service.htm ，仅升级使用，此处唯一。2.3交互基本结构2.3.1提交报文请求类型eInfo|fsIn

8、fo |upload机器码用户ID（新增）纳税人识别号许可码登录密码（密码安全见下文）厂商代码06产品代码060-不压缩，默认1压缩ZIP或 GZIP(如无结点或结点为空，默认为ZIP)密文加密模式（规则见下文）接口报文版本号，当前版本号为1.01.请求类型：type=如下表所示序号请求类型说明备注1eInfo获取企业信息2fsInfo获取购票信息3verifyUser上传验证请求上传发票前4upload上传发票5updateJmpm更新减免品目6updateSkj升级税控机注意服务器地址是升级URL7syncTime时间同步8fpPmnr下载发票9fpCancel作废发票10dispense

9、发票分发11withdrawal分机退票12downloadFile下载文件13password修改密码2.password采用密文方式传输，加密规则：password+“JSAISINO”,使用MD5加密（16位），编码为GBK。输入：admin密码JSAISINO输出：7044199e707bd3623.interfaceVersion报文版本号，目前版本是1.03. securityMode规则 暂时只支持MD5（16位）方式加密填写1或留空则为MD5（16位）加密，编码GBK 4. security 存放密文 例如，加密串：2013110711，MD5加密后：7e7e051d1c357

10、eb17e7e051d1c357eb1返回报文服务端根据相应请求返回相关细细，返回的xml会写入如下结构CDATA中，并把如下整个xml返回。请求类型若STATUS为FATAL时在此处写入失败原因3.报文说明33.1企业基本信息请求3.1.1功能描述根据纳税人识别号返回企业基本信息。3.1.2提交报文发送时遵从2.3.1的结构请求类型(type)为eInfo,依次写入相关参数(param)。3.1.3返回报文 纳税人识别号 纳税人名称 纳税人税务机关代码 开户银行银行账号生产经营地址离线时间 单位为天，例：2 征前减免方式 减免数 减免原因代码 限开标志征前减免方式减免数减免原因代码限开标志时

11、间，格式：yyyy-MM-dd hh:mm:ss只支持单户企业下载说明：jmXx 减免信息，没有减免就没有该节点，将来有多个减免种类时，可能多节点,有该节点时可以调用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提交报文发送购票请求

12、根据2.3.1中定义，type为fsInfo，依次写入相关信息。购票天数（数字，例如：90）3.2.3返回报文发票代码发票起当前发票止用户ID发票种类代码发票名称领购日期领购ID开票限额间隔时间每本份数 多条购票记录实例：000698001006980310070200032060207WT0603028053通用机打平推式发票2012-11-1932060207WT06030_0_006980012200税控机开发商在开发时应注意一下几点：1）该购票信息为实时购票信息，剔除了验旧缴销票；2) 用户第一次使用(即请求的gpts为空值时)返回该企业三个月前到现在的所有可开票记录；3) 非第一次使

13、用(即请求的gpts有值时)返回从最后一次购票日期开始，到当前止的所有可开票记录4) CTAIS的EJB取票时最小时间单位只精确到月。因此在开发过程中应注意，下载购票信息时返回的票，有可能会与税控机前几次下载的票相等或有交集，开发商在开发过程中应注意比对。5）kpxe如为空，则不限票面金额；如有值，票面金额不得大于限额。6）jgsj如为空，默认为2。7）购票记录返回的是该企业所有领购的发票，机具应根据自身票种支持性过滤其他种类发票；3.3验证码请求3.3.1功能描述从后台服务器获取上传所需验证码。3.3.2提交报文上传发票前先上传一个验证的请求，获取返回验证码verifyUser机器码纳税人识

14、别号登录密码许可码厂商代码06产品代码063.3.3返回报文验证返回，如验证成功会在CDATA中返回一个验证码。请求类型若STATUS为FATAL时在此处写入失败原因3.4上传发票请求3.4.1功能描述将企业开具发票上传至后台服务器。注：801804为限额票，金额不能大于10000元。 805808不限额，但税局也可以对个别企业开票金额进行限制。在购票请求中可以取到限额。3.4.2提交报文上传处理为确保开票信息传输的效率与安全性，税控机开发商需把XML文件先压缩再加密，再采用Base64编码后放入CDATA中上传。打包只针对上传发票请求，其他请求与返回不采用此方式。之所以先压缩再加密，是因为直

15、接对发票容XML压缩效率高。采用标准ZIP算法压缩采用对称加密DES算法密钥： NjtwxXmJ密钥编码：UTF8由于DES算法采用的是64位加密方法，所以有8字节补齐的事项。加密前：数据字节长度对8取余，余数为m，若m0,则补足8-m个字节，字节数值为8-m，即差几个字节就补几个字节，字节数值即为补充的字节数，若为0则补充8个字节的8 解密后：取最后一个字节，值为m，则从数据尾部删除m个字节，剩余数据即为加密前的原文 比如差三个字节就要填补3个3: XXXXX333 没有差就填补8个8:88888888采用BASE64编码上传发票请求，存放在基本结构里的CDATA中，上传发票要等验证请求通过

16、后才能上传，且上传时要把验证码加入上传xml中，存放在基本结构中作为的子节点，节点名称为code。 upload 机器码纳税人识别号登录密码（此处为新增容）许可码厂商代码06产品代码06验证码密文加密模式报文版本号开票方纳税人识别号客户端版本号 发票代码 发票起号发票止号 3位发票代码，根据12位发票代码获取第8位到第10位 发票种类代码 份数 来源类型，类型为8最大金额品名 最大金额数量 金额 日期（yyyyMMdd） 作废标志，1表示作废，0表示正常 售货方税号 售货方名称 售货方 售货方地址 售货方开户银行 售货方银行账号 购货方税号 购货方名称 购货方地址 购货方 购货方开户银行 购货

17、方银行账号 开票人收款人实际开票方纳税人识别号实际开票方名称实际开票方税务机关代码原发票代码（开具负数发票时需有值，正常发票留空即可）原发票（开具负数发票时需有值，正常发票留空即可）用户登录名(一般为税号，如果是分机用户，则为分机名称) 品名即项目 规格型号 计量单位 数量 单价 金额 多个发票明细. 多发票. 注意：XML节点名称有大小写区分；id.fpDm、id.fpqh由于是复合主键，注意这种点分隔的表达方式；行政区划取意为CTAIS相关概念，尽量明细到开票方所在地区；3位发票种类代码来自于省国家税务局发票样本2010年版本。发票主体容数据类型描述：名称对应字段数据类型为主键不能为空发票

18、代码id.fpDmvarchar(12)TRUETRUE发票起号id.fpqhvarchar(8)TRUETRUE发票止号fpzhvarchar(8)FALSEFALSE3位发票种类fpzlDm3varchar(3)FALSETRUE发票种类代码fpzlDmvarchar(5)FALSETRUE份数fsnumeric(10,0)FALSETRUE来源类型lylxintFALSETRUE最大金额品名pmvarchar(128)FALSEFALSE最大金额数量slnumeric(16,8)FALSEFALSE金额jenumeric(16,2)FALSETRUE开票日期kprqDatetimeFAL

19、SETRUE作废标志zfbzSmallintFALSETRUE售货方税号kpfNsrsbhvarchar(32)FALSEFALSE售货方名称kpfMcvarchar(128)FALSEFALSE售货方kpfLxdhvarchar(60)FALSEFALSE售货方地址kpfLxdzvarchar(200)FALSEFALSE售货方开户银行kpfKhyhvarchar(200)FALSEFALSE售货方银行账号kpfYhzhvarchar(50)FALSEFALSE购货方税号ghfNsrsbhvarchar(20)FALSEFALSE购货方名称ghfMcvarchar(128)FALSEFALSE购货方地址ghfLxdzvarchar(200)FALSEFALSE购货方ghfLxdhvarchar(60)FALSEFALSE购货方开户银行ghfKhyhvarchar(