《中信银行银企直联接口使用规范(必读)》由会员分享,可在线阅读,更多相关《中信银行银企直联接口使用规范(必读)(7页珍藏版)》请在金锄头文库上搜索。
1、 中信银行银企直联接口使用规范(必读)第 I 页 中信银行银企直联接口使用规范(必读)版本 V1.0.0.0 中信银行银企直联接口使用规范(必读)第 II 页 目 录一、 概述 .11.1 文档用途 .11.2 适用对象 .1二、 报文结构 .12.1 HTTP 请求报文 .12.2 HTTP 响应报文 .1三、 报文定义规则 .13.1 XML 报文格式 .13.2 响应报文说明 .23.3 响应码 .23.3.1 客户端响应码 .33.3.2 服务器端响应码 .3四、 典型交易说明 .44.1 动账类 .44.2 查询类 .4第 1 页一、 概述1.1 文档用途此文档作为银企直联客户的必读
2、手册,用于说明中信银行银企直联系统的接口规范。银企直联客户须严格按照该规范使用银企直联接口,避免因接口使用不当导致重复动账、资金损失。1.2 适用对象中信银行银企直联客户。二、 报文结构在企业内部局域网环境内,报文的传输方式采用 HTTP 协议。HTTP 报文包括企业内部系统向前置服务器(客户端软件)的请求报文以及前置服务器(客户端软件)向企业内部系统的响应报文,均由 HTTP 报文头与 HTTP 报文体两部分构成。2.1 HTTP 请求报文HTTP 请求报文由 HTTP 报文头(请求行、通用信息、请求头、实体头)、回车换行(CRLF )、HTTP 报文体构成。HTTP 请求报文采用 POST
3、 方式提交。HTTP 报文体为报文接口定义的请求报文数据(XML 报文数据)。2.2 HTTP 响应报文前置服务器处理 HTTP 请求报文后,返回 HTTP 响应报文至企业内部系统。HTTP 响应报文由HTTP 报文头(状态行、通用信息、响应头、实体头)、回车换行(CRLF)、HTTP 报文体构成。HTTP 报文体为报文接口定义的响应报文数据(XML 报文数据)。三、 报文定义规则3.1 XML 报文格式所有 XML 报文均遵循以下数据格式:value1第 2 页value2value3。其中,list 循环域中放置重复数据记录。报文中的数据项标签名称必须与接口定义中的数据项标签名称一致(包括
4、大小写)。3.2 响应报文说明HTTP 响应报文均遵循以下格式:响应码 响应信息描述valueN银企直联响应报文中均包含 status、statusText 两个字段,status 标签对应信息为交易响应码,statusText 标签对应信息为交易响应码的中文描述。3.3 响应码一个完整的交易由请求报文、响应报文两部分组成,其中,响应报文中用于表示该交易请求处理状态的标志,称为响应码。响应码是由字母+数字的组合的交易信息代码,长度为 7 位。响应码主要分为两类:客户端响应码和服务器端响应码。银企直联交易主要分为动账类、查询类两种。动账类交易的响应码用于表示该交易请求的银行受理状态,而非该交易的
5、账务状态。查询类交易的响应码用于表示该查询交易的查询处理过程是否第 3 页成功,而非被查交易信息的账务状态,被查交易的交易状态信息需根据响应报文相应状态字段信息确定。3.3.1 客 户 端 响 应 码当银企直联客户端因企业端环境、网络等问题导致与银行服务器端无法进行正常通讯时,若企业端系统给银企直联客户端发送交易请求,则银企直联客户端会给企业端系统返回客户端响应码。客户端响应码均以“ET”、“CF09”、“CF14”、“CF15”、“CF18 ”、“CF19”、“CF20”、“ CF21”、“CF22 ”、“CF23 ”、“CM12 ”、“ED10”、“ED11 ”、“ED12”开头。特别说明
6、:当银企直联客户端返回客户端响应码时,无法确定当前交易银行端是否处理成功。 若当前交易为查询类交易,则客户可稍后重新进行查询。 若当前交易为动账类交易,则客户务必先进行当前交易对应的交易状态查询确认真实交易状态或联系中信银行进行交易状态确认,切勿重新发起动账交易造成重复动账、资金损失。3.3.2 服 务 器 端 响 应 码若银企直联客户端与银行服务器端通讯正常,当企业端系统给银企直联客户端发送交易请求时,银企直联客户端会给企业端系统返回服务器端响应码。服务器端响应码:响应码 含义AAAAAAA 交易处理成功;AAAAAAB 经办成功待审核;AAAAAAC 预约支付成功;AAAAAAD 现金管理
7、代理收款信息查询交易专用,表示扣款方审核通过,扣款成功;AAAAAAE 已提交银行处理,需稍后使用“交易状态查询”交易进行查询;AAAAAAF 批次导入提交成功;AAAAAAG 已提交银行处理,需稍后使用“票据状态同步”交易进行查询;AAAAAAH 已提交银行处理,需稍后使用“电子合同确认查询”交易进行查询;AAAAAAK 已提交银行处理,需稍后使用“票据库状态同步”交易进行查询;BBBBBBB 批次处理部分成功;CCCCCCC 交易处理中;第 4 页EEEEEEE 交易未产生,请务必使用该业务的汇总查询交易确认交易真实状态!UNKNOWN 交易状态未知;其他 字母+数字的组合为服务端响应代码
8、。响应信息见 statusText 字段,以中文表示。四、 典型交易说明4.1 动账类(单笔)当客户提交单笔动账类交易请求成功时,仅能说明交易提交银行成功,无法确定交易的真实账务状态,必须进行相应的交易状态查询以明确真实的交易状态。举例说明:当客户发送对外支付(DLOUTTRN)交易成功时,仅说明交易提交银行成功,客户必须根据当前交易的客户流水号、交易请求码进行交易状态查询(DLCIDSTT)确认真实交易状态。4.2 动账类(批量)当客户提交批量动账类交易请求成功时,仅能说明交易提交银行成功,无法确定交易的真实账务状态,必须进行相应的交易状态查询以明确真实的交易状态。 当客户发送代发工资(批量
9、交易)(DLSALIMP)交易成功时,仅说明交易提交银行成功,客户必须先进行代发工资汇总查询(DLSALCOL )确认批次处理状态,再进行代发工资明细查询(DLSALDET)确认代发工资的明细状态。 当客户发送代理收款(批量交易)(DLAGENTF)交易成功时,仅说明交易提交银行成功,客户必须先进行代理收款汇总查询(DLAGECOL)确认批次处理状态,再进行代理收款明细查询(DLAGEDET)确认代理收款的明细状态。 当客户发送其他代付(批量交易)(DLOTHSUB)交易成功时,仅说明交易提交银行成功,客户必须先进行其他代付汇总查询(DLOTHCOL)确认批次处理状态,再进行其他代付明细查询(DLOTHDET)确认其他代付的明细状态。4.3 查询类当客户提交查询类交易请求成功时,仅能说明当前查询过程是成功,被查交易的真实处理状态必须根据