佛山小企业信贷管理系统设计说明书—核心接口V1.0..doc

佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 1 页 共 18 页 Document number 文档编号 Confidentiality level 密级 内部公开 Document version 文档版本 V1.0 佛山小企业信贷管理系统设计说明佛山小企业信贷管理系统设计说明 书书_ _核心接口详细设计说明书核心接口详细设计说明书 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 2 页 共 18 页 Revision Record 修订记录 Date 日期 Revision Version 修订版本 Sec No. 修改章节 Change Description 修改描述 Author 作者 2014-12-25V1.0.23.1.9 3.1.10 3.1.11 添加三个发核心的支付对手相关信 息接口 贷款受托支付信息查询贷款受托支付信息查询 20330001 信贷受托支付信息录入信贷受托支付信息录入20320001 信贷受托支付信息作废信贷受托支付信息作废20320002 2015-1-14V1.0.33.1.3返回报文添加字段，以前只有 账户名称 acct_name与 可用余额 useable_bal两个字段 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 3 页 共 18 页 目目 录录 第第 1 章章.概述概述4 第第 2 章章.设计方案设计方案4 2.1.通讯方式4 2.1.1.信贷到核心4 第第 3 章章.接口规范接口规范7 3.1.1.客户码提取7 3.1.2.客户账户查询8 3.1.3.存款账户余额查询9 3.1.4.协议还款计划查询查询查询10 3.1.5.建立(修改)协议还款计划.11 3.1.6.客户信息查询12 3.1.7.按客户号/帐号 查询证件号（用于建账系统） 14 3.1.8.担保品状态查询14 3.1.9.贷款受托支付信息查询 2033000115 3.1.10.信贷受托支付信息录入 20320001.16 3.1.11.信贷受托支付信息作废 20320002.17 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 4 页 共 18 页 第第 1 章章. 概述概述 第第 2 章章. 设计方案设计方案 2.1.通讯方式通讯方式 2.1.1.信贷到核心信贷到核心 2.1.1.1. 基本通信协议基本通信协议 采用 TCP/IP 短连接，通信双方每次通信时建立连接，通信结束后关闭连接。对于信 贷调用前置的交易，前置监听 SOCKET 端口，接收、处理、返回交易请求。 信贷系统省前置 核心系统 交交互互方方式式: TCP 1 2 43 2.1.1.2. 数据传输数据传输 在 TCP/IP 网络中传输的应用数据采用下面的格式进行传送。 数据长度(6位)交易码(6位)数据块 数据长度数据长度 6 个字节，用 ASCII 码表示的数据长度。其值为不包含该数据长度字段，但包括交易 码长度字段的数据包长度。不足 6 个字节左补“0” ，例如：数据块长度为 128，则数据长 度表示为“000128” 。 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 5 页 共 18 页 交易码交易码 标识交易的代码，固定由 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表示 GBK 定义的 16 位（16bits or 双字节）编码字符 B表示二进制格式存储，其后的长度为 Byte 2.1.1.7. 报文头报文头 报文头信息在报文头节点之内，具体的内容在请求报文头与应答报文头有差异，具 体内容如下： 2.1.1.8. 请求报文头请求报文头 字段名说明 数据 类型 正向交易 是否必输 反向交易 是否必输 备注 tx_code 交易码 字符 (6) MM branch_no 机构号 字符 (5) C(可选)M(必输) teller_no 柜员号 字符 (12) CC channel_flag 渠道标识 字符 (2) MM 03-信贷 request_date 请求方日期 字符 (8) MMyyyymmdd request_time 请求方时间 字符 (6) MMHHMMSS 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 6 页 共 18 页 request_seq_no 请求方流水号 字符 (20) MM 当日该渠道唯一 值 terminal_info 客户渠道交易 终端 字符 (20) CM 信贷发送客户的 IP，柜面发送终端 号，手机银行与呼 叫中心发送电话号 码 2.1.1.9. 应答报文头应答报文头 字段名说明 数据类 型 正向交易 是否必输 反向交易 是否必输 备注 tx_code 交易码字符(6) MM branch_no 机构号字符(5)C(可选)M(必输) teller_no 柜员号 字符 (12) CC channel_flag 渠道标识字符(2) MM 01-信贷 02-手机 银行 request_seq_no 请求方流水号 字符 (20) MM 当日该渠道唯一值 service_date 服务方日期字符(8) MMyyyymmdd service_time 服务方时间字符(6) MMHHMMSS service_serial_no 服务方流水号 字符 (20) MM 当日内唯一 ret_code 响应码字符(5) MM ret_explain 响应码说明 字符 (100) CC 2.1.1.10.报文体报文体 报文体信息在报文体节点之内，对于数组，通过节点进行标识。 2.1.1.11.报文示例报文示例 001234 58101 123456789012 123456 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 7 页 共 18 页 111111111 CNY 111111111 HKD 第第 3 章章. 接口规范接口规范 3.1.1. 客户码提取客户码提取 3.1.1.1. 交易描述交易描述 信贷系统在登记客户信息时，需要从核心系统获取客户码。信贷系统发起，将信贷系 统输入的证件类型、证件号码、客户开户机构码发送给核心业务系统，由核心系统判断三 个要素是否相符。如果相符，返回核心系统中的客户信息，否则，返回相应的错误信息。 3.1.1.2. 接口交易码接口交易码 11130007 3.1.1.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 1. cert_no证件号码字符32 2. cert_type证件类型字符2 3.1.1.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 显示 4 记录(记录号、客户号、客户类型、证件类型、证件号、客户名称) 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 8 页 共 18 页 1. Rec_num记录号字符4 记录号 Rec number 2cust_no客户号字符17 3Cust_type客户类型字符2 客户类型 Customer Type 4 cert_type证件类型字符2 5 cert_no证件号码字符32 6 cust_name客户名称字符120 3.1.1.5. 信贷系统处理信贷系统处理 页面录入证件类型、证件号码和获取客户经理的机构号，信贷系统检查客户表是否已 经存在对应的客户。如果信贷系统已经存在，则提示，如果没有则发送给核心，收到核心 的应答报文以后，根据情况进行处理: 1、返回一个客户码。将客户码显示在页面客户码部分。将证件类型、证件号 码、户名、客户码四个输入框设置为只读。 2、返回多个客户码。提示客户经理选择其中的一个，将客户码显示在页面客户 码部分。将证件类型、证件号码、户名、客户码四个输入框设置为只读。 3、返回错误信息。以alert窗口的形式，将应答报文头返回的错误信息内容弹 出。 3.1.2. 客户账户查询客户账户查询 3.1.2.1. 交易描述交易描述 根据客户号，查询客户的所有存款与贷款账户信息。 3.1.2.2. 接口交易码接口交易码 11130002 3.1.2.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 1. cust_type客户类型字符2 01:个人客户 02:企业客户 03:金融机构客户 04:客户群 2. cust_no客户号字符17 3.1.2.4. 应答报文结构应答报文结构 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 9 页 共 18 页 顺序字段名称字段说明类型长度说明 循环数组 list 1 acct_no账号字符20 2acct_status账号状态字符2 3dl_flag存贷标志字符1 D 存款 D Doposit L 贷款 L Loan 4 curreny货币代码字符3 5 acct_bal账户余额数值16,2 3.1.2.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败，相应的将反馈内容和账 户余额显示到页面。 3.1.3.存款账户余额查询存款账户余额查询 3.1.3.1. 交易描述交易描述 信贷系统除了不会实时反映客户的存款信息，对于一些内部账户（保证金、委托存款 户等）或者其他内部特殊账户也不会实时反映余额情况。如果需要获取单笔账户的余额款 信息，使用单笔账户余额查询。 如果是一本通的，只能查询活期 3.1.3.2. 接口交易码接口交易码 . 10130002 3.1.3.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 1. acct_no账号字符17 2. acct_sub子帐户类别字符4活期一本通必输 3.1.3.4. 应答报文结构应答报文结构 顺序顺序字段名称字段名称字段说明字段说明类型类型长度长度说明说明 1. curreny货币类型char3 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 10 页 共 18 页 2. product_desc产品描述char30 3. bank_no机构号char5开户时的分行编 号 4. acct_status账户状态描述char7“OPEN ”:账户 使用中 “CLOSED ”： 账户已销户 5. rate适用利率N8 6. area地区char4 7. acct_name账户名称char60 8. open_date开户日期char8DDMMYYYY 9. credit_rate贷方利率N7 10. debit_rate借方利率N7 11. curr_bal当前余额decimal16，2 12. freeze_bal冻结金额decimal16，2 13. useable_bal可用余额decimal16，2 3.1.3.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败，相应的将反馈内容和账 户余额显示到页面。 3.1.4.协议还款计划协议还款计划查询查询查询 3.1.4.1. 交易描述交易描述 对于协议还款的贷款，根据账号从核心系统查询协议还款计划，更新信贷系统的协议 还款计划表。 3.1.4.2. 接口交易码接口交易码 11120004 3.1.4.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型位数备注 1 acct_no账号字符17 2 action选项字符1C:创建 A:修改 E:查询 3 Rec_no屏数字符919 任何一个数字 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 11 页 共 18 页 3.1.4.4. 应答报文结构应答报文结构 顺 序 字段说明类型位数备注 帐号字符17 计划总笔数字符3 还款/起始日 1字符8ddMMyyyy 次数 1字符3 类型 1字符1 还款金额 1字符18 。 。 。 字符 还款/起始日 n字符8ddMMyyyy 次数 n字符3 类型 n字符1 还款金额 n字符18 3.1.4.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败。 1、核心反馈成功： 信贷系统根据帐号更新协议还款计划表，并将内容显示在页面上。 2、核心反馈失败： 将反馈内容中的错误信息显示在页面上。 3.1.5.建立建立(修改修改)协议还款计划协议还款计划 3.1.5.1. 交易描述交易描述 对于协议还款的贷款，创建或者维护协议还款计划。 3.1.5.2. 接口交易码接口交易码 11120005 3.1.5.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 12 页 共 18 页 acct_no帐号字符179（17） action选项字符1 C:创建 A:修改 E:查询 Rec_no屏数字符9 19 任何一个数 字 return_or_begin _date1 还款/起始日 1字符8ddMMyyyy times1次数 1字符3999 type1类型 1字符1X return_sum1还款金额 1字符189(14)V999S return_or_begin _date2 还款/起始日 2字符8ddMMyyyy times2次数 2字符3999 type2类型 2字符1X return_sum2还款金额 2字符189(14)V999S 。 。 。 return_begin_da te(n) 还款/起始日 n字符8ddMMyyyy times(n)次数 n字符3999 Type(n)类型 n字符1X return_sum(n)还款金额 n字符189(14)V999S Action上一页下一页字符1 第一屏是空格， 其它是 N 3.1.5.4. 应答报文结构应答报文结构 顺序字段说明类型位数备注 1 帐号字符 17 3.1.5.5. 信贷系统处理信贷系统处理 1、 建立协议还款计划: 信贷系统将还款计划信息发给核心，核心建立相应帐号的协议还款计划信息。信贷系 统根据核心传送回来的应答报文头判断成功或者失败，并将内容在页面显示。 2、 修改协议还款计划: 做此交易前，信贷系统做先协议还款计划查询，从核心系统获取最新的协议还款计 划，并显示在页面上，操作人员修改计划后再发给核心，更新核心的协议还款计划表。 信贷系统根据核心传送回来的应答报文头判断成功或者失败，并将内容在页面显示。 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 13 页 共 18 页 3.1.6.客户信息查询客户信息查询 3.1.6.1. 交易描述交易描述 根据客户号或帐号、客户号或帐号标志、客户类型从核心系统查询该客户的客户信息。 3.1.6.2. 接口交易码接口交易码 11130001。 3.1.6.3. 请求报文结构请求报文结构 顺序字段说明字段说明类型长度说明 1acct_no账号/客户号字符329（17） 2acct_cust_type 账号、客户号 标识 字符19（17） 3inquiry_type查询类型字符1X(32) 3.1.6.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 个人客户查询返回个人客户查询返回 2. cust_no客户号字符20 3. cert_type证件类型字符2 4. cert_no证件号码字符20 5. cust_name客户名称字符60 6. attach_bank所属行字符5 7. cust_status客户状态字符2 8. open_bank开户行字符5 企业客户查询返回企业客户查询返回 1. cust_name客户名称(中文)字符60 2. cust_no客户号字符20 3. cert_type 法人代表证件类 型 字符2 4. legal_cert_no法人证件号码字符20 5. legal_name法人代表姓名字符60 6. contact_name联系人姓名字符60 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 14 页 共 18 页 7. contact_tel联系人电话字符22 8. contact_mail联系人电子邮件字符30 3.1.6.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败。 1、核心反馈成功： 信贷系统收到应答报文以后，如果成功，将获取到的客户号和客户姓名展示在 前端页面。 2、核心反馈失败： 将反馈内容以提示框的形式在前端页面展示。 3.1.7.按客户号按客户号/帐号帐号 查询证件号（用于建账系统）查询证件号（用于建账系统） 3.1.7.1. 交易描述交易描述 根据给定的客户号/帐号从核心系统查询对应的证件号。 3.1.7.2. 接口交易码接口交易码 11130009。 3.1.7.3. 请求报文结构请求报文结构 顺序字段说明字段说明类型长度说明 1acct_no账号或客户号字符17 2acct_cust_type标志字符1 3.1.7.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 1.cust_no客户号字符17 2.cust_type客户类型字符2 3.FILLERFILLER 4.cust_name客户名称字符120 5.FillerFiller 6.cert_no证件号码字符32 7.cert_type证件类型字符2 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 15 页 共 18 页 3.1.8.担保品状态查询担保品状态查询 3.1.8.1. 交易描述交易描述 查询抵质押品在核心状态 3.1.8.2. 接口交易码接口交易码 11120007 3.1.8.3. 请求报文结构请求报文结构 顺序字段说明字段说明类型长度说明 1collateralno担保品编号字符17 3.1.8.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 1.collateralno担保品编号字符17 2.gage_status担保品状态字符2 3.1.9. 贷款受托支付信息贷款受托支付信息查询查询 20330001 3.1.9.1.请求报文请求报文 顺序顺序字段名称字段名称字段说明字段说明类型类型是否是否 必输必输 前置数据元素前置数据元素说明说明 1 AcctNo受托编号char(17) M BkAcctNo 3.1.9.2.应答报文应答报文 顺序顺序字段名称字段名称字段说明字段说明类型类型前置数据元素前置数据元素说明说明 Num1总记录数long(1)BkNum1 循环以下的 内容 EstablishDat e 建立日期char(8)Bk10Date2 YYYYMMD D AcctNo受托编号char(17)BkAcctNo AcctNo1支付 ID 号char(20)BkAcctNo1 CustNo客户号char(17)BkCustNo 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 16 页 共 18 页 CustName客户名char(80)BkCustName AcctNo3贷款账号char(17)BkAcctNo3 AcctNo4存款账号char(17)BkAcctNo4 TotAmt贷款金额 DECIMAL (16,2) BkTotAmt Flag21收款账号类型char(2)BkFlag21 01:系统内账 号 02:系统外账 号 OthBrchNo收款行号char(12)BkOthBrchNo OthBrchNam e 收款行名char(60) BkOthBrchNa me AcctNo2收款人账号char(32)BkAcctNo2 Name2收款人名称char(60)BkName2 TxAmt待支付金额 DECIMAL (16,2) BkTxAmt CurrNo币种char(3)BkCurrNoCNY Date2支付日期char(8)Bk8Date2 YYYYMMD D AreaNo支付流水号char(9)BkAreaNo EducLvl标志 1char(2)BkEducLvl 01：录入状 态 02：已校验 03：已确认 07：已作废 04：待支付 05：支付中 00：支付成 功 06: 支付退汇 Flag2标志 2char(2)BkFlag2 00：不可操 作 01：可作 废 02：可修 改 CustAddr1附言char(60)BkCustAddr1 GroupName备注char(50) BkGroupNam e 3.1.9.3.说明说明 调用前置支付公共交易 SET_92107 佛山小企业信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 17 页 共 18 页 3.1.10.信贷受托支付信息录入信贷受托支付信息录入 20320001 3.1.10.1. 请求报文请求报文 顺序顺序字段名称字段名称字段说明字段说明类型类型是否是否 必输必输 前置数据元素前置数据元素说明说明 1 EstablishDate建立日期char(8)MBk10Date2 YYYYMMD D 2AcctNo受托编号char(17)MBkAcctNo 3AcctNo1支付 ID 号char(20)MBkAcctNo1 4CustNo客户号char(17)MBkCustNo 5CustName客户名char(80)MBkCu