增值税管理系统百望接口样本.doc-资源下载-咨信网-让知识获取变得高效

增值税管理系统百望接口样本.doc

1、税控开票服务器组件接口规范 ( 标准版) 税控项目组 9月目录目录 2 第一章概述 3 1. 接口概述 3 2. 适用范围 3 第二章接口调用方式 4 1. 本地ActiveX组件调用 4 2. 本地DLL调用 6 第三章接口定义 6 1. 参数设置 6 2. 税控钥匙信息查询 7 3. 发票开具 9 4. 发票作废 15 5. 发票查询 17 6. 发票领购信息查询 20 7. 发票打印 22 8. 页边距设置 23 9. 查询当前未开票号 24 10. 发票领购信息

2、分发 26 11. 发票领购信息退回 27 第一章概述 1. 接口概述企业核心业务系统经过接口实现与税控开票服务器的通信, 完成发票管理、发票开具和税控服务器信息查询功能。接口根据调用方式的不同分为远程Servlet接口和本地ActiveX组件接口。 2. 适用范围本接口规范仅适用于开票端经过组件接口ActiveX控件和Servlet接口方式访问税控开票服务器。第二章接口调用方式本地接口提供ActiveX控件和DLL两种调用方式, 接口列表见下表。序号接口ID 接口说明其它说明 1 1 参数设置本地接口 2 2

3、税控钥匙信息查询本地接口 3 10008 发票开具本地接口 4 10009 发票作废本地接口 5 10010 发票查询本地接口 6 10005 发票领购信息查询本地接口 7 4 发票打印本地接口 8 3 打印页边距设置本地接口 9 10004 查询当前未开票号本地接口 10 10006 发票领购信息分发本地接口 11 10007 发票领购信息退回本地接口 1. 本地ActiveX组件调用 n ActiveX组件文件名: NISEC_SKSCX.ocx n ActiveX组件GUID:

4、 CLASSID="clsid: 003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F" n 函数定义: String Operate(string sInputInfo); 参数: sInputInfo 输入XML信息返回值: 返回结果XML字符串 n 调用示例: ActiveX组件调用示例

8、ody bgcolor=#f0f0ff>

2. 本地DLL调用 n DLL文件名: NISEC_SKSC.dll n 函数定义: void _stdcall PostAndRecvEx(IN LPSTR pszPost, OUT LPSTR pszRecv) 参数: pszPost 输入XML信息

10、 pszRecv 返回XML信息返回值: 无第三章接口定义接口中的xml数据项, 如无特殊说明, 遵从以下规则: n 金额字段单位统一为元, 小数点后精确到两位。 n 日期字段格式统一为”YYYYMMDD”。 1. 参数设置 1.1 接口说明参数设置接口完成服务器IP地址、端口号和税控钥匙口令的设置功能, 仅ActiveX接口提供该接口, 其它接口调用前必须首先调用参数设置接口。 1.2 请求数据请求报文:

11、ment="参数设置"> 服务器IP地址服务器端口号税控钥匙口令注册码参数说明: 索引 ID 名称长度必须说明 1 id 交易编号 5 是 1 2 comment 交易描述 30 是参数设置 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 servletip

12、税控开票服务器IP地址 15 是 5 servletport 税控开票服务器端口号 5 是 6 keypwd 税控钥匙口令 8 是 7 zcm 注册码 512 是 1.3 返回数据响应报文: 返回代码返回信息

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

14、请求报文: 88888888 参数说明: 索引 ID 名称长度必须说明 1 id 交易编号 5 是 2 2 comment 交易描述 30 是税控钥匙信息查询 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 keypwd 税控钥匙口令

15、 8 是 2.3 返回数据响应报文: 返回代码返回信息纳税人识别号税控钥匙编号参数说明: 索引 ID 名称

