增值税管理系统-百望接口

1、税控开票服务器组件接口规范（标准版）税控项目组2015 年 9 月.目录目录2第一章概述31. 接口概述32. 适用范围3第二章接口调用方式41. 本地 ActiveX 组件调用42. 本地 DLL 调用6第三章接口定义61. 参数设置62. 税控钥匙信息查询73. 发票开具94. 发票作废155. 发票查询176. 发票领购信息查询207. 发票打印228. 页边距设置239. 查询当前未开票号2410. 发票领购信息分发2611. 发票领购信息退回27.第一章概述1. 接口概述企业核心业务系统通过接口实现与税控开票服务器的通信，完成发票管理、发票开具和税控服务器信息查询功能。 接口根据调用

2、方式的不同分为远程Servlet接口和本地 ActiveX 组件接口。企业核心业务系统远程 Servlet接口税控服务器税控开票服务器本地 ActiveX 组件开票终端2. 适用范围本接口规范仅适用于开票端通过组件接口ActiveX 控件和 Servlet接口方式访问税控开票服务器。.第二章接口调用方式本地接口提供 ActiveX 控件和 DLL 两种调用方式，接口列表见下表。序号接口 ID接口说明其它说明120001参数设置本地接口220002税控钥匙信息查询本地接口310008发票开具本地接口410009发票作废本地接口510010发票查询本地接口610005发票领购信息查询本地接口720

3、004发票打印本地接口820003打印页边距设置本地接口910004查询当前未开票号本地接口1010006发票领购信息分发本地接口1110007发票领购信息退回本地接口1. 本地 ActiveX 组件调用ActiveX 组件文件名： NISEC_SKSCX.ocxActiveX 组件 GUID：CLASSID=clsid: 003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F函数定义：String Operate(string sInputInfo);参数：sInputInfo输入 XML 信息返回值 :返回结果 XML 字符串调用示例：ActiveX组件调用示例funct

4、ion SetParameter().var sInputInfo =rnrnrn192.168.0.1rn7001rn00000000rnrn;alert(sInputInfo);tryret = sk.Operate(sInputInfo);alert(ret);catch(e)alert(e.message + ,errno: + e.number);function KeyQuery()varsInputInfo=rnrnrn00000000rnrn;alert(sInputInfo);tryret = sk.Operate(sInputInfo);alert(ret);catch(e

5、)alert(e.message + ,errno: + e.number);ActiveX组 件 调 用 示 例.2. 本地 DLL 调用DLL文件名： NISEC_SKSC.dll函数定义：void_stdcallPostAndRecvEx(INLPSTR pszPost,OUT LPSTR pszRecv)参数：pszPost输入 XML 信息pszRecv返回 XML 信息返回值 :无第三章接口定义接口中的 xml 数据项，如无特殊说明，遵从以下规则：金额字段单位统一为元，小数点后精确到两位。日期字段格式统一为“ YYYYMMDD”。1. 参数设置1.1 接口说明参数设置接口完成服务器

6、IP 地址、端口号和税控钥匙口令的设置功能，仅ActiveX 接口提供该接口，其它接口调用前必须首先调用参数设置接口。1.2 请求数据请求报文：服务器 IP 地址 服务器端口号税控钥匙口令 注册码 .参数说明：索ID名称长度必须说明引1id交易编号5是200012comment交易描述30是参数设置3yylxdm应用类型代码1是固定为“ 1”表示国税4servletip税控开票服务器15是IP 地址5servletport税控开票服务器5是端口号6keypwd税控钥匙口令8是7zcm注册码512是1.3 返回数据响应报文：返回代码 返回信息 参数说明：索ID名称长度必须说明引1id交易编号5是

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

8、令8是2.3 返回数据响应报文：返回代码 返回信息 纳税人识别号 税控钥匙编号参数说明：索ID名称长度必须说明引1id交易编号5是200022comment交易描述30是税控钥匙信息查询3yylxdm应用类型代码1是固定为“ 1”表示国税4returncode返回代码8是0 成功，其它失败5returnmsg返回信息160是6nsrsbh纳税人识别号20否7keyno税控钥匙编号14否前两位固定为“ 33”.3. 发票开具3.1 接口说明发票开具接口实现发票的正数开具和负数开具，开具成功后由税控服务器生成税控码，并由本地税控钥匙生成发票签名。该接口根据不同的发票类型，参数定义不同。3.2 请求

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

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

11、6ghdwyhzh购货单位银行账100是号17qdbz清单标志1是0：无清单1：带清单18fphxz发票行性质1是0 正常行1 折扣行2 被折扣行19spmc商品名称72是折扣行商品名称规则：折扣行数 N（XX.XXX%）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 位，不含税，正负3

