增值税管理系统百望接口.docx

上传人:b****8 文档编号:29491067 上传时间:2023-07-23 格式:DOCX 页数:47 大小:107.68KB
下载 相关 举报
增值税管理系统百望接口.docx_第1页
第1页 / 共47页
增值税管理系统百望接口.docx_第2页
第2页 / 共47页
增值税管理系统百望接口.docx_第3页
第3页 / 共47页
增值税管理系统百望接口.docx_第4页
第4页 / 共47页
增值税管理系统百望接口.docx_第5页
第5页 / 共47页
点击查看更多>>
下载资源
资源描述

增值税管理系统百望接口.docx

《增值税管理系统百望接口.docx》由会员分享,可在线阅读,更多相关《增值税管理系统百望接口.docx(47页珍藏版)》请在冰豆网上搜索。

增值税管理系统百望接口.docx

增值税管理系统百望接口

税控开票服务器组件接口规

(标准版)

税控项目组

2015年9月

目录3

第一章概述4

1.接口概述4

2.适用围4

第二章接口调用式5

1.本地ActiveX组件调用5

2.本地DLL调用7

第三章接口定义8

1.参数设置8

2.税控钥匙信息查询10

3.发票开具11

4.发票作废21

5.发票查询23

6.发票领购信息查询27

7.发票打印29

8.页边距设置32

9.查询当前未开票号33

10.发票领购信息分发35

11.发票领购信息退回37

 

第一章概述

1.接口概述

企业核心业务系统通过接口实现与税控开票服务器的通信,完成发票管理、

发票开具和税控服务器信息查询功能。

接口根据调用式的不同分为远程Servlet

接口和本地ActiveX组件接口

企业核心业务系统

税控开票服务器

©~

本地ActiveX组件

开票终端

2.适用围

本接口规仅适用于开票端通过组件接口ActiveX控件和Servlet接口式访问

税控开票服务器

第二章接口调用式

本地接口提供ActiveX控件和DLL两种调用式,接口列表见下表。

序号

接口ID

接口说明

其它说明

1

20001

参数设置

本地接口

2

20002

税控钥匙信息查询

本地接口

3

10008

发票开具

本地接口

4

10009

发票作废

本地接口

5

10010

发票查询

本地接口

6

10005

发票领购信息查询

本地接口

7

20004

发票打印

本地接口

8

20003

打印页边距设置

本地接口

9

10004

查询当前未开票号

本地接口

10

10006

发票领购信息分发

本地接口

11

10007

发票领购信息退回

本地接口

1.本地ActiveX组件调用

ActiveX组件文件名:

NISEC_SKSCX.ocx

ActiveX组件GUID:

CLASSID="clsid:

003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F"

函数定义:

StringOperate(stringsinputlnfo);

参数:

sinputlnfo输入XML信息

返回值:

返回结果XML字符串

调用示例:

ActiveX组件调用示例</p><p>

CLASSID="clsid:

003BD8F2-A6C3-48EF-9B72-ECFD8FC4D49F"codebase="NISEC_SKSCX.ocx#version=1,0,0,1">

functionSetParameter()

