附4 财政电子票据公共服务接口规范docx

《附4 财政电子票据公共服务接口规范docx》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、附4：财政电子票据公共服务接口规范1适用范围本规范规定了财政电子票据公共服务接口，为财政电子票据服务平台和外部系统间在交互财政电子票据相关电子信息时的接口技术规范，实现财政电子票据的下载和入账反馈。2技术规范2.1处理流程使用公共服务接口时，基于HTTPS协议，采用POST方式“请求-响应”模式进行交互。（1）请求方发送请求请求方系统由财政电子票据服务平台分配一个身份标识app_id，每个app_id配有一个秘钥（appKey）。请求方根据接口要求，构造请求参数并9使用密钥（appKey）对请求参数进行签名。（2）电子票据服务

2、平台返回响应结果电子票据服务平台通过验证请求参数的签名来验证请求方身份合法性及数据完整性，无误后进行处理。a)处理成功时，根据请求服务不同，响应结果分为两种情况：电子票据下载时，返回电子票据文件压缩包；电子票据入账时，返回JSON格式的参数。b)处理失败时，响应结果为JSON格式的参数。（3）请求方接收数据请求方收到响应结果后，首先判断电子票据服务平台响应是否成功：电子票据下载时，通过HTTPContent-Type判断是否成功；电子票据入账时，通过返回码判断是否成功。1.1数据类型序号类型类型名称说明1String字符串标准

3、XML字符串类型（xs:string）。长度分为定长和变长两种，例如：长度“8”表示字符串长度固定为8，长度“[1,100]”表示字符串长度在1到100之间2NString数字串表示由数字0-9组成的字符串，如：01234567893Integer整数标准XML整数类型（xs:integer）4Decimal实数标准XML实数类型（xs:decimal）5Base64BinaryBase64编码字符串标准XMLBase64编码字符串类型（xs:base64Binary）6Date日期表示日期，格式为yyyyMMdd（年月日），

4、长度为8位，如：2016061397Time时间表示时间，格式为HH:mm:ss（时分秒），长度为8位，如：09:29:538DateTime日期时间表示日期时间，格式为yyyyMMddHH:mm:ss（年月日时分秒），长度为17位，如：2016061309:29:539UTCDateTimeUTC日期时间表示UTC日期时间，格式为ddMMMyyyyHH:mm:ssz（日月年时分秒时区），长度为24位，如：13Jun201609:29:53GMT10Currency金额表示金额，单位为元，整数部分最长15位，小数部分固定两位，

5、不能包含逗号等分隔符，如：12345.671.1参数说明序号标识符数据项名称类型长度说明强制1methodString接口服务名称是2app_idString应用帐号是3security安全码String请求串的防伪码。是4formatString定义请求参数message和接口返回的数据格式。取值说明：json是5datetimeDateTime时间，格式为yyyyMMddHHmmssSSS是6version版本NString5接口版本,默认版本1.0.1是7message_id请求编号String[1,50]每次请求生成一

6、个唯一请求编号是8message请求业务参数String请求业务参数，参见具体接口描述。需转换为Base64编码。说明：（1）参数名必须为小写字母；（2）业务参数message的构成，根据具体接口描述构造；（3）字符集统一采用UTF-8编码格式。91接口列表接口服务名称描述downloadPNG4AccountByDate电子票据下载accountForRecode电子票据入账反馈2接口描述2.1电子票据下载单位通过该接口下载待入账电子票据。2.1.1服务名downloadPNG4AccountByDate2.1.2业务参数节

7、点：message序号标识符数据项名称类型长度说明强制1agency_code单位代码String[1,30]一般采用组织机构代码是2agency_name单位名称String[1,100]是3agency_type单位类型NString11:开票单位2:交款单位是4bill_batch_code电子票据代码NString8否5end_date开票终止日期Date否6batch_no批次序列号NString13上次下载时返回的最大的序列号；初始值为0是2.1.3返回参数根据HTTP响应头中Content-Type值判断成功或失

8、败。成功时值为9application/x-zip-compressed，失败时值为application/json。（1）成功返回电子票据文件压缩包，命名规则为：包内电子票据份数-最大批次序列号.zip。电子票据压缩包文件名提取方式：HTTPHeadercontent-di