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

财政电子票据公共服务接口 规范 编程规范下载gsp规范下载钢格栅规范下载警徽规范下载建设厅规范下载 适用范围本规范规定了财政电子票据公共服务接口，为财政电子票据服务平台和外部系统间在交互财政电子票据相关电子信息时的接口技术规范，实现财政电子票据的下载和入账反馈。技术规范处理 流程 快递问题件怎么处理流程河南自建厂房流程下载关于规范招聘需求审批流程制作流程表下载邮件下载流程设计 使用公共服务接口时，基于HTTPS 协议 离婚协议模板下载合伙人协议 下载渠道分销协议免费下载敬业协议下载授课协议下载 ，采用POST方式“请求-响应”模式进行交互。（1）请求方发送请求请求方系统由财政电子票据服务平台分配一个身份标识app_id，每个app_id配有一个秘钥（appKey）。请求方根据接口要求，构造请求参数并使用密钥（appKey）对请求参数进行签名。（2）电子票据服务平台返回响应结果电子票据服务平台通过验证请求参数的签名来验证请求方身份合法性及数据完整性，无误后进行处理。处理成功时，根据请求服务不同，响应结果分为两种情况：电子票据下载时，返回电子票据文件压缩包；电子票据入账时，返回JSON格式的参数。处理失败时，响应结果为JSON格式的参数。（3）请求方接收数据请求方收到响应结果后，首先判断电子票据服务平台响应是否成功：电子票据下载时，通过HTTPContent-Type判断是否成功；电子票据入账时，通过返回码判断是否成功。数据类型序号类型类型名称说明1String字符串标准XML字符串类型（xs:string）。长度分为定长和变长两种，例如：长度“8” 表 关于同志近三年现实表现材料材料类招标技术评分表图表与交易pdf视力表打印pdf用图表说话 pdf 示字符串长度固定为8，长度“[1,100]”表示字符串长度在1到100之间2NString数字串表示由数字0-9组成的字符串，如：3Integer整数标准XML整数类型（xs:integer）4Decimal实数标准XML实数类型（xs:decimal）5Base64BinaryBase64编码字符串标准XMLBase64编码字符串类型（xs:base64Binary）6Date日期表示日期，格式为yyyyMMdd（年月日），长度为8位，如：7Time时间表示时间，格式为HH:mm:ss（时分秒），长度为8位，如：09:29:538DateTime日期时间表示日期时间，格式为yyyyMMddHH:mm:ss（年月日时分秒），长度为17位，如：09:29:539UTCDateTimeUTC日期时间表示UTC日期时间，格式为ddMMMyyyyHH:mm:ssz（日月年时分秒时区），长度为24位，如：13Jun201609:29:53GMT10Currency金额表示金额，单位为元，整数部分最长15位，小数部分固定两位，不能包含逗号等分隔符，如：12345.67参数说明序号标识符数据项名称类型长度说明强制1methodString接口服务名称是2app_idString应用帐号是3security安全码String请求串的防伪码。是4formatString定义请求参数message和接口返回的数据格式。取值说明：json是5datetimeDateTime时间，格式为yyyyMMddHHmmssSSS是6version版本NString5接口版本,默认版本1.0.1是7message_id请求编号String[1,50]每次请求生成一个唯一请求编号是8message请求业务参数String请求业务参数，参见具体接口描述。需转换为Base64编码。说明：（1）参数名必须为小写字母；（2）业务参数message的构成，根据具体接口描述构造；（3）字符集统一采用UTF-8编码格式。接口列表接口服务名称描述HYPERLINK\l"_电子票据下载"downloadPNG4AccountByDate电子票据下载HYPERLINK\l"_单位票据入账"accountForRecode电子票据入账反馈接口描述电子票据下载单位通过该接口下载待入账电子票据。服务名downloadPNG4AccountByDate业务参数节点：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是返回参数根据HTTP响应头中Content-Type值判断成功或失败。成功时值为application/x-zip-compressed，失败时值为application/json。（1）成功返回电子票据文件压缩包，命名规则为：包内电子票据份数-最大批次序列号.zip。电子票据压缩包文件名提取方式：HTTPHeadercontent-disposition，值为"attachment;filename=包内电子票据份数-最大批次序列号.zip"。压缩包内包含电子票据文件和清单文件，每批最大份数100。电子票据文件命名规则为：电子票据代码-电子票据号码.后缀名（后缀名为png）。清单文件是JSON格式的文本文件，命名规则为：最大批次序列号.json。清单文件 内容 财务内部控制制度的内容财务内部控制制度的内容人员招聘与配置的内容项目成本控制的内容消防安全演练内容 如下：序号标识符数据项名称类型长度说明强制1Data电子票据清单内容String[1,4096]JSON格式是Data包含一系列电子票据，每份电子票据的数据项目：序号标识符数据项名称类型长度说明强制1EInvoiceCode票据代码NString8是2EInvoiceNumber票据号码NString10是3EInvoiceName电子票据名称String[1,100]是4InvoicingPartyName开票单位名称String[1,100]是5IssueDate开票日期Date是6TotalAmount总金额Currency是7HandlingPerson开票人String[1,20]是8PayerPartyName交款人名称String[1,100]是9Item项目明细|-ItemCode项目编码String[1,30]是|-ItemName项目名称String[1,100]是|-ItemQuantity数量Integer否|-ItemUnit单位String[1,30]否|-ItemAmount金额Currency是|-ItemExt项目明细扩展节点否10RelatedEInvoice相关电子票据|-RelatedEInvoiceCode相关电子票据代码NString8红字电子票据非空否|-RelatedEInvoiceNumber相关电子票据号码NString10红字电子票据非空否11MainExt基本信息扩展节点否12EInvoiceFileNumber电子票据份数NString[1,3]固定值1是13EInvoiceFile电子票据文件名String[1,100]PNG文件名称是（2）失败返回参数：节点：error_message序号标识符数据项名称类型长度说明强制1error_code返回码NString3失败的返回代码是2error_msg返回消息NString[1,200]错误信息是电子票据入账反馈单位入账后，通过该接口将财政电子票据入账凭证号反馈财政电子票据服务平台。服务名accountForRecode业务参数节点：message序号标识符数据项名称类型长度说明强制1agency_code单位代码String[1,30]一般采用组织机构代码是2agency_name单位名称String[1,100]是3agency_type单位类型NString11:开票单位2:交款单位是4bill_batch_code电子票据代码NString8是5bill_no电子票据号码NString10是6acc_number入账凭证号String账务系统生成的记账凭证号是7acc_amount入账金额Currency是返回参数（1）成功返回参数节点：message序号标识符数据项名称类型长度说明强制1succ_code返回码NString3成功的返回代码：200是2succ_msg返回消息NString[1,200]是（2）失败返回参数：节点：error_message序号标识符数据项名称类型长度说明强制1error_code返回码NString3失败的返回代码是2error_msg返回消息NString[1,200]错误信息是调用步骤说明以accountForRecode调用为例，具体步骤如下：设置参数值请求参数（示例）：method=“accountForRecode”,app_id=”7e7f4ec1a5c2cce38a4219b3”,format=”json”,datetime=”203123”,version=”1.0.1”,message_id=”132e4ef89ff44816b0d2”,message=”JTdCJTIybWVzc2FnZSUyMiUzQSUyMCU3QiUyMCUyMnBsYWNlX2NvZGUlMjIlM0ElMjAlMjIwMDElMjIlMjAlN0QlN0Q=”其中，message为业务参数转换为Base64编码。按ASCII顺序排序app_id=”7e7f4ec1a5c2cce38a4219b3”,datetime=”203123”,format=”json”,message=”JTdCJTIybWVzc2FnZSUyMiUzQSUyMCU3QiUyMCUyMnBsYWNlX2NvZGUlMjIlM0ElMjAlMjIwMDElMjIlMjAlN0QlN0Q=”,message_id=”132e4ef89ff44816b0d2”,method=”accountForRecode”,version=”1.0.1”参数值拼接把各个参数值进行拼接，结果为：7e7f4ec1a5c2cce38a4219bjsonJTdCJTIybWVzc2FnZSUyMiUzQSUyMCU3QiUyMCUyMnBsYWNlX2NvZGUlMjIlM0ElMjAlMjIwMDElMjIlMjAlN0QlN0Q=132e4ef89ff44816b0d2accountForRecode1.0.1生成防伪码调用接口时需要生成请求参数防伪码(HYPERLINK\l"_Sign签名"security)，服务器会对该参数进行验证，用于确认调用者身份是否合法及参数信息完整性。防伪码(HYPERLINK\l"_Sign签名"security)为32位大写字符串，计算过程如下：将appKey拼接到参数字符串头、尾假设appkey为”helloworld”，则拼接后的结果为：helloworld7e7f4ec1a5c2cce38a4219bjsonJTdCJTIybWVzc2FnZSUyMiUzQSUyMCU3QiUyMCUyMnBsYWNlX2NvZGUlMjIlM0ElMjAlMjIwMDElMjIlMjAlN0QlN0Q=132e4ef89ff44816b0d2accountForRecode1.0.1helloworld对拼接结果进行md5加密转化成32位大写，HYPERLINK\l"_Sign签名"security为：66987CB115214E59E6ECFB8组装HTTP请求将所有参数名和参数值采用utf-8进行URL编码（参数顺序可随意，但必须要包括防伪参数），然后通过POST方式发起请求，如：http://IP:PORT/?app_id=7e7f4ec1a5c2cce38a4219b3&datetime=203123&message=JTdCJTIybWVzc2FnZSUyMiUzQSUyMCU3QiUyMCUyMnBsYWNlX2NvZGUlMjIlM0ElMjAlMjIwMDElMjIlMjAlN0QlN0Q=&message_id=132e4ef89ff44816b0d2&method=accountForRecode&version=1.0.1&security=66987CB115214E59E6ECFB8返回结果代码序号返回码说明分类1200调用成功成功2401参数错误失败3418AppID不存在或者为空4419身份认证错误5410票据不存在6415该票据已经被其他单位入账备案,不能备案7416入账金额超额，可用入账金额小于当前入账金额8417同一单位入账多次9421服务不可用，原因：[根据具体情况而定]10500系统错误