广东农信信贷系统服务接口规范说明书_V1.0.

合集下载

1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。

广东省农村信用合作社信贷业务管理系统
接入服务接口规范
广东省农村信用合作社联合社
编写说明标题：网络中心接口规范
类别：技术
版本历史：
1.引言
1.1.编写目的
本文档为广东省农村信用合作社信贷业务系统与佛山小企业系统间的数据交互接口规范。

针对佛山小企业系统，省信贷系统发布了业务信息同步服务、核心系统MQ通知信息查询服务。

该文档描述且用于规范信息同步、通知查询服务的接口交互规范，用于省信贷系统、前置系统、佛山小企业系统开发接口交互应用。

本文档由广东农村信用合作社信贷业务管理系统项目组编写，在实施过程可能会做相应的调整。

1.2.定义
1、省前置系统：是由广东省农村信用合作社建设的前置平台，系统连
接核心业务系统，银行卡交换系统，地市前置系统，呼叫中心系统，
信贷系统，省柜面清算系统等等系统，定位为各个渠道的整合端，
以及核心业务，国结，信贷等系统的服务发布端。

2、省信贷系统：广东省农村信用社信贷业务管理系统。

3、小企业系统：佛山农商银行小企业信贷业务管理系统。

1.3.参考文献
《佛山农商银行小企业信贷系统与信贷系统接口方案说明书V0.2.doc》
《广东农信前置系统-信贷项目-信贷系统接口_V1.10.0.doc》
2. 交易通信协议
2.1. 基本通信协议
采用TCP/IP 短连接，通信双方每次通信时建立连接，通信结束后关闭连接。

对于信贷调用前置的交易，前置监听SOCKET 端口，接收、处理、返回交易请求；对于前置调用信贷的反向交易，信贷监听SOCKET 端口，接收、处理、返回前置的交易请求。

两种交互方式:
3. 数据传输
在TCP/IP 网络中传输的应用数据采用下面的格式进行传送。

数据长度
6个字节，用ASCII 码表示的数据长度。

其值为不包含该数据长度字段，但包括交易码长度字段的数据包长度。

不足6个字节左补“0”，例如：数据块长度为128，则数据长度表示为“000128”。

交易码
标识交易的代码，固定由6个字节组成。

数据块
应用层要传输的交易报文数据。

4.超时时间
接收报文的超时时间为90秒。

5.报文说明
信贷与前置间采用XML报文格式，所有报文包含报文头和报文体两部分。

5.1.报文编码
报文编码使用GBK编码。

5.2.属性说明
n 表示0至9的数字字符
a 表示数字和英文字字符
G 表示GB2312定义的16位（16bits or双字节）编码字符
B 表示二进制格式存储，其后的长度为Byte
5.3.报文头
报文头信息在报文头节点<head>之内，具体的内容在请求报文头与应答报文头有差异，具体内容如下：
5.3.1.请求报文头
5.3.2.应答报文头
5.4.报文体
报文体信息在报文体节点<body>之内，对于数组，通过节点<list>进行标识。

5.5.报文示例
<?xml version="1.0" encoding="BGK" ?>
<pifcs>
<!—报文头部分—>
<Head>
<tx_code>001234</tx_code>
<branch_no>58101</branch_no>
<operator>123456789012</operator>
</Head>

<Body>
<cust_no>123456</cust_no>
<list>
<row>
<acct_no>111111111</acct_no>
<currency>CNY</currency>
</row>
<row>
<acct_no>111111111</acct_no>
<currency>HKD</currency>
</row>
</list>
</Body>
</pifcs>
5.6.交易码码命名规则
前置服务命名由8位组成：
服务方代码(X) + 业务类别(XX) + 性质(X) + 编号(XXXX)
服务方代码标识服务的提供方，目前的取值有：
1：核心系统
2：省前置整合
3：地市前置
4：信贷系统
5：国结系统
6：网银/手机银行系统
7：支付
8：ECIF
业务类别由2位组成，目前取值有：
01：存款类
02：贷款类
03：支付类
04：借记卡类
05：信用卡类
06：国际结算类
07：资金类
08：外汇类
09：理财类
10：中间业务类
11：综合类
12：创新业务类
性质目前的取值有：
1：金融类
2：非金融类(管理类)
3：查询类
4：冲正类
5：文件类
编号是一个四位的顺序号6.报文清单
7.报文修改日志
8.其他说明
1，本文档中所有报文的‘字段名称’部分均为英文的小写字母，且字段名称的单个单词之间用下划线连接。

2，对报文中各字段赋值时忽略其中的隐藏域字段。

9.报文体格式
9.1.业务同步服务接入报文
9.1.1.客户信息同步
9.1.1.1.客户信息主表同步接口(cus_com)
9.1.1.1.1.请求报文
9.1.1.1.2.响应报文
9.1.1.1.3.报文说明
无
9.1.1.2.客户信息子表同步接口(cus_base) 9.1.1.2.1.请求报文
9.1.1.2.2.响应报文
9.1.1.2.3.报文说明
无
9.1.2.合同信息同步
9.1.2.1.借款合同主表同步接口(ctr_loan_cont) 9.1.2.1.1.请求报文
9.1.2.1.2.响应报文
9.1.2.1.3.报文说明
无
9.1.2.2.展期合同表同步接口(ctr_loan_extend) 9.1.2.2.1.请求报文
9.1.2.2.2.响应报文
9.1.2.2.3.报文说明
无
9.1.2.3.业务合同引用担保同步接口(grt_loanguar_info) 9.1.2.3.1.请求报文
9.1.2.3.2.响应报文
9.1.2.3.3.报文说明
9.1.2.4.签订合同同步接口
9.1.2.4.1.请求报文
9.1.2.4.2.响应报文
9.1.2.4.3.报文说明
9.1.3.联保信息同步
9.1.3.1.联保协议主表同步接口(GRT_COSURETY_CONT)
9.1.3.1.1.请求报文
9.1.3.1.3.报文说明
无
9.1.3.2.联保协议成员表同步接口(GRT_COSURETY_MEM) 9.1.3.2.1.请求报文
9.1.3.2.2.响应报文
无
9.1.4.担保信息同步
9.1.4.1.担保合同主表同步接口(GRT_GUAR_CONT) 9.1.4.1.1.请求报文
9.1.4.1.2.响应报文
9.1.4.1.3.报文说明
无
9.1.4.2.担保合同引用押品同步接口(GRT_GUAR_CONT) 9.1.4.2.1.请求报文
9.1.4.2.3.报文说明
9.1.4.3.担保合同签订同步接口
9.1.4.3.1.请求报文
9.1.4.3.2.响应报文
9.1.4.3.3.报文说明
9.1.4.4.担保变更同步接口
9.1.4.4.1.请求报文
9.1.4.4.2.响应报文
9.1.4.4.3.报文说明
9.1.5.放款授权信息同步9.1.5.1.1.请求报文
9.1.5.1.2.响应报文
9.2.核心交易查询服务接入报文
9.2.1.放款成功通知查询20000031 9.2.1.1.请求报文
9.2.1.2.响应报文
9.2.1.3.报文说明。