税控开票服务器组件接口规范标准版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.开通流程开通暂定由手工开通。
关于发布增值税发票系统升级版与税控收款机数据接口规范的公告
第七条信用评价覆盖采购环节、履约环节、质疑投诉环节和后续审计检查环节全过程。 乐税网（ / ）邮箱： Jiufu@
第八条信用评价应当在采购项目结束后即时进行。因项目进度或质保期较长等原因，采购环 节延时或跨年度的，可以根据前期供应商信用进行评价，或按统一标准或指标平均分值对供 应商进行评价。
国家税务总局公告2015 年第77 号
根据增值税发票系统升级版推广工作需要，为了实现增值税发票系统升级版与税控收款机平 稳对接，国家税务总局制定了相关数据接口规范，现予发布，并将有关事项公告如下：
一、本次发布的数据接口规范分两种：第一种适用于使用自带USB 接口的税控收款机；第二种适用于使用串行通信接口的税控收款机。各税控收款机厂商可依 据本规范完成税控收款机的升级改造工作。
国家税务总局
2015年11月12日
国税系统政府采购供应商信用管理办法 乐税网（ / ）邮箱： Jiufu@
第一章总则
第一条为了加强国税系统政府采购供应商信用管理，提高供应商政府采购诚信度，根据《中 华人民共和国政府采购法》及其实施条例有关规定，结合国税系统政府采购工作实际，制定 本办法。
电子评价在国税系统政府采购电子平台上进行。
第十一条税务总局每年对各级国税局评价情况进行归集统计，并于每年4月底前汇总上年度 信用评价结果。
第十二条信用评价应当以政府采购规定和合同条款为制度依据，以供应商履约行为为事实依 据。
第十三条供应商对信用评价结果有异议的，可以书面向税务总局申请复核。税务总局应当按 照政府采购有关规定和本办法对评价情况进行复核。
税总函〔2015〕612号
各省、自治区、直辖市和计划单列市国家税务局，局内各单位：
“升级版”组件接口2.0 软件方案(补充稿)
“升级版”组件接口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开票成功；其它失败。
增值税发票税控开票软件清单信息数据接口规范样例
0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16
12 外管牙扣压接头 个
G1/4〃-19
13 外管牙扣压接头 个
G3/8〃-19
14 外管牙扣压接头 个
G1/2〃-14-0°
15 外管牙扣压接头 个
G5/8"-14-0°
16 外管牙扣压接头 个
G3/4〃-14-0°
17 外管牙扣压接头 个 18 外管牙扣压接头 个 19 外管牙扣压接头 个
G1〃-11-0° G1 1/4〃-11-0 ° G1 1/2〃-11
0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16 0.16
20 外管牙扣压接头 个
G2〃-0°
21 转接头
个
R1/4
22 转接头
个
R3/8
23 转接头
个
R1/2
24 转接头
个
R3/4
25 转接头
个
R1
26 转接头
个
R1-1/4
增值税发票税控开票软件清单信息数据接口规范V1.0
增值税发票税控开票软件清单信息
数据接口规范V1.0
1概述
为进一步优化纳税服务，方便纳税人开具增值税发票时《销售货物或者提供应税劳务、服务清单》的录入，国家税务总局下发税控发票开票软件清单信息数据接口规范V1.0。
纳税人在使用增值税发票税控开票软件开具增值税发票时，可通过此接口批量导入Excel格式的《销售货物或者提供应税劳务、服务清单》，
本接口规范适用于是增值税发票税控开票软件（金税盘版）与增值税发票税控开票软件（税控盘版）（以下统一简称为税控发票开票软件），配合清单导入功能使用。
2使用说明
通过税控发票开票软件中的清单导入功能，选择要导入的EXCEL文件，将清单信息批量导入到税控发票开票软件，完成发票开具。
请严格按照本接口规范中定义的列顺序生成EXCEL文件。
3接口定义
本接口规范适用的发票类型为增值税专用发票、增值税普通发票。
3.1说明
3.2格式
具体格式请参考附件：增值税发票税控开票软件清单信息数据接口规范样例.xls。
增值税发票系统升级版与电子发票系统数据接口规范 国家税务总局公告 第 号 V
增值税发票系统升级版与电子发票系统数据接口规范国家税务总局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。
国家税务总局关于发布增值税发票系统升级版开票软件数据接口规范
现将白酒消费税最低计税价格核定问题公告如下： 纳税人将委托加工收回的白酒销售给销售单位 ， 消费税 计税价格低于销售单位对外销售 价格 （ 不含增值税） ７ ０ ％以 下， 属于《 中华人 民共和国消费税暂行条例》 第十条规定的情
形， 应该按照《 国家 税 务 总局 关 于 加强 白酒 消 费税 征 收管 理
２ ． 所属期为２ ０ １ ５ 年５ 月１ ０日至２ ０ １ ５ 年５ 月３ １ 日的卷烟消 费税， 纳税 ＾ 依据调整后的卷烟批发环节消费税税率计算填写。 （ －） 纳税人于 ２ ０ １ ５ 年６ 月申报期 内， 将纸质 申报资料及 《 卷烟批发企业月份销售明细清单》 电子数据一并报送主管 税务机关 。纳税 申报资料不完整、 逻辑关系不符 的， 纳税人 应补充、 修改后重新报送。
将 有关事 项公 告如 下 ：
一
为促进节约能源， 鼓励使用新能源 ， 根据《 中华人民共和 国车船税法》 及其实施条例有关规定 ， 经国务院批准 ， 现将节
、
升级版开票软件是指增值税纳税人安装使用的增值
使用新能源车船的车船税优惠政策通知如下 ： 税发票 系统升级版税控发票开票软件 （ 金税盘版 ） 和税控发 约能源、 票开票软件（ 税控盘版） 。
年５ 月１ 日至 ２ ０ １ ５ 年５ 月３ １ 日的消费税 ， 按以下过渡方式办 装升级版开票软件过程中， 如有问题 ， 请联系当地税控技术 理纳税申报 ： 。
（ 一） 纳税人按税款所属期分段填写纸质《 卷烟批发环节
消费税纳税申报表（ 过渡期） 》 （ 附件 １ ） ， 其中：
１ ． 所属期 为 ２ ０ １ ５ 年５ 月１ 日 至２ ０ １ ５ 年５ 月 ９日的卷烟消 费 税， 纳税人 依据调整 前的卷烟批 发环节 消费税税率计算 填写 。
增值税管理系统-百望接口规范V1.0
税控开票服务器组件接口规范（标准版）税控项目组目录目录 (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数据项，如无特殊说明，遵从以下规则：⏹金额字段单位统一为元，小数点后精确到两位。
增值税发票系统升级版与电子发票系统数据接口规范(国家税务总局公告2015年第53号附件)V2.1.20.160825
说明 0-蓝字发票；1-红字发票
红字发票时必须 红字发票时必须 单位：元（2 位小数） 不含税，单位：元（2 位小
第4页
18 HJSE 19 BZ
合计税额 备注
项目明细，可多条（最大 100 条）
20 FPHXZ
发票行性质
21 XMMC
项目名称
22 DW 23 GGXH 24 XMSL 25 XMDJ 26 XMJE
票结பைடு நூலகம்.TXT。内容为：
<?xml version="1.0" encoding="gbk"?> <business id="FPKJ" comment="发票开具"> <RESPONSE_COMMON_FPKJ class="RESPONSE_COMMON_FPKJ">
<FPQQLSH>发票请求流水号</FPQQLSH> <JQBH>税控设备编号</JQBH>
<?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>
国家税务总局关于发布增值税发票税控开票软件数据接口规范的公告
、
装机容量 超 过１ ０ ０ 万千 瓦的水 力发电站（ 含抽 水蓄 能电站）
批量 自动导 入开 具、 批量 数据 导 出等功能。 需启用这 些功 销售自 产 电 力 产 品， ￣ ２ ０ １ ３ 年１ 月１ 日 至２ ０ １ ５ 年１ ２ ） ｑ ３ １ Ｅ ｌ ， 对 其 增 值 税 实 入 开具 、 能的纳 税人 ， 应 将增 值 税 防伪税 控 系统 防伪 开票 子 系统 升 级 为 际税 负超 过８ ％的部分 实行即征即退 政策； ￣ １ ２ ０ １ ６ 年１ 月１ 日 至２ ０ １ ７ 年 ． ２ ３ ． １ Ｏ 版， 发票税 控系统开票软件 升级为Ｖ１ ． ３ ． ０ ０ 版。 １ ２ ￣３ １ Ｅ １ ， 对 其增值税 实际税负超过１ ２ ％的部分 实行即征即退 政策。 Ｖ７ 二、 本通知所称的装机容量， 是指单站发电机组额 定装机容量 的总 和。 该额 定装机 容量 包括 项目 核 准（ 审批） 机关依 权限核准（ 审 四、 数据 接口规范 和税控 开票软 件安装 包在金 税工程 纳税 人 技术 服务网（ ｈ ｔ ｔ ｐ ： ／ ／ ｗｗｗ． ｃ ｈｉ ｎ ａ ｅ ｔ ａ ｘ ． ｃ ｎ ） 上 发布， 纳税 人可自
ｌ － ￣ ｅ ｇ ｕ ｌ ａ ｔ ｌ ｏｎ
任公司电力产 品增值税 税收政 策问题的通知》 （ 国税函［ ２ ０ ０ ４ ］ ５ ２ 号） ［ ￣ ２ ０ １ ４ 年１ 月１ 日 起废 止。
（ 财税 ［ ２ ０ １ ４ １ １ ０ 号， ２ ０ １ ４ 年２ ￣１ ２ １ ： ｑ ）
（ 国家税务总局公告２ ０ １ ４ 年第１ ４ 号． ２ ０ １ ４ 年３ 月３ 日）
国家税务总局
关于发布增值税发票税控开票软件数据接 口规 范的公告
江苏国税网络开票机接口规范
江苏国税网络开票机接口规范
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
增值税发票税控开票软件清单信息
数据接口规范V1.0
1概述
为进一步优化纳税服务，方便纳税人开具增值税发票时《销售货物或者提供应税劳务、服务清单》的录入，国家税务总局下发税控发票开票软件清单信息数据接口规范V1.0。
纳税人在使用增值税发票税控开票软件开具增值税发票时，可通过此接口批量导入Excel格式的《销售货物或者提供应税劳务、服务清单》，
本接口规范适用于是增值税发票税控开票软件（金税盘版）与增值税发票税控开票软件（税控盘版）（以下统一简称为税控发票开票软件），配合清单导入功能使用。
2使用说明
通过税控发票开票软件中的清单导入功能，选择要导入的EXCEL文件，将清单信息批量导入到税控发票开票软件，完成发票开具。
请严格按照本接口规范中定义的列顺序生成EXCEL文件。
3接口定义
本接口规范适用的发票类型为增值税专用发票、增值税普通发票。
3.1说明
3.2格式
具体格式请参考附件：增值税发票税控开票软件清单信息数据接口规范样例.xls。
税控发票开票软件发票信息数据接口规范V4.0
税控发票开票软件发票信息数据接口规范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"。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
税控开票服务器组件接口规范（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数据项，如无特殊说明，遵从以下规则：⏹金额字段单位统一为元，小数点后精确到两位。