《增值税管理系统-百望接口.doc》由会员分享，可在线阅读，更多相关《增值税管理系统-百望接口.doc（35页珍藏版）》请在课桌文档上搜索。
1、-目录目录2第一章 概述31. 接口概述32. 适用围3第二章 接口调用式41. 本地Active*组件调用42. 本地DLL调用6第三章 接口定义61. 参数设置62. 税控钥匙信息查询73. 发票开具94. 发票作废155. 发票查询176. 发票领购信息查询207. 发票打印228. 页边距设置239. 查询当前未开票号2410. 发票领购信息分发2611. 发票领购信息退回27第一章 概述1. 接口概述企业核心业务系统通过接口实现与税控开票服务器的通信，完成发票管理、发票开具和税控服务器信息查询功能。接口根据调用式的不同分为远程Servlet接口和本地Active*组件接口。2. 适用
2、围本接口规仅适用于开票端通过组件接口Active*控件和Servlet接口式访问税控开票服务器。第二章 接口调用式本地接口提供Active*控件和DLL两种调用式，接口列表见下表。序号接口ID接口说明其它说明120001参数设置本地接口220002税控钥匙信息查询本地接口310008发票开具本地接口410009发票作废本地接口510010发票查询本地接口610005发票领购信息查询本地接口720004发票打印本地接口820003打印页边距设置本地接口910004查询当前未开票号本地接口1010006发票领购信息分发本地接口1110007发票领购信息退回本地接口1. 本地Active*组件调用n
3、 Active*组件文件名：NISEC_SKSC*.oc*n Active*组件GUID：CLASSID=clsid: 003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49Fn 函数定义：String Operate(string sInputInfo);参数： sInputInfo 输入*ML信息返回值:返回结果*ML字符串n 调用示例：Active*组件调用示例function SetParameter()var sInputInfo = rnrnrn192.168.0.1rn7001rn00000000rnrn;alert(sInputInfo);try ret = s
4、k.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); Active*组件调用示例2. 本地DLL调用n DLL文件名：NISEC_SKSC.dlln 函数定义
5、：void _stdcall PostAndRecvE*(IN LPSTR pszPost, OUT LPSTR pszRecv)参数： pszPost 输入*ML信息 pszRecv 返回*ML信息返回值: 无第三章 接口定义接口中的*ml数据项，如无特殊说明，遵从以下规则：n 金额字段单位统一为元，小数点后精确到两位。n 日期字段格式统一为YYYYMMDD”。1. 参数设置1.1 接口说明参数设置接口完成服务器IP地址、端口号和税控钥匙口令的设置功能，仅Active*接口提供该接口，其它接口调用前必须首先调用参数设置接口。1.2 请求数据请求报文：服务器IP地址服务器端口号税控钥匙口令注册
6、码参数说明：索引ID名称长度必须说明1id交易编号5是200012ment交易描述30是参数设置3yyl*dm应用类型代码1是固定为1”表示国税4servletip税控开票服务器IP地址15是5servletport税控开票服务器端口号5是6keypwd税控钥匙口令8是7zcm注册码512是1.3 返回数据响应报文：返回代码返回信息参数说明：索引ID名称长度必须说明1id交易编号5是200012ment交易描述30是获取服务器基本信息3yyl*dm应用类型代码1是固定为1”表示国税4returncode返回代码8是0成功，其它失败5returnmsg返回信息160是2. 税控钥匙信息查询2.1
7、 接口说明提供查询税控钥匙基本信息的接口，主要查询企业纳税人识别号和税控钥匙编号。仅本地组件接口提供该接口，需要保证税控钥匙与本地电脑连接正常。2.2 请求数据请求报文：88888888参数说明：索引ID名称长度必须说明1id交易编号5是200022ment交易描述30是税控钥匙信息查询3yyl*dm应用类型代码1是固定为1”表示国税4keypwd税控钥匙口令8是2.3 返回数据响应报文：返回代码返回信息纳税人识别号税控钥匙编号参数说明：索引ID名称长度必须说明1id交易编号5是200022ment交易描述30是税控钥匙信息查询3yyl*dm应用类型代码1是固定为1”表示国税4returnco
8、de返回代码8是0成功，其它失败5returnmsg返回信息160是6nsrsbh纳税人识别号20否7keyno税控钥匙编号14否前两位固定为33”3. 发票开具3.1 接口说明发票开具接口实现发票的正数开具和负数开具，开具成功后由税控服务器生成税控码，并由本地税控钥匙生成发票签名。该接口根据不同的发票类型，参数定义不同。3.2 请求数据1. 增值税专用发票（发票类型代码：004）请求报文：开票终端标识发票类型代码发票请求流水号开票类型特殊票种标识销货单位识别号销货单位名称销货单位地址销货单位银行购货单位识别号购货单位名称购货单位地址购货单位银行清单标志发票行性质商品名称商品税目规格型号单位商
9、品数量单价金额税率税额含税标志合计金额合计税额价税合计备注收款人复核人开票人信息表编号原发票代码原发票签名参数参数说明：索引ID名称长度必须说明1id交易编号5是100082ment交易描述8是发票开具3yyl*dm应用类型代码1是固定为1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fpl*dm发票类型代码3是6kpl*开票类型1是0：正数票开具1：负数票开具7fpqqlsh发票请求流水号100否如果为空就不校验，有值就不能重复8tspz特殊票种标识2是00”不是01”农产品销售02”农产品收购9*hdwsbh销货单位识别号20是与税控服务器保持一致10*hdwmc销货单位名
10、称100是与税控服务器保持一致11*hdwdzdh销货单位地址100是12*hdwyhzh销货单位银行账号100是13ghdwsbh购货单位识别号20是14ghdwmc购货单位名称100是15ghdwdzdh购货单位地址100是16ghdwyhzh购货单位银行账号100是17qdbz清单标志1是0：无清单1：带清单18fph*z发票行性质1是0 正常行1 折扣行2 被折扣行19spmc商品名称72是折扣行商品名称规则：折扣行数N（*.*%）20spsm商品税目20否保留字段，目前为空21gg*h规格型号36否22dw单位14否23spsl商品数量12否小数点后6位24dj单价12否小数点后6位
11、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否38qmcs签名参数16否2. 增值税普通发票（发票类型代码：007）请求报文：开票终端标识发票类型代码发票请求流水号开票类型特殊票种标
12、识销货单位识别号销货单位名称销货单位地址销货单位银行购货单位识别号购货单位名称购货单位地址购货单位银行清单标志发票行性质商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志合计金额合计税额价税合计备注收款人复核人开票人信息表编号原发票代码原发票签名参数参数说明：索引ID名称长度必须说明1id交易编号5是100082ment交易描述8是发票开具3yyl*dm应用类型代码1是固定为1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fpl*dm发票类型代码3是6fpqqlsh发票请求流水号100否如果为空就不校验，有值就不能重复7kpl*开票类型1是0：正数票开具1：负数票开具
13、8tspz特殊票种标识2是00”不是01”农产品销售02”农产品收购9*hdwsbh销货单位识别号20是与税控服务器保持一致10*hdwmc销货单位名称100是与税控服务器保持一致11*hdwdzdh销货单位地址100是12*hdwyhzh销货单位银行100是13ghdwsbh购货单位识别号20否14ghdwmc购货单位名称100是15ghdwdzdh购货单位地址100否16ghdwyhzh购货单位银行100否17qdbz清单标志1是0：无清单1：带清单18fph*z发票行性质1是0 正常行1 折扣行2 被折扣行19spmc商品名称72是折扣行商品名称规则：折扣行数N（*.*%）20spsm商
14、品税目20否保留字段，目前为空21gg*h规格型号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原发票代码10否38yfphm 原发票8否38qmcs签名参数16否3.3
15、 返回数据响应报文：返回代码返回信息发票代码发票开票日期税控码校验码二维码参数说明：索引ID名称长度必须说明1id交易编号5是100082ment交易描述8是发票开具3yyl*dm应用类型代码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 接口说明通过发票
16、作废接口对已开具的问题发票和未开具的空白发票进行作废处理。已开发票作废要求发票当月开具且未抄报，空白发票作废要求从当前第一未开具发票开始逐顺序作废。4.2 请求数据请求报文：开票终端标识发票类型代码作废类型发票代码发票合计金额作废人参数说明：索引ID名称长度必须说明1id交易编号5是100092ment交易描述8是发票作废3yyl*dm应用类型代码1是固定为1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fpl*dm发票类型代码3是6zfl*作废类型1是0：空白票作废1：已开票作废7fpdm发票代码10是8fphm发票8是9hjje合计金额8否空白作废时为空10zfr作废人20
17、是4.3 返回数据响应报文：返回代码返回信息发票代码发票作废日期参数说明：索引ID名称长度必须说明1id交易编号5是100092ment交易描述8是发票作废3yyl*dm应用类型代码1是固定为1”表示国税4returncode返回代码8是0成功，其它失败5returnmsg返回信息160是6fpdm发票代码10否7fphm发票8否8zfrq作废日期14否格式YYYYMMDDHHMMSS5. 发票查询5.1 接口说明发票查询接口实现通过接口读取税控服务器发票开具明细信息，可用于发票补打。按开票日期查询时，仅提供查询一天的发票明细；按发票段查询时，仅支持查询单发票明细。5.2 请求数据请求报文：开
18、票终端标识发票类型代码查询式查询条件参数说明：索引ID名称长度必须说明1id交易编号5是100102ment交易描述8是发票查询3yyl*dm应用类型代码1是固定为1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fpl*dm发票类型代码3是6c*fs查询式1是0：按发票段查询1：按时间段查询7c*tj查询条件是c*fs为0时：发票代码+发票起始+发票终止c*fs为1时：起始日期+终止日期YYYYMMDD5.3 返回数据响应报文：1. 增值税专用发票（发票类型代码：004）返回代码返回信息发票代码发票发票状态上传标志开票日期YYYYMMDDHHMMSS税控服务器编号税控码校验码销
19、货单位识别号销货单位名称销货单位地址销货单位银行购货单位识别号购货单位名称购货单位地址购货单位银行发票行性质商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志发票行性质商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志税率金额税额综合税率合计金额合计税额价税合计备注收款人复核人开票人加密版本号主要商品名称商品税目清单标志所属月份开票机号信息表编号原发票代码原发票作废日期作废人签名参数签名值已开负数金额2. 增值税普通发票（发票类型代码：007）格式同增值税专用发票6. 发票领购信息查询6.1 接口说明通过发票领购信息查询接口，获取税控服务器指定发票类型的发票领购信息。6.2
20、 请求数据请求报文：开票终端标识发票类型代码参数说明：索引ID名称长度必须说明1id交易编号5是100052ment交易描述8是发票领购信息查询3yyl*dm应用类型代码1是固定为1”表示国税4kpzdbs开票终端标识16是开票终端唯一性标识5fpl*dm发票类型代码3是004”增值税专用发票007”增值税普通发票6.3 返回数据响应报文：返回代码返回信息当前未开发票代码当前未开发票总剩余份数发票代码起始终止发票份数剩余份数领购日期领购人员发票代码发票起始发票终止发票份数剩余份数领购日期领购人员参数说明：索引ID名称长度必须说明1id交易编号5是100052ment交易描述8是发票领购信息查询3yyl*dm应用类型代码1是固定为1”表示国税4returncode返回代码8是0成功，其它失败5returnmsg返回信息160是6dqfpdm当前未开发票代码20否7dqfphm当前未开发票12否8zsyfs总剩余份数12否9fpdm发票代码10否10qshm发票起始8否11zzhm发票终止8否12fpfs发票份数8否13syfs剩余份数8否14lgrq领购日期8否格式YYYYMMDD15lgry领购人员20否7. 发票打印7.1 接口说明调用本地打印
