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

1、税控开票服务器组件接口规（标准版）税控项目组2015年9月目录目录3第一章概述41. 接口概述42. 适用围 4第二章接口调用式51. 本地ActiveX组件调用52. 本地DLL调用7第三章接口定义81.参数设置82. 税控钥匙信息查询103. 发票开具114. 发票作废215. 发票查询236. 发票领购信息查询 277. 发票打印298. 页边距设置329. 查询当前未开票号3310. 发票领购信息分发3511. 发票领购信息退回37第一章概述1 接口概述企业核心业务系统通过接口实现与税控开票服务器的通信，完成发票管理、发票开具和税控服务器信息查询功能。接口根据调用式的不同分为远程Ser

2、vlet接口和本地ActivoX组件按口税控服务器企业核心业务系统税控开票服务器本地ActiveX组件开票终端2 适用围本接口规仅适用于开票端通过组件接口ActiveX控件和Servlet接口式访问税控开票服务器第二章接口调用式本地接口提供ActiveX控件和DLL两种调用式，接口列表见下表。序号接口 ID接口说明其它说明120001参数设置本地接口220002税控钥匙信息查询本地接口310008发票开具本地接口410009发票作废本地接口510010发票查询本地接口610005发票领购信息查询本地接口720004发票打印本地接口820003打印页边距设置本地接口910004查询当前未开票号本

3、地接口1010006发票领购信息分发本地接口1110007发票领购信息退回本地接口1 本地ActiveX组件调用ActiveX 组件文件名:NISEC_SKSCX.ocxActiveX 组件 GUID :CLASSID=nclsid:003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F函数定义：String Operate(string sinputlnfo); 参数：sinputlnfo 输入 XML 信息返回值：返回结果XML字符串调用示例：ActiveX 组件调用示例 fun ctio n SetParameter()var sin put Info =Mrnvbus

4、i nessid=”20001“comme nt=参数设置Vrnr * servletip192.168.0.1 r nv servletport7001 r * keypwd00000000r */bodyr */busi ness*;alert(s In putl nfo);tryret = sk.Operate(s In putl nfo); alert(ret);fun ctio n KeyQuery()var sin put Info = rn vbus in essid=V20002 comme nt=税控钥匙信息查询 *rnrn00000000r nrnJalert(s In p

5、utl nfo);tryret = sk.Operate(s In putl nfo);alert(ret);catch(e)alert(e.message + ”,err no:” + e.nu mber);ActiveX组件调用示例vinput type=Hbuttonvalue=参数设置”on click=SetParameter():x/td2本地DLL调用DLL 文件名：NISEC_SKSC.dll 函数定义:void _stdcall PostA ndRecvEx(IN LPSTR pszPost, OUT LPSTR pszRecv)参数：pszPost输入XML信息pszRec

6、v返回XML信息返回值：无第三章接口定义接口中的xml数据项，如无特殊说明，遵从以下规则：金额字段单位统一为元，小数点后精确到两位。日期字段格式统一为“ YYYYMMDD”。1 参数设置1.1接口说明参数设置接口完成服务器IP地址、端口号和税控钥匙口令的设置功能，仅ActiveX接口提供该接口，其它接口调用前必须首先调用参数设置接口。1.2请求数据请求报文： bus in ess id=20001 comme nt=参数设置” 服务器 IP 地址 v/servletip vservletport 服务器端口号 税控钥匙口令 注册码参数说明:索引ID名称长度必须说明1id交易编号5是200012

7、comme nt交易描述30是参数设置3yylxdm应用类型代码1是固定为“T表示国税4servletip税控开票服务器IP地址15是5servletport税控开票服务器端口号5是6keypwd税控钥匙口令8是7zcm注册码512是13返回数据响应报文：bus in ess id=20001 comme nt= 参数设置” 返回代码 返回信息 v/returnmsg 参数说明:索引ID名称长度必须说明1id交易编号5是200012comme nt交易描述30是获取服务器基本信息3yylxdm应用类型代码1是固定为“T表示国税4retur ncode返回代码8是0成功，其它失败5returnm

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

9、述30是税控钥匙信息查询3yylxdm应用类型代码1是固定为“T表示国税4retur ncode返回代码8是0成功，其它失败5returnmsg返回信息160是6n srsbh纳税人识别号20否7keyno税控钥匙编号14否前两位固定为u 333 发票开具3.1接口说明发票开具接口实现发票的正数开具和负数开具，开具成功后由税控服务器生成税控码，并由本地税控钥匙生成发票签名。该接口根据不同的发票类型，参数定义不同3.2请求数据1 增值税专用发票（发票类型代码：004）请求报文：bus in ess id=10008 comme nt=u 发票开具”开票终端标识v/kpzdbs 发票类型代码 发票