12、0hjse合计税额12是小数点后 2 位，正负31jshj加税合计12是小数点后 2 位，正负32bz备注150否33skr收款人16否34fhr复核人16否35kpr开票人20是中文名称36tzdbh信息表编号20否37yfpdm原发票代码10否38yfphm原发票号码8否38qmcs签名参数16否.2. 增值税普通发票（发票类型代码： 007 ）请求报文：开票终端标识发票类型代码发票请求流水号开票类型 特殊票种标识销货单位识别号 销货单位名称销货单位地址电话销货单位银行帐号购货单位识别号 购货单位名称购货单位地址电话购货单位银行帐号 清单标志 发票行性质 商品名称 商品税目 规格型号 单位

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

14、单位识别号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（XX.XXX%）20spsm商品税目20否保留字段，目前为空21ggxh规格型号36否22d

15、w单位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收款人16否34fhr复核人16否35kpr开票人20是36tzdbh信息表编号20否37yfpdm原发票代码10否38yfphm原发票号码8否38qmcs签名参数16否3.3 返回数据响应报文：返回代码

16、 返回信息 发票代码 发票号码 开票日期 税控码 校验码 二维码 .参数说明：索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. 发票作废4.1

17、接口说明通过发票作废接口对已开具的问题发票和未开具的空白发票进行作废处理。已开发票作废要求发票当月开具且未抄报，空白发票作废要求从当前第一张未开具发票开始逐张顺序作废。4.2 请求数据请求报文：开票终端标识发票类型代码作废类型 发票代码 发票号码 合计金额 作废人 .参数说明：索ID名称长度必须说明引1id交易编号5是100092comment交易描述8是发票作废3yylxdm应用类型代码1是固定为“ 1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是6zflx作废类型1是0：空白票作废1：已开票作废7fpdm发票代码10是8fphm发票号码8是9hj

18、je合计金额8否空白作废时为空10zfr作废人20是4.3 返回数据响应报文：返回代码 返回信息 发票代码 发票号码 作废日期 参数说明：索ID名称长度必须说明引1id交易编号5是100092comment交易描述8是发票作废3yylxdm应用类型代码1是固定为“ 1”表示国税4returncode返回代码8是0 成功，其它失败5returnmsg返回信息160是6fpdm发票代码10否7fphm发票号码8否8zfrq作废日期14否格式 YYYYMMDDHHMMSS.5. 发票查询5.1 接口说明发票查询接口实现通过接口读取税控服务器发票开具明细信息，可用于发票补打。按开票日期查询时，仅提供查

19、询一天内的发票明细；按发票段查询时，仅支持查询单张发票明细。5.2 请求数据请求报文：开票终端标识发票类型代码查询方式 查询条件 参数说明：索ID名称长度必须说明引1id交易编号5是100102comment交易描述8是发票查询3yylxdm应用类型代码1是固定为“ 1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是6cxfs查询方式1是0：按发票号码段查询1：按时间段查询7cxtj查询条件是cxfs 为 0 时：发票代码 +发票起始号码 +发票终止号码cxfs 为 1 时：起始日期 +终止日期YYYYMMDD5.3 返回数据响应报文：.1. 增值税专

20、用发票（发票类型代码： 004 ）返回代码 返回信息 发票代码 发票号码 发票状态 上传标志 开票日期YYYYMMDDHHMMSS税控服务器编号 税控码 校验码 销货单位识别号 销货单位名称销货单位地址电话销货单位银行帐号购货单位识别号 购货单位名称购货单位地址电话购货单位银行帐号发票行性质 商品名称 商品税目 规格型号 单位 商品数量 单价 金额 税率 税额 含税标志 发票行性质 商品名称 商品税目 规格型号 单位 商品数量 单价 金额 .税率 税额 含税标志 税率 金额 税额 综合税率 合计金额 合计税额 价税合计 备注 收款人 复核人 开票人 加密版本号 主要商品名称 商品税目 清单标志 所属月份 开票机号 信息表编号 原发票代码 原发票号码 作废日期 作废人 签名参数 签名值 已开负数金额2. 增值税普通发票（发票类型代码： 007 ）格式同增值税专用发票.6. 发票领购信息查询6.1 接口说明通过发票领购信息查询接口，获取税控服务器指定发票类型的发票领购信息。6.2 请求数据请求报文： 开票终端标识发票类型代码参数说明：索ID名称长度必须说明引1id交易编号5是100052comment交易描述8是发票领购信息查询3yylxdm应用类型代码1是固定为“ 1”表示国税4k