政策法规
增值税发票清单导入开票增值税普通发票(电子)企业端(服务器版可编程)接口规范
作者: 发布时间:2020-03-12 浏览次数:

【简介】本文主要就增值税发票清单导入开票有关的增值税发票清单导入增值税普通发票(电子)企业端(服务器版可编程)接口规范进行详细的描述


第1章 接口概述

1.1.接口概述

本接口用于电子发票系统对接增值税发票系统升级版开具增值税普通发票(电子)的接口说明。接口设计为以XML格式字符串作为参数传递。

1.2.适用范围

该接口规范适用于通过税控设备(目前特指税控盘组/金税盘组)实现电子发票与升级版系统的对接,仅支持增值税普通发票(电子)。

第2章 接口说明

2.1.登记信息查询

接口说明:获取税控设备基本登记信息。

业务类型:"DJXXCX"

输入参数:

<?xml version="1.0" encoding="gbk"?>

<business id="DJXXCX" comment="登记信息查询">

<REQUEST_COMMON_DJXXCX>

      <NSRSBH>纳税人识别号</NSRSBH>

</REQUEST_COMMON_DJXXCX>

</business>

返回数据:

<?xml version="1.0" encoding="gbk"?>

<business id="DJXXCX" comment="登记信息查询">

<RESPONSE_COMMON_DJXXCX class="RESPONSE_COMMON_DJXXCX">

   <NSRSBH>纳税人识别号</NSRSBH>

   <NSRMC>纳税人名称</NSRMC>

   <SWJGDM>主管税务机关代码</SWJGDM>

   <SWJGMC>主管税务机关名称</SWJGMC>

   <JQBH>税控设备编号</JQBH>

   <DQSZ>当前时钟</DQSZ>

   <RETURNCODE>返回代码</RETURNCODE>

   <RETURNMSG>返回信息</RETURNMSG>

</RESPONSE_COMMON_DJXXCX>

</business>

参数说明:

索引

ID

名称

长度

必须

说明

1 

NSRSBH

纳税人识别号

20


2 

NSRMC

纳税人名称

80


3 

SWJGDM

主管税务机关代码

16


4 

SWJGMC

主管税务机关名称

80


5 

JQBH

税控设备编号

12


6 

DQSZ

当前时钟

14

YYYYMMDDHHMMSS

7 

RETURNCODE

返回代码

4

0000成功,其它失败

8 

RETURNMSG

返回信息

160

变长

2.2.发票库存查询

接口说明:查询企业普通发票(电子)库存。

业务类型:"FPKCCX"

输入参数:

<?xml version="1.0" encoding="gbk"?>

<business id="FPKCCX" comment="发票库存查询">

<REQUEST_COMMON_FPKCCX>

   <NSRSBH>纳税人识别号</NSRSBH>

</REQUEST_COMMON_FPKCCX>

</business>

索引

ID

名称

长度

必须

说明

1 

NSRSBH

纳税人识别号

20


返回数据:

<?xml version="1.0" encoding="gbk"?>

<business id="FPKCCX" comment="发票库存查询">

<RESPONSE_COMMON_FPKCCX>

   <SYFPFS>剩余发票份数</SYFPFS>

   <RETURNCODE>返回代码</RETURNCODE>

   <RETURNMSG>返回信息</RETURNMSG>

</RESPONSE_COMMON_FPKCCX>

</business>

参数说明:

索引

ID

名称

长度

必须

说明

1 

SYFPFS

剩余发票份数



2 

RETURNCODE

返回代码

4

0000成功,其它失败

3 

RETURNMSG

返回信息


变长

2.3.发票开具

接口说明:完成蓝字发票和红字发票开具。项目条数最大100条。

业务类型:"FPKJ"

输入参数:

<?xml version="1.0" encoding="gbk"?>

<business id="FPKJ" comment="发票开具">

<REQUEST_COMMON_FPKJ>

   <COMMON_FPKJ_FPT>

      <FPQQLSH>发票请求流水号</FPQQLSH>

      <KPLX>开票类型</KPLX>

      <BMB_BBH>编码表版本号</BMB_BBH>

       <ZSFS>征税方式</ZSFS>

      <XSF_NSRSBH>销售方纳税人识别号</XSF_NSRSBH>

      <XSF_MC>销售方名称</XSF_MC>

<XSF_DZDH>销售方地址、电话</XSF_DZDH>

<XSF_YHZH>销售方银行账号</XSF_YHZH>

<GMF_NSRSBH>购买方纳税人识别号</GMF_NSRSBH>

      <GMF_MC>购买方名称</GMF_MC>

      <GMF_DZDH>购买方地址、电话</GMF_DZDH>

      <GMF_YHZH>购买方银行账号</GMF_YHZH>

      <KPR>开票人</KPR>

      <SKR>收款人</SKR>

<FHR>复核人</FHR>    

      <YFP_DM>原发票代码</YFP_DM>

      <YFP_HM>原发票号码</YFP_HM>

      <JSHJ>价税合计</JSHJ>

<HJJE>合计金额</HJJE>

