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

中信银行

银企直联接口使用规范

（必读）

版本V1.0.0.0

目录

一、概述 (1)

1.1文档用途 (1)

1.2适用对象 (1)

二、报文结构 (1)

2.1 HTTP请求报文 (1)

2.2 HTTP响应报文 (1)

三、报文定义规则 (1)

3.1 XML报文格式 (1)

3.2响应报文说明 (2)

3.3响应码 (2)

3.3.1客户端响应码 (3)

3.3.2服务器端响应码 (3)

四、典型交易说明 (4)

4.1动账类 (4)

4.2查询类 (4)

一、概述

1.1文档用途

此文档作为银企直联客户的必读手册，用于说明中信银行银企直联系统的接口规范。银企直联客户须严格按照该规范使用银企直联接口，避免因接口使用不当导致重复动账、资金损失。

1.2适用对象

中信银行银企直联客户。

二、报文结构

在企业内部局域网环境内，报文的传输方式采用HTTP协议。HTTP报文包括企业内部系统向前置服务器（客户端软件）的请求报文以及前置服务器（客户端软件）向企业内部系统的响应报文，均由HTTP报文头与HTTP报文体两部分构成。

2.1 HTTP请求报文

HTTP请求报文由HTTP报文头（请求行、通用信息、请求头、实体头)、回车换行（CRLF）、HTTP报文体构成。

HTTP请求报文采用POST方式提交。

HTTP报文体为报文接口定义的请求报文数据（XML报文数据）。

2.2 HTTP响应报文

前置服务器处理HTTP请求报文后，返回HTTP响应报文至企业内部系统。HTTP响应报文由HTTP报文头（状态行、通用信息、响应头、实体头）、回车换行（CRLF）、HTTP报文体构成。

HTTP报文体为报文接口定义的响应报文数据（XML报文数据）。

三、报文定义规则

3.1 XML报文格式

所有XML报文均遵循以下数据格式：

value1

value2

value3

…

。

其中，list循环域中放置重复数据记录。

报文中的数据项标签名称必须与接口定义中的数据项标签名称一致（包括大小写）。

3.2响应报文说明

HTTP响应报文均遵循以下格式：

响应码

响应信息描述

……

valueN

银企直联响应报文中均包含status、statusText两个字段，status标签对应信息为交易响应码，statusText标签对应信息为交易响应码的中文描述。

3.3响应码

一个完整的交易由请求报文、响应报文两部分组成，其中，响应报文中用于表示该交易请求处理状态的标志，称为响应码。响应码是由字母+数字的组合的交易信息代码，长度为7位。响应码主要分为两类：客户端响应码和服务器端响应码。

银企直联交易主要分为动账类、查询类两种。动账类交易的响应码用于表示该交易请求的银行受理状态，而非该交易的账务状态。查询类交易的响应码用于表示该查询交易的查询处理过程是否成功，

而非被查交易信息的账务状态，被查交易的交易状态信息需根据响应报文相应状态字段信息确定。

3.3.1客户端响应码

当银企直联客户端因企业端环境、网络等问题导致与银行服务器端无法进行正常通讯时，若企业端系统给银企直联客户端发送交易请求，则银企直联客户端会给企业端系统返回客户端响应码。

客户端响应码均以“ET”、“CF09”、“CF14”、“CF15”、“CF18”、“CF19”、“CF20”、“CF21”、“CF22”、“CF23”、“CM12”、“ED10”、“ED11”、“ED12”开头。

特别说明：

当银企直联客户端返回客户端响应码时，无法确定当前交易银行端是否处理成功。

?若当前交易为查询类交易，则客户可稍后重新进行查询。

?若当前交易为动账类交易，则客户务必先进行当前交易对应的交易状态查询确认真实交易状态或联系中信银行进行交易状态确认，切勿重新发起动账交易造成重复动账、资金损失。

3.3.2服务器端响应码

若银企直联客户端与银行服务器端通讯正常，当企业端系统给银企直联客户端发送交易请求时，银企直联客户端会给企业端系统返回服务器端响应码。

服务器端响应码：

四、典型交易说明

4.1动账类（单笔）

当客户提交单笔动账类交易请求成功时，仅能说明交易提交银行成功，无法确定交易的真实账务状态，必须进行相应的交易状态查询以明确真实的交易状态。

举例说明：

当客户发送对外支付（DLOUTTRN）交易成功时，仅说明交易提交银行成功，客户必须根据当前交易的客户流水号、交易请求码进行交易状态查询（DLCIDSTT）确认真实交易状态。

4.2动账类（批量）

当客户提交批量动账类交易请求成功时，仅能说明交易提交银行成功，无法确定交易的真实账务状态，必须进行相应的交易状态查询以明确真实的交易状态。

?当客户发送代发工资（批量交易）（DLSALIMP）交易成功时，仅说明交易提交银行成功，客户必须先进行代发工资汇总查询（DLSALCOL）确认批次处理状态，再进行代发工资

明细查询（DLSALDET）确认代发工资的明细状态。

?当客户发送代理收款（批量交易）（DLAGENTF）交易成功时，仅说明交易提交银行成功，客户必须先进行代理收款汇总查询（DLAGECOL）确认批次处理状态，再进行代理

收款明细查询（DLAGEDET）确认代理收款的明细状态。

?当客户发送其他代付（批量交易）（DLOTHSUB）交易成功时，仅说明交易提交银行成功，客户必须先进行其他代付汇总查询（DLOTHCOL）确认批次处理状态，再进行其他

代付明细查询（DLOTHDET）确认其他代付的明细状态。

4.3查询类

当客户提交查询类交易请求成功时，仅能说明当前查询过程是成功，被查交易的真实处理状态必须根据交易返回的交易状态信息来判断。

举例说明：

客户发送交易状态查询（DLCIDSTT）交易，交易返回报文如下：

AAAAAAA

交易成功

0

AAAAAAA

交易成功

响应报文中list域外的status为AAAAAA（交易成功）表示当前交易状态查询过程成功，list域内的status为AAAAAA（交易成功）、stt（0）表示被查交易的交易状态是交易成功。

. . .