江苏国税网络开票机接口规范

/7isino(9为索京E晨雪盍『心科技有限4*司

网络开票机接口设计

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

/7isino（9为索京E晨雪盍『心科技有限4*司

历史版本

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

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张伟章节3.4.2和章节483的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节点

/7isino(9为需需靠盛出盍F'3科技有限A司

目录

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提交报文..........................................................................II

3.2.3返叵I报文..........................................................................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返回报文..........................................................................30

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

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

/7isino(9为需需靠盛出盍F'3科技有限A司

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

3.5.3返回报文.........................................................................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.11.3返回报文.........................................................................39

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

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

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

“AisinoCorporation

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

3.12.3返回报文.........................................................................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

/7isino（9为需需靠盛出盍F'3科技有限A司

1.开通流程

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

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

开通简要流程:

厂商登记机器

码与用户ID

▼

客服将数据维

护进增值管理

系统

返回许可码，

供厂商存储至

税控机中

纳税人接入服

务

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

机器码,用户ID

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

如：

0712098123456780,320101000000001

0712098123456790,32010100000000101

返回许可码如下：

许可码：b7876850b8331a3

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

“fiiJc3，i，nfln#AisinoCorporation

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

2.交互说明

2.1交互方式

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

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

2.2交互URL

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

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

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

2.3交互基本结构

2.3.1提交报文

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

<request>

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

<param>

vid>机器码</id>

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

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

vkey>许可码</key>

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

vcsDm>厂商代码06</csDm>

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

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

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

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

fiicinnAisinoCorporation

〈security〉密文〈/security〉

vsecurityMode,加密模式（规则见下文）</securityMode>

〈interfaceVersion》接口报文版本号，当前版本号为l.Ov/interfaceVersion〉

</param>

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

</request>

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

序号请求类型说明备注

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

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

\S^AisinoCorporation

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

3.securityMode规贝!]

暂时只支持MD5（16位）方式加密

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

4.security

存放密文

例如，加密串：2013110711,MD5加密后:7e7e051dlc357ebl

<security>7e7e051dlc357ebl</security〉

返回报文

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

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

<RESPONSESTATUS="SUCCESS|FATAL”>

<TYPE>请求类型</TYPE>

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

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

</RESPONSE>

3.报文说明

3.1企业基本信息请求

3.1.1功能描述

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

3.1.2提交报文

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

3.1.3返回报文

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

AisinoCorporation

<?xmlversion=H1.0nencoding=“GBK"？>

<business>

<group>

vnsrsbh>纳税人识别号〈/nsrsbh>

vnsrmc>纳税人名称v/nsimc>

<nsrSwjgDm>纳税人税务机关代码</nsrSwjgDm>

<khyh>开户银行</khyh>

<yhzh>银行账号</yhzh>

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

<dhhm>电话号码</dhhm>

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

<jmXx>

<zqjmfsDm>征前减免方式v/zqjmfsDm>

<jms>减免数</jms>

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

<xkbz>限开标志</xkbz>

</jmXx>

<jmXx>

<zqjmfsDm>征前减免方式v/zqjmfsDm>

<jms>减免数<斤ms>

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

<xkbz>限开标志</xkbz>

</jmXx>

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

</group>

只支持单户企业下载

<business>

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

“fiicinfinxAisinoCorporation

说明：

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

接口，下载减免品目。

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

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

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

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

3.2购票请求

3.2.1功能描述

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

3.2.2提交报文

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

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

3.2.3返回报文

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

<business>

<group>

vfpDm>发票代码</fpDm>

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

<dqhm>当前号码</dqhm>

vfpzh>发票号码止</fpzh>

<userld>用户ID</userId>

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

vfpzlMc>发票名称v/fpzlMc>

<lgrq>领购日期</lgrq>

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

AisinoCorporation

vjobld>领购ID<〃obId>

<kjlx></kjlx>

<kpxe>开票限额</kpxe>

vjgsj>间隔时间</jgsj>

vmbfs>每本份数v/mbfs>

</group>

<group>

多条购票记录…

</group>

</business>

实例：

<?xmlversion=',1.0Mencoding=nGBKn?>

<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>

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

<lgrq>2012-ll-19</lgrq>

<jxqx></jxqx>

<jobld>32060207WT06030_132061280530.0069800l</jobld>

<kjlxx/kjlx>

<kpxe></kpxe>

<jgsj>2</jgsj>

<mbfs>200</mbfs>

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

“fiicinfln#AisinoCorporation

</group>

</business>

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

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

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

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

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

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

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

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

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

3.3验证码请求

3.3.1功能描述

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

3.3.2提交报文

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

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

<request>

<type>verifyUser</type>

<param>

<id>机器码v/id>

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

（password〉登录密码<卅2$5\¥0苗〉

<key>许可码</key>

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

vcpDm>产品代H马06</cpDm>

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

“fiicinfinxAisinoCorporation

</param>

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

</request>

3.3.3返回报文

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

<?xmlversion=n1.0Mencoding="GBK"？>

<RESPONSESTATUS="SUCCESS|FATAL”>

<TYPE>请求类型</TYPE>

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

<CONTENT><![CDATA[验证码]]></CONTENT>

</RESPONSE>

3.4上传发票请求

3.4.1功能描述

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

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

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

3.4.2提交报文

上传处理

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

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

发票内容XML压缩效率高。

采用标准ZIP算法压缩

采用对称加密DES算法

密钥：NjtwxXmJ

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

AisinoCorporation

密钥编码：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中，存放在基本结构中作为<param>的子节点，节点名称为code。

<?xmlversion=M1.0nencoding=,,GBKn?>

<request>

<type>upload</type>

<param>

<id>机器码</id>

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

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

<key>许可码</key>

vcsDm>厂商代码06</csDm>

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

vcode>验证码</code>

（security〉密文〈/security〉

vsecurityMode>力口密模式</securityMode>

〈interfaceVersion〉报文版本号〈/interfaceVersion,

</param>

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

</request>

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

“fAisinoCorporation

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

<park>

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

<param>

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

</param>

<invoice>

<item>

vid.fpDm>发票代码<力(34口1T1>

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

<fpzh>发票止号<^^11>

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

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

<fs>份数</fs>

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

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

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

vje>金额<乖>

<kprq>日期(yyyyMMdd)</kprq>

vzfbz>作废标志，1表示作废，0表示正常v/zfbz>

vkpfNsrsbh>售货方税号</kpfNsrsbh>

vkpfMc>售货方名称v/kpfMc>

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

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

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

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

<ghfNsrsbh>购货方税号</ghfNsrsbh>

<ghfMc>购货方名称</ghfMc>

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

“fii■c与i〃nfln#AisinoCorporation

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

vghfLxdh>购货方电话v/ghfLxdh>

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

<ghfYhzh>购货方银行账号v/ghfYhzh>

vkpr>开票人v/kpr>

<skr>收款人</skr>

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

<sjKpfMc>实际开票方名称v/sjKpfMc>

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

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

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

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

<detail>

<record>

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

<ggxh>规格型号</ggxh>

<jldw>计量单位</jldw>

vsl>数量</sl>

<dj>单价v/dj>

<je>金额v〃e>

</record>

多个发票明细…

</detail>

</item>

多张发票...

</invoice>

</park>

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

AisinoCorporation

注意：

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。0,0)FALSETRUE

来源类型lylxintFALSETRUE

最大金额品名pmvarchar(128)FALSEFALSE

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

金额jenumeric(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

/7isino（9为需需靠盛出盍F'3科技有限A司

购货方地址ghfLxdzvarchar(200)FALSEFALSE

购货方电话ghfLxdhvarchar(60)FALSEFALSE

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

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

开票人kprvarchar(16)FALSEFALSE

收款人skrvarchar(16)FALSEFALSE

实际开票方纳税人

识别号sjKpfNsrsbhvarchar(32)FALSETRUE

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

实际开票方税务机

关代码nsrSwjgDmvarchar(11)FALSETRUE

原发票代码s_fp_dmvarchar(12)FALSEFALSE

原发票起号s_fpqhvarchar(8)FALSEFALSE

明细说明（平推票）

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

明细主表

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

品名pmvarchar(16)FALSEFALSE

规格型号ggvarchar(16)FALSEFALSE

计量单位jldwvarchar(16)FALSEFALSE

数量sivarchar(16)FALSEFALSE

金额jevarchar(16)FALSEFALSE

单价djvarchar(16)FALSEFALSE

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

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

AisinoCorporation

例如：

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

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

<park>

<param>

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

</param>

<invoice>

<item>

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

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

<fpzh>发票止号</fpzh>

……略过其他节点

<detail>

<record>

<bz>#ii</bz>

vdj>单价v/dj>

<gg>规格</gg>

vje>金额v/je>

<jldw>单位<<jldw>

<pm>品名</pm>

<sl>数量v/sl>

</record>

....record可以有多个

</detail>

<fh»复核人</fhr>

<invoice>

</park>

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

“fiiJc3，i，nfinxAisinoCorporation

.1工商业(11)

主表：

名称说明

(hr复核人

明细：

不同的票种不同的行数:

8011k80511：3行

80211、80611：4行

80311>80711：15行

80411,80811：5行

名称对应字段

继承明细主表

bz备注

.2出口(12)

主表：

名称说明

hth合同号

contractNo合同号英文

myfs贸易方式

trade贸易方式英文

xyzh信用证号

IcNo信用证号英文

receivUnit出售单位英文

payUnit购货方英文

date日期英文

/7isino(9为需需靠盛出盍F'3科技有限A司

ybh运编号

issued开证银行英文

qtsx其他事项

csfdz出售方英文地址

ghfdz购售方英文地址

telNo电话英文

wbdxje外币大写金额

wbJe外币金额

biZhong币种

bzMc币种名称

huiLv汇率

hlSz