<HJSE>合计税额</HJSE>

<KCE>扣除额</KCE>

      <BZ>备注</BZ>

   </COMMON_FPKJ_FPT>

   <COMMON_FPKJ_XMXXS size="1">

      <COMMON_FPKJ_XMXX>

          <FPHXZ>发票行性质</FPHXZ>

          <SPBM>商品编码</SPBM>

          <ZXBM>自行编码</ZXBM>  

          <YHZCBS>优惠政策标识</YHZCBS>

          <LSLBS>零税率标识<LSLBS/>

          <ZZSTSGL>增值税特殊管理</ZZSTSGL>

          <XMMC>项目名称</XMMC>

          <GGXH>规格型号</GGXH>

          <DW>单位</DW>

          <XMSL>项目数量</XMSL>

          <XMDJ>项目单价</XMDJ>

          <XMJE>项目金额</XMJE>

          <SL>税率</SL>

          <SE>税额</SE>

      </COMMON_FPKJ_XMXX>

   </COMMON_FPKJ_XMXXS>

</REQUEST_COMMON_FPKJ>

</business>

参数说明:

索引

ID

名称

长度

必须

说明

1 

FPQQLSH

发票请求流水号

20


2 

KPLX

开票类型

1

0-蓝字发票;1-红字发票

3 

BMB_BBH

编码表版本号

20


4 

ZSFS

征税方式

1

0:普通征税

1减按计征

2:差额征税

5 

XSF_NSRSBH

销售方纳税人识别号

20


6 

XSF_MC

销售方名称

100


7 

XSF_DZDH

销售方地址、电话

100


8 

XSF_YHZH

销售方银行账号

100


9 

GMF_NSRSBH

购买方纳税人识别号

20


10 

GMF_MC

购买方名称

100


11 

GMF_DZDH

购买方地址、电话

100


12 

GMF_YHZH

购买方银行账号

100


13 

KPR

开票人

8


14 

SKR

收款人

8


15 

FHR

复核人

8


16 

YFP_DM

原发票代码

12


红字发票时必须

17 

YFP_HM

原发票号码

8


红字发票时必须

18 

JSHJ

价税合计


单位:元(2位小数)

19 

HJJE

合计金额


不含税,单位:元(2位小数)

20 

HJSE

合计税额


单位:元(2位小数)

21 

KCE

扣除额

12

小数点后2位,当ZSFS2时扣除额为必填项

22 

BZ

备注

200

备注长度应减去机器编号:ZZZZZZZZZZZ”,”对应正数发票代码:XXXXXXXXXXXX号码:YYYYYYYY”

字样长度,长度剩余130

项目明细,可多条(最大100)

23 

FPHXZ

发票行性质

1

0正常行、1折扣行、2被折扣行

24 

SPBM

商品编码

19


25 

ZXBM

自行编码

20


26 

YHZCBS

优惠政策标识

1

0:不使用,1:使用

27 

LSLBS

零税率标识

1

空:非零税率, 1:免税,2:不征收,3普通零税率

28 

ZZSTSGL

增值税特殊管理

50


29 

XMMC

项目名称

90

在发票和销货清单中,可在每一行商品下加入折扣行,折扣行商品名称栏填写“折扣(X.XXX%字样,其中“X”为折扣率数字,金额和税额栏以负数填写,税率与被折扣行商品税率相同,其它栏不填写。

30 

DW

计量单位

20


31 

GGXH

规格型号

40


32 

XMSL

项目数量


小数点后6

33 

XMDJ

项目单价


小数点后6位   不含税

34 

XMJE

项目金额


不含税,单位:元(2位小数)

35 

SL

税率


6位小数,例1%0.01

36 

SE

税额


单位:元(2位小数)

返回参数:

若企业

以上是Excel表格导入开票软件、金税接口批量开票软件、增值税专业发票清单导入开票、防伪税控开票接口、自动开票接口软件、增值税发票导入软件等的部分规范,若企业需要实现增值税防伪税控开票系统对接业务系统,如SAP、Oracle、PeopleSoft、JDE、金蝶、用友、浪潮、新中大、Microsoft、各种电商平台(天猫、京东、拼多多等),并希望支持多种数据库Oracle、SQL Server、MySQL、PostgreSQL等,可以看看SEAM Printer和SEAM Tax,这两种软件系统是完全满足企业自动批量开票,实现Excel表格导入开票、防伪税控开票接口、增值税专业发票清单导入开票、excel清单导入开票的功能详细建议参考这里。


版权所有 © 2010-2016 上海协明信息科技有限公司 – SEAM. 保留所有权利 沪ICP备13047021号                 上海协明信息科技有限公司是国内航天金税接口百旺金赋票接口开发提供商,为各种类型企业提供自动开票批量开票、清单导入、金税导入等金税开票系统接口及百旺金赋开票接口,让企业实现清单导入开票、自动批量开票及票据影像存档管理系统,同时为企业提供定制化开发及移动APP、微信二次开发等服务,协助客户提升管理效率。

               沪公网安备 31011002001350号                沪ICP备13047021号