10、请求流水 号 开票类型 特殊票种标识 销货单位识别号v/xhdwsbh 销货单位名称v/xhdwmo 销货单位地址 销货单位银行 购货单位 识别号 购货单位名称 购货单位地址 购货单位银行 清单标志 发票行性质 商品名称 商品税目 规格型号 单位 商品数量 单价 金额 税率 税额 含税标志 合计金额 合计税额 vjshj 价税合计 备注 收款人 v/skr 复核人 开票人 v/kpr信息表编号 vyfpdm原发票代码v/yfpdm 原发票 vqmcs 签名参数 参数说明:索引ID名称长度必须说明1id交易编号5是100082comme nt交易描述8是发票开具3yylxdm应用类型代码1是固定

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

12、00是16ghdwyhzh购货单位银行账号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合计税额1

13、2是小数点后2位，正负31jshj加税合计12是小数点后2位，正负32bz备注150否33skr收款人16否34fhr复核人16否35kpr开票人20是中文名称36tzdbh信息表编号20否37yfpdm原发票代码10否38yfphm原发票8否38qmcs签名参数16否2增值税普通发票（发票类型代码：007）请求报文：bus in ess id=10008 comme nt=u发票开具、开票终端标识v/kpzdbs 发票类型代码 发票请求流水 号 开票类型 特殊票种标识 销货单位识别号v/xhdwsbh 销货单位名称v/xhdwmo 销货单位地址 销货单位银行 购货单位 识别号 购货单位名称

14、购货单位地址 购货单位银行 清单标志 发票行性质 商品名称 商品税 目 规格型号 单位 商品数量v/sps卜vdj单价 金额 税率 税额 含税标志 合计金额 合计税额 vjshj 价税合计 备注 收款人 v/skr 复核人 开票人 信息表编号 原发票代码v/yfpdm 原发票 vqmcs 签名参数 参数说明:索引ID名称长度必须说明1id交易编号5是100082comme nt交易描述8是发票开具3yylxdm应用类型代码1是固定为“T表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是6fpqqlsh发票请求流水号100否如果为空就不校验，有值就不能重复7

15、kplx开票类型1是0 :正数票开具1:负数票开具8tspz特殊票种标识2是u 00 55不是u 01 农产品销售u 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商品名称7

16、2是折扣行商品名称规则：折扌口行数 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位32bz备注160否33skr收款人16否34fhr复核人16否35kpr开票人20是36tzdbh信息表编号20否37yfpdm原发

17、票代码10否38yfphm原发票8否38qmcs签名参数16否3.3返回数据响应报文：bus in ess id=10008 comme nt=*发票开具” 返回代码 v/returncode 返回彳言息 发票代码 发票 开票日期 税控码 vjym 校验码 二维码 参数说明:索引ID名称长度必须说明1id交易编号5是100082comme nt交易描述8是发票开具3yylxdm应用类型代码1是固定为“T表示国税4retur ncode返回代码8是0成功，其它失败5returnmsg返回信息160是6jqbh税控服务器编号12否7fpdm发票代码12否8fphm8否9kprq开票日期14否YYY

18、YM MDDHHMMSS10skm税控码112否4行，每行28个字符11jym校验码22否增值税普票有效，增值税专票固定为空12ewm二维码819否电子发票有效24 发票作废4.1接口说明通过发票作废接口对已开具的问题发票和未开具的空白发票进行作废处理。已开发票作废要求发票当月开具且未抄报，空白发票作废要求从当前第一未开具发票开始逐顺序作废。4.2请求数据请求报文：bus in ess id=n10009 comme nt= 发票作废”开票终端标识发票类型代码 作废类型 发票代码 发票 合计金额 作废人 参数说明:索引ID名称长度必须说明1id交易编号5是100092comme nt交易描述8

19、是发票作废3yylxdm应用类型代码1是固定为U1,J表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是6zflx作废类型1是0 :空白票作废1:已开票作废7fpdm发票代码10是8fphm8是9hjje合计金额8否空白作废时为空10zfr作废人20是4.3返回数据响应报文：bus in ess id=u10009 comme nt= 发票作废” 返回代码 v/returncode 返回彳言息 发票代码 发票 vzfrq 作废日期 参数说明：索ID名称长度必须说明引1id交易编号5是100092comme nt交易描述8是发票作废3yylxdm应用类型代码

20、1是固定为“T表示国税4retur ncode返回代码8是0成功，其它失败5returnmsg返回信息160是6fpdm发票代码10否7fphm8否8zfrq作废日期14否格式YYYYM MDDHHMMSS5 发票查询5.1接口说明发票查询接口实现通过接口读取税控服务器发票开具明细信息，可用于发票补打。按开票日期查询时，仅提供查询一天的发票明细；按发票段查询时，仅支持查询单 发票明细。5.2请求数据请求报文：bus in ess id=10010 comme nt= 发票查询开票终端标识发票类型代码 查询式 查询条件 参数说明:索引ID名称长度必须说明1id交易编号5是100102comme

