1. 概述
为进一步优化纳税服务,国家税务总局对本接口规范予以发布,以满足纳税人内部管理信息系统与增值税防伪税控系统开票子系统的衔接需要。
本接口规范适用于增值税防伪税控系统开票子系统V7.23.10及以上版本,配合手工导入、批量自动导入和开票数据导出功能使用。具体操作参见新增改进功能操作说明。
2. 接口说明
(1)待开票信息导入接口
通过增值税防伪税控系统开票子系统中的手工导入和批量自动导入功能,将待开票的信息批量导入到增值税防伪税控系统开票子系统,完成开票。
选择手工导入时,首先选择要导入的XML文件,再对导入开票信息逐张保存并打印。
选择批量自动导入时,首先设置文件存储路径和轮询时间。批量自动导入开启后,系统自动轮询指定路径下的XML文件,自动完成开票,并将开具结果写入指定文件目录。
(2)已开票信息导出接口
通过增值税防伪税控系统开票子系统中的开票数据导出功能,实现已开票信息的批量导出,提供EXCEL文件和XML文件两种格式选择。
3. 接口定义
本接口规范内容包括待开票信息导入接口和已开票信息导出接口。类型为增值税专用票和增值税普通票。
(1) 待开票信息导入接口规范
1)导入文件XML格式如下(每个XML节点首字母大写):
2 //此文件含有的单据信息数量
1 //单据号(20字节)
购方名称 //购方名称(100字节)
110000000000000//购方税号
购方银行账号 //购方银行账号(100字节)
购方地址电话 //购方地址电话(100字节)
备注 //备注(240字节)
fhr //复核人(8字节)
skr //收款人(8字节)
1 //序号
商品名称//商品名称,金额为负数时此项为折扣行数(100字节)
规格型号//规格型号(40字节)
计量单位 //计量单位(32字节)
100 //单价
10 //数量
1000.00 //金额,当金额为负数时为折扣行
0.17 //税率
2 //单据号(20字节)
购方名称1 //购方名称(100字节)
110000000000000//购方税号
购方银行账号1//购方银行账号(100字节)
购方地址电话1//购方地址电话(100字节)
备注1 //备注(240字节)
fhr1 //复核人(8字节)
skr1 //收款人(8字节)
1 //序号
商品名称1//商品名称,金额为负数时此项为折扣行数(100字节)
规格型号1//规格型号(40字节)
计量单位1 //计量单位(32字节)
100 //单价
10 //数量
1000.00 //金额,当金额为负数时为折扣行
0.17 //税率
2)开具结果回写文件格式
选择批量自动导入时,每个XML文件形成一个开具结果文件,命名规则为:XML文件名_开票结果.TXT。内容为:
开具成功的单据:
[YYYY-MM-DD hh:mm:ss] 单据号:XXX,开具结果:1(0 失败,1成功),对应开票信息:普通(专用)票,XXXXXXXXXX(代码),XXXXXXXX(号码)
开具失败的单据:
[YYYY-MM-DD hh:mm:ss] 单据号:XXX,开具结果:0(0 失败,1成功),开具失败原因:XXXXXXXXXXXXXXXXXXXX
(2)已开票信息导出接口
1)导出文件为XML格式时,格式如下(每个XML节点首字母大写):
2 //此文件含有的开票信息数量
1 //单据号(20字节)
专用票 //种类(专用票或普通票)
1400111560 //类别代码(10字节)
00000001 //开票号码(8字节)
20140305 //开票日期(YYYYMMDD)
购方名称 //购方名称(100字节)
110000000000000//购方税号
购方银行账号 //购方银行账号(100字节)
购方地址电话 //购方地址电话(100字节)
销方名称 //销方名称(100字节)
110000000000001//销方税号
销方银行账号 //销方银行账号(100字节)
销方地址电话 //销方地址电话(100字节)
合计金额 //合计金额
合计税额 //合计税额
备注 //备注(240字节)
fhr //开票人(8字节)
fhr //复核人(8字节)
skr //收款人(8字节)
1 //序号
商品名称//商品名称(100字节)
规格型号//规格型号(40字节)
计量单位 //计量单位(32字节)
100 //单价
10 //数量
1000.00 //金额
0.17 //税率
170.00 //税额
2 //单据号(20字节)
普通票 //种类(专用票或普通票)
1400111650 //类别代码(10字节)
00000002 //开票号码(8字节)
20140305 //开票日期(YYYYMMDD)
购方名称 //购方名称(100字节)
110000000000000//购方税号
购方银行账号 //购方银行账号(100字节)
购方地址电话 //购方地址电话(100字节)
销方名称 //销方名称(100字节)
110000000000001//销方税号
销方银行账号 //销方银行账号(100字节)
销方地址电话 //销方地址电话(100字节)
合计金额 //合计金额
合计税额 //合计税额
备注 //备注(240字节)
fhr //开票人(8字节)
fhr //复核人(8字节)
skr //收款人(8字节)
1 //序号
商品名称1//商品名称(100字节)
规格型号1//规格型号(40字节)
计量单位1 //计量单位(32字节)
100 //单价
10 //数量
1000.00 //金额
0.17 //税率
170.00 //税额
2)导出文件为EXCEL格式时,具体格式请参考附件:导出样例.xls。