税控发票开票软件发票信息数据接口规范V40.docx
《税控发票开票软件发票信息数据接口规范V40.docx》由会员分享，可在线阅读，更多相关《税控发票开票软件发票信息数据接口规范V40.docx（15页珍藏版）》请在冰豆网上搜索。
税控发票开票软件发票信息数据接口规范税控发票开票软件发票信息数据接口规范V40税控发票开票软件发票信息数据接口规范V4.01概述概述为进一步优化纳税服务，满足纳税人内部管理信息系统与增值税发票税控开票软件的衔接需要，国家税务总局下发了税控发票开票软件发票信息数据接口规范V1.0、V2.0、V3.0版。
随着增值税发票管理新系统的全国推广和营改增的全面实施，公布的接口已经不能满足需要，现对该接口进行更新升级，形成V4.0版。
本接口规范适用于是增值税发票税控开票软件（金税盘版）与增值税发票税控开票软件（税控盘版）的商品编码版本（以下统一简称为税控发票开票软件），配合手工导入开具、自动导入开具和发票明细导出功能使用。
2接口说明接口说明2.1待开发票信息导入接口待开发票信息导入接口通过税控发票开票软件中的手工导入开具和自动导入开具功能，将待开发票的信息批量导入到税控发票开票软件，完成发票开具。
选择手工导入开具时，首先选择要导入的XML文件，再对导入发票信息逐张开具并打印发票。
选择自动导入开具时，首先设置文件存储路径和轮询时间。
自动导入开具功能开启后，系统自动轮询指定路径下的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（优惠政策说明），详细内容请查看接口规范中相关说明；单据只允许对单行商品进行折扣，折扣行紧挨被折行之后，折扣行的商品名称与被折行相同；单据新增了Kce节点，用于差额税计算。
单据新增Se节点，实际开具发票票面税额以单据中实际传入的为准。
3.1.2待待开发票信息导入接口开发票信息导入接口1）导入文件XML格式如下：
2.0/有此节点，则表示用带分类编码2/此文件含有的单据信息数量1/单据号（20字节）购方名称/购方名称（100字节）110000000000000/购方税号购方银行账号/购方银行账号（100字节）购方地址电话/购方地址电话（100字节）备注/备注（240字节）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字节）购方名称1/购方名称（100字节）110000000000000/购方税号购方银行账号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/数量1000.00/金额，当金额为负数时为折扣行0.17/税率170.00/税额扣除额/扣除额，用于差额税计算2）开具结果回写文件格式选择批量自动导入时，每个XML文件形成一个开具结果文件，命名规则为：
XML文件名_开票结果.TXT。
内容为：
开具成功的单据：
YYYY-MM-DDhh:
mm:
ss单据号:
XXX,开具结果:
1（0失败，1成功）,对应发票信息:
普通（专用）发票,XXXXXXXXXX（代码）,XXXXXXXX（号码）开具失败的单据：
YYYY-MM-DDhh:
mm:
ss单据号:
XXX,开具结果:
0（0失败，1成功）,开具失败原因:
XXXXXXXXXXXXXXXXXXXX3.1.3已开发票信息导出接口已开发票信息导出接口1）导出文件为XML格式时，格式如下：
2.0/有此节点，则表示用带分类编码2/此文件含有的发票信息数量1/单据号（20字节）专用发票/发票种类（专用发票或普通发票）1400111560/类别代码（10字节）00000001/发票号码（8字节）20140305/开票日期（YYYYMMDD）购方名称/购方名称（100字节）110000000000000/购方税号购方银行账号/购方银行账号（100字节）购方地址电话/购方地址电话（100字节）销方名称/销方名称（100字节）110000000000001/销方税号销方银行账号/销方银行账号（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字节）普通发票/发票种类（专用发票或普通发票）1400111650/类别代码（10字节）00000002/发票号码（8字节）20140305/开票日期（YYYYMMDD）购方名称/购方名称（100字节）110000000000000/购方税号购方银行账号/购方银行账号（100字节）购方地址电话/购方地址电话（100字节）销方名称/销方名称（100字节）110000000000001/销方税号销方银行账号/销方银行账号（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/税额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个字符）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-DDhh:
mm:
ss单据号:
XXX,开具结果:
1（0失败，1成功）,对应发票信息:
XXXXXXXXXX（发票代码）,XXXXXXXX（发票号码）。
开具失败的单据：
YYYY-MM-DDhh:
mm:
ss单据号:
XXX,开具结果:
0（0失败，1成功）,开具失败原因:
XXXXXXXXXXXXXXXXXXXX。
3.2.3已开发票信息导出接口已开发票信息导出接口1）导出文件XML文件时，格式如下：
bmb_bbh/编码表版本号（20个字符）fpdm/发票代码（10个字符）fphm/发票号码（8个字符）kprq/开票日期（10个字符）gfdwmc/购方单位名称（72个字符）sfzhm/身份证号码/组织机构代码（22个字符）gfdwsbh/购方单位识别号（20个字符）cllx/车辆类型（40个字符）cpxh/厂牌型号（60个字符）cd/产地（32个字符）hgzs/合格证书（50个字符）jkzmsh/进口证明书号（36个字符）sjdh/商检单号（32个字符）fdjhm/发动机号码（60个字符）clsbdh/车辆识别代号（23个字符）scqymc/生产企业名称（80个字符）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个字符）空：
非零税率，1：
免税，2：
不征收，3普通零税率zzstsgl/增值税特殊管理（50个字符）2）导出文件EXCEL格式时，具体格式见附件：
机动车销售统一发票导出样例.xls。
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个字符）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-DDhh:
mm:
ss单据号:
XXX,开具结果:
1（0失败，1成功）,对应发票信息:
XXXXXXXXXX（发票代码）,XXXXXXXX（发票号码）。
开具失败的单据：
YYYY-MM-DDhh:
mm:
ss单据号:
XXX,开具结果:
0（0失败，1成功）,开具失败原因:
XXXXXXXXXXXXXXXXXXXX。
3.3.3已开发票信息导出接口已开发票信息导出接口1）导出文件XML文件时，格式如下：
fpdm/发票代码（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。
升级会员 