16、长度必须说明 1 id 交易编号 5 是 2 2 comment 交易描述 30 是税控钥匙信息查询 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 returncode 返回代码 8 是 0成功, 其它失败 5 returnmsg 返回信息 160 是 6 nsrsbh 纳税人识别号 20 否 7 keyno 税控钥匙编号 14 否前两位固定为”33” 3. 发票开具 1.1 3.1 接口说明发票开具接口实现发票的正数开具和负数开具, 开具成功后由税控服务器生

17、成税控码, 并由本地税控钥匙生成发票签名。该接口根据不同的发票类型, 参数定义不同。 3.2 请求数据 1. 增值税专用发票( 发票类型代码: 004) 请求报文: 开票终端标识发票类型代码发票请求流水号开票类型特殊票种标识

18、z> 销货单位识别号销货单位名称销货单位地址电话销货单位银行帐号购货单位识别号购货单位名称购货单位地址电话购货单位银行帐号清单标志发票行性质<

19、/fphxz> 商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志合计金额合计税额价税合计备注收款人复核人开票人

20、kpr> 信息表编号原发票代码原发票号码签名参数参数说明: 索引 ID 名称长度必须说明 1 id 交易编号 5 是 10008 2 comment 交易描述 8 是发票开具 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 kpzdbs 开票终端标识 16 是开票终端唯一性标识 5 fplxdm 发票类型代码 3 是

21、 6 kplx 开票类型 1 是 0: 正数票开具 1: 负数票开具 7 fpqqlsh 发票请求流水号 100 否如果为空就不校验, 有值就不能重复 8 tspz 特殊票种标识 2 是 ”00”不是 ”01”农产品销售 ”02”农产品收购 9 xhdwsbh 销货单位识别号 20 是与税控服务器保持一致 10 xhdwmc 销货单位名称 100 是与税控服务器保持一致 11 xhdwdzdh 销货单位地址电话 100 是 12 xhdwyhzh 销货单位银行账号 100 是 13 ghdw

22、sbh 购货单位识别号 20 是 14 ghdwmc 购货单位名称 100 是 15 ghdwdzdh 购货单位地址电话 100 是 16 ghdwyhzh 购货单位银行账号 100 是 17 qdbz 清单标志 1 是 0: 无清单 1: 带清单 18 fphxz 发票行性质 1 是 0 正常行 1 折扣行 2 被折扣行 19 spmc 商品名称 72 是折扣行商品名称规则: 折扣行数N( XX.XXX%) 20 spsm 商品税目 20 否保留字段, 当前为空 21 ggxh

23、规格型号 36 否 22 dw 单位 14 否 23 spsl 商品数量 12 否小数点后6位 24 dj 单价 12 否小数点后6位 25 je 金额 12 是小数点后2位, 正负 26 sl 税率 12 是小数点后2位 27 se 税额 12 是小数点后2位, 正负 28 hsbz 含税标志 1 是 0 不含税 1 含税 29 hjje 合计金额 12 是小数点后2位, 不含税, 正负 30 hjse 合计税额 12 是小数点后2位, 正负 31 j

24、shj 加税合计 12 是小数点后2位, 正负 32 bz 备注 150 否 33 skr 收款人 16 否 34 fhr 复核人 16 否 35 kpr 开票人 20 是中文名称 36 tzdbh 信息表编号 20 否 37 yfpdm 原发票代码 10 否 38 yfphm 原发票号码 8 否 38 qmcs 签名参数 16 否 2. 增值税普通发票( 发票类型代码: 007) 请求报文:

25、k"?> 开票终端标识发票类型代码发票请求流水号开票类型特殊票种标识销货单位识别号销货单位名称销货单位地址电话销货单位银行帐号

26、wsbh>购货单位识别号购货单位名称购货单位地址电话购货单位银行帐号清单标志发票行性质商品名称商品税目规格型号单位商品数量单价金额

27、税率税额含税标志合计金额合计税额价税合计备注收款人复核人开票人信息表编号原发票代码原发票号码签名参数参数说明: 索引

