2024年1月14日发(作者：)
税控发票开票软件发票信息
数据接口规范V4.0
1 概述
为进一步优化纳税服务，满足纳税人内部管理信息系统与增值税发票税控开票软件的衔接需要，国家税务总局下发了税控发票开票软件发票信息数据接口规范V1.0、V2.0、V3.0版。随着增值税发票管理新系统的全国推广和营改增的全面实施，公布的接口已经不能满足需要，现对该接口进行更新升级，形成V4.0版。
本接口规范适用于是增值税发票税控开票软件（金税盘版）与增值税发票税控开票软件（税控盘版）的商品编码版本（以下统一简称为税控发票开票软件），配合手工导入开具、自动导入开具和发票明细导出功能使用。
2 接口说明
2.1 待开发票信息导入接口
通过税控发票开票软件中的手工导入开具和自动导入开具功能，将待开发票的信息批量导入到税控发票开票软件，完成发票开具。
选择手工导入开具时，首先选择要导入的XML文件，再对导入发票信息逐张开具并打印发票。
1
选择自动导入开具时，首先设置文件存储路径和轮询时间。自动导入开具功能开启后，系统自动轮询指定路径下的XML文件，自动完成发票开具，并将开具结果写入指定文件目录。
2.2 已开发票信息导出接口
通过税控发票开票软件中的发票明细导出功能，实现已开发票信息的批量导出，生成EXCEL文件或XML文件。
3 接口定义
本接口规范内容包括待开发票信息导入接口和已开发票信息导出接口，发票类型为增值税专用发票、增值税普通发票、货物运输业增值税专用发票、机动车销售统一发票和二手车销售统一发票。
3.1 增值税专用发票和增值税普通发票
3.1.1 修改说明
单据新增了Version节点，增加商品编码功能后的版本为2.0；
单据新增了Spbmbbh节点，增加商品编码功能后为税局下载的商品编码表版本号；
单据新增了Hsbz节点，用于区分营改增新增的5%不含税税率和中外合作油气田（原海洋石油）5%税率、1.5%税率、差额税；
单据商品明细中新增了Spbm（商品编码）、Qyspbm（企业商品编码）、Syyhzcbz（享受优惠政策）、Lslbz（零税率标识）、Yhzcsm 2
（优惠政策说明），详细内容请查看接口规范中相关说明；
单据只允许对单行商品进行折扣，折扣行紧挨被折行之后，折扣行的商品名称与被折行相同；
单据新增了Kce节点，用于差额税计算。
单据新增Se节点，实际开具发票票面税额以单据中实际传入的为准。
3.1.2 待开发票信息导入接口
1）导入文件XML格式如下：
2.0 //有此节点，则表示用带分类编码
2 //此文件含有的单据信息数量
1 //单据号（20字节）
购方名称 //购方名称（100字节）
110 //购方税号
购方银行账号 //购方银行账号（100字节）
购方地址电话 //购方地址电话（100字节）
备注 //备注（240字节）
fhr //复核人（8字节）
skr //收款人（8字节）
商品编码版本号 //商品编码版本号(20字节)（必输项）
含税标志 //含税标志 0：不含税税率，1：含税税率，2：差额税;中外合作油气田（原海洋石油）5%税率、1.5%税率为1，差额税为2，其他为0；
1 //序号
商品名称 //商品名称，金额为负数时此行是折扣行，折扣行的商品名称应与上一行的商品名称一致（100字节）
规格型号 //规格型号（40字节）
计量单位 //计量单位（32字节）
商品编码 //商品编码(19字节)（必输项）
企业商品编码 //企业商品编码（20字节）
3
优惠政策标识 //是否使用优惠政策标识0：不使用，1：使用（1字节）
零税率标识 //零税率标识 空：非零税率，0：出口退税，1：免税，2：不征收，3普通零税率（1字节）
优惠政策说明 //优惠政策说明（50字节）
100 //单价（中外合作油气田（原海洋石油）5%税率，单价为含税单价）
10 //数量
1000.00 //金额，当金额为负数时为折扣行
0.17 //税率
170.00 //税额
扣除额 //扣除额，用于差额税计算
2 //单据号（20字节）
购方名称1 //购方名称（100字节）
110 //购方税号
购方银行账号1 //购方银行账号（100字节）
购方地址电话1 //购方地址电话（100字节）
备注1 //备注（240字节）
fhr1 //复核人（8字节）
skr1 //收款人（8字节）
商品编码版本号 //商品编码版本号(20字节) （必输项）
含税标志 //含税标志 0：不含税税率，1：含税税率，2：差额税;中外合作油气田（原海洋石油）5%税率、1.5%税率为1，差额税为2，其他为0；
1 //序号
商品名称1 //商品名称，金额为负数时此行是折扣行，折扣行的商品名称应与上一行的商品名称一致（100字节）
规格型号1 //规格型号（40字节）
计量单位1 //计量单位（32字节）
商品编码 //商品编码(19字节) （必输项）
企业商品编码 //企业商品编码（20字节）
优惠政策标识 //是否使用优惠政策标识0：不使用，1：使用（1字节）
零税率标识 //零税率标识 空：非零税率，0：出口退税，1：免税，2：不征收，3普通零税率（1字节）
优惠政策说明 //优惠政策说明（50字节）
100 //单价（中外合作油气田（原海洋石油）5%税率，单价为含税单价）
10 //数量
4
1000.00 //金额，当金额为负数时为折扣行
0.17 //税率
170.00 //税额
扣除额 //扣除额，用于差额税计算
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
3.1.3 已开发票信息导出接口
1）导出文件为XML格式时，格式如下：
2.0 //有此节点，则表示用带分类编码
2
//此文件含有的发票信息数量
1 //单据号（20字节）
专用发票 //发票种类（专用发票或普通发票）
1400111560 //类别代码（10字节）
5
00000001 //发票号码（8字节）
20140305 //开票日期（YYYYMMDD）
购方名称 //购方名称（100字节）
110 //购方税号
购方银行账号 //购方银行账号（100字节）
购方地址电话 //购方地址电话（100字节）
销方名称 //销方名称（100字节）
111 //销方税号
销方银行账号 //销方银行账号（100字节）
销方地址电话 //销方地址电话（100字节）
合计金额 //合计金额
合计税额 //合计税额
备注 //备注（240字节）
fhr //开票人（8字节）
fhr //复核人（8字节）
skr //收款人（8字节）
商品编码版本号 //商品编码版本号(20字节)
含税标志 //含税标志 0：不含税税率，1：含税税率，2：差额税;中外合作油气田（原海洋石油）5%税率、1.5%税率为1，差额税为2，其他为0；
1 //序号
商品名称 //商品名称（100字节）
规格型号 //规格型号（40字节）
计量单位 //计量单位（32字节）
商品编码 //商品编码(19字节)
企业商品编码 //企业商品编码（20字节）
优惠政策标识 //是否使用优惠政策标识0：不使用，1：使用（1字节）
零税率标识 //零税率标识 空：非零税率，0：出口退税，1：免税，2：不征收，3普通零税率（1字节）
优惠政策说明 //优惠政策说明（50字节）
100 //单价（中外合作油气田（原海洋石油）5%税率，单价为含税单价）
10 //数量
1000.00 //金额
0.17 //税率
170.00 //税额
2 //单据号（20字节）
普通发票 //发票种类（专用发票或普通发票）
6
1400111650 //类别代码（10字节）
00000002 //发票号码（8字节）
20140305 //开票日期（YYYYMMDD）
购方名称 //购方名称（100字节）
110 //购方税号
购方银行账号 //购方银行账号（100字节）
购方地址电话 //购方地址电话（100字节）
销方名称 //销方名称（100字节）
111 //销方税号
销方银行账号 //销方银行账号（100字节）
销方地址电话 //销方地址电话（100字节）
合计金额 //合计金额
合计税额 //合计税额
备注 //备注（240字节）
fhr //开票人（8字节）
fhr //复核人（8字节）
skr //收款人（8字节）
商品编码版本号 //商品编码版本号(20字节)
含税标志 //含税标志 0：不含税税率，1：含税税率，2：差额税;中外合作油气田（原海洋石油）5%税率、1.5%税率为1，差额税为2，其他为0；
1 //序号
商品名称1 //商品名称（100字节）
规格型号1 //规格型号（40字节）
计量单位1 //计量单位（32字节）
商品编码 //商品编码(19字节)
企业商品编码 //企业商品编码（20字节）
优惠政策标识 //是否使用优惠政策标识0：不使用，1：使用（1字节）
零税率标识 //零税率标识 空：非零税率，0：出口退税，1：免税，2：不征收，3普通零税率（1字节）
优惠政策说明 //优惠政策说明（50字节）
100 //单价（中外合作油气田（原海洋石油）5%税率，单价为含税单价）
10 //数量
1000.00 //金额
0.17 //税率
170.00 //税额
7
2）导出文件为EXCEL格式时，具体格式请参考附件：增值税专用发票和增值税普通发票导出样例.xls。
3.2 机动车销售统一发票
3.2.1 修改说明
新增了bmb_bbh节点，为增加商品编码功能后的商品编码表版本号；spbm（商品编码）、zxbm（企业商品自编码）、yhzcbs（享受优惠政策）、lslbs（零税率标识）、zzstsgl（优惠政策说明），详细内容请查看接口规范中相关说明。
3.2.2 待开发票信息导入接口
1）导入的XML文件格式如下：
djh //单据号（30字符）
bmb_bbh //编码表版本号（20个字符）
fpdm //发票代码（10个字符）
fphm //发票号码（8个字符）
gfdwmc //购方单位名称（72个字符）
sfzhm //身份证号码/组织机构代码（22个字符）
gfdwsbh //购方单位识别号（20个字符）
cllx //车辆类型（40个字符）
cpxh //厂牌型号（60个字符）
cd //产地（32个字符）
hgzs //合格证书（50个字符）
jkzmsh //进口证明书号（36个字符）
sjdh //商检单号（32个字符）
fdjhm //发动机号码（60个字符）
clsbdh //车辆识别代号（23个字符）
scqymc //生产企业名称（80个字符）
8
jshj //价税合计
dh //电话（40个字符）
zh //账号（40个字符）
dz //地址（80个字符）
khyh //开户银行（80个字符）
zzssl //增值税税率（实际税率）
zzsse //增值税税额
bhsj //不含税价
dw //吨位（8个字符）
xcrs //限乘人数（12个字符）
spbm //商品编码（19个字符）
zxbm //自行编码（20个字符）
yhzcbs //优惠政策标识（1个字符） 0：不使用，1：使用
lslbs //税率标识空（1个字符）：非零税率，0：出口退税，1：免税，2：不征收，3普通零税率
zzstsgl //增值税特殊管理（50个字符）
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。
3.2.3 已开发票信息导出接口
1）导出文件XML文件时，格式如下：
9
bmb_bbh //编码表版本号（20个字符）
fpdm //发票代码（10个字符）
fphm //发票号码（8个字符）
kprq //开票日期（10个字符）
gfdwmc //购方单位名称（72个字符）
sfzhm //身份证号码/组织机构代码（22个字符）
gfdwsbh //购方单位识别号（20个字符）
cllx //车辆类型（40个字符）
cpxh // cd // hgzs // jkzmsh // sjdh // fdjhm //clsbdh //scqymc // jshj // dh // zh // dz // khyh // zzssl // zzsse // bhsj // dw //xcrs // spbm
zxbm
yhzcbs
lslbs
2：不征收，3普通零税率
zzstsgl
2）导出文件EXCEL格式时，具体格式见附件：机动车销售统一发票导出样例.xls。
厂牌型号（60个字符）
产地（32个字符）
合格证书（50个字符）
进口证明书号（36个字符）
商检单号（32个字符）
发动机号码（60个字符）
车辆识别代号（23个字符）
生产企业名称（80个字符）
价税合计
电话（40个字符）
账号（40个字符）
地址（80个字符）
开户银行（80个字符）
增值税税率（实际税率）
增值税税额
不含税价
吨位（8个字符）
限乘人数（12个字符）
//商品编码（19个字符）
//自行编码（20个字符）
//优惠政策标识（1个字符） 0：不使用，1：使用
//税率标识（1个字符） 空：非零税率， 1：免税，//增值税特殊管理（50个字符）
10
3.3 二手车销售统一发票
3.3.1 修改说明
新增二手车销售统一发票待开发票信息导入及已开发票信息导出接口。
3.3.2 待开发票信息导入接口
1）导入的XML文件格式如下：
djh//单据号（30字符）
bmb_bbh//编码表版本号（20个字符）
fpdm//发票代码（12个字符）
fphm//发票号码（8个字符）
kpflx//开票方类型:01经营单位、02拍卖单位、 03二手车市场
gfmc//买方单位/个人名称（72个字符）
gfdm//买方单位代码/身份证号码（22个字符）
gfdz//买方单位/个人住址（80个字符）
gfdh//买方单位/个人电话（20个字符）
xfmc//卖方单位/个人名称（72个字符）
xfdm//卖方单位/个人代码（22个字符）
xfdz//卖方单位/个人地址（80个字符）
xfdh//卖方单位/个人电话 （20个字符）
cpzh//车牌照号（20个字符）
djzh//登记证号（20个字符）
cllx//车辆类型（40个字符）
clsbdh//车辆识别代号（23个字符）
cpxh//厂牌型号（60个字符）
zrdclglsmc//转入地车辆管理所名称（80个字符）
jypmdwmc//经营、拍卖单位名称（80个字符）
jypmdwdz//经营、拍卖单位地址（80个字符）
jypmdwsbh//经营、拍卖单位纳税人识别号（20个字符）
jypmdwyhzh//经营、拍卖单位开户行、账号（120个字符）
11
jypmdwdh//经营、拍卖单位电话（20个字符）
escscmc//二手车市场名称（80个字符）
escscsbh//二手车市场识别号（20个字符）
escscdz//二手车市场地址（80个字符）
escscyhzh//二手车市场开户行、账号（120个字符）
escscdh//二手车市场电话（20个字符）
cjhj//车价合计（20个字符）
kpr//开票人
bz//备注（230个字符）
spbm//商品编码（19个字符）
zxbm//自行编码（20个字符）
yhzcbs//优惠政策标识（1个字符） 0：不使用，1：使用
lslbs//税率标识空（1个字符）：非零税率，0：出口退税，1：免税，2：不征收，3普通零税率
zzstsgl//增值税特殊管理（50个字符）
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。
3.3.3 已开发票信息导出接口
1）导出文件XML文件时，格式如下：
fpdm//发票代码（12个字符）
12
fphm//发票号码（8个字符）
gfmc//买方单位/个人名称（72个字符）
gfdm//买方单位代码/身份证号码（22个字符）
gfdz//买方单位/个人住址（80个字符）
gfdh//买方单位/个人电话（20个字符）
xfmc//卖方单位/个人名称（72个字符）
xfdm//卖方单位/个人代码（22个字符）
xfdz//卖方单位/个人地址（80个字符）
xfdh//卖方单位/个人电话 （20个字符）
cpzh//车牌照号（20个字符）
djzh//登记证号（20个字符）
cllx//车辆类型（40个字符）
clsbdh//车辆识别代号（23个字符）
cpxh//厂牌型号（60个字符）
zrdclglsmc//转入地车辆管理所名称（80个字符）
jypmdwmc//经营、拍卖单位名称（80个字符）
jypmdwdz//经营、拍卖单位地址（80个字符）
jypmdwsbh//经营、拍卖单位纳税人识别号（20个字符）
jypmdwyhzh//经营、拍卖单位开户行、账号（120个字符）
jypmdwdh//经营、拍卖单位电话（72个字符）
escscmc//二手车市场名称（80个字符）
escscsbh//二手车市场识别号（20个字符）
escscdz//二手车市场地址（80个字符）
escscyhzh//二手车市场开户行、账号（120个字符）
escscdh//二手车市场电话（20个字符）
cjhj//车价合计（20个字符）
kpr//开票人
bz//备注（230个字符）
spbm//商品编码（19个字符）
2）导出文件EXCEL格式时，具体格式见附件：二手车销售统一发票导出样例.xls。
13
发布评论