江苏国税网络开票机接口规范4293.docx

《江苏国税网络开票机接口规范4293.docx》由会员分享，可在线阅读，更多相关《江苏国税网络开票机接口规范4293.docx（68页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、网络开票机接口口设计江苏爱信诺航天天信息科技有有限公司历 史 版 本本版本日期作者修改内容批准人1.02010-077李方平初始化版本PM1.12012-033张世科接口eInfoo增加减免信信息增加接口更新减减免品目Requestt报文增加iisZip1.22012-3-9张世科支持税控机升级级接口eInfoo增加减免信信息限开标志志1.32012-3-21张世科接口eInfoo返回数据增增加时间，格格式：yyyyy-MM-dd hhh:mm:sss，用于授授时2.02012-100-21马晓龙更新支持票种，增增加接口2.12012-122-04马晓龙增加作废接口2.22012-122-17

2、马晓龙下载发票明细接接口名修改为为fpPmnnr2.32012-122-24马晓龙修改上传发票加加密需求2.42013-011-04马晓龙1.增加分机接接口2.实现密码加加密3.修改购票请请求接口2.52013-1-16马晓龙增加zipMoode结点，支支持处理GZZIP2.62013-3-13张伟3.2.2 llgrq 改改成 gptts3.8.2 发发送报文改动动2.72013-4-1张伟章节3.4.22 和 章节节4.8.33 的XMLL中增加s_fp_dmm（源发票代代码）s_fpqh（源源发票号码）2.82013-4-2马晓龙完善3.6升级级接口2.92013-4-11马晓龙章节3.

3、4.22 和4.88.3中增加加userIId2.102013-4-16马晓龙增加3.12，修修改3.62.112013-4-25张伟增加3.13 修改密码2.122013-6-5张伟3.2.3 返返回报文中增增加mbfss（每本份数数）字段2.132013-111-5张伟3.4上传发票票请求接口中中需要上传客客户端的版本本号2.142013-111-7张伟报文头中增加ssecuriityseecurittyModeeinteerfaceeVersiion节点目录1.开通流程程62.交互说明明72.1交互方方式72.2交互UURL72.3交互基基本结构72.3.1提提交报文73.报文说明明93

4、.1企业基基本信息请求求93.1.1功功能描述93.1.2提提交报文93.1.3返返回报文93.2购票请求113.2.1功功能描述113.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更新减减免品目3033.5.1功能描述303.5.2提提交报文303.5.3返返回报文313.6网络开开票机升级313.6.1功功能描述313.6.2提提交报文313.6.3返返回报文313.7网络授授时323.7.1功功

5、能描述323.7.2提提交报文323.7.33返回报文323.8发票下下载323.8.1功功能描述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

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

7、0011071209881234556790, 320110100000000001_01返回许可码如下下：许可码：b788768500b83311a3初始密码：机器器码后6位。2. 交互说明122.1 交互方式终端访问CICCS weeb服务器（目目前各地级市市分别部署）的的一个URLL，通过HTTTP协议连连接，均采用用POST方方法，采用XXML格式进进行数据封装装，提交一个个XML，返返回一个XMML，HTTTP协议版本本1.1以上上。2.2 交互URLCICS URRL格式： htttp:/cicssserverr:poort/uuamsSeervicee.htm测试示例：httpp

8、:/2222.1900.120.106:77002/uuamsSeervicee.htm,此处随地级级市变动而变变动。升级URL: http:/2222.190.120.1106:70001/seervicee.htm ，仅升级使使用，此处唯唯一。2.3 交互基本结构2.3.1 提交报文请请求类型eIInfo|ffsInfoo |uplload机器码码用户IDD（新增）纳税人识识别号许可可码登录密码（密密码安全见下下文）厂厂商代码066产产品代码0660-不压缩缩，默认1压压缩ZIPP或 GZIIP(如无结结点或结点为为空，默认为为ZIP)密文加密模式（规规则见下文）接口报文版本本号，当前版版

9、本号为1.01.请求类型：type=如下表所所示序号请求类型说明备注1eInfo获取企业信息2fsInfo获取购票信息3verifyUUser上传验证请求上传发票前4upload上传发票5updateJJmpm更新减免品目6updateSSkj升级税控机注意服务器地址址是升级URRL7syncTimme时间同步8fpPmnr下载发票9fpCanceel作废发票10dispensse发票分发11withdraawal分机退票12downloaadFilee下载文件13passworrd修改密码2.passwword采用用密文方式传传输，加密规则：paassworrd+“JSAISSINO”,使用

