增值税普通发票电子企业端.docx
《增值税普通发票电子企业端.docx》由会员分享，可在线阅读，更多相关《增值税普通发票电子企业端.docx（13页珍藏版）》请在冰豆网上搜索。
增值税普通发票电子企业端
增值税普通发票（电子）企业端
（服务器版可编程）接口规范
2018年3月
第1章接口概述
1.1.接口概述
本接口用于电子发票系统对接增值税发票系统升级版开具增值税普通发票（电子）的接口说明。
接口设计为以XML格式字符串作为参数传递。
1.2.适用范围
该接口规范适用于通过税控设备（目前特指税控盘组/金税盘组）实现电子发票与升级版系统的对接，仅支持增值税普通发票（电子）。
第2章接口说明
2.1.登记信息查询
接口说明：
获取税控设备基本登记信息。
业务类型：
"DJXXCX"
输入参数：
xmlversion="1.0"encoding="gbk"?
>
纳税人识别号
返回数据：
xmlversion="1.0"encoding="gbk"?
>
纳税人识别号
纳税人名称
主管税务机关代码
主管税务机关名称
税控设备编号
当前时钟
返回代码
返回信息
参数说明：
索引
ID
名称
长度
必须
说明
1
NSRSBH
纳税人识别号
20
否
2
NSRMC
纳税人名称
80
否
3
SWJGDM
主管税务机关代码
16
否
4
SWJGMC
主管税务机关名称
80
否
5
JQBH
税控设备编号
12
否
6
DQSZ
当前时钟
14
否
YYYYMMDDHHMMSS
7
RETURNCODE
返回代码
4
是
0000成功，其它失败
8
RETURNMSG
返回信息
160
是
变长
2.2.发票库存查询
接口说明：
查询企业普通发票（电子）库存。
业务类型：
"FPKCCX"
输入参数：
xmlversion="1.0"encoding="gbk"?
>
纳税人识别号
索引
ID
名称
长度
必须
说明
1
NSRSBH
纳税人识别号
20
是
返回数据：
xmlversion="1.0"encoding="gbk"?
>
剩余发票份数
返回代码
返回信息
参数说明：
索引
ID
名称
长度
必须
说明
1
SYFPFS
剩余发票份数
是
2
RETURNCODE
返回代码
4
是
0000成功，其它失败
3
RETURNMSG
返回信息
是
变长
2.3.发票开具
接口说明：
完成蓝字发票和红字发票开具。
项目条数最大100条。
业务类型：
"FPKJ"
输入参数：
xmlversion="1.0"encoding="gbk"?
>
发票请求流水号
开票类型
编码表版本号
征税方式
销售方纳税人识别号
销售方名称
销售方地址、电话
销售方银行账号
购买方纳税人识别号
购买方名称
购买方地址、电话
购买方银行账号
开票人
收款人
复核人
原发票代码
原发票号码
价税合计
合计金额
合计税额
扣除额
备注
发票行性质
商品编码
自行编码
优惠政策标识
零税率标识
增值税特殊管理
项目名称
规格型号
单位
项目数量
项目单价
项目金额
税率
税额
参数说明：
索引
ID
名称
长度
必须
说明
1
FPQQLSH
发票请求流水号
20
是
2
KPLX
开票类型
1
是
0-蓝字发票；1-红字发票
3
BMB_BBH
编码表版本号
20
否
4
ZSFS
征税方式
1
是
0：
普通征税
1：
减按计征
2：
差额征税
5
XSF_NSRSBH
销售方纳税人识别号
20
是
6
XSF_MC
销售方名称
100
是
7
XSF_DZDH
销售方地址、电话
100
是
8
XSF_YHZH
销售方银行账号
100
否
9
GMF_NSRSBH
购买方纳税人识别号
20
否
10
GMF_MC
购买方名称
100
是
11
GMF_DZDH
购买方地址、电话
100
否
12
GMF_YHZH
购买方银行账号
100
否
13
KPR
开票人
8
是
14
SKR
收款人
8
否
15
FHR
复核人
8
否
16
YFP_DM
原发票代码
12
红字发票时必须
17
YFP_HM
原发票号码
8
红字发票时必须
18
JSHJ
价税合计
是
单位：
元（2位小数）
19
HJJE
合计金额
是
不含税，单位：
元（2位小数）
20
HJSE
合计税额
是
单位：
元（2位小数）
21
KCE
扣除额
12
否
小数点后2位，当ZSFS为2时扣除额为必填项
22
BZ
备注
200
否
备注长度应减去“机器编号:
ZZZZZZZZZZZ”,”对应正数发票代码:
XXXXXXXXXXXX号码:
YYYYYYYY”
字样长度，长度剩余130。
项目明细，可多条（最大100条）
23
FPHXZ
发票行性质
1
是
0正常行、1折扣行、2被折扣行
24
SPBM
商品编码
19
否
25
ZXBM
自行编码
20
否
26
YHZCBS
优惠政策标识
1
否
0：
不使用，1：
使用
27
LSLBS
零税率标识
1
否
空：
非零税率，1：
免税，2：
不征收，3普通零税率
28
ZZSTSGL
增值税特殊管理
50
否
29
XMMC
项目名称
90
是
在发票和销货清单中，可在每一行商品下加入折扣行，折扣行商品名称栏填写“折扣（X.XXX%）”字样，其中“X”为折扣率数字，金额和税额栏以负数填写，税率与被折扣行商品税率相同，其它栏不填写。
30
DW
计量单位
20
否
31
GGXH
规格型号
40
否
32
XMSL
项目数量
否
小数点后6位
33
XMDJ
项目单价
否
小数点后6位不含税
34
XMJE
项目金额
是
不含税，单位：
元（2位小数）
35
SL
税率
是
6位小数，例1%为0.01
36
SE
税额
是
单位：
元（2位小数）
返回参数：
xmlversion="1.0"encoding="gbk"?
>
发票请求流水号
税控设备编号
发票代码
发票号码
开票日期
发票密文
校验码
二维码
备注
返回代码
返回信息
参数说明：
索引
ID
名称
长度
必须
说明
1
FPQQLSH
发票请求流水号
20
是
2
JQBH
税控设备编号
12
否
成功必填
3
FP_DM
发票代码
12
否
成功必填
4
FP_HM
发票号码
8
否
成功必填
5
KPRQ
开票日期
14
否
YYYYMMDDHHMMSS
成功必填
6
FP_MW
发票密文
112
否
长度108或112，成功必填
7
JYM
发票校验码
20
否
成功必填
8
EWM
二维码
3000
否
长度可变
9
BZ
备注
200
10
RETURNCODE
返回代码
4
是
0000成功，其它失败
11
RETURNMSG
返回信息
160
是
变长
2.4.发票查询
接口说明：
根据发票请求流水号查询发票结果。
业务类型：
"FPCX"
输入参数：
xmlversion="1.0"encoding="gbk"?
>
发票请求流水号
参数说明：
索引
ID
名称
长度
必须
说明
1
FPQQLSH
发票请求流水号
20
是
返回参数：
xmlversion="1.0"encoding="gbk"?
>
发票请求流水号
税控设备编号
发票代码
发票号码
开票日期
发票密文
校验码
二维码
备注
返回代码
返回信息
参数说明：
索引
ID
名称
长度
必须
说明
1
FPQQLSH
发票请求流水号
20
是
2
JQBH
税控设备编号
12
否
成功必填
3
FP_DM
发票代码
12
否
成功必填
4
FP_HM
发票号码
8
否
成功必填
5
KPRQ
开票日期
14
否
YYYYMMDDHHMMSS
成功必填
6
FP_MW
发票密文
112
否
长度108或112，成功必填
7
JYM
发票校验码
20
否
成功必填
8
EWM
二维码
3000
否
长度可变
9
BZ
备注
200
10
RETURNCODE
返回代码
4
是
0000成功，其它失败
11
RETURNMSG
返回信息
160
是
变长
返回代码说明：
1、返回代码
0000业务处理成功
9999业务处理失败
2、返回信息
当返回代码为0000时，返回信息可为空。
当返回代码为9999时，返回信息为详细错误描述信息。
错误描述组成：
错误代码详细错误描述。
升级会员 