{

varsinputInfo=

"

xmlversion=\"1.0\"encoding=\"gbk\"?

>\r\n

comment=\"参数设置\">\r\n

yylxdm=\"1\">\r\*servletip>192.168.0.1\r\n7001\r\*keypwd>00000000\r\*/body>\r\*/business>";

alert(sInputInfo);

try

{

ret=sk.Operate(sInputInfo);

alert(ret);

}

catch(e)

{

alert(e.message+",errno:

"+e.number);

}

}

functionKeyQuery()

{

varsinputInfo="

xmlversion=\"1.0\"encoding=\"gbk\"?

>\r\n

id=\"20002\"comment=\"税控钥匙信息查询\">\r\n

yylxdm=\"1\">\r\n00000000\r\n\r\n"

J

alert(sInputInfo);

try

{

ret=sk.Operate(sInputInfo);

alert(ret);

}

catch(e)

{

alert(e.message+",errno:

"+e.number);

}

}

ActiveX组件调用示例


onclick="SetParameter();"x/td>

查询"onclick="KeyQuery();">


2.本地DLL调用

DLL文件名:

NISEC_SKSC.dll

函数定义:

void_stdcallPostAndRecvEx(INLPSTRpszPost,OUTLPSTRpszRecv)

参数:

pszPost输入XML信息pszRecv返回XML信息

返回值:

第三章接口定义

接口中的xml数据项,如无特殊说明,遵从以下规则:

金额字段单位统一为元,小数点后精确到两位。

日期字段格式统一为“YYYYMMDD”。

1.参数设置

1.1接口说明

参数设置接口完成服务器IP地址、端口号和税控钥匙口令的设置功能,仅

ActiveX接口提供该接口,其它接口调用前必须首先调用参数设置接口。

1.2请求数据

请求报文:

xmlversion="1.0"encoding="gbk"?

>

服务器IP地址服务器端口号税控钥匙口令注册码

参数说明:

ID

名称

长度

必须

说明

1

id

交易编号

5

20001

2

comment

交易描述

30

参数设置

3

yylxdm

应用类型代码

1

固定为“1”表示国税

4

servletip

税控开票服务器

IP地址

15

5

servletport

税控开票服务器

端口号

5

6

keypwd

税控钥匙口令

8

7

zcm

注册码

512

1.3返回数据

响应报文:

xmlversion="1.0"encoding="gbk"?

>

返回代码

返回信息

参数说明:

ID

名称

长度

必须

说明

1

id

交易编号

5

20001

2

comment

交易描述

30

获取服务器基本信息

3

yylxdm

应用类型代码

1

固定为“1”表示国税

4

returncode

返回代码

8

0成功,其它失败

5

returnmsg

返回信息

160

2.税控钥匙信息查询

2.1接口说明

提供查询税控钥匙基本信息的接口,主要查询企业纳税人识别号和税控钥匙

编号。

仅本地组件接口提供该接口,需要保证税控钥匙与本地电脑连接正常。

2.2请求数据

请求报文:

xmlversion="1.0"encoding="gbk"?

>

88888888

参数说明:

ID

名称

长度

必须

说明

1

id

交易编号

5

20002

2

comment

交易描述

30

税控钥匙信息查询

3

yylxdm

应用类型代码

1

固定为“1”表示国税

4

keypwd

税控钥匙口令

8

2.3返回数据

响应报文:

xmlversion="1.0"encoding="gbk"?

>

返回代码

返回信息

纳税人识别号税控钥匙编号

参数说明:

ID

名称

长度

必须

说明

1

id

交易编号

5

20002

2

comment

交易描述

30

税控钥匙信息查询

3

yylxdm

应用类型代码

1

固定为“1”表示国税

4

returncode

返回代码

8

0成功,其它失败

5

returnmsg

返回信息

160

6

nsrsbh

纳税人识别号

20

7

keyno

税控钥匙编号

14

前两位固定为“33”

3.发票开具

3.1接口说明

发票开具接口实现发票的正数开具和负数开具,开具成功后由税控服务器生

成税控码,并由本地税控钥匙生成发票签名。

该接口根据不同的发票类型,参数定义不同

3.2请求数据

1.增值税专用发票(发票类型代码:

004)

请求报文:

xmlversion="1.0"encoding="gbk"?

>

开票终端标识发票类型代码发票请求流水号开票类型

特殊票种标识

销货单位识别号销货单位名称销货单位地址销货单位银行购货单位识别号购货单位名称购货单位地址

购货单位银行清单标志

发票行性质商品名称商品税目

规格型号单位商品数量单价金额税率税额

含税标志

合计金额

合计税额

价税合计

备注

收款人

复核人

开票人

信息表编号

原发票代码

原发票

签名参数

参数说明:

ID

名称

长度

必须

说明

1

id

交易编号

5

10008

2

comment

交易描述

8

发票开具

3

yylxdm

应用类型代码

1

固定为“1”表示国税

4

kpzdbs

开票终端标识

16

开票终端唯一性标识

5

fplxdm

发票类型代码

3

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

ghdwsbh

购货单位识别号

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

规格型号

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

jshj

加税合计

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)

请求报文:

xmlversion="1.0"encoding="gbk"?

>

开票终端标识发票类型代码发票请求流水号开票类型

特殊票种标识

销货单位识别号销货单位名称销货单位地址销货单位银行购货单位识别号购货单位名称购货单位地址

购货单位银行清单标志

发票行性质商品名称商品税目

规格型号单位

商品数量单价

金额

税率

税额

含税标志

合计金额

合计税额

价税合计备注

收款人

复核人

开票人

信息表编号原发票代码原发票签名参数

参数说明:

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”农产品销售

“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

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

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

37

yfpdm

原发票代码

10

38

yfphm

原发票

8

38

qmcs

签名参数

16

3.3返回数据

响应报文:

xmlversion="1.0"encoding="gbk"?

>

返回代码

返回信息

发票代码

发票开票日期税控码校验码二维码

参数说明:

展开阅读全文
相关资源
猜你喜欢
相关搜索

当前位置:首页 > PPT模板 > 图表模板

copyright@ 2008-2022 冰豆网网站版权所有

经营许可证编号:鄂ICP备2022015515号-1