发票通开放注册平台

一、概述

本规范主要是企业 ERP 系统与增值税盘开票之间的数据交互接口规范。接口规范包括通用规范和业务规范。通用规范描述所有接口必须遵守的公共部分，业务规范根据具体业务交互内容不同，描述实际业务需要的详细数据内容。

备注:增值税盘开票接口报文统一 UTF-8 编码传入，在有特殊字符时，需要企业进行转义。

二、接口规范

通用格式规范

通用格式

  <?xml version="1.0" encoding="UTF-8"?>
  <interface xmlns="" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/ interfaces.xsd" version="DZFPQZ0.2">
    <globalInfo>
      <appId>国票信息提供 appId</appId>
      <interfaceId></interfaceId> 
      <interfaceCode>DFXJ1001</interfaceCode> 
      <requestCode>DZFPQZ</requestCode>
      <requestTime>2013-09-04 09:58:53</requestTime>
      <responseCode>DS</responseCode> 
      <dataExchangeId>DZFPQZDZFPQZ300320130904095853110</dataExchangeId>
    </globalInfo>
    <returnStateInfo>
      <returnCode>0000(成功) 0001-9999(错误码)</returnCode>
      <returnMessage>成功或错误的详细消息</returnMessage> 
    </returnStateInfo>
    <Data>
      <dataDescription> 
        <zipCode>0</zipCode>
      </dataDescription> 
      <content>Base64 返回数据内容 </content>
      <contentKey>请求数据 content 节点内容 MD5 在 AES 加密 </contentKey>
    </Data>
  </interface>

通用接口数据项说明

全局数据项(globalInfo)说明:

数据项	数据项名称	类型	长度	说明
appId	授权标识	String		国票信息提供针对不同税号企业的授权应用标识
interfaceId	接口 ID	String		保留为空
interfaceCode	接口编码	String		具体见各接口定义
requestCode	数据交换请求发起方代码	String	2	标识数据交换请求发起方固定值:DZFPQZ
requestTime	数据交换请求发出时间	String		格式 YYYY-MM-DD HH24:MI:SS
responseCode	数据交换请求接受方代码	String		标识数据交换请求接受方固定值:DS
dataExchangeId	数据交换流水号	String	50	requestCode+ interfaceCode+8 位日期+9 位序列号

数据交换请求返回状态信息 returnStateInfo

数据项	数据项名称	类型	长度	说明
returnCode	返回代码	String	4	0000 成功，其他为错误
returnMessage	返回描述	String	不定长	0000 返回成功，其他返回错误描述，base64 编码

交换数据属性描述(dataDescription)的数据项说明:

数据项	数据项名称	类型	长度	说明
zipCode	压缩标识	String(提供压缩方式)		0 不压缩 1 压缩数据包大于 10k 要求自动压缩

交换数据内容(content)数据项说明:

数据项	数据项名称	类型	说明
Content	需要交换的	String	如果数据量大于
	数据内容		10k先压缩，然后整个内容使用base64
contentKey	数据内容解密后的内容	String	请求数据content节点内容MD5在AES加密

发票开具接口

发票查询接口

已开发票作废接口（纸票）

空白发票作废查询接口（纸票）

三、返回码对应表

代码(returnCode)	中文描述 returnMessage
0000	业务处理成功，返回信息可为空
0001	查询接口返回代码，请求正在处理。
9001	查询接口返回代码，此发票不存在。
9002	盘返回错误码
9007	系统运行时异常
9991	推送盘失败
9996	报文格式错误
9997	数据不符合规范
9999	业务处理失败，返回信息为详细错误描述信息