税控开票服务器组件接口规范标准版V2.7(发布)

国税网络开票机接口规范标准网络开票机接口设计爱信诺航天信息科技历史版本目录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.开通流程开通暂定由手工开通。

“升级版”组件接口2.0软件方案（补充稿20150426）一、版本说明该技术方案是7.23版组件接口技术方案的补充部分。

版本匹配关系：开票版本(V2.0.10.150211)VS组件接口(V2.0.10.150227)开票版本(V2.0.10.150319)VS组件接口(V2.0.10.150316)开票版本(V2.0.10.150426)VS组件接口(V2.0.10.150426)二、接口功能1．设置数字证书密码件cert.txt，并将证书密码保存在此文件中，组件接口会自动读取文件内容作为证书密码。

2．开启金税盘3．查询库存发票4．发票开具方法：Invoice();功能：传入开票数据，将开票数据记入防伪税控开票数据库，并在金税盘中开具此发票。

输入：5.1增值税专、普票（1）发票整体信息SellerAddress–当InfoKind=2(普通发票)时：若赋值为“1”表示农产品销售发票，若赋值为“2”表示农产品收购发票，其它表示增值税普通发票（2）发票明细信息注意：支持一票多税率，明细行税率以发票整体信息中的InfoTaxRate当前值为准5.2货物运输业发票(1)发票整体信息传入发票整体信息前调用InvInfoInit()方法初始化发票整体信息各项属性。

InvInfoInit();InfoKind=11;如果是负数票给属性InfoClientAddressPhone传字符串“1”，如：InfoClientAddressPhone=WideString("1").Copy();InfoClientName=实际受票方InfoClientTaxCode=实际受票方纳税人识别号ConsignerName=收货人ConsignerTaxCode=收货人纳税人识别号ShipperName=发货人ShipperTaxCode=发货人纳税人识别号OriginViaArrivalPlace=起运地、经由、到达地InfoListName=运输货物信息InfoTaxRate=税率（5%传5）VehicleKindNo=车种车号VehicleTonnage=车船吨位InfoNotes=备注InfoCashier=收款人InfoChecker=复核人（2）费用项目：情况费用项目列表：ClearInvList();循环调用传入费用项目InvListInit();ListGoodsName=费用项目ListAmount=金额ListPriceKind=是否含税金额ListTaxAmount=税额（如果不传，或传零接口自动计算）AddInvList();5.3机动车销售统一发票InvInfoInit();InfoKind=12;InfoClientAddressPhone=“1”旧版、“2”新版InfoClientTaxCode=纳税人识别号InfoClientName=购货单位IDCard=身份证号码、组织机构代码VehicleKind=车辆类型BrandModel=厂牌型号OriginPlace=产地QualityCertificate=合格证号ImpCertificateNo=进口证明书号CommInspectionNo=商检单号EngineNo=发动机号码VehicleNo=车辆识别代号、车辆号码ManufacturerName=生产厂家名称AmountTaxTotal=价税合计SellerPhone=销货单位电话SellerAccount=销货单位账号SellerAddress=地址SellerBank=开户银行InfoTaxRate=税率（5%传5）Tonnage=吨位PeopleNo=限乘人数InfoNotes=备注（正数票不要传备注，负数票传相应格式的备注）输出：RetCode：4011开票成功；其它失败。

增值税发票税控开票软件清单信息
数据接口规范V1.0
1概述
为进一步优化纳税服务，方便纳税人开具增值税发票时《销售货物或者提供应税劳务、服务清单》的录入，国家税务总局下发税控发票开票软件清单信息数据接口规范V1.0。

纳税人在使用增值税发票税控开票软件开具增值税发票时，可通过此接口批量导入Excel格式的《销售货物或者提供应税劳务、服务清单》，
本接口规范适用于是增值税发票税控开票软件（金税盘版）与增值税发票税控开票软件（税控盘版）（以下统一简称为税控发票开票软件），配合清单导入功能使用。

2使用说明
通过税控发票开票软件中的清单导入功能，选择要导入的EXCEL文件，将清单信息批量导入到税控发票开票软件，完成发票开具。

请严格按照本接口规范中定义的列顺序生成EXCEL文件。

3接口定义
本接口规范适用的发票类型为增值税专用发票、增值税普通发票。

3.1说明
3.2格式
具体格式请参考附件：增值税发票税控开票软件清单信息数据接口规范样例.xls。

