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

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组件接口。2. 适用范围本接口规范仅适用于开票端通过组件接口ActiveX控件和Servlet接口方式访问税控开票服务器。第二章 接口调用方式本地接口提供ActiveX控件和DLL两种调用方式，接口列表见下表。序号接口ID接口说明其它说明120001参数设置本地接口220002税控钥匙信息查询本地接口310008发票开具本地接口410009发票作废本地接口510010发票查询本地接口610005发票领购信息查询本地接口720004发票打印本地接口820003打印页边距设置本地接口910004查询当前未开票号本地接口1010006发票领购信息分发本地接

3、口1110007发票领购信息退回本地接口1. 本地ActiveX组件调用n ActiveX组件文件名：NISEC_SKSCX.ocxn ActiveX组件GUID：CLASSID=clsid: 003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49Fn 函数定义：String Operate(string sInputInfo);参数： sInputInfo 输入XML信息返回值:返回结果XML字符串n 调用示例：ActiveX组件调用示例function SetParameter()var sInputInfo = rnrnrn192.168.0.1rn7001rn00000

4、000rnrn;alert(sInputInfo);try ret = sk.Operate(sInputInfo);alert(ret); catch(e) alert(e.message + ,errno: + e.number); function KeyQuery()var sInputInfo = rnrnrn00000000rnrn;alert(sInputInfo);try ret = sk.Operate(sInputInfo);alert(ret); catch(e) alert(e.message + ,errno: + e.number); ActiveX组件调用示例2.

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

6、置接口。1.2 请求数据请求报文：服务器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

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

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

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

10、00”不是“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（XX.XXX%）20spsm商

11、品税目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备注150否33skr收款人16否34fhr复核人16否35kpr开票人20是中文名称36tzdbh信息表编号20否37yfpdm原发票代码10否38yfphm 原发

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

13、16是开票终端唯一性标识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购货单位银行帐

14、号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位，不含税30hjse合计税额12是小数点后2位31jshj加税合计12是小数点后2位3

15、2bz备注160否33skr收款人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否9kp

16、rq开票日期14否YYYYMMDDHHMMSS10skm税控码112否4行，每行28个字符11jym校验码22否增值税普票有效，增值税专票固定为空12ewm二维码8192否电子发票有效4. 发票作废4.1 接口说明通过发票作废接口对已开具的问题发票和未开具的空白发票进行作废处理。已开发票作废要求发票当月开具且未抄报，空白发票作废要求从当前第一张未开具发票开始逐张顺序作废。4.2 请求数据请求报文：开票终端标识发票类型代码作废类型发票代码发票号码合计金额作废人参数说明：索引ID名称长度必须说明1id交易编号5是100092comment交易描述8是发票作废3yylxdm应用类型代码1是固定为“1

17、”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是6zflx作废类型1是0：空白票作废1：已开票作废7fpdm发票代码10是8fphm发票号码8是9hjje合计金额8否空白作废时为空10zfr作废人20是4.3 返回数据响应报文：返回代码返回信息发票代码发票号码作废日期参数说明：索引ID名称长度必须说明1id交易编号5是100092comment交易描述8是发票作废3yylxdm应用类型代码1是固定为“1”表示国税4returncode返回代码8是0成功，其它失败5returnmsg返回信息160是6fpdm发票代码10否7fphm发票号码8否8zfrq

18、作废日期14否格式YYYYMMDDHHMMSS5. 发票查询5.1 接口说明发票查询接口实现通过接口读取税控服务器发票开具明细信息，可用于发票补打。按开票日期查询时，仅提供查询一天内的发票明细；按发票段查询时，仅支持查询单张发票明细。5.2 请求数据请求报文：开票终端标识发票类型代码查询方式查询条件参数说明：索引ID名称长度必须说明1id交易编号5是100102comment交易描述8是发票查询3yylxdm应用类型代码1是固定为“1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是6cxfs查询方式1是0：按发票号码段查询1：按时间段查询7cxtj查询

19、条件是cxfs为0时：发票代码+发票起始号码+发票终止号码cxfs为1时：起始日期+终止日期YYYYMMDD5.3 返回数据响应报文：1. 增值税专用发票（发票类型代码：004）返回代码返回信息发票代码发票号码发票状态上传标志开票日期YYYYMMDDHHMMSS税控服务器编号税控码校验码销货单位识别号销货单位名称销货单位地址电话销货单位银行帐号购货单位识别号购货单位名称购货单位地址电话购货单位银行帐号发票行性质商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志发票行性质商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志税率金额税额综合税率合计金额合计税额价税合计备注收款人复

