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

上传人:b****1 文档编号:3420468 上传时间:2023-05-05 格式:DOCX 页数:47 大小:379.51KB
下载 相关 举报
增值税管理系统百望接口.docx_第1页
第1页 / 共47页
增值税管理系统百望接口.docx_第2页
第2页 / 共47页
增值税管理系统百望接口.docx_第3页
第3页 / 共47页
增值税管理系统百望接口.docx_第4页
第4页 / 共47页
增值税管理系统百望接口.docx_第5页
第5页 / 共47页
增值税管理系统百望接口.docx_第6页
第6页 / 共47页
增值税管理系统百望接口.docx_第7页
第7页 / 共47页
增值税管理系统百望接口.docx_第8页
第8页 / 共47页
增值税管理系统百望接口.docx_第9页
第9页 / 共47页
增值税管理系统百望接口.docx_第10页
第10页 / 共47页
增值税管理系统百望接口.docx_第11页
第11页 / 共47页
增值税管理系统百望接口.docx_第12页
第12页 / 共47页
增值税管理系统百望接口.docx_第13页
第13页 / 共47页
增值税管理系统百望接口.docx_第14页
第14页 / 共47页
增值税管理系统百望接口.docx_第15页
第15页 / 共47页
增值税管理系统百望接口.docx_第16页
第16页 / 共47页
增值税管理系统百望接口.docx_第17页
第17页 / 共47页
增值税管理系统百望接口.docx_第18页
第18页 / 共47页
增值税管理系统百望接口.docx_第19页
第19页 / 共47页
增值税管理系统百望接口.docx_第20页
第20页 / 共47页
亲,该文档总共47页,到这儿已超出免费预览范围,如果喜欢就下载吧!
下载资源
资源描述

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

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

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

增值税管理系统百望接口

 

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

(标准版)

 

税控项目组

2015年9月

第一章概述

1.接口概述

企业核心业务系统通过接口实现与税控开票服务器的通信,完成发票管理、发票开具和税控服务器信息查询功能。

接口根据调用式的不同分为远程Servlet接口和本地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(stringsInputInfo);

参数:

sInputInfo输入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\r\n\r\n192.168.0.1\r\n7001\r\n00000000\r\n\r\n";

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\r\n\r\n00000000\r\n\r\n";

alert(sInputInfo);

try

{

ret=sk.Operate(sInputInfo);

alert(ret);

}

catch(e)

{

alert(e.message+",errno:

"+e.number);

}

}

ActiveX组件调用示例



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.发票开具

1.1

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"?

>

返回代码

返回信息

发票代码

发票

开票日期

税控码

校验码

二维码

参数说明:

索引

ID

名称

长度

必须

说明

1

id

交易编号

5

10008

2

comment

交易描述

8

发票开具

3

yylxdm

应用类型代码

1

固定为“1”表示国税

4

returncode

返回代码

8

0成功,其它失败

5

returnmsg

返回信息

160

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接口说明

通过发票作废接口对已开具的问题发票和未开具的空白发票进行作废处理。

已开发票作废要求发票当月开具且未抄报,空白发票作废要求从当前第一未开具发票开始逐顺序作废。

4.2请求数据

请求报文:

xmlversion="1.0"encoding="gbk"?

>

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

当前位置:首页 > IT计算机 > 电脑基础知识

copyright@ 2008-2023 冰点文库 网站版权所有

经营许可证编号:鄂ICP备19020893号-2