增值税发票系统升级版与电子发票系统数据接口规范国家税务总局2015年7月目录目录 (2)第1章接口概述 (3)1.1.接口概述 (3)1.2.适用范围 (3)第2章金税盘/税控盘接口说明 (3)2.1.发票开具 (3)第3章税控开票服务器接口说明 (6)3.1.登记信息查询 (6)3.2.发票库存查询 (7)3.3.发票开具 (8)3.4.发票查询 (11)第1章接口概述1.1.接口概述本接口用于电子发票系统对接增值税发票系统升级版开具增值税普通发票（电子）的接口说明。

接口设计为以XML格式字符串作为参数传递。

1.2.适用范围该接口规范适用于通过金税盘或税控盘及其开票软件和税控开票服务器两种开具模式实现电子发票与升级版系统的对接，仅支持增值税普通发票（电子）。

第2章金税盘/税控盘接口说明2.1.发票开具1）接口说明：金税盘、税控盘配套开票软件使用。

开票软件完成蓝字发票和红字发票开具。

项目条数最大100条。

2）使用说明：通过税控发票开票软件中的手工导入开具和自动导入开具功能，将待开发票的信息批量导入到税控发票开票软件，完成发票开具。

选择手工导入开具时，首先选择要导入的XML文件，再对导入发票信息逐张开具。

选择自动导入开具时，首先设置文件存储路径和轮询时间。

自动导入开具功能开启后，系统自动轮询指定路径下的XML文件，自动完成发票开具，并将开具结果写入指定文件目录。

3）导入的XML文件格式如下：<?xml version="1.0"encoding="gbk"?><business id="FPKJ"comment="发票开具"><REQUEST_COMMON_FPKJ class="REQUEST_COMMON_FPKJ"><COMMON_FPKJ_FPT class="COMMON_FPKJ_FPT"><FPQQLSH>发票请求流水号</FPQQLSH><KPLX>开票类型</KPLX><XSF_NSRSBH>销售方纳税人识别号</XSF_NSRSBH><XSF_MC>销售方名称</XSF_MC><XSF_DZDH>销售方地址、电话</XSF_DZDH><XSF_YHZH>销售方银行账号</XSF_YHZH><GMF_NSRSBH>购买方纳税人识别号</GMF_NSRSBH><GMF_MC>购买方名称</GMF_MC><GMF_DZDH>购买方地址、电话</GMF_DZDH><GMF_YHZH>购买方银行账号</GMF_YHZH><KPR>开票人</KPR><SKR>收款人</SKR><FHR>复核人</FHR><YFP_DM>原发票代码</YFP_DM><YFP_HM>原发票号码</YFP_HM><JSHJ>价税合计</JSHJ><HJJE>合计金额</HJJE><HJSE>合计税额</HJSE><BZ>备注</BZ></COMMON_FPKJ_FPT><COMMON_FPKJ_XMXXS class="COMMON_FPKJ_XMXX"size="1"> <COMMON_FPKJ_XMXX><FPHXZ>发票行性质</FPHXZ><XMMC>项目名称</XMMC><GGXH>规格型号</GGXH><DW>单位</DW><XMSL>项目数量</XMSL><XMDJ>项目单价</XMDJ><XMJE>项目金额</XMJE><SL>税率</SL><SE>税额</SE></COMMON_FPKJ_XMXX></COMMON_FPKJ_XMXXS></REQUEST_COMMON_FPKJ></business>参数说明：索引ID名称长度必须说明1FPQQLSH发票请求流水号20是2KPLX开票类型1是0-蓝字发票；1-红字发票3XSF_NSRSBH销售方纳税人识别号20是4XSF_MC销售方名称100是5XSF_DZDH销售方地址、电话100是6XSF_YHZH销售方银行账号100否7GMF_NSRSBH购买方纳税人识别号20否8GMF_MC购买方名称100是9GMF_DZDH购买方地址、电话100否10GMF_YHZH购买方银行账号100否11KPR开票人8是12SKR收款人8否13FHR复核人8否14YFP_DM原发票代码12红字发票时必须15YFP_HM原发票号码8红字发票时必须16JSHJ价税合计是单位：元（2位小数）17HJJE合计金额是不含税，单位：元（2位小数）18HJSE合计税额是单位：元（2位小数）19BZ备注200否备注长度应减去“机器编号:ZZZZZZZZZZZ”,”对应正数发票代码:XXXXXXXXXXXX号码:YYYYYYYY”字样长度，长度剩余130。

