admin管理员组文章数量:1530842
2024年7月2日发(作者:)
税控开票服务器组件接口规范
(标准版)
税控项目组
税控开票服务器组件接口规范
目录
目录 .................................................................................................................................................. 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. 发票领购信息分发 .......................................................................................................... 26
11. 发票领购信息退回 .......................................................................................................... 27
税控开票服务器组件接口规范
第一章 概述
1. 接口概述
企业核心业务系统通过接口实现与税控开票服务器的通信,完成发票管理、
发票开具和税控服务器信息查询功能。接口根据调用方式的不同分为远程Servlet
接口和本地ActiveX组件接口。
企业核心业务系统
远程Servlet接口
税控服务器
税控开票服务器
本地ActiveX组件
开票终端
2. 适用范围
本接口规范仅适用于开票端通过组件接口ActiveX控件和
Servlet
接口方式
访问税控开票服务器。
税控开票服务器组件接口规范
第二章 接口调用方式
本地接口提供ActiveX控件和DLL两种调用方式,接口列表见下表。
序号 接口ID
1
2
3
4
5
6
7
8
9
10
11
20001
20002
10008
10009
10010
10005
20004
20003
10004
10006
10007
接口说明
参数设置
税控钥匙信息查询
发票开具
发票作废
发票查询
发票领购信息查询
发票打印
打印页边距设置
查询当前未开票号
发票领购信息分发
发票领购信息退回
其它说明
本地接口
本地接口
本地接口
本地接口
本地接口
本地接口
本地接口
本地接口
本地接口
本地接口
本地接口
1. 本地ActiveX组件调用
ActiveX组件文件名:NISEC_
ActiveX组件GUID:
CLASSID="clsid: 003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F"
函数定义:
String Operate(string sInputInfo);
参数:
sInputInfo
输入
XML
信息
返回值
:
返回结果
XML
字符串
调用示例:
组件调用示例
税控开票服务器组件接口规范
2. 本地DLL调用
DLL文件名:NISEC_
函数定义:
void _stdcall PostAndRecvEx(IN LPSTR pszPost, OUT LPSTR pszRecv)
参数:
pszPost
输入
XML
信息
pszRecv
返回
XML
信息
返回值
:
无
第三章 接口定义
接口中的xml数据项,如无特殊说明,遵从以下规则:
金额字段单位统一为元,小数点后精确到两位。
日期字段格式统一为“YYYYMMDD”。
1. 参数设置
1.1 接口说明
参数设置接口完成服务器IP地址、端口号和税控钥匙口令的设置功能,仅
ActiveX接口提供该接口,其它接口调用前必须首先调用参数设置接口。
1.2 请求数据
请求报文:
">
服务器
IP
地址
服务器端口号
税控钥匙口令
注册码
税控开票服务器组件接口规范
参数说明:
索
引
1
2
3
4
5
6
7
ID
id
comment
yylxdm
servletip
名称 长度 必须 说明
5
30
1
15
5
是
是
是
是
是
20001
参数设置
固定为“1”表示国税
交易编号
交易描述
应用类型代码
税控开票服务器
IP地址
servletport 税控开票服务器
端口号
keypwd 税控钥匙口令
zcm 注册码
8 是
512 是
1.3 返回数据
响应报文:
">
返回代码
返回信息
参数说明:
索
引
1
2
3
4
5
ID
id
comment
yylxdm
returncode
returnmsg
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
长度 必须 说明
5
30
1
8
160
是
是
是
是
是
20001
获取服务器基本信息
固定为“1”表示国税
0成功,其它失败
2. 税控钥匙信息查询
2.1 接口说明
提供查询税控钥匙基本信息的接口,主要查询企业纳税人识别号和税控钥匙
编号。仅本地组件接口提供该接口,需要保证税控钥匙与本地电脑连接正常。
税控开票服务器组件接口规范
2.2 请求数据
请求报文:
">
参数说明:
索
引
1
2
3
4
ID
id
comment
yylxdm
keypwd
名称
交易编号
交易描述
应用类型代码
税控钥匙口令
长度 必须 说明
5
30
1
8
是
是
是
是
20002
税控钥匙信息查询
固定为“1”表示国税
2.3 返回数据
响应报文:
">
返回代码
返回信息
纳税人识别号
税控钥匙编号
参数说明:
索
引
1
2
3
4
5
6
7
ID
id
comment
yylxdm
returncode
returnmsg
nsrsbh
keyno
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
纳税人识别号
税控钥匙编号
长度 必须 说明
5
30
1
8
160
20
14
是
是
是
是
是
否
否
20002
税控钥匙信息查询
固定为“1”表示国税
0成功,其它失败
前两位固定为“33”
税控开票服务器组件接口规范
3. 发票开具
3.1 接口说明
发票开具接口实现发票的正数开具和负数开具,开具成功后由税控服务器生
成税控码,并由本地税控钥匙生成发票签名。该接口根据不同的发票类型,参数
定义不同。
3.2 请求数据
1. 增值税专用发票(发票类型代码:004)
请求报文:
">
开票终端标识
发票类型代码
发票请求流水号
开票类型
特殊票种标识
销货单位识别号
销货单位名称
销货单位地址电话
销货单位银行帐号
税控开票服务器组件接口规范
购货单位识别号
购货单位名称
购货单位地址电话
购货单位银行帐号
清单标志
发票行性质
商品名称
商品税目
规格型号
单位
商品数量
单价
金额
税率
税额
含税标志
合计金额
合计税额
价税合计
备注
收款人
复核人
开票人
信息表编号
原发票代码
原发票号码
签名参数
参数说明:
索
引
1
2
3
4
5
6
7
8
ID
id
comment
yylxdm
kpzdbs
fplxdm
kplx
fpqqlsh
名称
交易编号
交易描述
应用类型代码
开票终端标识
发票类型代码
开票类型
发票请求流水号
长度 必须 说明
5
8
1
16
3
1
是
是
是
是
是
是
10008
发票开具
固定为“1”表示国税
开票终端唯一性标识
0:正数票开具
1:负数票开具
如果为空就不校验,有值
就不能重复
“00”不是
“01”农产品销售
“02”农产品收购
100 否
2 是 tspz 特殊票种标识
税控开票服务器组件接口规范
9
10
11
12
13
14
15
16
17
18
xhdwsbh
xhdwmc
xhdwdzdh
xhdwyhzh
ghdwsbh
ghdwmc
ghdwdzdh
ghdwyhzh
qdbz
fphxz
销货单位识别号
销货单位名称
销货单位地址电
话
销货单位银行账
号
购货单位识别号
购货单位名称
购货单位地址电
话
购货单位银行账
号
清单标志
发票行性质
20 是
100 是
100 是
100 是
20 是
100 是
100 是
100 是
1
1
是
是
与税控服务器保持一致
与税控服务器保持一致
0:无清单
1:带清单
0 正常行
1 折扣行
2 被折扣行
折扣行商品名称规则:折
扣行数N(%)
保留字段,目前为空
小数点后6位
小数点后6位
小数点后2位,正负
小数点后2位
小数点后2位,正负
0 不含税
1 含税
小数点后2位,不含税,
正负
小数点后2位,正负
小数点后2位,正负
中文名称
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
38
spmc
spsm
ggxh
dw
spsl
dj
je
sl
se
hsbz
hjje
hjse
jshj
bz
skr
fhr
kpr
tzdbh
yfpdm
yfphm
qmcs
商品名称
商品税目
规格型号
单位
商品数量
单价
金额
税率
税额
含税标志
合计金额
合计税额
加税合计
备注
收款人
复核人
开票人
信息表编号
原发票代码
原发票号码
签名参数
72
20
36
14
12
12
12
12
12
1
12
12
12
150
16
16
20
20
10
8
16
是
否
否
否
否
否
是
是
是
是
是
是
是
否
否
否
是
否
否
否
否
税控开票服务器组件接口规范
2. 增值税普通发票(发票类型代码:007)
请求报文:
">
开票终端标识
发票类型代码
发票请求流水号
开票类型
特殊票种标识
销货单位识别号
销货单位名称
销货单位地址电话
销货单位银行帐号
购货单位识别号
购货单位名称
购货单位地址电话
购货单位银行帐号
清单标志
发票行性质
商品名称
商品税目
规格型号
单位
商品数量
单价
税控开票服务器组件接口规范
金额
税率
税额
含税标志
合计金额
合计税额
价税合计
备注
收款人
复核人
开票人
信息表编号
原发票代码
原发票号码
签名参数
参数说明:
索
引
1
2
3
4
5
6
7
8
ID
id
comment
yylxdm
kpzdbs
fplxdm
fpqqlsh
kplx
tspz
名称
交易编号
交易描述
应用类型代码
开票终端标识
发票类型代码
发票请求流水号
开票类型
特殊票种标识
长度 必须 说明
5
8
1
16
3
100
1
2
是
是
是
是
是
否
是
是
10008
发票开具
固定为“1”表示国税
开票终端唯一性标识
如果为空就不校验,有值
就不能重复
0:正数票开具
1:负数票开具
“00”不是
“01”农产品销售
“02”农产品收购
与税控服务器保持一致
与税控服务器保持一致
0:无清单
9
10
11
12
13
14
15
16
17
xhdwsbh
xhdwmc
xhdwdzdh
xhdwyhzh
ghdwsbh
ghdwmc
ghdwdzdh
ghdwyhzh
qdbz
销货单位识别号
销货单位名称
销货单位地址电
话
销货单位银行帐
号
购货单位识别号
购货单位名称
购货单位地址电
话
购货单位银行帐
号
清单标志
20 是
100 是
100 是
100 是
20 否
100 是
100 否
100 否
1 是
税控开票服务器组件接口规范
18 fphxz 发票行性质 1 是
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
38
spmc
spsm
ggxh
dw
spsl
dj
je
sl
se
hsbz
hjje
hjse
jshj
bz
skr
fhr
kpr
tzdbh
yfpdm
yfphm
qmcs
商品名称
商品税目
规格型号
单位
商品数量
单价
金额
税率
税额
含税标志
合计金额
合计税额
加税合计
备注
收款人
复核人
开票人
信息表编号
原发票代码
原发票号码
签名参数
72
20
36
14
12
12
12
12
12
1
12
12
12
160
16
16
20
20
10
8
16
是
否
否
否
否
否
是
是
是
是
是
是
是
否
否
否
是
否
否
否
否
1:带清单
0 正常行
1 折扣行
2 被折扣行
折扣行商品名称规则:折
扣行数N(%)
保留字段,目前为空
小数点后6位
小数点后6位
小数点后2位
小数点后2位
小数点后2位
0 不含税
1 含税
小数点后2位,不含税
小数点后2位
小数点后2位
3.3 返回数据
响应报文:
">
返回代码
返回信息
发票代码
发票号码
开票日期
税控码
校验码
二维码
税控开票服务器组件接口规范
参数说明:
索
引
1
2
3
4
5
6
7
8
9
10
11
12
ID
id
comment
yylxdm
returncode
returnmsg
jqbh
fpdm
fphm
kprq
skm
jym
ewm
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
税控服务器编号
发票代码
发票号码
开票日期
税控码
校验码
二维码
长度 必须 说明
5
8
1
8
160
12
12
8
14
112
22
是
是
是
是
是
否
否
否
否
否
否
10008
发票开具
固定为“1”表示国税
0成功,其它失败
YYYYMMDDHHMMSS
4行,每行28个字符
增值税普票有效,增值税
专票固定为空
电子发票有效 8192 否
4. 发票作废
4.1 接口说明
通过发票作废接口对已开具的问题发票和未开具的空白发票进行作废处理。
已开发票作废要求发票当月开具且未抄报,空白发票作废要求从当前第一张未开
具发票开始逐张顺序作废。
4.2 请求数据
请求报文:
">
开票终端标识
发票类型代码
作废类型
发票代码
发票号码
合计金额
作废人
税控开票服务器组件接口规范
参数说明:
索
引
1
2
3
4
5
6
7
8
9
10
ID
id
comment
yylxdm
kpzdbs
fplxdm
zflx
fpdm
fphm
hjje
zfr
名称
交易编号
交易描述
应用类型代码
开票终端标识
发票类型代码
作废类型
发票代码
发票号码
合计金额
作废人
长度 必须 说明
5
8
1
16
3
1
10
8
8
20
是
是
是
是
是
是
是
是
否
是
10009
发票作废
固定为“1”表示国税
开票终端唯一性标识
0:空白票作废
1:已开票作废
空白作废时为空
4.3 返回数据
响应报文:
">
返回代码
返回信息
发票代码
发票号码
作废日期
参数说明:
索
引
1
2
3
4
5
6
7
8
ID
id
comment
yylxdm
returncode
returnmsg
fpdm
fphm
zfrq
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
发票代码
发票号码
作废日期
长度 必须 说明
5
8
1
8
160
10
8
14
是
是
是
是
是
否
否
否
10009
发票作废
固定为“1”表示国税
0成功,其它失败
格式YYYYMMDDHHMMSS
税控开票服务器组件接口规范
5. 发票查询
5.1 接口说明
发票查询接口实现通过接口读取税控服务器发票开具明细信息,可用于发票
补打。按开票日期查询时,仅提供查询一天内的发票明细;按发票段查询时,仅
支持查询单张发票明细。
5.2 请求数据
请求报文:
">
开票终端标识
发票类型代码
查询方式
查询条件
参数说明:
索
引
1
2
3
4
5
6
7
ID
id
comment
yylxdm
kpzdbs
fplxdm
cxfs
cxtj
名称
交易编号
交易描述
应用类型代码
开票终端标识
发票类型代码
查询方式
查询条件
长度 必须 说明
5
8
1
16
3
1
是
是
是
是
是
是
是
10010
发票查询
固定为“1”表示国税
开票终端唯一性标识
0:按发票号码段查询
1:按时间段查询
cxfs为0时:
发票代码+发票起始号码+
发票终止号码
cxfs为1时:
起始日期+终止日期
YYYYMMDD
5.3 返回数据
响应报文:
税控开票服务器组件接口规范
1. 增值税专用发票(发票类型代码:004)
">
返回代码
返回信息
发票代码
发票号码
发票状态
上传标志
开票日期
YYYYMMDDHHMMSS
税控服务器编号
税控码
校验码
销货单位识别号
销货单位名称
销货单位地址电话
销货单位银行帐号
购货单位识别号
购货单位名称
购货单位地址电话
购货单位银行帐号
发票行性质
商品名称
商品税目
规格型号
单位
商品数量
单价
金额
税率
税额
含税标志
发票行性质
商品名称
商品税目
规格型号
单位
商品数量
单价
金额
税控开票服务器组件接口规范
税率
税额
含税标志
税率
金额
税额
综合税率
合计金额
合计税额
价税合计
备注
收款人
复核人
开票人
加密版本号
主要商品名称
商品税目
清单标志
所属月份
开票机号
信息表编号
原发票代码
原发票号码
作废日期
作废人
签名参数
签名值
已开负数金额
2. 增值税普通发票(发票类型代码:007)
格式同增值税专用发票
税控开票服务器组件接口规范
6. 发票领购信息查询
6.1 接口说明
通过发票领购信息查询接口,获取税控服务器指定发票类型的发票领购信息。
6.2 请求数据
请求报文:
">
开票终端标识
发票类型代码
参数说明:
索
引
1
2
3
4
5
ID
id
comment
yylxdm
kpzdbs
fplxdm
名称
交易编号
交易描述
应用类型代码
开票终端标识
发票类型代码
长度 必须 说明
5
8
1
16
3
是
是
是
是
是
10005
发票领购信息查询
固定为“1”表示国税
开票终端唯一性标识
“004”增值税专用发票
“007”增值税普通发票
6.3 返回数据
响应报文:
">
返回代码
返回信息
当前未开发票代码
当前未开发票号码
总剩余份数
发票代码
起始号码
税控开票服务器组件接口规范
终止号码
发票份数
剩余份数
领购日期
领购人员
发票代码
发票起始号码
发票终止号码
发票份数
剩余份数
领购日期
领购人员
参数说明:
索
引
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
ID
id
comment
yylxdm
returncode
returnmsg
dqfpdm
dqfphm
zsyfs
fpdm
qshm
zzhm
fpfs
syfs
lgrq
lgry
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
当前未开发票代
码
当前未开发票号
码
总剩余份数
发票代码
发票起始号码
发票终止号码
发票份数
剩余份数
领购日期
领购人员
长度 必须 说明
5
8
1
8
160
20
12
12
10
8
8
8
8
8
20
是
是
是
是
是
否
否
否
否
否
否
否
否
否
否
10005
发票领购信息查询
固定为“1”表示国税
0成功,其它失败
格式YYYYMMDD
税控开票服务器组件接口规范
7. 发票打印
7.1 接口说明
调用本地打印机完成发票打印操作。接口根据传入的发票代码和发票号码从税控服务器
中提取发票明细数据并完成发票打印。
7.2 请求数据
请求报文:
">
开票终端标识
发票类型代码
发票代码
发票号码
打印类型
打印方式
参数说明:
索
引
1
2
3
4
5
6
7
8
9
ID
id
comment
yylxdm
kpzdbs
fplxdm
fpdm
fphm
dylx
dyfs
名称
交易编号
交易描述
应用类型代码
开票终端标识
发票类型代码
发票代码
发票号码
打印类型
打印方式
长度 必须 说明
5
30
1
16
3
12
8
1
1
是
是
是
是
是
是
是
是
是
20004
发票打印
固定为“1”表示国税
开票终端唯一性标识
长度根据发票类型而不
同,最长不超过12位
0:发票打印
1:清单打印
0:每次点击都弹出打印设
置框
1:只在第一次点击时弹出
打印设置框
税控开票服务器组件接口规范
7.3 返回数据
响应报文:
">
返回代码
返回信息
参数说明:
索
引
1
2
3
4
5
ID
id
comment
yylxdm
returncode
returnmsg
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
长度 必须 说明
5
30
1
8
160
是
是
是
是
是
20004
发票打印
固定为“1”表示国税
0成功,其它失败
8. 页边距设置
8.1 接口说明
根据发票种类设置发票打印页边距
。
8.2 请求数据
请求报文:
">
发票类型代码
打印上边距
打印左边距
参数说明:
税控开票服务器组件接口规范
索
引
1
2
3
4
5
6
ID
id
comment
yylxdm
fplxdm
top
left
名称
交易编号
交易描述
应用类型代码
发票类型代码
打印上边距
打印左边距
长度 必须 说明
5
30
1
3
5
5
是
是
是
是
是
是
20003
打印页边距设置
固定为“1”表示国税
整数,可正负
整数,可正负
8.3 返回数据
响应报文:
">
返回代码
返回信息
参数说明:
索
引
1
2
3
4
5
ID
id
comment
yylxdm
returncode
returnmsg
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
长度 必须 说明
5
30
1
8
160
是
是
是
是
是
20003
打印页边距设置
固定为“1”表示国税
0成功,其它失败
9. 查询当前未开票号
9.1 接口说明
查询指定开票终端的当前第一张未开具的发票代码和发票号码,发票开票和
发票作废前调用。
9.2 请求数据
请求报文:
税控开票服务器组件接口规范
">
开票终端标识
发票类型代码
参数说明:
索
引
1
2
3
4
5
ID
id
comment
yylxdm
kpzdbs
fplxdm
名称
交易编号
交易描述
应用类型代码
开票终端标识
发票类型代码
长度 必须 说明
5
8
1
16
3
是
是
是
是
是
10004
查询当前未开票号
固定为“1”表示国税
开票终端唯一性标识
“004”增值税专用发票
“007”增值税普通发票
9.3 返回数据
响应报文:
">
返回代码
返回信息
当前未开具发票代码
当前未开具发票号码
参数说明:
索
引
1
2
3
4
5
6
7
ID
id
comment
yylxdm
returncode
returnmsg
dqfpdm
dqfphm
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
当前未开发票代
码
当前未开发票号
码
长度 必须 说明
5
8
1
8
160
10
8
是
是
是
是
是
否
否
10004
查询当前未开票号
固定为“1”表示国税
0成功,其它失败
税控开票服务器组件接口规范
10. 发票领购信息分发
10.1 接口说明
通过发票领购信息分发接口实现税控服务器的发票领购信息电子号段由发
票库存到开票终端的分发。只有分发到开票终端的电子号段才可以进行发票开具。
10.2 请求数据
请求报文:
">
开票终端标识
发票类型代码
发票代码
起始号码
发票份数
参数说明:
索
引
1
2
3
4
5
6
7
8
ID
id
comment
yylxdm
kpzdbs
fplxdm
fpdm
qshm
fpfs
名称
交易编号
交易描述
应用类型代码
开票终端标识
发票类型代码
发票代码
起始号码
发票份数
长度 必须 说明
5
30
1
16
3
10
8
8
是
是
是
是
是
是
是
是
10006
发票领购信息分发
固定为“1”表示国税
“004”增值税专用发票
“007”增值税普通发票
10.3 返回数据
响应报文:
">
税控开票服务器组件接口规范
返回代码
返回信息
参数说明:
索
引
1
2
3
4
5
ID
id
comment
yylxdm
returncode
returnmsg
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
长度 必须 说明
5
30
1
8
160
是
是
是
是
是
10006
发票领购信息分发
固定为“1”表示国税
0成功,其它失败
11. 发票领购信息退回
11.1 接口说明
通过发票领购信息退回接口实现税控服务器的发票领购信息由开票终端退
回到发票库存,要求退回整段发票领购信息剩余全部未开发票。
11.2 请求数据
请求报文:
">
开票终端标识
发票类型代码
发票代码
起始号码
终止号码
参数说明:
索
引
1
2
3
4
ID
id
comment
yylxdm
kpzdbs
名称
交易编号
交易描述
应用类型代码
开票终端标识
长度 必须 说明
5
30
1
16
是
是
是
是
10007
发票领购信息退回
固定为“1”表示国税
开票终端唯一性标识
税控开票服务器组件接口规范
5
6
7
8
fplxdm
fpdm
qshm
zzhm
发票类型代码
发票代码
起始号码
终止号码
3
10
8
8
是
是
是
是
“004”增值税专用发票
“007”增值税普通发票
剩余号段的起始号码
剩余号段的终止号码
11.3 返回数据
响应报文:
">
返回代码
返回信息
参数说明:
索
引
1
2
3
4
5
ID
id
comment
yylxdm
returncode
returnmsg
名称
交易编号
交易描述
应用类型代码
返回代码
返回信息
长度 必须 说明
5
30
1
8
160
是
是
是
是
是
10007
发票领购信息退回
固定为“1”表示国税
0成功,其它失败
版权声明:本文标题:增值税管理系统-百望接口规范V1.0 内容由热心网友自发贡献,该文观点仅代表作者本人, 转载请联系作者并注明出处:https://m.elefans.com/xitong/1719915421a807564.html, 本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容,一经查实,本站将立刻删除。
发表评论