中信银行银企直联接口使用规范(必读).doc

《中信银行银企直联接口使用规范(必读).doc》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、中信银行银企直联接口使用规范（必读）版本V1.0.0.0目录一、概述11.1文档用途11.2适用对象1二、报文结构12.1HTTP请求报文12.2HTTP响应报文1三、报文定义规则13.1XML报文格式13.2响应报文说明23.3响应码23.3.1客户端响应码33.3.2服务器端响应码3四、典型交易说明44.1动账类44.2查询类4一、概述1.1文档用途此文档作为银企直联客户的必读手册，用于说明中信银行银企直联系统的接口规范。银企直联客户须严格按照该规范使用银企直联接口，避免因接口使用不当导致重复

2、动账、资金损失。1.2适用对象中信银行银企直联客户。二、报文结构在企业内部局域网环境内，报文的传输方式采用HTTP协议。HTTP报文包括企业内部系统向前置服务器（客户端软件）的请求报文以及前置服务器（客户端软件）向企业内部系统的响应报文，均由HTTP报文头与HTTP报文体两部分构成。2.1HTTP请求报文HTTP请求报文由HTTP报文头（请求行、通用信息、请求头、实体头)、回车换行（CRLF）、HTTP报文体构成。HTTP请求报文采用POST方式提交。HTTP报文体为报文接口定义的请求报文数据（X

3、ML报文数据）。2.2HTTP响应报文前置服务器处理HTTP请求报文后，返回HTTP响应报文至企业内部系统。HTTP响应报文由HTTP报文头（状态行、通用信息、响应头、实体头）、回车换行（CRLF）、HTTP报文体构成。HTTP报文体为报文接口定义的响应报文数据（XML报文数据）。三、报文定义规则3.1XML报文格式所有XML报文均遵循以下数据格式：value1value2

4、key2>value3…。其中，list循环域中放置重复数据记录。报文中的数据项标签名称必须与接口定义中的数据项标签名称一致（包括大小写）。3.2响应报文说明HTTP响应报文均遵循以下格式：响应码响应信息描述

5、Text>……valueN银企直联响应报文中均包含status、statusText两个字段，status标签对应信息为交易响应码，statusText标签对应信息为交易响应码的中文描述。3.3响应码一个完整的交易由请求报文、响应报文两部分组成，其中，响应报文中用于表示该交易请求处理状态的标志，称为响应码。响应码是由字母+数字的组合的交易信息代码，长度为7位。响应码主要分为两类：客户端响应码和服务器端响应码。银企直联交易主要分为动账类、查询类两种。动账类

6、交易的响应码用于表示该交易请求的银行受理状态，而非该交易的账务状态。查询类交易的响应码用于表示该查询交易的查询处理过程是否成功，而非被查交易信息的账务状态，被查交易的交易状态信息需根据响应报文相应状态字段信息确定。3.3.1客户端响应码当银企直联客户端因企业端环境、网络等问题导致与银行服务器端无法进行正常通讯时，若企业端系统给银企直联客户端发送交易请求，则银企直联客户端会给企业端系统返回客户端响应码。客户端响应码均以“ET”、“CF09”、“CF14”、“CF15”、“CF18”、“CF19”、“

7、CF20”、“CF21”、“CF22”、“CF23”、“CM12”、“ED10”、“ED11”、“ED12”开头。特别说明：当银企直联客户端返回客户端响应码时，无法确定当前交易银行端是否处理成功。Ø若当前交易为查询类交易，则客户可稍后重新进行查询。Ø若当前交易为动账类交易，则客户务必先进行当前交易对应的交易状态查询确认真实交易状态或联系中信银行进行交易状态确认，切勿重新发起动账交易造成重复动账、资金损失。3.3.2服务器端响应码若银企直联客户端与银行服务器端通讯正常，当企业端系统给银企直联客户端发

8、送交易请求时，银企直联客户端会给企业端系统返回服务器端响应码。服务器端响应码：响应码含义AAAAAAA交易处理成功；AAAAAAB经办成功待审核；AAAAAAC预约支付成功；AAAAAAD现金管理代理收款信息查询交易专用，表示扣款方审核通过，扣款成功；AAAAAAE已提交银行处理，需稍后使用“交易状态查询”交易进行查询；AAAAAAF批次导入提交成功；AAAAAAG已提交银行处理，需稍后使用“票据状态同步”交易进行查询；AAAAAAH已提交银行处理，需稍后使用“电子合同确认查询”交