国税网络开票机接口规范

/iisino(§为流熨5温居盍fl科技有限区司

网络开票机接口设计

江苏爱信诺航天信息科技有限公司

/iisino（§为流熨5温居盍fl科技有限区司

历史版本

版本日期作者修改内容批准人

1.02010-07李方平初始化版本PM

1.12012-03张世科接口eInfo增加减免信息

增加接口更新减免品目

Request报文增加isZip

1.22012-3-9张世科支持税控机升级

接口eInfo增加减免信息限开标志

1.32012-3-21张世科接口eInfo返回数据增加时间，格式：

yyyy-MM-ddhh:mm:ss,用于授时

2.02012-10-21马晓龙更新支持票种，增加接口

2.12012-12-04马晓龙增加作废接口

2.22012-12-17马晓龙下载发票明细接口名修改为fpPmnr

2.32012-12-24马晓龙修改上传发票加密需求

2.42013-01-04马晓龙1.增加分机接口

2实.现密码加密

3修.改购票请求接口

2.52013-1-16马晓龙增加zipMode结点，支持处理GZIP

2.62013-3-13张伟3.2.2Igrq改成gpts

3.8.2发送报文改动

2.72013-4-1张伟章节342和章节4.8.3的XML中增加

s_fp_dm（源发票代码）

s_fpqh（源发票号码）

2.82013-4-2马晓龙完善3.6升级接口

2.92013-4-11

马晓龙章节3.4.2和4.8.3中增加userid

2.102013-4-16马晓龙增加3.12,修改3.6

2.112013-4-25张伟增加3.13修改密码

2.122013-6-5张伟3.2.3返回报文中增加mbfs（每本份数）

字段

2.132013-11-5张伟3.4上传发票请求接口中需要上传客户

端的版本号

2.142013-11-7张伟报文头中增加

security\securityMode\interfaceVersion节点

/iisino(§为流熨5温居盍fl科技有限区司

目录

1.开通流程....................................................................................6

2.交互说明....................................................................................7

2.1交互方式................................................................................7

2.2交互URL...............................................................................................................................................................7

2.3交互基本结构............................................................................7

2.3.1提交报文...........................................................................7

3.报文说明....................................................................................9

3.1企业基本信息请求.......................................................................9

3.1.1功能描述...........................................................................9

3.1.2提交报文...........................................................................9

3.1.3返回报文...........................................................................9

3.2购票请求...............................................................................11

3.2.1功能描述..........................................................................11

3.2.2提交报文..........................................................................11

3.2.3返【可报文..........................................................................11

3.3验证码请求.............................................................................13

3.3.1功能描述..........................................................................13

3.3.2提交报文..........................................................................13

3.3.3返回报文..........................................................................14

3.4上传发票请求...........................................................................14

3.4.1功能描述..........................................................................14

3.4.2提交报文..........................................................................14

3.4.3返I可报文..........................................................................30

3.5更新减免品目..........................................................................30

3.5.1功能描述..........................................................................30

jSi^inn澹江苏爱信诺航天信息科技有限公司

3.5.2提交报文.........................................................................30

353返问报文.........................................................................31

3.6网络开票机升级........................................................................31

3.6.1功能描述.........................................................................31

3.6.2提交报文.........................................................................31

3.6.3返回报文.........................................................................31

3.7网络授时...............................................................................32

3.7.1功能描述.........................................................................32

3.7.2提交报文.........................................................................32

3.7.3返回报文.........................................................................32

3.8发票下载...............................................................................32

3.8.1功能描述.........................................................................32

3.8.2提交报文.........................................................................33

3.8.3返回报文.........................................................................33

3.9作废发票..............................................................................35

3.9.1功能描述.........................................................................35

3.9.2提交报文.........................................................................35

3.9.3返回报文.........................................................................35

3.10发票分发..............................................................................35

3.10.1功能描述.........................................................................35

3.10.2提交报文.........................................................................36

3.10.3返回报文.........................................................................38

3.11分机退票..............................................................................38

3.11.1功能描述.........................................................................38

3.11.2提交报文.........................................................................38

3.113返回报文.........................................................................39

3.12下载文件.............................................................................39

3.12.1功能描述........................................................................39

/iisino(§为流熨5温居盍fl科技有限区司

3.12.2提交报文.........................................................................39

3.123返回报文.........................................................................39

3.13修改密码.............................................................................40

3.13.1功能描述.........................................................................40

3.13.2提交报文.........................................................................40

3.13.3返回报文.........................................................................40

4.附录..........................................................................................40

3.14江苏国税卷式票目录..................................................................40

3.15江苏国税平推式发票目录..............................................................40

3.16实例.................................................................................43

3.16.1购票请求.........................................................................43

3.16.2上传发票请求....................................................................43

5.其他.........................................................................................45

/iisino（§为流熨5温居盍fl科技有限区司

L开通流程

开通暂定由手工开通。税控机厂商提供需开通的税控机名单（格式下文中描述），由我方开通后返回开通成功的

税控机名单（含许可码）给税控机厂商。

开通简要流程：

税控机厂商提供如下格式的文本文件：

机器码，用户ID

（用户ID格式为税号+“_**"，**为两位分机号，取值01—99,如无分机，此处与税号一致）

如：

0712098123456780,320101000000001

0712098123456790,32010100000000101

返回许可码如下：

许可码：b7876850b8331a3

倡江苏爱信诺航天信息科技有限公司

jSi^innAisinoCorporation

初始密码：机器码后6位。

2.交互说明

2.1交互方式

终端访问CICSweb服务器（目前各地级市分别部署）的一个URL,通过HTTP协议连接，均采用POST方

法，采用XML格式进行数据封装，提交一个XML,返回一个XML,HTTP协议版本1.1以上。

2.2交互URL

CICSURL格式：http://{cicsserver}{:port）/uamsService.htm

测试示例：hl（p://06:7002/uamsService.hlm,此处随地级市变动而变动。

升级URL:hltp:〃06:7001/service.hlm,仅升级使用，此处唯一。

2.3交互基本结构

2.3.1提交报文

<?xmlversion="1.0"encoding="GBK''?>

<request>

vtype>请求类型elnfo|fslnfo|upload</type>

<param>

<id>机器码</id>

<userld>用户ID（新增）</userId>

<nsrsbh>纳税人识别号v/nsrsbh>

<key>许可码v/key>

〈password》登录密码（密码安全见下文）</password>

<csDm>厂商代码06</csDm>

<cpDm>产品代码06</cpDm>

<isZip>0-不压缩，默认1压缩v/isZip>

<zipMode>ZIP或GZIP（如无结点或结点为空，默认为ZIP）v/zipMode>

倡江苏爱信诺航天信息科技有限公司

jSi^inn/AisinoCorporation

<security>密文</security>

«eciirityMndp>加密模式（规则见下文）〈/securityMcde>

〈interfaceVersion》接口报文版本号，当前版本号为1.0</interfaceVersion>

</param>

<content><![CDATA[.......]]></content>

</request>

1.请求类型：iype=［如下表所示］

序号请求类型说明备注

1eInfo获取企业信息

2fslnfo获取购票信息

3verifyUser上传验证请求上传发票前

4upload上传发票

5updateJmpm更新减免品目

6updateSkj升级税控机注意服务器地址是升级URL

7syncTime时间同步

8fpPmnr下载发票

9fpCancel作废发票

10dispense发票分发

11withdrawal分机退票

12downloadFile下载文件

13password修改密码

2.password采用密文方式传输，

加密规则：password>"JSAISINO"，使用MD5加密（16位），编码为GBK。

输入：admin密码JSAISINO

输出：7044199e707bd362

3.interfaceVersion

倡江苏爱信诺航天信息科技有限公司

"J"Sni^"in，<n/AisinoCorporation

报文版本号，目前版本是1.0

3.seciirityMnde规贝I]

暂时只支持MD5(16位)方式加密

填写1或留空则为MD5(16位)加密，编码GBK

4.security

存放密文

例如,加密串：2013110711,MD5加密后：7e7e051dlc357eb1

<security>7e7e05ldlc357eb1</security>

返回报文

服务端根据相应请求返回相关细细，返回的xml会写入如下结构CDATA中，并把如下整个xml返回。

<?xmlversion："1.0”encoding="GBKn?>

<RESPONSESTATUS="SUCCESS|FATAU)

<TYPE>请求类型</TYPE>

<ALERD>若STATUS为FATAL时在此处写入失败原因</ALERT>

<CONTENTx![CDATA[]]x/CONTENT>

</RESPONSE>

3.报文说明

3.1企业基本信息请求

3.1.1功能描述

根据纳税人识别号返回企业基本信息。

3.1.2提交报文

发送时遵从2.3.1的结构请求类型(type)为eInfo,依次写入相关参数(paran)。

3.1.3返回报文

倡江苏爱信诺航天信息科技有限公司

"J"Sni^"in，<n/AisinoCorporation

<?xmlversion="1.0"cncoding="GBK''?>

<hnsiness>

<group>

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

<nsrmc>纳税人名称v/nsrmc>

<nsrSwjgDm>纳税人税务机关代码OnsrSwjgDm〉

<khyh>开户银行v/khyh>

<yhzh>银行账号v/yhzh>

<scjydz>生产经营地址v/scjydz>

<dhhm>电话号不马</dhhm>

<lxsj>离线时间单位为天.例：2</lxsj>

<jmXx>

vzqjmfsDmXiE前减免方式v/zqjmfsDm>

vjms>减免数</jms>

vjmyyDm>减免原因代码VjmyyDm>

vxkbz>限开标志v/xkbz>

</jmXx>

<jmXx>

<zqjmfsDm>征前减免方式</2川mfsDm>

vjms>减免数</jms>

<jmyyDm>减免原因代码</jmyyDm>

<xkbz>限开标志v/xkbz>

</jmXx>

<sj>时间，格式：yyyy-MM-ddhh:mm:ss</sj>

</group>

只支持单户企业下载

<business>

倡江苏爱信诺航天信息科技有限公司

jSi^innAisinoCorporation

说明：

jmXx减免信息，没有减免就没有该节点，将来有多个减免种类时，可能多节点，有该节点时可以调用updatejmpm

接口，下或减免品目。

zqjmfsDm征前减免方式:01按幅度减免,02按额度减免,03优惠税率。

jms减免数，zqjmfsDm=01时，jms为减免百分比,0.3就是减免30%,1就是全免。

jmyyDm减免原因代码，如：A_2011」37,财税[2011]137号免征蔬菜。

xkbz限开标志1限制只能开指定品目，0不限开.

3.2购票请求

3.2.1功能描述

根据参数获取企业购票信息。

3.2.2提交报文

发送购票请求根据2.3.1中定义，type为fslnfo,依次写入相关信息。

<gpts>购票天数（数字，例如：90）</gpts>

323返回报文

<?xmlversion='*1.0"encoding="GBK''?>

<business>

<group>

<fpDm>发票代码</fpDm>

<fpqh>发票号码起v/fpqh>

<dqhm>当前号码v/dqhm>

<fpzh>发票号码止</fpzh>

<userld>用户IDv/userld>

<fpzlDm>发票种类代码</fpzlDm>

<fpzlMc>发票名称<^2夙0

<lgrq>领购口期</lgrq>

倡江苏爱信诺航天信息科技有限公司

"J"Sni^"in，<n/AisinoCorporation

<jobld>领购ID</jobId>

<kjlx></kjlx>

<kpxe>开票限额</kpxe>

<jgsj>间隔时间</jgsj>

<mbfs>每本份数v/mbfs>

</group>

<group>

多条购票记录…

</group>

</business>

实例：

<?xmlversion："1.0”encoding="GBK''?>

<businessJSAISINO_QR='TRUE,'>

<group>

<fp_dm>132061280530</fp_dm>

<fpqh>00698001</fpqh>

<dqhm>0069803l</dqhm>

<fpzh>00702000</fpzh>

<userId>32060207WT06030</userId>

<fpzl_dm>28053</fpzl_dm>

<fpzl_mc>通用机打平推式发票v/fpzl_mc>

<lgrq>2012-11-19</lgrq>

<jxqx></jxqx>

<jobId>32060207WT06030_l32061280530_0069800l</jobld>

<kjlxx/kjlx>

<kpxe></kpxe>

<jgsj>2</jgsj>

<mbfs>200</mbfs>

倡江苏爱信诺航天信息科技有限公司

JSi^innAisinoCorporation

</group>

</hnsiness>

税控机开发商在开发时应注意一下几点：

1）该购票信息为实时购票信息，剔除了验旧缴销票；

2）用户第一次使用（即请求的gpts为空值时）返回该企业三个月前到现在的所有可开票记录；

3）非第一次使用（即请求的gpts有值时）返回从最后一次购票日期开始，到当前止的所有可开票记录

4）CTAIS的EJB取票时最小时间单位只精确到月。因此在开发过程中应注意，下载购票信息时返回的票，有可

能会与税控机前几次下载的票相等或有交集，开发商在开发过程中应注意比对。

5）kpxe如为空，则不限票面金额；如有值，票面金额不得大于限额。

6）jgsj如为空，默认为2。

7）购票记录返回的是该企业所有领购的发票,机具应根据自身票种支持性过滤其他种类发票：

3.3验证码请求

33.1功能描述

从后台服务器获取上传所需验证码。

33.2提交报文

上传发票前先上传一个验证的请求，获取返回验证码

<?xmlversion="1.0"encoding="GBKn?>

<request>

<type>verifyUser</type>

<param>

<id>机器码v/id>

<nsrsbh>纳税人识别号v/nsrsbh>

（password〉登录密码〈/password〉

<key>许可码v/key>

<csDm>厂商代码06</csDm>

<cpDm>产品代码06</cpDm>

倡江苏爱信诺航天信息科技有限公司

jSi^innAisinoCorporation

</param>

<content><![CDATA[]]></content>

</request>

3.3.3返回报文

验证返回，如验证成功会在CDATA中返回一个验证码。

<?xmlversion="1.0"encoding="GBK"?>

<RESPONSESTATUS="SUCCESS|FATALf

<TYPE>请求类型</TYPE>

<人1^区7'>若STATUS为FATAL时在此处写入失败原因</ALERT>

vCONTENT>v![CDATA[验证码]]x/CONTENT>

</RESPONSE>

3.4上传发票请求

3.4.1功能描述

将企业开具发票上传至后台服务器。

注：801~804为限额票，金额不能大于10000元。

805~808不限额，但税局也可以对个别企业开票金额进行限制。在购票请求中可以取到限额。

3.4.2提交报文

上传处理

为确保开票信息传输的效率与安全性，税控机开发商需把XML文件先压缩再加密，再采用Base64编码后放入

CDATA中上传。打包只针对上传发票请求，其他请求与返回不采用此方式。之所以先压缩再加密，是因为直接对

发票内容XML压缩效率高。

采用标准ZIP算法压缩

采用对称加密DES算法

密钥：NjtwxXmJ

倡江苏爱信诺航天信息科技有限公司

jSi^innAisinoCorporation

密钥编码：UTF8

由于DES算法采用的是64位加密方法，所以有8字节补齐的事项.

加密前：数据字节长度对8取余，余数为m,若m>0,则补足8-m个字节，字节数值为8・m,即差几个字节就

补几个字节，字节数值即为补充的字节数，若为0则补充8个字节的8

解密后：取最后一个字节，值为m,则从数据尾部删除m个字节，剩余数据即为加密前的原文

比如差三个字节就要填补3个3:XXXXX333

没有差就填补8个8:88888888

采用BASE64编码

上传发票请求，存放在基本结构里的CDATA中，上传发票要等验证请求通过后才能上传，且上传时要把验证

码加入上传xml中.存放在基本结构中作的子节点,节点名称为code。

<?xmlversion="1.0"encoding="GBK"?>

<request>

<type>upload</type>

<param>

<id>机器码</id>

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

（password》登录密码（此处为新增内容）〈/password,

<key>许可码v/key>

<csDm>厂商代码06</csDm>

<cpDm>产品代码06</cpDm>

<code>验证码v/code>

〈security〉密文〈/security〉

<securityMode>in密模式</securityMode>

〈interfaceVersion〉报文版本号々interfaceVersion〉

</param>

<content><![CDATA[......]]></content>

</request>

倡江苏爱信诺航天信息科技有限公司

"J"Sni^"in，<n/AisinoCorporation

<?xmlversion="1.0"cncoding="GBK"?>

<park>

vnsrsbh>开票方纳税人识别号</nsrsbh>

<param>

<version>客户端版本号v/version>

</param>

<invoice>

<item>

vid.fpDm>发票代码</id.fpDm>

<id.fpqh>发票起号</id.fpqh>

vfpzh>发票止号</fpzh>

<fpzlDm3>3位发票代码，根据12位发票代码获取第8位到第10位々fpzIDm3>

vfpzlDm>发票种类代码v/fpzlDm>

vfs>份数v/fs>

vlylx>来源类型，类型为8</lylx>

<pm>最大金额品名</pm>

<sl>最大金额数量</sl>

<je>金额</je>

vkprq>日期(yyyyMMdd)</kprq>

<zfbz>作废标志，1表示作废，0表示正常<7zfbz>

vkpfNsrsbh>售货方税号</kpfNsrsbh>

vkpfMc>售货方名称v/kpfMc>

<kpfLxdh>售货方电话</kpfLxdh>

<kpfLxdz>售货方地址</kpfLxdz>

<kpfKhyh>售货方开户银行</kpfKhyh>

<kpfYhzh>售货方银行账号</kpfYhzh>

vghfNsrsbh>购货方税号</ghfNsrsbh>

vghlMc>购货方名称v/ghfMc>

倡江苏爱信诺航天信息科技有限公司

jSi^inn/AisinoCorporation

<ghfLxdz>购货方地址</ghfLxdz>

<ghfl.xdh>购货方电话</ghf!,xdh>

<ghfKhyh>购货方开户银行</ghfKhyh>

vghfYhzh>购货方银行账号</且11£¥11211>

vkpr>开票人v/kpr>

<skr>收款人v/skr>

vsjKpfNsrsbh>实际开票方纳税人识别号</sjKpfNsrsbh>

vsjKpfMc〉实际开票方名称v/sjKpfMc>

<nsrSwjgDm>实际开票方税务机关代码v/nsrSwjgDm>

<s_fp_dm>原发票代码（开具负数发票时需有值，正常发票留空即可）</s_fp_dm>

vs_fpqh>原发票号码（开具负数发票时需有值,正常发票留空即可）</s_fpqh>

vuserld>用户登录名v/userld>（一般为税号，如果是分机用户，则为分机名称）

<detail>

<record>

<pm>品名即项目</pm>

vggxh>规格型号v/ggxh>

<jIdw>计量单位</jIdw>

vsl>数量</sl>

vdj>单价v/dj>

金额</je>

</record>

多个发票明细...

</detail>

</item>

多张发票…

</invoice>

</park>

倡江苏爱信诺航天信息科技有限公司

"jS"ni^"in，nAisinoCorporation

注意：

XML节点名称有大小写区分：

id.fpDm^id.fpqh由于是复合主键，注意这种点分隔的表达方式；

行政区划取意为CTAIS相关概念，尽量明细到开票方所在地区；

3位发票种类代码来自于《江苏省国家税务局发票样本》2010年版本。

发票主体内容数据类型描述:

名称对应字段数据类型为主键不能为空

发票代码id.fpDmvarchar(12)TRUETRUE

发票起号id.fpqhvarchar(8)TRUETRUE

发票止号fpzhvarchar(8)FALSEFALSE

3位发票种类fpzlDm3varchar(3)FALSETRUE

发票种类代码fpzlDmvarchar(5)FALSETRUE

份数fsnumeric(10,0)FALSETRUE

来源类型lylxintFALSETRUE

最大金额品名pmvarchar(128)FALSEFALSE

最大金额数量sinumeric。6,8)FALSEFALSE

金额.ienumeric(16,2)FALSETRUE

开票日期kprqDatetimeFALSETRUE

作废标志zfbzSmallintFALSETRUE

售货方税号kpfNsrsbhvarchar(32)FALSEFALSE

售货方名称kpfMcvarchar(128)FALSEFALSE

售货方电话kpfLxdhvarchar(60)FALSEFALSE

售货方地址kpfLxdzvarchar(200)FALSEFALSE

售货方开户银行kpfKhyhvarchar(200)FALSEFALSE

售货方银行账号kpfYhzhvarchar(50)FALSEFALSE

购货方税号ghfNsrsbhvarchar(20)FALSEFALSE

购货方名称ghfMcvarchar(128)FALSEFALSE

/iisino（§为流熨5温居盍fl科技有限区司

购货方地址ghfLxdzvarchar(200)FALSEFALSE

购货方电话ghfLxdhvarchar(60)FALSEFALSE

购货方开户银行ghfKhyhvarchar(200)FALSEFALSE

购货方银行账号ghfYhzhvarchar(50)FALSEFALSE

开票人kprvarchar(16)FALSEFALSE

收款人skrvarchar(16)FALSEFALSE

实际开票方纳税人

识别号sjKpiNsrsbhvarchar(32)FALSETRUE

实际开票方名称sjKpfMcvarchar(128)FALSETRUE

实阮开票方税务机

关代码nsrSwjgDnivarchar(11)FALSETRUE

原发票代码s_fp_dmvarchar(12)FALSEFALSE

原发票起号s_fpqhvarchar(8)FALSEFALzSE

3.421明细说明（平推票）

发票明细内容数据结构描述：

明细主表

名称对应字段数据类型为主键不能为空

品名pmvarchar(16)FALSEFALSE

规格型号ggvarchar(16)FALSEFALSE

计量单位jldwvarchar(16)FALSEFALSE

数量sivarchar(16)FALSEFALSE

金额jevarchar(16)FALSEFALSE

单价djvarchar(16)FALSEFALSE

以下各发票代码中的明细都继承此表。

倡江苏爱信诺航天信息科技有限公司

"J"Sni^"in，nAisinoCorporation

例如：

发票代码80111发票的XML内容格式是：

<?xmlversion=H1.0"encoding="GBK"?>

<park>

<param>

〈version〉客户端版本号〈/version〉

<param>

<invoice>

<item>

<id.fpDm>发票代码v/id.fpDm>

vid.fpqh>发票起号<万44411>

vfpzh>发票止号v/fpzh>

……略过其他节点

<detail>

<record>

<bz>备注v/bz>

<dj>单价</dj>

vgg>规格</gg>

vje>金额v/je>

<jldw>单位

vpm>品名v/pm>

vsl>数量</sl>

</record>

....record可以有多个

</detail>

vfhr>复核人</fhr>

<invoice>

</park>

/iisino(§为流熨5温居盍fl科技有限区司

.1工商业(11)

主表：

名称说明

fhr复核人

明细：

不同的票种不同的行数：

8011k80511：3行

8021k80611：4行

8031k80711：15行

8041k80811：5行

名称对应字段

继承明细主表

bz备注

.2出口(12)

主表：

名称说明

hth合问号

contractNo合同号英文

myf$贸易方式

trade贸易方式英文

xyzh信用证号

leNo信用证号英文

receivUnit出售单位英文

payUnit购货方英文

date日期英文

/iisino(§为流熨5温居盍fl科技有限区司

ybh运编号

issued开证银行英文

qtsx其他事项

csfdz出售方英文地址

ghfdz购售方英文地址

telNo电话英文

wbdxje外币大写金额

wbJe外币金额

biZhong币种

bzMc币种名称

huiLv汇率

hISz汇率数值

slhj数量合计

明细：

不同的票种不同的行数:

80312、80712：15行

80812：5行

名称对应字段

继承明细主表

bj标记

.3废旧物资/粮食等收购(41)

主表：

名称说明

而付款人

scr司秤人

倡江苏爱信诺航天信息科技有限公司

"jS"ni^"in，nAisinoCorporation

明细：

不同的票种不同的行数：

8014k80541：3行

8024k80641：4行

80341、70741：15行

8044R80841：5行

名称对应