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

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

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

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

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

增值税管理系统百望接口

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

(标准版)

税控项目组

2015年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.发票领购信息分发26

11•发票领购信息退回27

第一章概述

1.接口概述

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

接口根据调用方式的不同分为远程Servlet接口和本地ActiveX组件接口。

企业核心业务系统

|税控开票服务器

©—

本地ActiveX组件

开票终端

2.适用范围

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

访问税控开票服务器

第二章

接口调用方式

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

序号

接口ID

接口说明

其它说明

1

20001

参数设置

本地接口

2

[20002

税控钥匙信息查询

本地接口

3

10008

发票开具

本地接口

4

10009

发票作废

本地接口

5

M0010

发票查询

本地接口

6

10005

发票领购信息查询

本地接口

7

[20004

发票打印

本地接口

8

20003

打印页边距设置

本地接口

9

10004

查询当前未开票号

本地接口

10

r10006

发票领购信息分发

本地接口

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

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

yylxdm=\"1\">\r\*servletip>192.168.0.1\r\n7001\r\n00000000\r\*/body>\r

\n";

alert(sInputInfo);

try

{

ret=sk.Operate(sInputInfo);

alert(ret);

}

catch(e)

{

alert(e.message+",errno:

"+e.number);

}

}

functionKeyQuery()

{

varsinputInfo="

xml

encoding=\"gbk\"?

>\r\*businessid=\"20002\"comment=\"息查询

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

alert(sInputInfo);

try

{

ret=sk.Operate(sInputInfo);

alert(ret);

}

catch(e)

{alert(e.message+",errno:

"+e.number);

}

}

ActiveX


version=\"1.0\"

税控钥匙信

\">\r\n

组件调用示例


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

>

开票终端标识

发票类型代码

发票请求流水号

开票类型

特殊票种标识

销货单位识别号销货单位名称

销货单位地址电话销货单位银行帐号

购货单位识别号购货单位名称购货单位地址电话购货单位银行帐号清单标志

vfyxmcount="1">

vgroupxh="1">

发票行性质

商品名称

商品税目

规格型号

单位

商品数量

单价

金额

税率

税额

含税标志

合计金额

合计税额

价税合计

备注

收款人

复核人

开票人

信息表编号

原发票代码

原发票号码

签名参数

参数说明:

索引

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

>

返回代码

返回信息

发票代码

发票号码开票日期税控码

校验码二维码

参数说明:

索引

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

当前位置:首页 > 小学教育 > 语文

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

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