20、核人开票人加密版本号主要商品名称商品税目清单标志所属月份开票机号信息表编号原发票代码原发票号码作废日期作废人签名参数签名值已开负数金额2. 增值税普通发票（发票类型代码：007）格式同增值税专用发票6. 发票领购信息查询6.1 接口说明通过发票领购信息查询接口，获取税控服务器指定发票类型的发票领购信息。6.2 请求数据请求报文：开票终端标识发票类型代码参数说明：索引ID名称长度必须说明1id交易编号5是100052comment交易描述8是发票领购信息查询3yylxdm应用类型代码1是固定为“1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是“004”

21、增值税专用发票“007”增值税普通发票6.3 返回数据响应报文：返回代码返回信息当前未开发票代码当前未开发票号码总剩余份数发票代码起始号码终止号码发票份数剩余份数领购日期领购人员发票代码发票起始号码发票终止号码发票份数剩余份数领购日期领购人员参数说明：索引ID名称长度必须说明1id交易编号5是100052comment交易描述8是发票领购信息查询3yylxdm应用类型代码1是固定为“1”表示国税4returncode返回代码8是0成功，其它失败5returnmsg返回信息160是6dqfpdm当前未开发票代码20否7dqfphm当前未开发票号码12否8zsyfs总剩余份数12否9fpdm发票代

22、码10否10qshm发票起始号码8否11zzhm发票终止号码8否12fpfs发票份数8否13syfs剩余份数8否14lgrq领购日期8否格式YYYYMMDD15lgry领购人员20否7. 发票打印7.1 接口说明调用本地打印机完成发票打印操作。接口根据传入的发票代码和发票号码从税控服务器中提取发票明细数据并完成发票打印。7.2 请求数据请求报文：开票终端标识发票类型代码发票代码发票号码打印类型打印方式参数说明：索引ID名称长度必须说明1id交易编号5是200042comment交易描述30是发票打印3yylxdm应用类型代码1是固定为“1”表示国税4kpzdbs开票终端标识16是开票终端唯一性

23、标识5fplxdm发票类型代码3是6fpdm发票代码12是长度根据发票类型而不同，最长不超过12位7fphm发票号码8是8dylx打印类型1是0：发票打印1：清单打印9dyfs打印方式1是0：每次点击都弹出打印设置框1：只在第一次点击时弹出打印设置框7.3 返回数据响应报文：返回代码返回信息参数说明：索引ID名称长度必须说明1id交易编号5是200042comment交易描述30是发票打印3yylxdm应用类型代码1是固定为“1”表示国税4returncode返回代码8是0成功，其它失败5returnmsg返回信息160是8. 页边距设置8.1 接口说明根据发票种类设置发票打印页边距。8.2

24、请求数据请求报文：发票类型代码打印上边距打印左边距参数说明：索引ID名称长度必须说明1id交易编号5是200032comment交易描述30是打印页边距设置3yylxdm应用类型代码1是固定为“1”表示国税4fplxdm发票类型代码3是5top打印上边距5是整数，可正负6left打印左边距5是整数，可正负8.3 返回数据响应报文：返回代码返回信息参数说明：索引ID名称长度必须说明1id交易编号5是200032comment交易描述30是打印页边距设置3yylxdm应用类型代码1是固定为“1”表示国税4returncode返回代码8是0成功，其它失败5returnmsg返回信息160是9. 查询

25、当前未开票号9.1 接口说明查询指定开票终端的当前第一张未开具的发票代码和发票号码，发票开票和发票作废前调用。9.2 请求数据请求报文：开票终端标识发票类型代码参数说明：索引ID名称长度必须说明1id交易编号5是100042comment交易描述8是查询当前未开票号3yylxdm应用类型代码1是固定为“1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是“004”增值税专用发票“007”增值税普通发票9.3 返回数据响应报文：返回代码返回信息当前未开具发票代码当前未开具发票号码参数说明：索引ID名称长度必须说明1id交易编号5是100042comment交易描述8是查询当前未开票号3yylxdm应用类型代码1是固定为“1”表示国税4returncode返回代码8是0成功，