28、ID 名称长度必须说明 1 id 交易编号 5 是 10008 2 comment 交易描述 8 是发票开具 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 kpzdbs 开票终端标识 16 是开票终端唯一性标识 5 fplxdm 发票类型代码 3 是 6 fpqqlsh 发票请求流水号 100 否如果为空就不校验, 有值就不能重复 7 kplx 开票类型 1 是 0: 正数票开具 1: 负数票开具 8 tspz 特殊票种标识 2 是 ”00”不是 ”01

29、农产品销售 ”02”农产品收购 9 xhdwsbh 销货单位识别号 20 是与税控服务器保持一致 10 xhdwmc 销货单位名称 100 是与税控服务器保持一致 11 xhdwdzdh 销货单位地址电话 100 是 12 xhdwyhzh 销货单位银行帐号 100 是 13 ghdwsbh 购货单位识别号 20 否 14 ghdwmc 购货单位名称 100 是 15 ghdwdzdh 购货单位地址电话 100 否 16 ghdwyhzh 购货单位银行帐号 100 否 17

30、qdbz 清单标志 1 是 0: 无清单 1: 带清单 18 fphxz 发票行性质 1 是 0 正常行 1 折扣行 2 被折扣行 19 spmc 商品名称 72 是折扣行商品名称规则: 折扣行数N( XX.XXX%) 20 spsm 商品税目 20 否保留字段, 当前为空 21 ggxh 规格型号 36 否 22 dw 单位 14 否 23 spsl 商品数量 12 否小数点后6位 24 dj 单价 12 否小数点后6位 25 je 金额 12 是小数点后2位 26

31、 sl 税率 12 是小数点后2位 27 se 税额 12 是小数点后2位 28 hsbz 含税标志 1 是 0 不含税 1 含税 29 hjje 合计金额 12 是小数点后2位, 不含税 30 hjse 合计税额 12 是小数点后2位 31 jshj 加税合计 12 是小数点后2位 32 bz 备注 160 否 33 skr 收款人 16 否 34 fhr 复核人 16 否 35 kpr 开票人 20 是 36 tzdbh 信息表编号 20 否

32、 37 yfpdm 原发票代码 10 否 38 yfphm 原发票号码 8 否 38 qmcs 签名参数 16 否 3.3 返回数据响应报文: 返回代码返回信息发票代码发票号码

33、fphm> 开票日期税控码校验码二维码参数说明: 索引 ID 名称长度必须说明 1 id 交易编号 5 是 10008 2 comment 交易描述 8 是发票开具 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 returncode 返回代码 8 是 0成功, 其它失败 5 returnmsg 返回信息 160 是

34、 6 jqbh 税控服务器编号 12 否 7 fpdm 发票代码 12 否 8 fphm 发票号码 8 否 9 kprq 开票日期 14 否 YYYYMMDDHHMMSS 10 skm 税控码 112 否 4行, 每行28个字符 11 jym 校验码 22 否增值税普票有效, 增值税专票固定为空 12 ewm 二维码 8192 否电子发票有效 4. 发票作废 1.2 4.1 接口说明经过发票作废接口对已开具的问题发票和未开具的空白发票进行作废处理。已开发票作废要求发票当月开具且未抄报,

35、空白发票作废要求从当前第一张未开具发票开始逐张顺序作废。 4.2 请求数据请求报文: 开票终端标识发票类型代码作废类型发票代码发票号码合计金额作废人

36、ness> 参数说明: 索引 ID 名称长度必须说明 1 id 交易编号 5 是 10009 2 comment 交易描述 8 是发票作废 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 kpzdbs 开票终端标识 16 是开票终端唯一性标识 5 fplxdm 发票类型代码 3 是 6 zflx 作废类型 1 是 0: 空白票作废 1: 已开票作废 7 fpdm 发票代码 10 是 8 fphm 发票号码 8 是 9 hjje 合计金额 8

