佛山小企业信贷管理系统设计说明书——外部接口.docVIP

广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 1 页 共 73 页 Document number 文档编号 Confidentiality level 密级 内部公开 Document version 文档版本 V1.0 广东省农信信贷管理系统广东省农信信贷管理系统_ _核心信贷核心信贷 接口详细设计说明书接口详细设计说明书 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 2 页 共 73 页 Revision Record 修订记录 Date 日期 Revision Version 修订版本 Sec No. 修改章节 Change Description 修改描述 Author 作者 2010-4-5初稿邱洋星 2010-9-28增加核心通知信贷，并调整文档结 构 邱洋星 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 3 页 共 73 页 目目 录录 第第 1 章章.概述概述5 第第 2 章章.设计方案设计方案5 2.1.系统交互图5 2.2.通讯方式6 2.2.1.信贷到核心6 2.2.2.核心通知信贷9 2.3.交互模式9 2.3.1.实时处理模式9 2.3.2.后台处理模式10 第第 3 章章.表的详细结构设计表的详细结构设计11 3.1.表的详细结构11 3.2.详细流程11 3.2.1.信贷调核心实时处理模式11 3.2.2.信贷调核心后处理模式11 3.2.3.核心通知信贷MQ 通知模式11 第第 4 章章.接口规范接口规范12 4.1.信贷调核心实时处理模式12 4.1.1.客户码提取12 4.1.2.客户账户查询13 4.1.3.存款账户余额查询14 4.1.4.CTA 或有账户查询.15 4.1.5.卡细节查询16 4.1.6.贷款撤销(贷款,按揭,贴现).17 4.1.7.协议还款计划查询查询查询17 4.1.8.建立(修改)协议还款计划.19 4.1.9.客户信息查询20 4.1.10.柜员新增21 4.1.11.按客户号/帐号 查询证件号（用于建账系统） 22 4.1.12.抵/质押物入库 23 4.1.13.抵/质押物出库 25 4.2.信贷调核心后处理模式26 4.2.1.普通贷款发放通知26 4.2.2.按揭贷款发放通知30 4.2.3.贴现发放通知31 4.2.4.委托贷款发放通知33 4.2.5.资金协议编号交易34 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 4 页 共 73 页 4.2.6.银行承兑汇票合同创建通知35 4.2.7.银行承兑汇票 CTA 发放通知36 4.2.8.展期交易37 4.3.核心通知信贷39 4.3.1.普通贷款发放通知39 4.3.2.自助贷款发放通知40 4.3.3.贴现出账通知41 4.3.4.贷款还款通知41 4.3.5.贷款还款冲正通知43 4.3.6.贷款结清通知44 4.3.7.贷款结清冲正通知45 4.3.8.抵质押品入库成功通知46 4.3.9.抵质押品出库成功通知47 第第 5 章章.附录附录48 5.1.附表 1：渠道编号规则.48 5.2.附表 2：证件类型取值定义.48 5.3.附表 3：账户状态取值定义.49 5.4.附表 4：币种类型取值说明.50 5.5.附表 5：客户状态取值说明.56 5.6.附表 6：账户状态取值说明.57 5.7.附表 7：产品类型取值说明.57 5.8.附表 8：结息周期取值说明.59 5.9.附表 9：存款产品列表取值说明.60 5.10.附表 10：存款产品子类取值说明.60 5.11.附表 11：信贷交易产品列表取值说明.67 5.12.附表 12：证件类型取值说明.67 5.13.附表 13：接口数据格式说明.68 5.13.1.“9”描述符(文档记录 Numeric 类型).68 5.13.2.“V”描述符和“S”描述符.69 5.13.3.“X“字符型数据描述(文档记录 Alphanumeric 类型) .69 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 5 页 共 73 页 第第 1 章章. 概述概述 广东农信信贷系统与核心系统的交互采用的是双向 T+0 的交易模式，实现对关联数据 的实时修改和同步，确保关键数据在任何时点的一致性，避免数据不同步造成的业务差错。 既保证了信贷管理系统对核心放款的授权控制，又及时从核心反馈回来信贷账务数据的交 易变化，从而方便信贷管理人员的监管控制和实时信息获取。对于提高信贷风险的管理水 平、实现科学决策、在确保资产安全的情况下实现最优工作效率起到关键的作用。 第第 2 章章. 设计方案设计方案 2.1.系统交互图系统交互图 信贷管理系统 浏览器 工作流引擎 （可使用第三方工作流引擎） 客 户 信 息 额 度 管 理 产 品 管 理 。 。 。 。 。 。 。 。 业务逻辑 服务接口 （符合农信 规划接口规 范） 数据数据 核心系统国结系统 。 。 。 。 省前置 底层接口 内部接口 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 6 页 共 73 页 2.2.通讯方式通讯方式 2.2.1.信贷到核心信贷到核心 2.2.1.1. 基本通信协议基本通信协议 采用 TCP/IP 短连接，通信双方每次通信时建立连接，通信结束后关闭连接。对于信 贷调用前置的交易，前置监听 SOCKET 端口，接收、处理、返回交易请求。 信贷系统省前置 核心系统 交交互互方方式式: TCP 1 2 43 2.2.1.2. 数据传输数据传输 在 TCP/IP 网络中传输的应用数据采用下面的格式进行传送。 数据长度(6位)交易码(6位)数据块 数据长度数据长度 6 个字节，用 ASCII 码表示的数据长度。其值为不包含该数据长度字段，但包括交易 码长度字段的数据包长度。不足 6 个字节左补“0” ，例如：数据块长度为 128，则数据长 度表示为“000128” 。 交易码交易码 标识交易的代码，固定由 6 个字节组成。 数据块数据块 应用层要传输的交易报文数据。 2.2.1.3. 超时时间超时时间 接收报文的超时时间为 90 秒。 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 7 页 共 73 页 2.2.1.4. 报文说明报文说明 信贷与前置间采用 XML 报文格式，所有报文包含报文头和报文体两部分。 报文说明 2.2.1.5. 报文编码报文编码 报文编码使用 gb2312 编码。 2.2.1.6. 属性说明属性说明 n表示 0 至 9 的数字字符 a表示数字和英文字字符 G表示 GBK 定义的 16 位（16bits or 双字节）编码字符 B表示二进制格式存储，其后的长度为 Byte 2.2.1.7. 报文头报文头 报文头信息在报文头节点之内，具体的内容在请求报文头与应答报文头有差异，具 体内容如下： 2.2.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 request_seq_no 请求方流水号 字符 (20) MM 当日该渠道唯一 值 terminal_info 客户渠道交易 终端 字符 (20) CM 信贷发送客户的 IP，柜面发送终端 号，手机银行与呼 叫中心发送电话号 码 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 8 页 共 73 页 2.2.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.2.1.10.报文体报文体 报文体信息在报文体节点之内，对于数组，通过节点进行标识。 2.2.1.11.报文示例报文示例 001234 58101 123456789012 123456 111111111 CNY 111111111 HKD 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 9 页 共 73 页 2.2.2.核心通知信贷核心通知信贷 为了及时处理信贷额度占用与释放，以及了解每个贷款的拖欠筒子情况，是要实时 将账户的筒子金额存放在筒子金额变更表及时向信贷发送账户的筒子变更信息告知信贷。 贷款金融交易账户筒子金额发生变化后，将最终账户的筒子金额存放在筒子金额变更表中 （FMIS） ，利用守护进程以及 MQ 工具将表中的信息发送给信贷系统,已发送的记录写在 (TMIS)。同样担保品状态的变更也是记录在 FMIS 表中，已发送的记录写在(TMIS)， 通过 大字段标识 告知信贷是贷款还是抵押品变更信息，使用的是同一个守护进程程序。 2.3.交互模式交互模式 2.3.1.实时处理模式实时处理模式 此种模式是有联机交易本身在交易进行的过程中驱动并完成交互通讯，实现两个系统 的业务调用和信息同步。此类模式主要是由信贷向核心发起的实时查询类交易；如查询余 额、获取客户信息等。 实时模式 核心信贷 核心服务 组织结 果数据 向核心发起 请求 联机交易 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 10 页 共 73 页 2.3.2.后台处理模式后台处理模式 系统完成联机交易的同时，将待发送信息表内插入通讯数据，联机交易处理就算成功 结束。依靠通讯引擎的守护进程监控获取新的待处理通讯任务并给对方系统发送消息，请 求对方系统完成数据及业务的同步处理。这种模式在核心和信贷都部署通讯引擎，担当的 是请求客户端的角色。 信贷授权通知： 后处理模式（信贷调核心） 核心信贷 守护进程实时监控授权表 核心响应服务 向核心发送 消息 插入授权信息 联机交易 授权信 息表 核心交易 MQ 通知信贷： 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 11 页 共 73 页 MQ通讯模式 核心信贷 核心系统 信贷端MQ 服务器 联机交易 核心端MQ 服务器 第第 3 章章. 表的详细结构设计表的详细结构设计 3.1.表的详细结构表的详细结构 详细结构参考广东信贷数据结构.PDM 。 3.2.详细流程详细流程 3.2.1.信贷调核心实时处理模式信贷调核心实时处理模式 直接有信贷向核心系统发起交易请求，核心系统相应后，反馈到信贷系统。 3.2.2.信贷调核心后处理模式信贷调核心后处理模式 信贷系统执行出账通知操作后，对应的授权通知信息保存在出账授权表内，出账 交易处理完成。 信贷系统的通讯守护进程，监控查询待发送的授权通知，根据不同的授权通知类 型，向核心的对应服务发送请求。 核心系统实时响应请求，登记对应的授权通知，回复反馈信息到信贷系统。 3.2.3.核心通知信贷核心通知信贷MQ 通知模式通知模式 核心通过 MQ 工具向信贷系统发送账户的筒子变更信息。 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 12 页 共 73 页 信贷系统收到 MQ 信息，根据编码规范解析信息，保存到通知表。 信贷系统读取通知表，并按照通知表的数据调用响应交易类。 第第 4 章章. 接口规范接口规范 4.1.信贷调核心实时处理模式信贷调核心实时处理模式 4.1.1. 客户码提取客户码提取 4.1.1.1. 交易描述交易描述 信贷系统在登记客户信息时，需要从核心系统获取客户码。信贷系统发起，将信贷系 统输入的证件类型、证件号码、客户开户机构码发送给核心业务系统，由核心系统判断三 个要素是否相符。如果相符，返回核心系统中的客户信息，否则，返回相应的错误信息。 4.1.1.2. 接口交易码接口交易码 11130007 4.1.1.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 1. cert_no证件号码字符32 2. cert_type证件类型字符2 4.1.1.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 显示 4 记录(记录号、客户号、客户类型、证件类型、证件号、客户名称) 1. Rec_num记录号字符4 记录号 Rec number 2cust_no客户号字符17 3Cust_type客户类型字符2 客户类型 Customer Type 4 cert_type证件类型字符2 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 13 页 共 73 页 5 cert_no证件号码字符32 6 cust_name客户名称字符120 4.1.1.5. 信贷系统处理信贷系统处理 页面录入证件类型、证件号码和获取客户经理的机构号，信贷系统检查客户表是否已 经存在对应的客户。如果信贷系统已经存在，则提示，如果没有则发送给核心，收到核心 的应答报文以后，根据情况进行处理: 1、返回一个客户码。将客户码显示在页面客户码部分。将证件类型、证件号 码、户名、客户码四个输入框设置为只读。 2、返回多个客户码。提示客户经理选择其中的一个，将客户码显示在页面客户 码部分。将证件类型、证件号码、户名、客户码四个输入框设置为只读。 3、返回错误信息。以alert窗口的形式，将应答报文头返回的错误信息内容弹 出。 4.1.2. 客户账户查询客户账户查询 4.1.2.1. 交易描述交易描述 根据客户号，查询客户的所有存款与贷款账户信息。 4.1.2.2. 接口交易码接口交易码 11130002 4.1.2.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 1. cust_type客户类型字符2 01:个人客户 02:企业客户 03:金融机构客户 04:客户群 2. cust_no客户号字符17 4.1.2.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 循环数组 list 1 acct_no账号字符20 2acct_status账号状态字符2 3dl_flag存贷标志字符1D 存款 D Doposit 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 14 页 共 73 页 L 贷款 L Loan 4 curreny货币代码字符3 5 acct_bal账户余额数值16,2 4.1.2.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败，相应的将反馈内容和账 户余额显示到页面。 4.1.3.存款账户余额查询存款账户余额查询 4.1.3.1. 交易描述交易描述 信贷系统除了不会实时反映客户的存款信息，对于一些内部账户（保证金、委托存款 户等）或者其他内部特殊账户也不会实时反映余额情况。如果需要获取单笔账户的余额款 信息，使用单笔账户余额查询。 如果是一本通的，只能查询活期 4.1.3.2. 接口交易码接口交易码 . 10130002 4.1.3.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 1. acct_no账号字符17 2. acct_sub子帐户类别字符4活期一本通必输 4.1.3.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 1. acct_name客户名称字符40 2. curr_bal当前余额数值16，2 4.1.3.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败，相应的将反馈内容和账 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 15 页 共 73 页 户余额显示到页面。 4.1.4.CTA 或有账户查询或有账户查询 4.1.4.1. 交易描述交易描述 查询 CTA 或有账户。 4.1.4.2. 接口交易码接口交易码 . 11130006 4.1.4.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 1acct_no 帐号 Account NO 字符17CTA 帐号. 2OptionOption 字符 1 1 一般或有账户查 询 2 银行承兑汇票类 或有账户查询 4.1.4.4. 应答报文结构应答报文结构 顺序字段说明类型长度说明 3. 账号字符17 4. 客户号字符17 5. 账户名称字符60 6. 账户余额数值16，2 7. 出票人全称字符4 8. 合同号码字符 17 4.1.4.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败，相应的将反馈内容和账 户余额显示到页面。 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 16 页 共 73 页 4.1.5.卡细节查询卡细节查询 4.1.5.1. 交易描述交易描述 查询卡细节。 4.1.5.2. 接口交易码接口交易码 . 11130008 4.1.5.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度是否必输说明 1. card_no卡号字符19M(必输) 要查询的卡的卡 号。必须是该机 构的一个有效的 卡号（包括核对 数位） 。对照 CARD Table 确认。 必须输入的字段。 2. function功能字符1O 3. openaccount是否开户字符1M 4.1.5.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 1. card_no卡号字符19 2. primary_card主卡卡号字符19 3. issu_branch发卡机构字符5 4. link_type1主账户关联类型 1字符1 5. link_acout1主账户关联帐号 1字符17 6. cust_no客户号字符17 7. cust_name客户名称字符40 4.1.5.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败，相应的将反馈内容和账 户余额显示到页面。 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 17 页 共 73 页 4.1.6.贷款撤销贷款撤销(贷款贷款,按揭按揭,贴现贴现) 4.1.6.1. 交易描述交易描述 信贷系统向核心系统发送创建贷款账户通知后，操作员如果发现有误，在核心系统没 有办理放款的前提下可以进行撤销处理。如果核心系统已经进行了放款业务办理，则无法 撤销，只能通过柜面做冲正操作或收回再贷。 4.1.6.2. 接口交易码接口交易码 11120003 4.1.6.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 acct_no帐号字符179（17） 4.1.6.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 acct_no帐号字符179（17） 4.1.6.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败。 1、核心反馈成功： 信贷系统更新出账授权表，根据授权编号将交易状态改为“授权已撤销” 。 删除贷款台帐中的相应记录，索引为贷款帐号。 2、核心反馈失败： 将反馈内容中的错误信息显示在页面上，提示授权撤销失败。 4.1.7.协议还款计划协议还款计划查询查询查询 4.1.7.1. 交易描述交易描述 对于协议还款的贷款，根据账号从核心系统查询协议还款计划，更新信贷系统的协议 还款计划表。 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 18 页 共 73 页 4.1.7.2. 接口交易码接口交易码 11120004 4.1.7.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型位数备注 1 acct_no账号字符17 2 action选项字符1C:创建 A:修改 E:查询 3 Rec_no屏数字符919 任何一个数字 4.1.7.4. 应答报文结构应答报文结构 顺 序 字段说明类型位数备注 帐号字符17 计划总笔数字符3 还款/起始日 1字符8ddMMyyyy 次数 1字符3 类型 1字符1 还款金额 1字符18 。 。 。 字符 还款/起始日 n字符8ddMMyyyy 次数 n字符3 类型 n字符1 还款金额 n字符18 4.1.7.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败。 1、核心反馈成功： 信贷系统根据帐号更新协议还款计划表，并将内容显示在页面上。 2、核心反馈失败： 将反馈内容中的错误信息显示在页面上。 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 19 页 共 73 页 4.1.8.建立建立(修改修改)协议还款计划协议还款计划 4.1.8.1. 交易描述交易描述 对于协议还款的贷款，创建或者维护协议还款计划。 4.1.8.2. 接口交易码接口交易码 11120005 4.1.8.3. 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 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 4.1.8.4. 应答报文结构应答报文结构 顺序字段说明类型位数备注 1 帐号字符 17 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 20 页 共 73 页 4.1.8.5. 信贷系统处理信贷系统处理 1、 建立协议还款计划: 信贷系统将还款计划信息发给核心，核心建立相应帐号的协议还款计划信息。信贷系 统根据核心传送回来的应答报文头判断成功或者失败，并将内容在页面显示。 2、 修改协议还款计划: 做此交易前，信贷系统做先协议还款计划查询，从核心系统获取最新的协议还款计 划，并显示在页面上，操作人员修改计划后再发给核心，更新核心的协议还款计划表。 信贷系统根据核心传送回来的应答报文头判断成功或者失败，并将内容在页面显示。 4.1.9.客户信息查询客户信息查询 4.1.9.1. 交易描述交易描述 根据客户号或帐号、客户号或帐号标志、客户类型从核心系统查询该客户的客户信息。 4.1.9.2. 接口交易码接口交易码 11130001。 4.1.9.3. 请求报文结构请求报文结构 顺序字段说明字段说明类型长度说明 1acct_no账号/客户号字符329（17） 2acct_cust_type 账号、客户号 标识 字符19（17） 3inquiry_type查询类型字符1X(32) 4.1.9.4. 应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 个人客户查询返回个人客户查询返回 2. cust_no客户号字符20 3. cert_type证件类型字符2 4. cert_no证件号码字符20 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 21 页 共 73 页 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 7. contact_tel联系人电话字符22 8. contact_mail联系人电子邮件字符30 4.1.9.5. 信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败。 1、核心反馈成功： 信贷系统收到应答报文以后，如果成功，将获取到的客户号和客户姓名展示在 前端页面。 2、核心反馈失败： 将反馈内容以提示框的形式在前端页面展示。 4.1.10. 柜员新增柜员新增 4.1.10.1.交易描述交易描述 根据柜员姓名、柜员证件类型、证件号码和系统标识从核心系统查询用户码，若用户 码在核心系统不存在，则在核心系统中新增该柜员号。 4.1.10.2.接口交易码接口交易码 21120001。 4.1.10.3.请求报文结构请求报文结构 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 22 页 共 73 页 顺序字段说明字段说明类型长度说明 1tellername柜员姓名字符409（17） 2idtype柜员证件类型字符29（17） 3idno柜员证件号码字符30 4sys_flag系统标识字符1X(32) 4.1.10.4.应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 1tellerno1柜员号字符7 4.1.10.5.信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败。 3、核心反馈成功： 信贷系统收到应答报文以后，如果成功，将获取到的柜员号展示在前端页面。 4、核心反馈失败： 将反馈内容以提示框的形式在前端页面展示。 4.1.11. 按客户号按客户号/帐号帐号 查询证件号（用于建账系统）查询证件号（用于建账系统） 4.1.11.1.交易描述交易描述 根据给定的客户号/帐号从核心系统查询对应的证件号。 4.1.11.2.接口交易码接口交易码 11130009。 4.1.11.3.请求报文结构请求报文结构 顺序字段说明字段说明类型长度说明 1acct_no账号或客户号字符17 2acct_cust_type标志字符1 4.1.11.4.应答报文结构应答报文结构 顺序字段名称字段说明类型长度说明 1.cust_no客户号字符17 2.cust_type客户类型字符2 3.FILLERFILLER 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 23 页 共 73 页 4.cust_name客户名称字符120 5.FillerFiller 6.cert_no证件号码字符32 7.cert_type证件类型字符2 4.1.12. 抵抵/质押物入库质押物入库 4.1.12.1.交易描述交易描述 核心担保品基本信息建立。 4.1.12.2.接口交易码接口交易码 11120008。 4.1.12.3.请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 cust_no客户号字符179（17） cust_name抵/质押人名称字符609（17） acct_or_sum_ no 账号/额度号字符17X(34) acct_or_sum_ type 账号/额度类型字符30X(60) gage_type担保品大类字符4 0001:抵押类 0002:质押类 0003:抵债资产类 0004:置换抵债类 0005:有价单证类 gage_summar ize 担保品概述字符50X bank_value银行认可价值字符189(14)V999S coin货币字符3X(3) gage_status担保品状态字符299 gage_sub_typ e 担保品子类字符4 0001:抵押类 0001:抵押类 0001:质押类 0002:质押类 0006:债券 0003:抵债资产类 0007:其他 0003:抵债资产类 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 24 页 共 73 页 0001:房屋及建筑 物 0003:抵债 资产类 0002:土地使用权 0003:抵债资产类 0003:交通工具 0003:抵债资产类 0004:电子设备 0003:抵债资产类 0005:机器设备 0003:抵债资产类 0001:置换抵债类 0004:置换抵债类 0001:有价单证类 0005:有价单证类 gage_sub_typ e1 担保品子类 1字符29(2) gage_value_d ate 担保品估价日期字符8ddMMyyyy homebranch机构号字符5X(5) collateralno担保品编号字符179（17） idno1抵/质押人证件号字符32X(32) idtype1抵/质押人证件类型字符2X(02) 4.1.12.4.应答报文结构应答报文结构 取应答报文头的还回状态。 4.1.12.5.信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败。 5、核心反馈成功： 信贷系统收到应答报文以后，如果成功，将抵质押物基本信息表的出入库状态 “入库未记帐” 。 6、核心反馈失败： 将反馈内容以提示框的形式在前端页面展示。 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 25 页 共 73 页 4.1.13. 抵抵/质押物出库质押物出库 4.1.13.1.交易描述交易描述 核心担保品基本信息修改。 4.1.13.2.接口交易码接口交易码 11120009。 4.1.13.3.请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 cust_no客户号字符179（17） cust_name抵/质押人名称字符609（17） acct_or_sum_no账号/额度号字符17X(34) acct_or_sum_ty pe 账号/额度类型字符30X(60) gage_type担保品大类字符4 0001:抵押类 0002:质押类 0003:抵债资产类 0004:置换抵债类 0005:有价单证类 gage_summariz e 担保品概述字符50X bank_value银行认可价值字符189(14)V999S coin货币字符3X(3) gage_status担保品状态字符299 gage_sub_type1担保品子类 1字符29(2) gage_value_date担保品估价日期字符8ddMMyyyy homebranch机构号字符5X(5) collateralno担保品编号字符179（17） 4.1.13.4.应答报文结构应答报文结构 取应答报文头的还回状态。 4.1.13.5.信贷系统处理信贷系统处理 信贷系统根据核心传送回来的应答报文头判断成功或者失败。 7、核心反馈成功： 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 26 页 共 73 页 信贷系统收到应答报文以后，如果成功，将抵质押物基本信息表的出入库状态 “出库未记帐” 。 8、核心反馈失败： 将反馈内容以提示框的形式在前端页面展示。 4.1.14. 受托支付受托支付 4.1.14.1.1 交易描述交易描述 受托支付校验交易对手，检查其账号是否符合要求 4.1.14.1.2 接口交易码接口交易码 20330001 4.1.14.1.3 请求报文结构请求报文结构 顺序顺序字段名称字段名称字段说明字段说明类型类型长度长度说明说明 1AcctNo受托编号char17 4.1.14.1.4 答报文结构答报文结构 顺序顺序字段名称字段名称字段说明字段说明类型类型长度长度说明说明 Num1总记录数long(1) 1循环以下的 内容 EstablishDat e 建立日期char(8) 8YYYYMMD D AcctNo受托编号char(17)17 AcctNo1支付 ID 号char(20)20 CustNo客户号char(17)17 CustName客户名char(80)80 AcctNo3贷款账号char(17)17 AcctNo4存款账号char(17)17 TotAmt贷款金额 DECIMAL (16,2) Flag21收款账号类型char(2) 201:系统内账 号 02:系统外账 号 OthBrchNo收款行号char(12)12 OthBrchNam e 收款行名char(60) 60 AcctNo2收款人账号char(32)32 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 27 页 共 73 页 Name2收款人名称char(60)60 TxAmt待支付金额 DECIMAL (16,2) CurrNo币种char(3)3CNY Date2支付日期char(8) 8YYYYMMD D AreaNo支付流水号char(9)9 EducLvl标志 1char(2) 201：录入状 态 02：已校验 03：已确认 07：已作废 04：待支付 05：支付中 00：支付成 功 06: 支付退汇 Flag2标志 2char(2) 200：不可操 作 01：可作 废 02：可修 改 CustAddr1附言char(60)60 GroupName备注char(50)50 4.1.14.1.5 系统处理系统处理 4.1.14.2.1 交易描述交易描述 信贷受托支付信息录入 4.1.14.2.2 接口交易码接口交易码 20320001 4.1.14.2.3 请求报文结构请求报文结构 顺序字段名称字段说明类型长度说明 1 EstablishDate建立日期字符8 YYYYMMD D 2AcctNo受托编号char(17)17 3AcctNo1支付 ID 号char(20)20 4CustNo客户号char(17)17 5CustName客户名char(80)80 6AcctNo3贷款账号char(17)17 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 28 页 共 73 页 7AcctNo4存款账号char(17)17 8TotAmt贷款金额DECIMA 9 Flag21收款账号类型char(2)2 01:系统内账 号 02:系统外账 号 11:第三方监 管 10 OthBrchNo收款行号char(12)12 收款账户类型 为 02 时必输 11 OthBrchName收款行名char(60)60 收款账户类型 为 02 时必输 13AcctNo2收款人账号char(32)32 14Name2收款人名称char(60)60 15 TxAmt待支付金额 DECIMA L(16,2) 16CurrNo币种char(3)3CNY 17 Date2支付日期char(8)O YYYYMMD D 18AreaNo支付流水号char(9)O 19 BkEducLvl标志 1char(2)O 01：录入状态 02：已校验 03：已确认 07：已作废 04：待支付 05：支付中 00：支付成功 06: 支付退汇 20 Flag2标志 2char(2)O 00：不可操作 01：可作废 02：可修改 21CustAddr1附言char(60)O 22GroupName备注char(50)O 4.1.14.2.4 应答报文结构应答报文结构 无 4.1.14.2.5 系统处理系统处理 4.1.14.3.1 交易描述交易描述 受托支付作废交易 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 29 页 共 73 页 4.1.14.3.2 接口交易码接口交易码 20320002 4.1.14.3.3 请求报文结构请求报文结构 顺序字段名称字段说明类型长度备注 1AcctNo受托编号char17 2AcctNo1支付 ID 号char20 4.1.14.3.4 应答报文结构应答报文结构 无 4.1.14.3.5 系统处理系统处理 4.1.14.4.1 交易描述交易描述 贷款受托支付信息修改 4.1.14.4.2 接口交易码接口交易码 20320003 4.1.14.4.3 请求报文结构请求报文结构 顺序顺序字段名称字段名称字段说明字段说明类型类型长度长度说明说明 1AcctNo受托编号char17 2AcctNo1支付 ID 号char20 3OthBrchNo收款行号char12能被修改 4OthBrchName收款行名char60能被修改 5AcctNo2收款人账号char32能被修改 6Name2收款人名称char60能被修改 7CustAddr1附言char60能被修改 4.1.14.4.4 应答报文结构应答报文结构 无 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 30 页 共 73 页 4.1.14.4.5 系统处理系统处理 4.2.信贷调核心后处理模式信贷调核心后处理模式 4.2.1.普通贷款发放通知普通贷款发放通知 4.2.1.1. 交易描述交易描述 信贷系统对待放借据进行放款操作，插入信贷系统的出账授权表；随后发往核心业务 系统，通知建立普通贷款账户。 4.2.1.2. 接口交易码接口交易码 11120002 4.2.1.3. 请求报文结构请求报文结构 顺序字段说明字段说明类型位数备注 cif_or_acct_no现有 CIF 号码/账号字符17 system字符3 DEP：建立存款帐号 LON:建立贷款帐号 CTA：建立 CTA 账户 CTB：建立银行承兑汇票 CTA BGD：建立银行承兑汇票合 同 COL 建立担保品（渠道需求 建立存款帐号） customer_or_acc t_no 客户号/账号字符1C:客户号码 cust_no现有 CIF 号码字符179(17) product_type产品类型字符4请参看附件 7 product_sub_typ e 产品子类字符4详见附表：产品子类 lsm_load_no借据号码字符179(17)(注意核心的规则) contract_no合同号字符179(17) apply_sum申请/核准金额字符189(14)V999S load_apply_date贷款申请日字符8ddMMyyyy ontract_end_day到期日字符8ddMMyyyy return_load_type还款方式字符1 X, 还款方式选项，有效值 选项： B:只还利息（默认） 、 F:等额本息、G:等额本金、 Comment qiuyangxi1: 已删除 广东省农信信贷管理系统_核心信贷接口详细设计说明书 北京宇信易诚科技有限公司 第 31 页 共 73 页 N:协议还款。 流动资金贷款常用方式是 B/N，按揭贷款常用方式 F/G。 load_term贷款期限字符49999 interest _rate_type 利率类型字符1 X, 定义账户利率类型（1 位 数字）有效值如下： A： 固定利率、B：浮动利率、 C：通知利率、D：期权利率、 E：协议利率。 由产品层带入不可修改 interest_rate_inc rease_option4 利率增量选项字符1 9, 指利率浮动的方式，有效 值为： 空值、1:按浮动值计 算利息、2:按浮动比计算利 息。 当利率类型为固定利率时该 项取值为空；当利率类型为 浮动利率时该项可取值 1、2 选项，默认选项为 2。 interest_rate_ increment 利率增量字符8 99V9(5)S, 有符号的字段， 输入的利率前面加上正负号， 表示上下浮动，默认的符号 为正。 该域中的值指利率 上下浮动的比率或值（2 位 数字和 5 位小数） 。当利率 类型为浮动利率时有效。 fastness_interest _rate 固定利率字符8999V9(4)S outload_acct_no放款账号字符179(17) return_acct_no还款账号字符179(17) basic_term基期字符1 普通贷款隐藏，定义”期限 “值。可能值为: D - 天数 M - 月数 return_load_date还款日字符2普通贷款隐