10、MDD5加密（116位），编编码为GBKK。输入：admiin密码JSSAISINNO输出：70444199e7707bd33623.interrfaceVVersioon报文版本号，目目前版本是11.03. secuurityMMode规则则 暂时只支持持MD5（116位）方式式加密填写1或留空则则为MD5（116位）加密，编码GGBK 4. seccurityy 存放密文 例如，加密密串：20131110711，MD55加密后：7e7e0051d1cc357ebb17e7e0051d1cc357ebb1返回报文服务端根据相应应请求返回相相关细细，返返回的xmll会写入如下下结构CDAATA

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

12、MM-dd hhh:mm:sss只支持单户企业业下载说明：jmXx 减免免信息，没有有减免就没有有该节点，将将来有多个减减免种类时，可可能多节点,有该节点时时可以调用uupdateeJmpm接接口，下载减减免品目。zqjmfsDDm征前减免免方式:011按幅度减免免,02按额额度减免,003优惠税率率。jms减免数，zqjmfsDm=01 时，jms为减免百分比,0.3就是减免30%，1就是全免。jmyyDm 减免原因代代码，如：AA_20111_137，财财税201111377号免征蔬菜菜。xkbz限开标标志 1限限制只能开指指定品目，00不限开。3.2 购票请求3.2.1 功能描述根据参数

13、获取企企业购票信息息。3.2.2 提交报文发送购票请求根根据2.3.1中定义，ttype为ffsInfoo，依次写入入相关信息。购购票天数（数数字，例如：90）3.2.3 返回报文发发票代码发发票号码起当当前号码发发票号码止用户IDD发票种类类代码发票名称称领领购日期领购ID开开票限额间间隔时间每每本份数 多条购购票记录实例：13206612805530000698000100069800310007020000320660207WWT060330280053通用机机打平推式发发票22012-111-19320600207WTT060300_13200612800530_00069800012

14、22200税控机开发商在在开发时应注注意一下几点点：1）该购票信息息为实时购票票信息，剔除除了验旧缴销销票；2) 用户第一一次使用(即即请求的gppts为空值值时)返回该该企业三个月月前到现在的的所有可开票票记录；3) 非第一次次使用(即请请求的gptts有值时)返回从最后后一次购票日日期开始，到到当前止的所所有可开票记记录4) CTAIIS的EJBB取票时最小小时间单位只只精确到月。因因此在开发过过程中应注意意，下载购票票信息时返回回的票，有可可能会与税控控机前几次下下载的票相等等或有交集，开开发商在开发发过程中应注注意比对。5）kpxe如如为空，则不不限票面金额额；如有值，票票面金额不得得

15、大于限额。6）jgsj如如为空，默认认为2。7）购票记录返返回的是该企企业所有领购购的发票，机机具应根据自自身票种支持持性过滤其他他种类发票；3.3 验证码请求3.3.1 功能描述从后台服务器获获取上传所需需验证码。3.3.2 提交报文上传发票前先上上传一个验证证的请求，获获取返回验证证码vverifyyUser机器码码纳税人识识别号登录录密码许可可码厂厂商代码066产产品代码0663.3.3 返回报文验证返回，如验验证成功会在在CDATAA中返回一个个验证码。请请求类型若STATTUS为FAATAL时在在此处写入失失败原因3.4 上传发票请求3.4.1 功能描述将企业开具发票票上传至后台台服

16、务器。注：8018804为限额额票，金额不不能大于100000元。 8055808不不限额，但税税局也可以对对个别企业开开票金额进行行限制。在购购票请求中可可以取到限额额。3.4.2 提交报文上传处理为确保开票信息息传输的效率率与安全性，税税控机开发商商需把XMLL文件先压缩缩再加密，再再采用Basse64编码码后放入CDDATA中上上传。打包只只针对上传发发票请求，其其他请求与返返回不采用此此方式。之所所以先压缩再再加密，是因因为直接对发发票内容XMML压缩效率率高。采用标准ZIPP算法压缩采用对称加密DDES算法密钥： NjttwxXmJJ密钥编码：UTTF8由于DES算法法采用的是664

