金税接口规范3.0.doc

金税接口规范3.0篇一：增值税发票税控开票软件数据接口规范v3.0 增值税发票税控开票软件 数据接口规范V3.0 1 概述 为进一步优化纳税服务，满足纳税人内部管理信息系统与增值税发票税控开票软件（以下简称开票软件）的衔接需要，国家税务总局下发了开票软件数据接口规范V1.0和V2.0版。随着增值税发票管理新系统的全国推广和营改增的全面实施，公布的接口已经不能满足需要，现对该接口进行更新升级，形成V3.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节点，用于差额税计算。 3.1.2 待开发票信息导入接口 1）导入文件XML格式如下： <?xml version=1.0 encoding=GBK ? <Kp <Version2.0</Version /有此节点，则表示用带分类编码 <Fpxx <Zsl2</Zsl /此文件含有的单据信息数量<Fpsj <Fp <Djh1</Djh /单据号（20字节）<Gfmc购方名称</Gfmc/购方名称（100字节）<Gfsh110000000000000</Gfsh /购方税号<Gfyhzh购方银行账号</Gfyhzh/购方银行账号（100字节）<Gfdzdh购方地址电话</Gfdzdh/购方地址电话（100字节）<Bz备注</Bz /备注（240字节）<Fhrfhr</Fhr /复核人（8字节）<Skrskr</Skr /收款人（8字节） <Spbmbbh商品编码版本号</Spbmbbh /商品编码版本号(20字节)（必输项） <Hsbz含税标志</Hsbz /含税标志 0：不含税税率，1：含税税率，2：差额税;中外合作油气田（原海洋石油）5%税率、1.5%税率为1，差额税为2，其他为0； <Spxx <Sph <Xh1</Xh/序号 <Spmc商品名称</Spmc/商品名称，金额为负数时此行是折扣行，折扣行的商品名称应与上一行的商品名称一致（100字节） <Ggxh规格型号</Ggxh/规格型号（40字节） <Jldw计量单位</Jldw/计量单位（32字节） <Spbm商品编码</Spbm/商品编码(19字节)（必输项） <Qyspbm企业商品编码</Qyspbm /企业商品编码（20字节） <Syyhzcbz优惠政策标识</Syyhzcbz /是否使用优惠政策标识0： 不使用，1：使用（1字节） <Lslbz零税率标识</Lslbz /零税率标识空：非零税率，0： 出口退税，1：免税，2：不征收，3普通零税率（1字节） <Yhzcsm优惠政策说明</Yhzcsm /优惠政策说明（50字节） <Dj100</Dj /单价（中外合作油气田（原海洋石油）5%税率，单价为含税单价） <Sl10</Sl /数量 <Je1000.00</Je/金额，当金额为负数时为折扣行<Slv0.17</Slv/税率 <Kce扣除额</Kce /扣除额，用于差额税计算 </Sph </Spxx </Fp <Fp <Djh2</ Djh /单据号（20字节）<Gfmc购方名称1</Gfmc /购方名称（100字节）<Gfsh110000000000000</Gfsh /购方税号<Gfyhzh购方银行账号1</Gfyhzh /购方银行账号（100字节）<Gfdzdh购方地址电话1</Gfdzdh /购方地址电话（100字节）<Bz备注1</ Bz /备注（240字节）<Fhrfhr1</ Fhr /复核人（8字节）<Skrskr1</ Skr /收款人（8字节） <Spbmbbh商品编码版本号</Spbmbbh /商品编码版本号(20字节) （必输项） <Hsbz含税标志</Hsbz /含税标志 0：不含税税率，1：含税税率，2：差额税;中外合作油气田（原海洋石油）5%税率、1.5%税率为1，差额税为2，其他为0； <Spxx <Sph <Xh1</Xh /序号 <Spmc商品名称1</Spmc/商品名称，金额为负数时此行是折扣行，折扣行的商品名称应与上一行的商品名称一致（100字节） <Ggxh规格型号1</Ggxh/规格型号（40字节） <Jldw计量单位1</Jldw/计量单位（32字节） <Spbm商品编码</Spbm/商品编码(19字节) （必输项） <Qyspbm企业商品编码</Qyspbm /企业商品编码（20字节） <Syyhzcbz优惠政策标识</Syyhzcbz /是否使用优惠政策标识0： 不使用，1：使用（1字节） <Lslbz零税率标识</Lslbz /零税率标识空：非零税率，0： 出口退税，1：免税，2：不征收，3普通零税率（1字节） <Yhzcsm优惠政策说明</Yhzcsm /优惠政策说明（50字节） <Dj100</Dj/单价（中外合作油气田（原海洋石油）5%税率，单价为含税单价） <Sl10</Sl/数量 <Je1000.00</Je /金额，当金额为负数时为折扣行<Slv0.17</Slv /税率 <Kce扣除额</Kce /扣除额，用于差额税计算 </Sph </Spxx </Fp </Fpsj </Fpxx </Kp 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格式时，格式如下： <?xml version=1.0 encoding=GBK ? <Kp <Version2.0</Version /有此节点，则表示用带分类编码 <Fpxx <Zsl2</Zsl <Fpsj <Fp /此文件含有的发票信息数量<Djh1</Djh /单据号（20字节）<Fpzl专用发票</Fpzl /发票种类（专用发票或普通发票）<Lbdm1400111560</Lbdm/类别代码（10字节）<Fphm00000001</Fphm /发票号码（8字节）<Kprq20140305</Kprq /开票日期（YYYYMMDD）<Gfmc购方名称</Gfmc/购方名称（100字节）<Gfsh110000000000000</Gfsh /购方税号<Gfyhzh购方银行账号</Gfyhzh/购方银行账号（100字节）<Gfdzdh购方地址电话</Gfdzdh/购方地址电话（100字节）<Xfmc销方名称</Xfmc /销方名称（100字节）<Xfsh110000000000001</Xfsh /销方税号<Xfyhzh销方银行账号</Xfyhzh /销方银行账号（100字节）<Xfdzdh销方地址电话</Xfdzdh /销方地址电话（100字节）篇二：金税接口文本接口文件格式 防伪开票文本接口软件 接口文件格式说明 一、 接口文件格式 1、 文件种类 接口文件为纯文本文件，各行尾以回车换行码（ASCII码13和10）或换行码（ASCII10）分隔均可，可用各种文本编辑器编写或通过应用程序生成。 2、 注释行 文件中以两个斜杠（/）置于行首的行为注释行，系统读入文件时忽略注释行和空行。 3、 分隔符 每行中各个项目之间以两个波浪号（“”）分隔，行尾各项目均省略时可省略相应的分隔符。 4、 日期格式 日期以四位年份+两位月份+两位日期表示：YYYYMMDD，例：1998年5月22日 - 19980522。 5、 项目格式说明 文件中按填写要求可分为固定项、选择项和任意项。在项目格式说明的括号中，固定项为双引号引住的内容，不可变化；选择项则在备注栏中说明可选的值。 任意项按项目内容分为文本、整数和数值，文本由任意可显示字符组成，限定的最大长度为字符个数（一个汉字或全角符号算两个字符）；整数限定最大位数；数值以不带千位分隔符的十进制浮点数表示，限定总长度和最大小数位数。如“税额(数值14.2)”表示最大为“99999999999.99”的数。 必有项数栏限定各行最少应有的项目数，少于该数则该行无效。各行项目数不小于必有项目数，但小于总项目数时，未填写的各项将由系统自动补上适当的值。 二、销售单据传入文件 文件格式文件示例 SJJK0101销售单据传入5月2日三厂销售业务 /单据一： 961100013远方公司321000X89010001湖北省武汉市工行珞珈山办事处软件价格不包含有偿服务费张三李四 财务软件套四模块110300.000.1715100软磁盘盒5-1-30.000.1715100-5.12软磁盘盒3160.000.1715101010.2 /单据二： 961100025康托公司321000789010005湖北省武汉市工行珞珈山办事处8734122-2314软件价格不包含有偿服务费财务软件（详见清单） 财务软件套四模块220000.000.1715103000.13400.03510.0215.2财务软件套八模块241000.000.171510543.21软磁盘盒510400.000.1715100软磁盘盒3.51006000.000.1715100硬磁盘块1G11300.000.171510 /单据三： 961100034武汉四通公司321000789010006湖北省武汉市工行珞珈山办事处31211-2134软件价格不包含有偿服务费 财务软件套四模块010000.000.1715100财务软件套八模块120500.000.1715100硬磁盘块3G24000.000.171510 精制色拉油公斤一级10600.000.1303020 三、作废单据传入文件 1、 文件功能 传入销售单据作废单据号，作废已传入的销售单据和作废单据已生成的发票。 2、文件格式3、文件示例 SJJK0102作废销售单据传入5月2日误传作废 /单据一： 96110001 /单据二： 961100025 四、已开发票传出文件 1、文件格式2、文件示例 SJJK0103已开发票传出 21998050119980531 /发票一： 000130698114000010004119980512059611000276233.350.1711076.66远方公司 321000789010005湖北省武汉市工行珞珈山办事处保定铁鞋厂130601000000000河北省保定市开别大街18号 3352051保定工行532611-3357211刘旭冬 0财务软件套四模块176233.350.1711076.6676233.3501510 /发票二： 000130698114000010007219980512059611000440482.000.175882.00康拓公司 110108078901007北京市海淀区知春路61号 68744479工商行海淀支行中关村分理处462088-07保定铁鞋厂130601000000000河北省保定市开别大街18号 3352051保定工行532611-3357211不包含有偿服务费刘旭冬 0财务软件套八模块139780.000.175780.0039780.0001510 0软磁盘盒3.510702.000.17102.0070.201510篇三：金税接口操作说明 金税接口操作说明文档 一、接口设置 . 2 二、业务操作说明： . 3 三、注意事项： . 6金税接口说明文档 一、接口设置 1. 安装防伪开票组件接口软件； 2. 把接口的注册文件放到%防伪开票系统的安装目录% BIN下 3. 把%防伪开票系统的安装目录%bin下的TaxCardX.dll文件复制至 c:windowssystem32 下 4. 注册dll: 在开始菜单中选择运行 ,输入 regsvr32 TaxCardX.dll 5. 添加可信站点：打开IE -工具-Internet选项 把OA系统的地址,添加至可信站点 设置可信站点的安全级别：点击自定义级别 “对未标记为可安全执行脚本的ActiveX控件初始化并执行脚本” 设置为”提示”“下载未签名的ActiveX“设置为”提示” 二、业务操作说明： 1. 须知： 使用接口文件，必须已经安装了防伪系统，如右图所示 金税卡只能独点操作：防伪系统与OA系统导入发票不能都打开。在导入发票时，防伪系统必须关闭。导入发票操作结束后，请关闭所有OA系统的页面； 税务信息必须填写正确。如税号、单位名称、开票限额、税率等必须填写正确;导入发票前，请仔细确认选中的数据; 导入金税的功能，只是把要开发票导入至开票系统，如需打印发票，请在数据都导入完成后，关闭所有OA系统页面，进入防伪开票系统进行打印。 2. 功能菜单下“接口管理”-“金税接口”节点，进入如下初始界面： 根据月份生成发票数据、测试金税、导入金税等操作。 ? 获取数据操作 在初始界面下，选择要对应月份单击按钮，系统自动计算各客户对应的销售数据，并根据”基础信息-税号信息维护”中设置开票限额，自动拆分能开票的数据； 已开票的客户，本月不重新生成数据。 ? 测试金税操作在初始界面下，单击 信息,弹出以下窗口。按钮，测试金税是否能正常启动，并查看对应的库存查询库存发票后，一定要。 点击 启动金税卡,如弹出以下对话框,请选择。 点击,查看当前金税卡对应的库存信息,如下图所示， 点击，关闭金税卡 ? 导入金税 在初始界面下，选择要导入的数据，单击按钮，弹出如下图提示窗口。 如确认数据无误，请选择“确定”弹出以下图所示窗口。