税控开票服务器组件接口规范（标准版）税控项目组目录目录 (2)第一章概述 (3)1. 接口概述 (3)2. 适用范围 (3)第二章接口调用方式 (4)1. 本地ActiveX组件调用 (4)2. 本地DLL调用 (6)第三章接口定义 (6)1. 参数设置 (6)2. 税控钥匙信息查询 (7)3. 发票开具 (9)4. 发票作废 (15)5. 发票查询 (17)6. 发票领购信息查询 (20)7. 发票打印 (22)8. 页边距设置 (23)9. 查询当前未开票号 (24)10. 发票领购信息分发 (26)11. 发票领购信息退回 (27)第一章概述1. 接口概述企业核心业务系统通过接口实现与税控开票服务器的通信，完成发票管理、发票开具和税控服务器信息查询功能。

接口根据调用方式的不同分为远程Servlet 接口和本地ActiveX组件接口。

企业核心业务系统远程Servlet接口税控服务器税控开票服务器本地ActiveX组件开票终端2. 适用范围本接口规范仅适用于开票端通过组件接口ActiveX控件和Servlet接口方式访问税控开票服务器。

第二章接口调用方式本地接口提供ActiveX控件和DLL两种调用方式，接口列表见下表。

序号接口ID 接口说明其它说明1 20001 参数设置本地接口2 20002 税控钥匙信息查询本地接口3 10008 发票开具本地接口4 10009 发票作废本地接口5 10010 发票查询本地接口6 10005 发票领购信息查询本地接口7 20004 发票打印本地接口8 20003 打印页边距设置本地接口9 10004 查询当前未开票号本地接口10 10006 发票领购信息分发本地接口11 10007 发票领购信息退回本地接口1. 本地ActiveX组件调用⏹ActiveX组件文件名：NISEC_SKSCX.ocx⏹ActiveX组件GUID：CLASSID="clsid: 003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F"⏹函数定义：String Operate(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></html>2. 本地DLL调用⏹DLL文件名：NISEC_SKSC.dll⏹函数定义：void _stdcall PostAndRecvEx(IN LPSTR pszPost, OUT LPSTR pszRecv) 参数：pszPost 输入XML信息pszRecv 返回XML信息返回值:无第三章接口定义接口中的xml数据项，如无特殊说明，遵从以下规则：⏹金额字段单位统一为元，小数点后精确到两位。

江苏国税网络开票机接口规范
1. 引言
本文档旨在明确规范江苏国税网络开票机的接口使用方式，以保证系统间的数据交互准确、高效。

开发人员在使用江苏国税网络开票机接口时，请严格按照本规范进行开发和调试。

2. 接口基本信息
•接口名称：江苏国税网络开票机接口
•接口版本：1.0
•开发语言：Java
•开发框架：Spring Boot
•API文档格式：Markdown
3. 接口概述
江苏国税网络开票机接口提供了一系列用于发票开具、查询、打印等功能的API。

开发人员可以通过调用这些API实现与江苏国税网络开票机的交互，从而实现发票管理和开票业务。

4. 接口使用方法
4.1 接口地址
接口地址为：http://localhost:8080/api
4.2 接口认证
在调用接口之前，需要进行认证。

开发人员需要提供有效的身份认证信息（如用户名和密码），接口将根据认证信息判断用户的权限和身份。

4.3 接口参数
接口参数以JSON格式进行传递，具体参数格式和说明如下：
•invoiceInfo(object, required): 发票信息，包括发票号码、金额等。

–invoiceNumber (string): 发票号码。

–amount (number): 发票金额。

示例：
```json {。

增值税发票税控开票软件清单信息
数据接口规范V1.0
1概述
为进一步优化纳税服务，方便纳税人开具增值税发票时《销售货物或者提供应税劳务、服务清单》的录入，国家税务总局下发税控发票开票软件清单信息数据接口规范V1.0。

纳税人在使用增值税发票税控开票软件开具增值税发票时，可通过此接口批量导入Excel格式的《销售货物或者提供应税劳务、服务清单》，
本接口规范适用于是增值税发票税控开票软件（金税盘版）与增值税发票税控开票软件（税控盘版）（以下统一简称为税控发票开票软件），配合清单导入功能使用。

2使用说明
通过税控发票开票软件中的清单导入功能，选择要导入的EXCEL文件，将清单信息批量导入到税控发票开票软件，完成发票开具。

请严格按照本接口规范中定义的列顺序生成EXCEL文件。

3接口定义
本接口规范适用的发票类型为增值税专用发票、增值税普通发票。

3.1说明
3.2格式
具体格式请参考附件：增值税发票税控开票软件清单信息数据接口规范样例.xls。

税控发票开票软件发票信息数据接口规范V4.01概述为进一步优化纳税服务，满足纳税人内部管理信息系统与增值税发票税控开票软件的衔接需要，国家税务总局下发了税控发票开票软件发票信息数据接口规范V1.0、V2.0、V3.0版。

随着增值税发票管理新系统的全国推广和营改增的全面实施，公布的接口已经不能满足需要，现对该接口进行更新升级，形成V4.0版。

本接口规范适用于是增值税发票税控开票软件（金税盘版）与增值税发票税控开票软件（税控盘版）的商品编码版本（以下统一简称为税控发票开票软件），配合手工导入开具、自动导入开具和发票明细导出功能使用。

2接口说明2.1待开发票信息导入接口通过税控发票开票软件中的手工导入开具和自动导入开具功能，将待开发票的信息批量导入到税控发票开票软件，完成发票开具。

选择手工导入开具时，首先选择要导入的XML文件，再对导入发票信息逐张开具并打印发票。

选择自动导入开具时，首先设置文件存储路径和轮询时间。

自动导入开具功能开启后，系统自动轮询指定路径下的XML文件，自动完成发票开具，并将开具结果写入指定文件目录。

2.2已开发票信息导出接口通过税控发票开票软件中的发票明细导出功能，实现已开发票信息的批量导出，生成EXCEL文件或XML文件。

3接口定义本接口规范内容包括待开发票信息导入接口和已开发票信息导出接口，发票类型为增值税专用发票、增值税普通发票、货物运输业增值税专用发票、机动车销售统一发票和二手车销售统一发票。

3.1增值税专用发票和增值税普通发票3.1.1修改说明单据新增了Version节点，增加商品编码功能后的版本为2.0；单据新增了Spbmbbh节点，增加商品编码功能后为税局下载的商品编码表版本号；单据新增了Hsbz节点，用于区分营改增新增的5%不含税税率和中外合作油气田（原海洋石油）5%税率、1.5%税率、差额税；单据商品明细中新增了Spbm（商品编码）、Qyspbm（企业商品编码）、Syyhzcbz（享受优惠政策）、Lslbz（零税率标识）、Yhzcsm（优惠政策说明），详细内容请查看接口规范中相关说明；单据只允许对单行商品进行折扣，折扣行紧挨被折行之后，折扣行的商品名称与被折行相同；单据新增了Kce节点，用于差额税计算。

财政电子票据公共服务接口规范1适用范围本规范规定了财政电子票据公共服务接口，为财政电子票据服务平台和外部系统间在交互财政电子票据相关电子信息时的接口技术规范，实现财政电子票据的下载和入账反馈。

2技术规范2.1处理流程使用公共服务接口时，基于HTTPS协议，采用POST方式“请求-响应”模式进行交互。

（1）请求方发送请求请求方系统由财政电子票据服务平台分配一个身份标识app_id，每个app_id 配有一个秘钥（appKey）。

请求方根据接口要求，构造请求参数并使用密钥（appKey）对请求参数进行签名。

（2）电子票据服务平台返回响应结果电子票据服务平台通过验证请求参数的签名来验证请求方身份合法性及数据完整性，无误后进行处理。

a)处理成功时，根据请求服务不同，响应结果分为两种情况：电子票据下载时，返回电子票据文件压缩包；电子票据入账时，返回JSON格式的参数。

b)处理失败时，响应结果为JSON格式的参数。

（3）请求方接收数据请求方收到响应结果后，首先判断电子票据服务平台响应是否成功：电子票据下载时，通过HTTP Content-Type判断是否成功；电子票据入账时，通过返回码判断是否成功。

2.2数据类型2.3参数说明说明：（1）参数名必须为小写字母；（2）业务参数message的构成，根据具体接口描述构造；（3）字符集统一采用 UTF-8编码格式。

3接口列表4接口描述4.1电子票据下载单位通过该接口下载待入账电子票据。

4.1.1服务名downloadPNG4AccountByDate4.1.2业务参数节点：message4.1.3返回参数根据HTTP响应头中Content-Type值判断成功或失败。

成功时值为application/x-zip-compressed，失败时值为application/json。

（1）成功返回电子票据文件压缩包，命名规则为：包内电子票据份数-最大批次序列号.zip。

电子票据压缩包文件名提取方式：HTTP Headercontent-disposition，值为"attachment;filename=包内电子票据份数-最大批次序列号.zip"。