17、位加密方方法，所以有有8字节补齐齐的事项。加密前：数据字字节长度对88取余，余数数为m，若mm0,则补补足8-m个个字节，字节节数值为8-m，即差几几个字节就补补几个字节，字字节数值即为为补充的字节节数，若为00则补充8个个字节的8 解密后：取取最后一个字字节，值为mm，则从数据据尾部删除mm个字节，剩剩余数据即为为加密前的原原文 比如差三个个字节就要填填补3个3: XXXXXX333 没有差就填填补8个8:888888888采用BASE664编码上传发票请求，存存放在基本结结构里的CDDATA中，上上传发票要等等验证请求通通过后才能上上传，且上传传时要把验证证码加入上传传xml中，存存放在基

18、本结结构中作为的子节点点，节点名称称为codee。 uploaad 机器码码纳税人识识别号登录录密码（此处处为新增内容容）许可可码厂厂商代码066产产品代码066验验证码密文文加密模模式报文版本本号开票方纳纳税人识别号号客户端端版本号 发票票代码 发票票起号发发票止号 3位位发票代码，根根据12位发发票代码获取取第8位到第第10位 发票种种类代码 份数数 来源类型，类类型为8最大金金额品名 最大大金额数量 金额额 日期（yyyyyMMddd） 作废标志，11表示作废，00表示正常 售货方税号号 售货方名名称 售货货方电话 售货货方地址 售货货方开户银行行 售货货方银行账号号 购货方税号号 购货

19、方名名称 购货货方地址 购货货方电话 购货货方开户银行行 购货货方银行账号号 开开票人收款款人实际开票票方纳税人识识别号实际开开票方名称实实际开票方税税务机关代码码原发票代码（开开具负数发票票时需有值，正正常发票留空空即可）原发票号码（开开具负数发票票时需有值，正正常发票留空空即可）用户登录录名(一般为税税号，如果是是分机用户，则则为分机名称称) 品名即即项目 规规格型号 计计量单位 数量 单价 金额 多个发票票明细. 多张发发票. 注意：XML节点名称称有大小写区区分；id.fpDmm、id.ffpqh由于于是复合主键键，注意这种种点分隔的表表达方式；行政区划取意为为CTAISS相关概念，尽

20、尽量明细到开开票方所在地地区；3位发票种类代代码来自于江江苏省国家税税务局发票样样本20110年版本。发票主体内容数数据类型描述述：名称对应字段数据类型为主键不能为空发票代码id.fpDmmvarcharr(12)TRUETRUE发票起号id.fpqhhvarcharr(8)TRUETRUE发票止号fpzhvarcharr(8)FALSEFALSE3位发票种类fpzlDm33varcharr(3)FALSETRUE发票种类代码fpzlDmvarcharr(5)FALSETRUE份数fsnumericc(10,00)FALSETRUE来源类型lylxintFALSETRUE最大金额品名pmvar

21、charr(128)FALSEFALSE最大金额数量slnumericc(16,88)FALSEFALSE金额jenumericc(16,22)FALSETRUE开票日期kprqDatetimmeFALSETRUE作废标志zfbzSmallinntFALSETRUE售货方税号kpfNsrssbhvarcharr(32)FALSEFALSE售货方名称kpfMcvarcharr(128)FALSEFALSE售货方电话kpfLxdhhvarcharr(60)FALSEFALSE售货方地址kpfLxdzzvarcharr(200)FALSEFALSE售货方开户银行行kpfKhyhhvarcharr(2

22、00)FALSEFALSE售货方银行账号号kpfYhzhhvarcharr(50)FALSEFALSE购货方税号ghfNsrssbhvarcharr(20)FALSEFALSE购货方名称ghfMcvarcharr(128)FALSEFALSE购货方地址ghfLxdzzvarcharr(200)FALSEFALSE购货方电话ghfLxdhhvarcharr(60)FALSEFALSE购货方开户银行行ghfKhyhhvarcharr(200)FALSEFALSE购货方银行账号号ghfYhzhhvarcharr(50)FALSEFALSE开票人kprvarcharr(16)FALSEFALSE收款人

