国税网络开票机接口规范标准
国家税务总局关于发布增值税发票税控开票软件数据接口规范的公告

国家税务总局关于发布增值税发票税控开票软件数据接口规范的公告文章属性•【制定机关】国家税务总局•【公布日期】2014.03.14•【文号】国家税务总局公告2014年第17号•【施行日期】2014.03.14•【效力等级】部门规范性文件•【时效性】失效•【主题分类】税收征管正文国家税务总局关于发布增值税发票税控开票软件数据接口规范的公告(国家税务总局公告2014年第17号)为进一步减轻纳税人负担,优化纳税服务,国家税务总局决定对纳税人使用的增值税发票税控开票软件(以下简称税控开票软件)数据接口规范予以发布,以满足纳税人内部管理信息系统与税控开票软件的衔接需要。
现将有关事项公告如下:一、税控开票软件是指增值税一般纳税人安装使用的防伪税控系统防伪开票子系统和发票税控系统开票软件。
二、本次发布的数据接口规范包括导入接口规范和导出接口规范,发票类型为增值税专用发票、增值税普通发票和货物运输业增值税专用发票。
导入接口规范是指税控开票软件可接收的待开具发票信息的数据格式;导出接口规范是指从税控开票软件导出已开具发票信息的数据格式。
三、为配合数据接口规范发布,税控开票软件增加了手工导入开具、批量自动导入开具、批量数据导出等功能。
需启用这些功能的纳税人,应将增值税防伪税控系统防伪开票子系统升级为V7.23.10版,发票税控系统开票软件升级为V1.3.00版。
四、数据接口规范和税控开票软件安装包在金税工程纳税人技术服务网(http://)上发布,纳税人可自行下载免费安装使用。
在使用数据接口规范和安装税控开票软件过程中,如有问题,请联系当地税控技术服务单位提供技术支持。
五、各地税控技术服务单位不得在税控开票软件安装、升级过程中,以技术服务为由强行向纳税人搭售通用设备或软件。
纳税人如发现税控技术服务单位的上述违规行为,可通过电子邮件(邮箱:*********************.cn)向税务总局反映。
特此公告。
国家税务总局2014年3月14日。
国税普通发票网络管理系统客户端操作手册

国税普通发票网络管理系统客户端操作手册 Document number【980KGB-6898YT-769T8CB-246UT-贵州省国税普通发票网络管理系统客户端操作手册业务咨询电话:0851-12366技术支持电话:目录纳税人申请开通一、发票领购申请纳税人持税务登记证副本按规定到税务机关进行发票领购申请,购买纸质发票。
二、软件申请开通纳税人可通过网络和手机短信两种方式申请开通使用《贵州国税普通发票网络管理系统》(一)网络申请首先要保证所使用的计算机连入互联网,启动“浏览器”,在地址栏输入“或出现以下界面。
鼠标点击“申请开通”图标,出现以下界面。
分别输入纳税人识别号、手机号和验证码,点击“提交”。
申请成功,将出现如下界面保持手机畅通,税务机关将开通信息及初始密码通过短信告知申请人。
申请失败,将出现如下界面,请核实纳税人识别号输入的正确性,如有疑问,请与税务机关联系。
(二)短信申请纳税人使用手机发送短信,内容如下:“sq 纳税人识别号”例如:“sqXXXXXXXXXXXXXXX”,发送号码到“6”,税务机关收到该短信后,回复短信“您已申请国税局网络开票系统,您的密码是:XXXXX,如有疑问,请与您的主管税务官员联系!”。
系统自动接受申请,并开通软件。
注意:纳税人注意保存密码,此初始密码将在开票系统进行初始化、第一次登录开票系统及今后出现重大事件时用到。
使用的手机号码将作为税务机关与您联系的唯一号码,手机号如有变动,请及时到税务机关申请变更。
软件下载在此界面鼠标点击“软件下载”图标,出现以下界面。
单击“”,弹出界面如下:将此压缩文件保存在硬盘的相应目录下,例如保存在D盘上,并将此文件解压,如图所示:鼠标双击执行gzwlfpClient程序,得到如下图所示界面,即表示系统可以在本机执行。
如出现下图所示错误:请到国税网站下载页面下载“微软dotNET框架”程序并按提示安装,安装完成后,再次执行gzwlfpClient程序。
3.中国票据交易系统直连接口规范(纸票业务分册)

内部资料,注意保管中国票据交易系统直连接口规范【纸票业务分册】上海票据交易所2019年04月文档修订记录版本编号变化状态简要说明日期变更人批准日期批准人V1.0 A 新建2017.6.8 闻名、黄继超2017.6.8 欧韵君V2.0 M 修改2017.9.30 冯达妮2017.9.30 欧韵君V2.1 M 修改2018.4.20 冯达妮2018.4.20 欧韵君V2.2 M 修改2019.4.30 冯达妮2019.4.30 欧韵君注:变化状态:A—增加,M—修改,D—删除目录修改记录 (3)1 各业务场景报文流程 (6)1.1承兑信息登记 (6)1.2承兑保证信息登记 (7)1.3质押信息登记 (7)1.4质押解除信息登记 (8)1.5贴现信息登记 (9)1.6结清信息登记 (10)1.7止付或止付解除信息登记 (11)1.8信息登记类撤回 (12)1.9纸票登记信息查询 (12)1.10库存变更申请 (13)1.11保证增信申请 (14)1.12付款确认申请 (14)2 中国票据交易系统报文(XML格式) (16)2.1承兑信息登记申请报文(NCP001) (16)2.2承兑保证信息登记申请报文(NCP002) (19)2.3质押信息登记申请报文(NCP003) (20)2.4质押解除信息登记申请报文(NCP004) (22)2.5贴现信息登记申请报文(NCP005) (24)2.6结清信息登记申请报文(NCP006) (26)2.7止付信息登记申请报文(NCP007) (28)2.8止付解除信息登记申请报文(NCP008) (30)2.9止付及止付解除登记通知报文(NCP009) (32)2.10信息登记类撤回申请报文(NCP010) (34)2.11纸票登记信息查询申请报文(NCP011) (36)2.12纸票登记信息查询应答报文(NCP012) (37)2.13库存变更申请报文(NCP013) (39)2.14库存变更通知报文(NCP014) (40)2.15保证增信申请报文(NCP015) (41)2.16付款确认申请报文(NCP016) (43)2.17付款确认结果通知报文(NCP017) (45)修改记录序号修改日期修改说明1 2017-6-16 1、[M]-修改库存变更申请报文(NCP013)前置状态删除风险票据状态判断;2 2017-6-19 1、[M]-修改修改付款确认结果通知报文(NCP017)报文功能描述,报文结构增加应答标识;2、[M]-修改修改库存变更通知报文(NCP014)报文功能描述;3、[M]-修改修改库存变更申请报文(NCP013)报文处理规则;3 2017-6-20 1、[M]-修改修改止付信息登记申请报文(NCP007)报文处理规则中的判断逻辑;4 2017-6-21 1、[M]-修改修改止付信息登记申请报文(NCP007)状态前置风险票据状态为:非风险票据、挂失止付;2、[M]-修改修改付款确认申请报文(NCP016)报文功能描述和前置风险票据状态;5 2017-6-27 1、[M]-修改票据库存状态“已增信保管”替换为“已增信保证”;6 2017-7-17 1、[M]-修改修改质押解除信息登记申请报文(NCP004)报文结构“登记机构代码”的备注为:与质权行同一机构;2、[M]-修改纸票库存状态“保证增信退票移出”替换为“保证增信退票待签收”;3、[M]-修改修改业务场景报文流程图“库存变更申请”;4、[M]-修改修改贴现信息登记申请报文(NCP005)报文结构中贴入人信息的<XML Tag>为:<DsctInInf/>;5、[M]-修改修改止付及止付解除登记通知报文(NCP009)报文功能描述;6、[M]-修改修改付款确认结果通知报文(NCP017)报文结构中付款确认拒绝原因代码的属性;7 2017-8-14 1、[M]-修改修改质押解除信息登记申请报文(NCP004)报文处理规则描述;8 2017-8-23 1、[M]-修改修改结清信息登记申请报文(NCP006)报文处理规则描述、报文结构的“登记机构代码”的备注为与付款行同一机构,报文结构中“解付信息”<RelPayInf/>标签内再添加一个子标签“结清类型”2、[M]-修改修改止付信息登记申请报文(NCP007)报文处理规则描述、报文结构中“登记机构代码”的备注为与承兑行或承兑人开户行同一机构3、[M]-修改修改库存变更申请报文(NCP013)报文处理规则描述4、[M]-修改修改止付及止付解除登记通知报文(NCP009)报文功能描述5、[M]-修改修改库存变更通知报文(NCP014)报文功能描述6、[M]-修改修改付款确认申请报文(NCP016)报文功能描述、报文结构中影像信息集合的备注、报文说明、报文处理规则7、[M]-修改在库存变更申请流程图库存通知报文方向接收人新增质权人8、[M]-修改在付款确认申请流程图场景四,删除流程图下注“注:若上传影像批次号,需提前上传贴现影像,处理时还需对对上传的影像批次号合法性进行校验”9、[M]-修改修改贴现信息登记申请报文(NCP005)报文结构中“登记机构代码”的备注为与贴现行同一会员10、[M]-修改信息登记类撤回申请报文(NCP010)报文处理规则中“风险票据状态更新为:止付登记或止付解除登记的撤回,撤回后恢复为登记前的风险票据状态。
国税网络开票

网络开票系统操作流程一、网络开票系统功能宁波市国税局普通发票网络开票系统(简称网络开票系统)是为推进信息管税,规范普通发票管理,提高发票管理的信息化水平,按照总局“简并票种、统一式样、建立平台、网络开具”的工作思路要求,同时为纳税人提供方便、快捷的开票手段而开发的新型开票系统。
该系统的推广使用,将进一步规范国税普通发票的使用管理,降低纳税人的开票成本,提高税收征管工作的质量,为纳税人提供优质服务奠定基础。
(一)纳税人端网络开具功能网络开具采用客户端开具方式,功能主要包括发票领购、开具、作废、开具红字发票及统计查询等。
发票领购信息取自综合征管软件,并与纳税人发票入库校验;发票开具时录入的票面信息通过网络实时存储到税务机关后台数据库,实现了网络开票数据实时采集,使开票信息与数据库一致。
对于因税务机关系统故障而离线开具发票的,发票信息由客户端进行加密后存储在本地,在条件符合的情况下根据系统设置将离线开具的发票信息通过网络上传至税务机关。
此外,系统还为纳税人提供发票查验推送服务,方便纳税人发票信息的比对。
(二)纳税人端发票信息查询功能网上发票信息查询是网络发票系统的重要部分,是加强发票管理的关键环节,主要分为开票企业查询、收票方或第三方对发票信息查询和发票流向查询。
1、网上发票信息查询范围包括网络发票系统推行后市局数据库保存的所有普通发票,其中CTAIS代开和增值税普通发票可对以前数据进行查询。
2、开票企业查询,是指纳税人可以在国税网站用税号和WEB口令及CA证书方式登陆后,对发票的领购、开具等进行查询。
3、收票方或第三方对发票信息查询,是指收票方或第三方可以通过国税网站输入发票代码、发票号码、查验码、开票日期等条件,查询到发票的销方名称、发票金额、税额、发票状态等信息,用以对发票作出初步的判定。
4、发票流向查询,是指纳税人通过输入发票代码、发票号码等条件,查询到发票的购买情况。
二、初次安装准备工作:1、获取并安装CA证书:纳税人初次使用网络开票系统前,需要先持税务登记副本原件、U盘、经办人员身份证到主管税务机关的办税服务厅申领CA证书(数字证书)。
数电发票接口技术要求

数电发票接口技术要求随着数字化的发展,电子发票成为了现代化管理和交易的重要工具。
电子发票具有快速、便捷、环保等特点,逐渐取代传统纸质发票成为主流。
为了实现电子发票的统一管理和互通,需要制定一套统一的接口技术要求,以确保不同系统之间的数据交互的准确性和稳定性。
下面将介绍数电发票接口技术的要求。
一、接口规范1. 数据格式规范:数电发票接口应采用标准的数据格式,如XML、JSON等,以确保数据的准确性和易读性。
2. 数据字段要求:数电发票接口应包含必要的字段,如发票号码、发票代码、购方名称、购方税号、销方名称、销方税号、发票金额、开票日期、开票人等,以满足发票的基本信息和交易的需求。
3. 数据校验规范:数电发票接口应设立数据校验机制,确保数据的准确性和完整性。
可以采用数字签名、数据加密等方式进行数据的验证和安全传输。
二、接口功能要求1. 发票开具功能:数电发票接口应具备发票的开具功能,包括填写发票信息、计算发票金额、生成发票号码、发票抬头等。
同时,应支持多种发票类型,如增值税发票、普通发票、电子发票等。
2. 发票查询功能:数电发票接口应提供发票查询功能,可以根据发票号码、发票代码、开票日期等条件查询发票信息,方便用户对发票进行核对和管理。
3. 发票作废功能:数电发票接口应支持发票作废功能,允许用户对错误或无效的发票进行作废操作,确保发票的准确性和合法性。
4. 发票打印功能:数电发票接口应支持发票的打印功能,可以将电子发票以纸质形式输出,以满足某些特殊行业或特定需求的用户。
5. 发票导出功能:数电发票接口应支持发票的导出功能,可以将发票数据导出为Excel、PDF等格式,方便用户进行数据分析和统计。
三、接口安全要求1. 访问权限控制:数电发票接口应设立严格的访问权限控制,确保只有具有合法身份和权限的用户才能访问和操作发票接口。
2. 数据加密传输:数电发票接口应采用加密传输技术,如SSL/TLS等,确保数据在传输过程中的安全性和保密性。
国家税务总局公告2016年第25号及解读

国家税务总局公告2016年第25号及解读国家税务总局关于发布增值税发票税控开票软件数据接口规范的公告国家税务总局公告2016年第25号为配合全面推开营改增试点工作,支持使用商品和服务税收分类与编码开具增值税发票,国家税务总局决定对纳税人使用的增值税发票税控开票软件(以下简称开票软件)相关数据接口规范予以发布。
现将有关事项公告如下:一、开票软件是指增值税纳税人安装使用的增值税发票税控开票软件(金税盘版)和增值税发票税控开票软件(税控盘版)。
二、本次发布的接口规范为开具增值税发票(不含电子发票)的接口规范,包括导入接口规范和导出接口规范。
发票类型支持增值税专用发票、增值税普通发票、机动车销售统一发票和货物运输业增值税专用发票四种发票。
导入接口规范是指开票软件可接收的待开具发票信息的数据格式;导出接口规范是指开票软件导出已开具发票信息的数据格式。
三、需要使用本数据接口规范的纳税人,应将开票软件统一升级为V2.0.09版本。
四、本数据接口规范和开票软件安装包在金税工程纳税人技术服务网()上发布,纳税人可自行下载免费安装使用。
五、纳税人在使用本数据接口规范过程中如有问题,可通过电子邮件(邮箱:*********************.cn)向税务总局反映。
六、本公告自2016年5月1日起施行。
《国家税务总局关于发布增值税发票系统升级版开票软件数据接口规范的公告》(国家税务总局公告2015年第36号)同时废止。
特此公告。
国家税务总局2016年4月25日关于《国家税务总局关于发布增值税发票税控开票软件数据接口规范的公告》的解读发布日期:2016年04月26日来源:国家税务总局办公厅一、公告出台的背景按照国务院工作部署,5月1日起在建筑业、房地产业、金融业、生活服务业全面推开营改增试点工作。
为支持营改增纳税人使用商品和服务税收分类与编码开具增值税发票,税务总局修订了相关数据接口规范,现予以公布。
二、公告的主要内容(一)本次公布的接口规范为开具增值税纸质发票接口规范,发票类型支持增值税专用发票、增值税普通发票、机动车销售统一发票和货物运输业增值税专用发票四种发票,包括导入接口规范和导出接口规范。
深圳市国家税务局关于推行使用网络发票的公告

深圳市国家税务局关于推行使用网络发票的公告文章属性•【制定机关】深圳市国家税务局•【公布日期】2012.10.16•【字号】深圳市国家税务局2012年第12号•【施行日期】2012.10.20•【效力等级】地方规范性文件•【时效性】现行有效•【主题分类】税收征管正文深圳市国家税务局关于推行使用网络发票的公告(深圳市国家税务局2012年第12号)为构建更加安全稳定的普通发票管理系统,并向纳税人提供更高质量的服务保障,根据《中华人民共和国发票管理办法》和国家税务总局关于网络发票的有关规定,结合深圳市营业税改征增值税试点(以下简称“营改增”)工作,深圳市国家税务局与中国电信、中国联通、中国移动等三大网络运营商协力建立了深圳国税网络发票平台,决定于2012年10月20日起正式启用。
现对推行使用网络发票有关问题公告如下:一、深圳国税网络发票平台向纳税人提供深圳国税所有普通发票的开具使用服务。
包括:深圳市国家税务局通用机打发票、深圳市出口商品发票、深圳市收购发票、机动车销售统一发票、二手车销售统一发票、海洋石油企业专用发票。
二、网络发票平台同时向纳税人提供普通发票网上验旧、发票查验等业务功能,纳税人还可以选择在该平台网上申购发票,并由邮政EMS将发票快递到经营场所。
网络发票平台所开具的发票,消费者可以通过安装APP软件的手机直接扫描识别。
相关软件请在深圳国税网站()下载。
三、三大网络运营商根据金税三期工程网络发票规范向纳税人提供网络发票平台服务,以及所需的普通互联网服务和增值性质的安全网络接入服务,同时向纳税人提供全面的咨询、培训和运维服务,但不得利用网络发票的推广要求纳税人使用其他各类增值服务。
具体请咨询三大网络运营商服务热线。
纳税人可自由选择、更换不同运营商的网络发票平台,对于运营商未能按承诺提供稳定的系统功能或规范服务的,纳税人可拨打深圳国税纳税服务热线:123661-4-1,进行投诉和监督。
四、为便于纳税人开通网络发票服务,请纳税人按如下时间安排,分期分批办理网络发票开户注册手续。
税控开票服务器组件接口规范标准版V2.7(发布)

税控开票服务器组件接口规范(V2.7)税控项目组2017年12月目录第一章概述 (3)第二章接口调用方式 (3)1. 远程Servlet调用 (3)2. 动态链接库调用(本地接口) (4)3. ActiveX方式调用(本地接口) (5)第三章接口定义 (7)1. 参数设置 (7)2. 税控钥匙信息查询 (8)3. 页边距设置 (10)4. 发票打印 (11)5. 获取监控管理数据 (12)6. 查询当前未开票号 (14)7. 发票领购信息查询 (15)8. 发票领购信息分发 (18)9. 发票领购信息退回 (20)10. 发票开具 (21)11. 发票作废 (40)12. 发票查询 (42)13. 红字信息表申请与查询 (53)附录1:企业使用商品编码接口变化 (58)附录2:商品与税收分类编码 (59)附录3:差额征税 (59)附录4:商品编码调试的引导说明 (59)附录5:增值税普通发票(电子)企业端(税控服务器)接口规范V1.51 (59)附录6:减按计征 (59)第一章概述1.1接口概述企业核心业务系统通过接口实现与税控开票服务器的通信,完成发票管理、发票开具和税控服务器信息查询功能。
接口根据调用方式的分为远程Servlet接口和本地组件接口。
1.2适用范围本接口规范适用于远程Servlet接口或本地组件接口(ActiveX或DLL)调用访问税控开票服务器。
第二章接口调用方式1. 远程Servlet调用企业核心业务系统与税控开票服务器采用http协议通信,接口调用方式为servlet,接口输入输出数据都是结构化的XML数据格式。
调用地址http://ip:port/SKServer/SKDoip: 税控开票服务器IP地址port:税控开票服务器端口号数据传输方式post/get同步传输提交数据请求报文返回数据响应报文调用示例:Private static void a() {try {URL url = new URL("http://127.0.0.1:8080/SKIServlet/SKDo");HttpURLConnection conn = (HttpURLConnection)url.openConnection();conn.setDoOutput(true);conn.setDoInput(true);//POST请求conn.setRequestMethod("POST");OutputStream wr = conn.getOutputStream();//读字节流byte[] content = IOUtils.toByteArray(newFileInputStream("D:\\ski\\007.xml"));wr.write(content);wr.flush();System.out.println("result = "+IOUtils.toString(conn.getInputStream(), "gbk"));} catch (Exception e) {e.printStackTrace();}}2. 动态链接库调用(本地接口)⏹动态链接库入口文件名:NISEC_SKSC.dll⏹函数定义:void _stdcall PostAndRecvEx(IN char* pszPost, OUT char* pszRecv) 参数:pszPost输入XML信息pszRecv返回XML信息返回值:无public static String getPKServerResult(String xmlcontent, Object... objs) {("log输入为======" + xmlcontent);Pointer pIn = null;Pointer pOut = null;try {// 加载动态库及函数JNative jnPKServer = new JNative("NISEC_SKSC","PostAndRecvEx");byte[] bytes = (xmlcontent + '\0').getBytes();pIn = Pointer.createPointer(bytes.length);// 设置传入参数pIn.setMemory(bytes);jnPKServer.setParameter(0, pIn);// 处理传出参数if(objs!= null&& objs.length== 1 && objs[0] instanceof Number) {pOut = Pointer.createPointer(((Number)objs[0]).intValue());} else {pOut = Pointer.createPointer(1000000);}jnPKServer.setParameter(1, pOut);// 执行调用jnPKServer.invoke();String bak = pOut.getAsString();("log输出为======" + bak);return bak;} catch (Exception e) {log.error("Jnative遇到错误", e);} finally {try {if (pIn != null) {pIn.dispose();}if (pOut != null) {pOut.dispose();}} catch (NativeException e) {log.error("Jnative遇到错误", e);}}return null;3. ActiveX方式调用(本地接口)⏹ActiveX组件文件名:NISEC_SKSCX.ocx⏹ActiveX组件GUID:<OBJECT ID=sk CLASSID="clsid: 003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F"></OBJECT>⏹函数定义:StringOperate(string sInputInfo);参数:sInputInfo 输入XML信息返回值:返回结果XML字符串⏹调用示例:<html><head><title>ActiveX组件调用示例</title><OBJECT ID=skCLASSID="clsid:003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F"codebase="NISEC_SKSCX.ocx#version=1,0,0,1"></OBJECT><script language="javascript">function SetParameter(){var sInputInfo ="<?xml version=\"1.0\" encoding=\"gbk\"?>\r\n<business id=\"20001\" comment=\"参数设置\">\r\n<body yylxdm=\"1\">\r\n<servletip>192.168.0.1</servletip>\r\n<servletp ort>7001</servletport>\r\n<keypwd>00000000</keypwd>\r\n</body>\r \n</business>";alert(sInputInfo);try{ret = sk.Operate(sInputInfo);alert(ret);}catch(e){alert(e.message + ",errno:" + e.number);}}function KeyQuery(){var sInputInfo = "<?xml version=\"1.0\" encoding=\"gbk\"?>\r\n<business id=\"20002\" comment=\"税控钥匙信息查询\">\r\n<body yylxdm=\"1\">\r\n<keypwd>00000000</keypwd>\r\n</body>\r\n</busin ess>";alert(sInputInfo);try{ret = sk.Operate(sInputInfo);alert(ret);}catch(e){alert(e.message + ",errno:" + e.number);}}</script></head><body bgcolor=#f0f0ff><div align="center"><form name=formData><table border=2 cellspacing=0><caption ><font size=6 color=#0000ff>ActiveX组件调用示例</font></caption><br><tr height=50><td width="300" align="center"><input type="button" value="参数设置" onclick="SetParameter();"></td><td width="300" align="center"><input type="button" value="税控钥匙信息查询" onclick="KeyQuery();"></td></tr><br></table></form></div></body>第三章接口定义接口中的xml数据项,如无特殊说明,遵从以下规则:⏹金额字段单位统一为元,小数点后精确到两位。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
网络开票机接口设计爱信诺航天信息科技历史版本目录1.开通流程 (6)2.交互说明 (7)2.1交互方式 (7)2.2交互URL (7)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,000156790, 0001_01返回许可码如下:许可码:b7876850b8331a3初始密码:机器码后6位。
2.交互说明2.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提交报文<?xml version="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><content><![CDATA[……]]></content></request>1.请求类型:type=[如下表所示]2.password采用密文方式传输,加密规则:password+“JSAISINO”,使用MD5加密(16位),编码为GBK。
输入:admin密码JSAISINO输出:7044199e707bd3623.interfaceVersion报文版本号,目前版本是1.03. securityMode规则暂时只支持MD5(16位)方式加密填写1或留空则为MD5(16位)加密,编码GBK4. security例如,加密串:2013110711,MD5加密后:7e7e051d1c357eb1<security>7e7e051d1c357eb1</ security>返回报文服务端根据相应请求返回相关细细,返回的xml会写入如下结构CDATA中,并把如下整个xml返回。
<?xml version="1.0" encoding="GBK"?><RESPONSE STATUS=”SUCCESS|FATAL”><TYPE>请求类型</TYPE><ALERT>若STATUS为FATAL时在此处写入失败原因</ALERT><CONTENT><![CDATA[]]></CONTENT></RESPONSE>3.报文说明3.1企业基本信息请求3.1.1功能描述根据纳税人识别号返回企业基本信息。
3.1.2提交报文发送时遵从2.3.1的结构请求类型(type)为eInfo,依次写入相关参数(param)。
3.1.3返回报文<?xml version="1.0" encoding="GBK"?><business><group><nsrsbh>纳税人识别号</nsrsbh><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><jmXx><zqjmfsDm>征前减免方式</zqjmfsDm><jms>减免数</jms><jmyyDm>减免原因代码</jmyyDm><xkbz>限开标志</xkbz></jmXx><sj>时间,格式:yyyy-MM-dd hh:mm:ss</sj>……</group>只支持单户企业下载<business>说明: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返回报文<?xml version="1.0" encoding="GBK"?><business ><group><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><group>多条购票记录…</group ></business>实例:<?xml version="1.0" encoding="GBK"?><business JSAISINO_QR="TRUE"><group><fp_dm>0</fp_dm><fpqh>00698001</fpqh><dqhm>00698031</dqhm><fpzh>00702000</fpzh><userId>32060207WT06030</userId><fpzl_dm>28053</fpzl_dm><fpzl_mc>通用机打平推式发票</fpzl_mc><lgrq>2012-11-19</lgrq><jxqx></jxqx><jobId>32060207WT06030_0_00698001</jobId><kjlx></kjlx><kpxe></kpxe><jgsj>2</jgsj><mbfs>200</mbfs></group></business>税控机开发商在开发时应注意一下几点:1)该购票信息为实时购票信息,剔除了验旧缴销票;2) 用户第一次使用(即请求的gpts为空值时)返回该企业三个月前到现在的所有可开票记录;3) 非第一次使用(即请求的gpts有值时)返回从最后一次购票日期开始,到当前止的所有可开票记录4) CTAIS的EJB取票时最小时间单位只精确到月。