税控开票服务器组件接口规范(标准版)税控项目组2015年9月税控开票服务器组件接口规范目录目录..................................................................................................................................................2第一章概述.....................................................................................................................................31.接口概述..............................................................................................................................32.适用范围..............................................................................................................................3第二章接口调用方式.....................................................................................................................41.本地ActiveX组件调用......................................................................................................42.本地DLL调用....................................................................................................................6第三章接口定义.............................................................................................................................61.参数设置..............................................................................................................................62.税控钥匙信息查询..............................................................................................................73.发票开具..............................................................................................................................94.发票作废............................................................................................................................155.发票查询............................................................................................................................176.发票领购信息查询............................................................................................................207.发票打印............................................................................................................................228.页边距设置........................................................................................................................239.查询当前未开票号............................................................................................................2410.发票领购信息分发..........................................................................................................2611.发票领购信息退回..........................................................................................................27税控开票服务器组件接口规范第一章概述1.接口概述企业核心业务系统通过接口实现与税控开票服务器的通信,完成发票管理、发票开具和税控服务器信息查询功能。接口根据调用方式的不同分为远程Servlet接口和本地ActiveX组件接口。税控服务器本地ActiveX组件远程Servlet接口税控开票服务器企业核心业务系统开票终端2.适用范围本接口规范仅适用于开票端通过组件接口ActiveX控件和Servlet接口方式访问税控开票服务器。税控开票服务器组件接口规范第二章接口调用方式本地接口提供ActiveX控件和DLL两种调用方式,接口列表见下表。序号接口ID接口说明其它说明120001参数设置本地接口220002税控钥匙信息查询本地接口310008发票开具本地接口410009发票作废本地接口510010发票查询本地接口610005发票领购信息查询本地接口720004发票打印本地接口820003打印页边距设置本地接口910004查询当前未开票号本地接口1010006发票领购信息分发本地接口1110007发票领购信息退回本地接口1.本地ActiveX组件调用ActiveX组件文件名:NISEC_SKSCX.ocxActiveX组件GUID:CLASSID=clsid:003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F函数定义:StringOperate(stringsInputInfo);参数:sInputInfo输入XML信息返回值:返回结果XML字符串调用示例:htmlheadtitleActiveX组件调用示例/titleOBJECTID=skCLASSID=clsid:003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49Fcodebase=NISEC_SKSCX.ocx#version=1,0,0,1/OBJECTscriptlanguage=javascriptfunctionSetParameter(){税控开票服务器组件接口规范varsInputInfo=?xmlversion=\1.0\encoding=\gbk\?\r\nbusinessid=\20001\comment=\参数设置\\r\nbodyyylxdm=\1\\r\nservletip192.168.0.1/servletip\r\nservletport7001/servletport\r\nkeypwd00000000/keypwd\r\n/body\r\n/business;alert(sInputInfo);try{ret=sk.Operate(sInputInfo);alert(ret);}catch(e){alert(e.message+,errno:+e.number);}}functionKeyQuery(){varsInputInfo=?xmlversion=\1.0\encoding=\gbk\?\r\nbusinessid=\20002\comment=\税控钥匙信息查询\\r\nbodyyylxdm=\1\\r\nkeypwd00000000/keypwd\r\n/body\r\n/business;alert(sInputInfo);try{ret=sk.Operate(sInputInfo);alert(ret);}catch(e){alert(e.message+,errno:+e.number);}}/script/headbodybgcolor=#f0f0ffdivalign=centerformname=formDatatableborder=2cellspacing=0captionfontsize=6color=#0000ffActiveX组件调用示例/font/captionbrtrheight=50tdwidth=300align=centerinputtype=buttonvalue=参数设置onclick=SetParameter();/tdtdwidth=300align=centerinputtype=buttonvalue=税控钥匙信息查询onclick=KeyQuery();/td/trbr/table/form/div/body/html税控开票服务器组件接口规范2.本地DLL调用DLL文件名:NISEC_SKSC.dll函数定义:void_stdcallPostAndRecvEx(INLPSTRpszPost,OUTLPSTRpszRecv)参数:pszPost输入XML信息pszRecv返回XML信息返回值:无第三章接口定义接口中的xml数据项,如无特殊说明,遵从以下规则:金额字段单位统一为元,小数点后精确到两位。日期字段格式统一为“YYYYMMDD”。1.参数设置1.1接口说明参数设置接口完成服务器IP地址、端口号和税控钥匙口令的设置功能,仅ActiveX接口提供该接口,其它接口调用前必须首先调用参数设置接口。1.2请求数据请求报文:?xmlversion=1.0encoding=gbk?businessid=20001comment=参数设置bodyyylxdm=1servletip服务器IP地址/servletipservletport服务器端口号/servletportkeypwd税控钥匙口令/keypwdaqm注册码/aqm/body/business税控开票服务器组件接口规范参数说明:索引ID名称长度必须说明1id交易编号5是200012comment交易描述30是参数设置3yylxdm应用类型代码1是固定为“1”表示国税4servletip税控开票服务器IP地址15是5servle