增值税管理系统百望接口.docx

1、增值税管理系统百望接口税控开票服务器组件接口规范（标准版）税控项目组2015年9月第一章 概述1. 接口概述企业核心业务系统通过接口实现与税控开票服务器的通信，完成发票管理、发票开具和税控服务器信息查询功能。接口根据调用方式的不同分为远程Servlet接口和本地ActiveX组件接口。2. 适用范围本接口规范仅适用于开票端通过组件接口ActiveX控件和Servlet接口方式访问税控开票服务器。第二章 接口调用方式本地接口提供ActiveX控件和DLL两种调用方式，接口列表见下表。序号接口ID接口说明其它说明120001参数设置本地接口220002税控钥匙信息查询本地接口310008发票开具本

2、地接口410009发票作废本地接口510010发票查询本地接口610005发票领购信息查询本地接口720004发票打印本地接口820003打印页边距设置本地接口910004查询当前未开票号本地接口1010006发票领购信息分发本地接口1110007发票领购信息退回本地接口1. 本地ActiveX组件调用 ActiveX组件文件名： ActiveX组件GUID：CLASSID=clsid: 003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F 函数定义：String Operate(string sInputInfo);参数： sInputInfo 输入XML信息返回值:返回

3、结果XML字符串 调用示例：ActiveX组件调用示例function SetParameter()var sInputInfo = rnrnrn;alert(sInputInfo);try ret = (sInputInfo);alert(ret); catch(e) alert + ,errno: + ; function KeyQuery()var sInputInfo = rnrnrn00000000rnrn;alert(sInputInfo);try ret = (sInputInfo); alert(ret); catch(e) alert + ,errno: + ; Active

4、X组件调用示例 2. 本地DLL调用 DLL文件名： 函数定义：void _stdcall PostAndRecvEx(IN LPSTR pszPost, OUT LPSTR pszRecv)参数： pszPost 输入XML信息 pszRecv 返回XML信息返回值: 无第三章 接口定义接口中的xml数据项，如无特殊说明，遵从以下规则： 金额字段单位统一为元，小数点后精确到两位。 日期字段格式统一为“YYYYMMDD”。1. 参数设置1.1 接口说明参数设置接口完成服务器IP地址、端口号和税控钥匙口令的设置功能，仅ActiveX接口提供该接口，其它接口调用前必须首先调用参数设置接口。1.2

5、请求数据请求报文：服务器IP地址服务器端口号税控钥匙口令注册码参数说明：索引ID名称长度必须说明1id交易编号5是200012comment交易描述30是参数设置3yylxdm应用类型代码1是固定为“1”表示国税4servletip税控开票服务器IP地址15是5servletport税控开票服务器端口号5是6keypwd税控钥匙口令8是7zcm注册码512是1.3 返回数据响应报文：返回代码返回信息参数说明：索引ID名称长度必须说明1id交易编号5是200012comment交易描述30是获取服务器基本信息3yylxdm应用类型代码1是固定为“1”表示国税4returncode返回代码8是0成

6、功，其它失败5returnmsg返回信息160是2. 税控钥匙信息查询2.1 接口说明提供查询税控钥匙基本信息的接口，主要查询企业纳税人识别号和税控钥匙编号。仅本地组件接口提供该接口，需要保证税控钥匙与本地电脑连接正常。2.2 请求数据请求报文：参数说明：索引ID名称长度必须说明1id交易编号5是200022comment交易描述30是税控钥匙信息查询3yylxdm应用类型代码1是固定为“1”表示国税4keypwd税控钥匙口令8是2.3 返回数据响应报文：返回代码返回信息纳税人识别号税控钥匙编号参数说明：索引ID名称长度必须说明1id交易编号5是200022comment交易描述30是税控钥匙

7、信息查询3yylxdm应用类型代码1是固定为“1”表示国税4returncode返回代码8是0成功，其它失败5returnmsg返回信息160是6nsrsbh纳税人识别号20否7keyno税控钥匙编号14否前两位固定为“33”3. 发票开具1.1 3.1 接口说明发票开具接口实现发票的正数开具和负数开具，开具成功后由税控服务器生成税控码，并由本地税控钥匙生成发票签名。该接口根据不同的发票类型，参数定义不同。3.2 请求数据1. 增值税专用发票（发票类型代码：004）请求报文：开票终端标识发票类型代码发票请求流水号开票类型特殊票种标识销货单位识别号销货单位名称销货单位地址电话销货单位银行帐号购货

8、单位识别号购货单位名称购货单位地址电话购货单位银行帐号清单标志发票行性质商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志合计金额合计税额价税合计备注收款人复核人开票人信息表编号原发票代码原发票号码签名参数参数说明：索引ID名称长度必须说明1id交易编号5是100082comment交易描述8是发票开具3yylxdm应用类型代码1是固定为“1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是6kplx开票类型1是0：正数票开具1：负数票开具7fpqqlsh发票请求流水号100否如果为空就不校验，有值就不能重复8tspz特殊票种标识2是“00”不