21、nt交易描述8是发票查询3yylxdm应用类型代码1是固定为“T表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是6cxfs查询式1是0：按发票段查询1:按时间段查询7cxtj查询条件是cxfs为0时：发票代码+发票起始+发票终止cxfs为1时：起始日期+终止日期YYYYMMDD5.3返回数据响应报文:1 增值税专用发票（发票类型代码：004）bus in ess id=u10010 comme nt= 发票查询、 返回代码 返回信息 发票代码 发票 发票状态 传标志开票日期 丫丫YYMMDDHHMMSSv/kprq vjqbh税控服务器编号 税控码 校验

22、码 销货单位识别号v/xhdwsbh 销货单位名称 销货单位地址 销货单位银行 购货单位识别号v/ghdwsbh 购货单位名称 购货单位地址 购货单位银行 vfyxm coun t=1* 发票行性质 商品名称 商 品税目 规格型号v/ggxh vdw单位 商品数量 单价 金额 税率 税额 含税标志 发票行性质 商品名称 商 品税目 规格型号v/ggxh vdw单位 商品数量 单价 金额 税率 税额 v/se 含税标志 vgroup xh=*1 税率 金额 税额 综合税率 合计金额 合计税额 v/hjse vjshj 价 税合计 备注 v/bz 收款人 复核人 v/fhr 开票 人 加密版本号

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

24、唯一性标识5fplxdm发票类型代码3是41 004 ”增值税专用发票u 007”增值税普通发票6.3返回数据响应报文： 返回代码 返回信息 当前未开发票代码当前未开发票总剩余份数 发票代码 起始 终止 发票份数 剩余份数 vlgrq 领购日期 领购人员 发票代码 发票起始 发票终止 v/zzhm 发票份数 剩余份数 vlgrq 领购日期 领购人员 参数说明：索说明ID名称长度必须引1id交易编号5是100052comme nt交易描述8是发票领购信息查询3yylxdm应用类型代码1是固定为“T表示国税4retur ncode返回代码8是0成功，其它失败5returnmsg返回信息160是6d

25、qfpdm当前未开发票代码20否7dqfphm当前未开发票12否8zsyfs总剩余份数12否9fpdm发票代码10否10qshm发票起始8否11zzhm发票终止8否12fpfs发票份数8否13syfs剩余份数8否14Igrq领购日期8否格式 YYYYMMDD15Igry领购人员20否7 发票打印7.1扌妾口说明接口根据传入的发票代码和发票从税控服务器中提取发票调用本地打印机完成发票打印操作。 明细数据并完成发票打印。7.2请求数据请求报文:ebusiness id=H20004comment=发票打印”开票终端标识 发票类型代码 发票代码 发票 打印类型 打印式 参数说明:索引ID名称长度必须

26、说明1id交易编号5是200042comme nt交易描述30是发票打印3yylxdm应用类型代码1是固定为“T表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fplxdm发票类型代码3是6fpdm发票代码12是长度根据发票类型而不 同，最长不超过12位7fphm8是8dylx打印类型1是0 :发票打印1 :清单打印9dyfs打印式1是0 :每次点击都弹出打印设置框1:只在第一次点击时弹出打印设置框7.3返回数据响应报文:bus in ess id=20004M comme nt= 发票打印” 返回代码 返回信息 v/retummsg 参数说明:索引ID名称长度必须说明1id交易编

27、号5是200042comme nt交易描述30是发票打印3yylxdm应用类型代码1是固定为“仁表示国税4retur ncode返回代码8是0成功，其它失败5returnmsg返回信息160是8 页边距设置8.1接口说明根据发票种类设置发票打印页边距8.2请求数据请求报文：bus in ess id=20003 comme nt=页边距设置、发票类型代码打印上边距打印左边距参数说明:索引ID名称长度必须说明1id交易编号5是200032comme nt交易描述30是打印页边距设置3yylxdm应用类型代码1是固定为“仁表示国税4fplxdm发票类型代码3是5top打印上边距5是整数，可正负6l

28、eft打印左边距5是整数，可正负8.3返回数据响应报文:bus in ess id=20003 comme nt= 页边距设置” 返回代码 返回彳言息 参数说明:索引ID名称长度必须说明1id交易编号5是200032comme nt交易描述30是打印页边距设置3yylxdm应用类型代码1是固定为“仁表示国税4retur ncode返回代码8是0成功，其它失败5returnmsg返回信息160是9 查询当前未开票号9.1接口说明查询指定开票终端的当前第一未开具的发票代码和发票，发票开票和发票作废前调 用。9.2请求数据请求报文：开票终端标识发票类型代码 参数说明:索引ID名称长度必须说明1id交易编号5是100042comme nt交易描述8是查询当前未开票号3yyl