37、否空白作废时为空 10 zfr 作废人 20 是 4.3 返回数据响应报文: 返回代码返回信息发票代码发票号码作废日期

38、dy> 参数说明: 索引 ID 名称长度必须说明 1 id 交易编号 5 是 10009 2 comment 交易描述 8 是发票作废 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 returncode 返回代码 8 是 0成功, 其它失败 5 returnmsg 返回信息 160 是 6 fpdm 发票代码 10 否 7 fphm 发票号码 8 否 8 zfrq 作废日期 14 否格式YYYYMMDDHHMMSS

39、5. 发票查询 1.3 5.1 接口说明发票查询接口实现经过接口读取税控服务器发票开具明细信息, 可用于发票补打。按开票日期查询时, 仅提供查询一天内的发票明细; 按发票段查询时, 仅支持查询单张发票明细。 5.2 请求数据请求报文: 开票终端标识发票类型代码查询方式查询条

40、件参数说明: 索引 ID 名称长度必须说明 1 id 交易编号 5 是 10010 2 comment 交易描述 8 是发票查询 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 kpzdbs 开票终端标识 16 是开票终端唯一性标识 5 fplxdm 发票类型代码 3 是 6 cxfs 查询方式 1 是 0: 按发票号码段查询 1: 按时间段查询 7 cxtj 查询条件是 cxfs为0时: 发票代

41、码+发票起始号码+发票终止号码 cxfs为1时: 起始日期+终止日期 YYYYMMDD 5.3 返回数据响应报文: 1. 增值税专用发票( 发票类型代码: 004) 返回代码返回信息

42、dm>发票代码发票号码发票状态上传标志开票日期YYYYMMDDHHMMSS 税控服务器编号税控码校验码销货单位识别号销货单位名称销货单位地址电话销货单位银行帐号购货单位识别号

43、购货单位名称购货单位地址电话购货单位银行帐号发票行性质商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志

44、bz> 发票行性质商品名称商品税目规格型号单位商品数量单价金额税率税额含税标志税率<

45、/sl> 金额税额综合税率合计金额合计税额价税合计备注收款人复核人开票人加密版本号主要商品名称商品税目清单标志所属月份开票

46、机号信息表编号原发票代码原发票号码作废日期作废人签名参数签名值已开负数金额 2. 增值税普通发票( 发票类型代码: 007) 格式同增值税专用发票 6. 发票领购信息查询 1.4 6.1 接口说明经过发票领

47、购信息查询接口, 获取税控服务器指定发票类型的发票领购信息。 6.2 请求数据请求报文: 开票终端标识发票类型代码参数说明: 索引 ID 名称长度必须说明 1 id 交易编号 5 是 10005 2 comment 交易描述 8

48、是发票领购信息查询 3 yylxdm 应用类型代码 1 是固定为”1”表示国税 4 kpzdbs 开票终端标识 16 是开票终端唯一性标识 5 fplxdm 发票类型代码 3 是 ”004”增值税专用发票 ”007”增值税普通发票 6.3 返回数据响应报文: 返回代码返

49、回信息当前未开发票代码当前未开发票号码总剩余份数发票代码起始号码终止号码发票份数剩余份数领购日期领购人员

50、发票代码发票起始号码发票终止号码发票份数剩余份数领购日期领购人员参数说明: 索引 ID 名称长度必须说明 1 id 交易编号 5 是 10005 2 comment 交易描述 8 是发票领购信息查询 3 yylxdm 应用类型

邮箱/手机：
温馨提示：	快捷下载时，用户名和密码都是您填写的邮箱或者手机号，方便查询和重复下载（系统自动生成）。如填写123，账号就是123，密码也是123。
特别说明：	请自助下载，系统不会自动发送文件的哦；如果您已付费，想二次下载，请登录后访问：我的下载记录
支付方式：
验证码：	换一换

账号：
密码：
验证码：	换一换
当日自动登录忘记密码？