23、skrvarcharr(16)FALSEFALSE实际开票方纳税税人识别号sjKpfNssrsbhvarcharr(32)FALSETRUE实际开票方名称称sjKpfMccvarcharr(128)FALSETRUE实际开票方税务务机关代码nsrSwjggDmvarcharr(11)FALSETRUE原发票代码s_fp_dmmvarcharr(12)FALSEFALSE原发票起号s_fpqhvarcharr(8)FALSEFALSE3.4.2.1 明细说明（平推推票）发票明细内容数数据结构描述述：明细主表名称对应字段数据类型为主键不能为空品名pmvarcharr(16)FALSEFALSE规格

24、型号ggvarcharr(16)FALSEFALSE计量单位jldwvarcharr(16)FALSEFALSE数量slvarcharr(16)FALSEFALSE金额jevarcharr(16)FALSEFALSE单价djvarcharr(16)FALSEFALSE以下各发票代码码中的明细都继承此此表。例如：发票代码 800111 发发票的XML内容容格式是：客户端端版本号发票代代码发票起起号发发票止号略过其他节节点 备注单价规格金额单单位品名数量.recorrd可以有多多个复核核人3.4.2.1.1 工商业（11）主表：名称说明fhr复核人明细：不同的票种不同同的行数：80111、8805

25、11：3行80211、880611：4行80311、880711：15行80411、880811：5行名称对应字段继承明细主表bz备注3.4.2.1.2 出口（12）主表：名称说明hth合同号contracctNo合同号英文myfs贸易方式trade贸易方式英文xyzh信用证号lcNo信用证号英文receivUUnit出售单位英文payUnitt购货方英文date日期英文ybh运编号issued开证银行英文qtsx其他事项csfdz出售方英文地址址ghfdz购售方英文地址址telNo电话英文wbdxje外币大写金额wbJe外币金额biZhongg币种bzMc币种名称huiLv汇率hlSz汇率数

26、值slhj数量合计明细：不同的票种不同同的行数：80312、880712：15行80812：55行名称对应字段继承明细主表bj标记3.4.2.1.3 废旧物资/粮食食等收购（441）主表：名称说明fkr付款人scr司秤人明细：不同的票种不同同的行数：80141、880541：3行80241、880641：4行80341、770741：15行80441、880841：5行名称对应字段继承明细主表sf水分dengj等级mz毛重bz备注3.4.2.1.4 废旧物资/粮食食等销售（442）主表：名称说明jsfs结算方式scr司秤人xhdd销货地点cydw承运单位明细：不同的票种不同同的行数：80141

27、、880541：3行80241、880641：5行80341、770741：15行80441、880841：5行名称对应字段继承明细主表3.4.2.1.5 水电气（51）主表：名称说明zhh总户号dhh段户号cbr抄表人jfy缴费月bz备注明细：不同的票种不同同的行数：80151、880551：3行名称对应字段继承明细主表byss本月示数syss上月示数3.4.2.1.6 其他代理服务（国国际货代船代代）（61）主表：名称说明hb航班qyd起运地mdd目的地dgrq到港日期zhg装货港xhg卸货港fz附注bz备注wbdxje外币大写金额wbJe外币金额biZhongg币种bzMc币种名称hui

28、Lv汇率hlSz汇率数值pjrX牌价日pjr牌价日rmbjeX人民币小写fhr复核人明细：不同的票种不同同的行数：80461、880861：10行名称对应字段继承明细主表tdh提单号bz备注3.4.2.1.7 其他代理服务（报报关代理）（662）主表：名称说明wtsh委托书号bz备注tgfjexjj通关费金额小计计ddfjexjj代垫费金额小计计明细：不同的票种不同同的行数：80462、880862：10行名称对应字段继承明细主表tgxm通关项目tgje通关金额ddfxm代垫项目ddfje代垫金额fz附注bz备注3.4.2.1.8 航空客运（代售售服务）（663）主表：名称说明hc航程pzhm票证号码jlbh记录编号fkfs付款方式fhr复核人明细：不同的票种不同同的行数：80163、880563：3行名称对应字段继承明细主表bz备注3.4.2.1.9 交通运输（644）主表：名称说明bz备注fhr复核人明细：不同的票种不同同的行数：80164、880564：4行80264、880664：8行80364、880764：15行80464、880864：10行名称对应字段继承明细主表kce折扣额fz附注bz备注3.4.2.1.10 其他服业（911）主表：名称说明fhr复核人bz备注明细：不同的票种不同同的行数：801191、880591：4行802191、880691