1、 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 1 页 共 15 页Document number 文档编号 Confidentiality level 密级 内部公开Document version 文档版本 V1.0佛山小企业信贷管理系统设计说明书_核心接口详细设计说明书佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 2 页 共 15 页Revision Record 修订记录Date日期Revision Version修订版本Sec No. 修改章节Change Description修改描述Author作者佛山小企业
2、信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 3 页 共 15 页目 录第 1 章. 概述 4第 2 章. 设计方案 42.1. 通讯方式 42.1.1. 信贷到核心 4第 3 章. 接口规范 73.1.1. 客户码提取 73.1.2. 客户账户查询 83.1.3. 存款账户余额查询 93.1.4. 协议还款计划 查询查询 103.1.5. 建立(修改)协议还款计划 .113.1.6. 客户信息查询 123.1.7. 按客户号/帐号 查询证件号（用于建账系统） 143.1.1. 担保品状态查询 14佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有
3、限公司 第 4 页 共 15 页第 1 章. 概述第 2 章. 设计方案2.1.通讯方式2.1.1.信贷到核心2.1.1.1. 基本通信协议采用 TCP/IP 短连接，通信双方每次通信时建立连接，通信结束后关闭连接。对于信贷调用前置的交易，前置监听 SOCKET 端口，接收、处理、返回交易请求。信贷系统 省前置核心系统交 互 方 式 :T C P124 32.1.1.2. 数据传输在 TCP/IP 网络中传输的应用数据采用下面的格式进行传送。数据长度 ( 6 位 ) 交易码 ( 6 位 ) 数据块数据长度6 个字节，用 ASCII 码表示的数据长度。其值为不包含该数据长度字段，但包括交易码长度
4、字段的数据包长度。不足 6 个字节左补“0” ，例如：数据块长度为 128，则数据长度表示为“000128” 。佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 5 页 共 15 页交易码标识交易的代码，固定由 6 个字节组成。数据块应用层要传输的交易报文数据。2.1.1.3. 超时时间接收报文的超时时间为 90 秒。2.1.1.4. 报文说明信贷与前置间采用 XML 报文格式，所有报文包含报文头和报文体两部分。报文说明2.1.1.5. 报文编码报文编码使用 gb2312 编码。2.1.1.6. 属性说明n 表示 0 至 9 的数字字符a 表示数字和英文字字符G
5、 表示 GBK 定义的 16 位（16bits or 双字节）编码字符B 表示二进制格式存储，其后的长度为 Byte2.1.1.7. 报文头报文头信息在报文头节点之内，具体的内容在请求报文头与应答报文头有差异，具体内容如下：2.1.1.8. 请求报文头字段名 说明 数据类型 正向交易是否必输 反向交易是否必输 备注tx_code 交易码字符(6) M Mbranch_no 机构号字符(5)C(可选) M(必输)teller_no 柜员号字符(12) C Cchannel_flag 渠道标识字符(2) M M03-信贷request_date 请求方日期字符(8) M M yyyymmddreq
6、uest_time 请求方时间字符(6) M M HHMMSS佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 6 页 共 15 页request_seq_no 请求方流水号字符(20) M M当日该渠道唯一值terminal_info客户渠道交易终端字符(20) C M信贷发送客户的IP，柜面发送终端号，手机银行与呼叫中心发送电话号码2.1.1.9. 应答报文头字段名 说明 数据类 型 正向交易是否必输 反向交易是否必输 备注tx_code 交易码 字符(6) M Mbranch_no 机构号 字符(5) C(可选) M(必输)teller_no 柜员号字符(
7、12) C Cchannel_flag 渠道标识 字符(2) M M01-信贷 02-手机银行request_seq_no 请求方流水号字符(20) M M当日该渠道唯一值service_date 服务方日期 字符(8) M M yyyymmddservice_time 服务方时间 字符(6) M M HHMMSSservice_serial_no 服务方流水号字符(20) M M当日内唯一ret_code 响应码 字符(5) M Mret_explain 响应码说明字符(100) C C2.1.1.10.报文体报文体信息在报文体节点之内，对于数组，通过节点 进行标识。2.1.1.11.报文示
8、例00123458101123456789012123456佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 7 页 共 15 页111111111CNY111111111HKD第 3 章. 接口规范3.1.1. 客户码提取3.1.1.1. 交易描述信贷系统在登记客户信息时，需要从核心系统获取客户码。信贷系统发起，将信贷系统输入的证件类型、证件号码、客户开户机构码发送给核心业务系统，由核心系统判断三个要素是否相符。如果相符，返回核心系统中的客户信息，否则，返回相应的错误信息。3.1.1.2. 接口交易码111300073.1.1.3. 请求报文结构顺序 字段名称
9、 字段说明 类型 长度 说明1. cert_no 证件号码 字符 322. cert_type 证件类型 字符 23.1.1.4. 应答报文结构顺序 字段名称 字段说明 类型 长度 说明显示 4 记录(记录号、客户号、客户类型、证件类型、证件号、客户名称)佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 8 页 共 15 页1. Rec_num 记录号 字符 4 记录号 Rec number2 cust_no 客户号 字符 173 Cust_type 客户类型 字符 2 客户类型Customer Type4 cert_type 证件类型 字符 25 cert_n
10、o 证件号码 字符 326 cust_name 客户名称 字符 1203.1.1.5. 信贷系统处理页面录入证件类型、证件号码和获取客户经理的机构号，信贷系统检查客户表是否已经存在对应的客户。如果信贷系统已经存在，则提示，如果没有则发送给核心，收到核心的应答报文以后，根据情况进行处理:1、 返回一个客户码。将客户码显示在页面客户码部分。将证件类型、证件号码、户名、客户码四个输入框设置为只读。2、 返回多个客户码。提示客户经理选择其中的一个，将客户码显示在页面客户码部分。将证件类型、证件号码、户名、客户码四个输入框设置为只读。3、 返回错误信息。以alert窗口的形式，将应答报文头返回的错误信息
11、内容弹出。3.1.2. 客户账户查询3.1.2.1. 交易描述根据客户号，查询客户的所有存款与贷款账户信息。3.1.2.2. 接口交易码111300023.1.2.3. 请求报文结构顺序 字段名称 字段说明 类型 长度 说明1. cust_type 客户类型 字符 201:个人客户02:企业客户03:金融机构客户04:客户群2. cust_no 客户号 字符 173.1.2.4. 应答报文结构佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 9 页 共 15 页顺序 字段名称 字段说明 类型 长度 说明循环数组 list1 acct_no 账号 字符 202 a
12、cct_status 账号状态 字符 23 dl_flag 存贷标志 字符 1 D 存款 D DopositL 贷款 L Loan4 curreny 货币代码 字符 35 acct_bal 账户余额 数值 16,23.1.2.5. 信贷系统处理信贷系统根据核心传送回来的应答报文头判断成功或者失败，相应的将反馈内容和账户余额显示到页面。3.1.3.存款账户余额查询3.1.3.1. 交易描述信贷系统除了不会实时反映客户的存款信息，对于一些内部账户（保证金、委托存款户等）或者其他内部特殊账户也不会实时反映余额情况。如果需要获取单笔账户的余额款信息，使用单笔账户余额查询。如果是一本通的，只能查询活期3
13、.1.3.2. 接口交易码. 101300023.1.3.3. 请求报文结构顺序 字段名称 字段说明 类型 长度 说明1. acct_no 账号 字符 172. acct_sub 子帐户类别 字符 4 活期一本通必输3.1.3.4. 应答报文结构顺序 字段名称 字段说明 类型 长度 说明1. acct_name 客户名称 字符 402. curr_bal 当前余额 数值 16，2佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 10 页 共 15 页3.1.3.5. 信贷系统处理信贷系统根据核心传送回来的应答报文头判断成功或者失败，相应的将反馈内容和账户余额显示
14、到页面。3.1.4.协议还款计划 查询查询3.1.4.1. 交易描述对于协议还款的贷款，根据账号从核心系统查询协议还款计划，更新信贷系统的协议还款计划表。3.1.4.2. 接口交易码111200043.1.4.3. 请求报文结构顺序 字段名称 字段说明 类型 位数 备注1 acct_no 账号 字符 172 action 选项 字符 1 C:创建 A:修改 E:查询3 Rec_no 屏数 字符 9 19 任何一个数字3.1.4.4. 应答报文结构顺序 字段说明 类型 位数 备注帐号 字符 17计划总笔数 字符 3还款/起始日 1 字符 8 ddMMyyyy次数 1 字符 3类型 1 字符 1还
15、款金额 1 字符 18。字符还款/起始日 n 字符 8 ddMMyyyy次数 n 字符 3类型 n 字符 1还款金额 n 字符 18佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 11 页 共 15 页3.1.4.5. 信贷系统处理信贷系统根据核心传送回来的应答报文头判断成功或者失败。1、 核心反馈成功：信贷系统根据帐号更新协议还款计划表，并将内容显示在页面上。2、 核心反馈失败：将反馈内容中的错误信息显示在页面上。3.1.5. 建立(修改) 协议还款计划3.1.5.1. 交易描述对于协议还款的贷款，创建或者维护协议还款计划。3.1.5.2. 接口交易码111
16、200053.1.5.3. 请求报文结构顺序 字段名称 字段说明 类型 长度 说明acct_no 帐号 字符 17 9（17）action 选项 字符 1 C:创建 A:修改 E:查询Rec_no 屏数 字符 9 19 任何一个数字return_or_begin_date1 还款/起始日 1 字符 8 ddMMyyyytimes1 次数 1 字符 3 999type1 类型 1 字符 1 Xreturn_sum1 还款金额 1 字符 18 9(14)V999Sreturn_or_begin_date2 还款/起始日 2 字符 8 ddMMyyyytimes2 次数 2 字符 3 999type
17、2 类型 2 字符 1 Xreturn_sum2 还款金额 2 字符 18 9(14)V999S。 。 。return_begin_date(n) 还款/起始日 n 字符 8 ddMMyyyy佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 12 页 共 15 页times(n) 次数 n 字符 3 999Type(n) 类型 n 字符 1 Xreturn_sum(n) 还款金额 n 字符 18 9(14)V999SAction 上一页下一页 字符 1 第一屏是空格，其它是 N3.1.5.4. 应答报文结构顺序 字段说明 类型 位数 备注1 帐号 字符 173.
18、1.5.5. 信贷系统处理1、 建立协议还款计划:信贷系统将还款计划信息发给核心，核心建立相应帐号的协议还款计划信息。信贷系统根据核心传送回来的应答报文头判断成功或者失败，并将内容在页面显示。2、 修改协议还款计划:做此交易前，信贷系统做先协议还款计划查询，从核心系统获取最新的协议还款计划，并显示在页面上，操作人员修改计划后再发给核心，更新核心的协议还款计划表。信贷系统根据核心传送回来的应答报文头判断成功或者失败，并将内容在页面显示。3.1.6.客户信息查询3.1.6.1. 交易描述根据客户号或帐号、客户号或帐号标志、客户类型从核心系统查询该客户的客户信息。3.1.6.2. 接口交易码1113
19、0001。3.1.6.3. 请求报文结构顺序 字段说明 字段说明 类型 长度 说明佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 13 页 共 15 页1 acct_no 账号/客户号 字符 32 9（17）2 acct_cust_type 账号、客户号标识 字符 1 9（17）3 inquiry_type 查询类型 字符 1 X(32)3.1.6.4. 应答报文结构顺序 字段名称 字段说明 类型 长度 说明个人客户查询返回2. cust_no 客户号 字符 203. cert_type 证件类型 字符 24. cert_no 证件号码 字符 205. cus
20、t_name 客户名称 字符 606. attach_bank 所属行 字符 57. cust_status 客户状态 字符 28. open_bank 开户行 字符 5企业客户查询返回1. cust_name 客户名称(中文) 字符 602. cust_no 客户号 字符 203. cert_type 法人代表证件类型 字符 24. legal_cert_no 法人证件号码 字符 205. legal_name 法人代表姓名 字符 606. contact_name 联系人姓名 字符 607. contact_tel 联系人电话 字符 228. contact_mail 联系人电子邮件 字符
21、 303.1.6.5. 信贷系统处理信贷系统根据核心传送回来的应答报文头判断成功或者失败。1、 核心反馈成功：信贷系统收到应答报文以后，如果成功，将获取到的客户号和客户姓名展示在前端页面。2、 核心反馈失败：将反馈内容以提示框的形式在前端页面展示。佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 14 页 共 15 页3.1.7.按客户号/帐号 查询证件号（用于建账系统）3.1.7.1. 交易描述根据给定的客户号/帐号从核心系统查询对应的证件号。3.1.7.2. 接口交易码11130009。3.1.7.3. 请求报文结构顺序 字段说明 字段说明 类型 长度 说明
22、1 acct_no 账号或客户号 字符 172 acct_cust_type 标志 字符 13.1.7.4. 应答报文结构顺序 字段名称 字段说明 类型 长度 说明1. cust_no 客户号 字符 172. cust_type 客户类型 字符 23. FILLER FILLER4. cust_name 客户名称 字符 1205. Filler Filler6. cert_no 证件号码 字符 327. cert_type 证件类型 字符 23.1.8.担保品状态查询3.1.8.1. 交易描述3.1.8.2. 接口交易码3.1.8.3. 请求报文结构顺序 字段说明 字段说明 类型 长度 说明1 collateralno 担保品编号 字符 17佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 15 页 共 15 页3.1.8.4. 应答报文结构顺序 字段名称 字段说明 类型 长度 说明1. collateralno 担保品编号 字符 172. gage_status 担保品状态 字符 2
