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