9、是“01”农产品销售“02”农产品收购9xhdwsbh销货单位识别号20是与税控服务器保持一致10xhdwmc销货单位名称100是与税控服务器保持一致11xhdwdzdh销货单位地址电话100是12xhdwyhzh销货单位银行账号100是13ghdwsbh购货单位识别号20是14ghdwmc购货单位名称100是15ghdwdzdh购货单位地址电话100是16ghdwyhzh购货单位银行账号100是17qdbz清单标志1是0：无清单1：带清单18fphxz发票行性质1是0 正常行1 折扣行2 被折扣行19spmc商品名称72是折扣行商品名称规则：折扣行数N（%）20spsm商品税目20否保留字段

10、，目前为空21ggxh规格型号36否22dw单位14否23spsl商品数量12否小数点后6位24dj单价12否小数点后6位25je金额12是小数点后2位，正负26sl税率12是小数点后2位27se税额12是小数点后2位，正负28hsbz含税标志1是0 不含税1 含税29hjje合计金额12是小数点后2位，不含税，正负30hjse合计税额12是小数点后2位，正负31jshj加税合计12是小数点后2位，正负32bz备注150否33skr收款人16否34fhr复核人16否35kpr开票人20是中文名称36tzdbh信息表编号20否37yfpdm原发票代码10否38yfphm 原发票号码8否38qmc

11、s签名参数16否2. 增值税普通发票（发票类型代码：007）请求报文：开票终端标识发票类型代码发票请求流水号开票类型特殊票种标识销货单位识别号销货单位名称销货单位地址电话销货单位银行帐号购货单位识别号购货单位名称购货单位地址电话购货单位银行帐号清单标志发票行性质商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志合计金额合计税额价税合计备注收款人复核人开票人信息表编号原发票代码原发票号码签名参数参数说明：索引ID名称长度必须说明1id交易编号5是100082comment交易描述8是发票开具3yylxdm应用类型代码1是固定为“1”表示国税4kpzdbs开票终端标识16是开票终端唯一性

12、标识5fplxdm发票类型代码3是6fpqqlsh发票请求流水号100否如果为空就不校验，有值就不能重复7kplx开票类型1是0：正数票开具1：负数票开具8tspz特殊票种标识2是“00”不是“01”农产品销售“02”农产品收购9xhdwsbh销货单位识别号20是与税控服务器保持一致10xhdwmc销货单位名称100是与税控服务器保持一致11xhdwdzdh销货单位地址电话100是12xhdwyhzh销货单位银行帐号100是13ghdwsbh购货单位识别号20否14ghdwmc购货单位名称100是15ghdwdzdh购货单位地址电话100否16ghdwyhzh购货单位银行帐号100否17qdb

13、z清单标志1是0：无清单1：带清单18fphxz发票行性质1是0 正常行1 折扣行2 被折扣行19spmc商品名称72是折扣行商品名称规则：折扣行数N（%）20spsm商品税目20否保留字段，目前为空21ggxh规格型号36否22dw单位14否23spsl商品数量12否小数点后6位24dj单价12否小数点后6位25je金额12是小数点后2位26sl税率12是小数点后2位27se税额12是小数点后2位28hsbz含税标志1是0 不含税1 含税29hjje合计金额12是小数点后2位，不含税30hjse合计税额12是小数点后2位31jshj加税合计12是小数点后2位32bz备注160否33skr收款

14、人16否34fhr复核人16否35kpr开票人20是36tzdbh信息表编号20否37yfpdm原发票代码10否38yfphm 原发票号码8否38qmcs签名参数16否3.3 返回数据响应报文：返回代码返回信息发票代码发票号码开票日期税控码校验码二维码参数说明：索引ID名称长度必须说明1id交易编号5是100082comment交易描述8是发票开具3yylxdm应用类型代码1是固定为“1”表示国税4returncode返回代码8是0成功，其它失败5returnmsg返回信息160是6jqbh税控服务器编号12否7fpdm发票代码12否8fphm发票号码8否9kprq开票日期14否YYYYMMDDHHMMSS10skm税控码112否4行，每行28个字符11jym校验码22否增值税普票有效，增值税专票固定为空12ewm二维码8192否电子发票有效4. 发票作废1.2 4.1 接口说明通过发票作废接口对已开具的问题发票和未开具的空白发票进行作废处理。已开发票作废要求发票当月开具且未抄报，空白发票作废要求从当前第一张未开具发票开始逐张顺序作废。4.2 请求数据请求报文：开票终端标识发票类型代码作废类型发票代码发票号码合计金额作废人参数说明：索引ID名称长度必须说明1id交易