税控开票软件信息数据接口规范V4.0

数据接口规范V4.0

1概述

为进一步优化纳税服务，满足纳税人内部管理信息系统与税控开票软件的衔接需要，国家税务总局下发了税控开票软件信息数据接口规范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-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字节）

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-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文件时，格式如下：

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-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个字符） 

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。