信贷管理与核算系统接口开发规范.docx
《信贷管理与核算系统接口开发规范.docx》由会员分享,可在线阅读,更多相关《信贷管理与核算系统接口开发规范.docx(170页珍藏版)》请在冰豆网上搜索。
信贷管理与核算系统接口开发规范
信贷管理系统与核算系统
接口规范
RevisionRecord修订记录
Date
日期
RevisionVersion
修订版本
SecNo.
修改章节
ChangeDescription
修改描述
Author
作者
2014-08-07
1.3
4
贷款发放的接口增加贴息的接收内容
张德富
2014-08-08
1.3
4
需要增加费用配置的同步接口
2014-08-26
1.3
4
贷款发放接口有四个字段代码值修改名称
伞萍萍
2014-08-27
1.3
4
还款计划试算接口增加输入报文、返回报文
伞萍萍
2014-09-01
1.3
4
增加还款账号变更及退货接口
张德富
2015-01-05
1.3
4
撤销接口中增加“撤销类型”,支持金融公司中的资金撤销情况
张德富
信贷管理系统与核算系统接口规范
1.概述:
核算系统与信贷管理系统的接口,具有开放、灵活、方便的特点,核算系统考虑到与外围系统接口的多样性,而核算系统与管理系统有可能是统一部署,也有可能独立部署,核算系统在设计中考虑了上述两种情况,如果是统一部署则信贷管理系统可以采用共享表方式,只需要在调用核算接口处理前将数据插入到共享表中即可;如果是独立部署,则调用核算提供的WEB服务调用即可,由于目前绝大部分项目都是统一部署,所以下面就统一方面进行说明。
由于核算系统的核算交易本身也是具有工作流支持,所以发放后核算交易的处理可以支持工作流的审批。
核算系统与信贷管理系统、核心系统接口架构如下图所示:
步骤如上所示:
1.信贷管理系统完成业务操作的审批流程后,调用核算提供的接口,核算将数据放到相关的授权表中。
2.会计人员在信贷核算系统中发起记账交易的流程,流程结束后,核算系统完成记账处理。
3.核算系统调用核心记账。
4.核算系统调用管理系统提供的更新台账接口,更新信贷管理系统台账信息。
1.1.编写目的
本文档用于描述信贷管理系统(包括对公及对私)与核算系统之间的接口规范。
1.2.适用范围
信贷管理系统与信贷核算系统之间接口开发及维护人员。
2.接口清单说明
报文编号
报文名称
方向
处理模式
01
贷款发放授权通知
管理=》核算
手工触发
02
贷款核销授权通知
管理=》核算
手工触发
03
贷款展期授权通知
管理=》核算
批处理触发
04
银承汇票出票授权通知
管理=》核算
手工触发
05
保函开立授权通知
管理=》核算
手工触发
06
保函核销授权通知
管理=》核算
手工触发
07
贴现发放授权通知
管理=》核算
手工触发
3.接口通讯报文规范
3.1.交易码描述
serviceId
funId
说明
状态
serv1
0000000022
贷款发放出账
serv1
0000000023
贷款展期
serv1
0000000024
贷款核销
serv1
0000000025
银承出账
serv1
0000000026
保函出账
serv1
0000000027
贴现出账
serv1
0000000028
抵质押品出入库
serv1
0000000029
还款方式查询
serv1
0000000030
记账状态查询
serv1
0000000031
交易撤销
serv1
0000100028
消费信贷退货
serv1
0000100029
还款计划调整
serv1
0000100030
还款账户变更
serv1
0000100032
单项减值确认与计提
serv1
0000100033
组合减值确认
serv1
0000100035
单项减值确认
serv1
0000000036
资产卖出/收回
serv1
0000000037
保函结清
serv1
0000000038
利息减免
serv1
0000000039
日终步骤处理
serv1
0000000040
贷款平移
serv1
0000000041
费用收取
serv1
0000000099
授权交易处理
serv1
0000100040
主动还款试算
serv1
0000100041
主动还款
serv1
0000100042
贷款停息
serv1
0000000043
欠款查询
serv1
0000000044
日终状态查询
serv1
0000000045
贷款发放授权查询
serv1
0000000046
主动还款授权查询
serv1
0000000053
贷款承诺签发
serv1
0000000054
收费交易
serv1
0000000055
银行承兑汇票生成垫款交易
serv1
0000000056
贷款产品变更
serv1
0000000057
资产证券化卖出/赎回
serv1
0000100046
归还委托贷款利息
serv1
0000100043
欠款查询
serv1
0000100027
还款计划试算
serv1
0000100028
还款计划查询
serv1
0000100047
保函付款
serv1
0000100048
授权交易处理
serv1
0000100049
可撤销/冲正交易查询
serv1
0000100050
帐务交易流水查询
serv1
0000100051
还款计划调整试算
serv1
0000100052
客户还款记录查询
serv1
0000100053
贷款信息查询
serv1
0000100054
费用记录查询
serv1
0000100055
押品出入库记录
serv1
0000100056
还款计划查询
serv1
0000100057
可买回贷款查询
serv1
0000000153
贷款承诺签发授权查询
serv1
P0000100001
核算规则参数同步
serv1
P0000100002
费用类型参数同步
serv1
P0000100003
还款方式参数同步
serv1
P0000100004
还款顺序参数同步
serv1
P0000100005
会计分录参数同步
serv1
P0000100006
会计科目设置参数同步
serv1
P0000100007
会计科目设置参数同步
serv1
P0000100008
系统参数加载
serv1
P0000100009
分支机构信息同步
serv1
P0000100010
金融机构信息同步
(交易码将会随接口文档而变化)
3.2.报文规范
(HTTP渠道方式)
3.3.请求报文结构
系统报文头:
CMIS;servi0000000021;
5位:
渠道编号(系统命名)
1位:
分割‘;’
15位:
交易码(serviceId+funId)
1位:
分割‘;’
报文体:
xmlversion="1.0"encoding="GB2312"?
>
LoanDrawdown
--借据信息表
………
--账号信息列表
--账号信息表
…………
--还款方式表,会有多条的情况
--还款方式表
…………………..
--费用有可能存在多条的情况
…………………..
报文例子如下所示:
kfs;servi0000000021;
xmlversion="1.0"encoding="GB2312"?
>
Contract_Detail
110104196310041662
3.4.响应报文结构
报文体:
kfs;servi0000000021;
xmlversion="1.0"encoding="GB2312"?
>
报文例子如下所示:
kfs;servi0000000021;
xmlversion="1.0"encoding="GB2312"?
>
1000000023
没有找到对应的服务信息
LoanDrawdown
3.5.渠道编号
渠道编号(系统命名)
说明
CMIS
信贷管理系统
3.6.错误代码描述
errorCode
errorMsg
00000
调用成功返回
10001
调用没有注册的服务
10002
调用服务所对应的渠道不正确
20001
调用服务所对应的渠道报文保存异常
90000
调用服务所对应的其它
……
3.7.请求报文示例
CMIS;servi0000000021;
xmlversion="1.0"encoding="GB2312"?
>
LoanDrawdown
--借据信息表
10021
102389
2011-03-09
user1
C10009
101
102120090
1000
1021
ABCD
01
522337190899813
CNY
D1009
CCY
10000
2011-03-09
1024
2019-09-08
2011-03-09
21
FX
D
R02
0.0783
0.2
0.1
6.890
R02
0.076
0.1
0.6
M
1
M01
01
LOAN
N
A
Y
NYF
0.2
--账号信息表
--账号信息表
…………
--还款方式表
--还款方式表
…………………..
…………………..
3.8.响应报文示例
kfs;servi0000000021;
xmlversion="1.0"encoding="GB2312"?
>
1000000023
没有找到对应的服务信息
LoanDrawdown
4.交易类接口说明
4.1.贷款发放
可以用于资产买入。
注意:
对于委托账户,需要3条账户信息。
需要提供委托人账户信息。
服务名:
serv10000000022
应用场景:
本交易接口用于当信贷管理系统已经完成审批流程后,信贷管理系统将相关核算信息通过该交易发送到信贷核算系统,包据借据信息、账号信息、费用等信息。
请求报文:
LM_LOAN_T(管理与核算接口数据表):
51
单条记录
名称
代码
数据类型
必填
注释
授权编号
GEN_GL_NO
VARCHAR2(30)
★
出账授权编号
申请书编号
APPL_SEQ
NUMBER(20)
★
申请日期
INPUT_DT
VARCHAR2(10)
★
业务申请日期
合同编号
LOAN_CONT_NO
VARCHAR2(30)
★
贷款合同号
机构码
BCH_CDE
VARCHAR2(10)
★
出账机构,分支机构代码
借据号
LOAN_NO
VARCHAR2(30)
★
借据号
银行代码
BANK_CDE
VARCHAR2(10)
★
银行代码
客户编号
CUST_ID
VARCHAR2(30)
★
客户编号
客户名称
CUST_NAME
VARCHAR2(200)
★
借款人姓名
证件类型
ID_TYPE
VARCHAR2(10)
★
借款人证件类型
证件号码
ID_NO
VARCHAR2(40)
★
借款人证件号
发证国家
ISS_CTRY
VARCHAR2(10)
☆
默认填:
CN
经销商代码
DEALER_CDE
VARCHAR2(20)
☆
经销商代码:
不填
币种
LOAN_CCY
VARCHAR2(10)
★
币种
申请金额
ORIG_PRCP
NUMBER(16,2)
★
发放金额
发放日期
LOAN_ACTV_DT
VARCHAR2(10)
★
放款日期
贷款组
TYP_GRP
VARCHAR2(10)
☆
贷款分组,比如汽车类品种是一组、住房类是一组
贷款品种
LOAN_TYP
VARCHAR2(10)
★
贷款品种代码,核算品种与信贷品种对应关系:
p_loan_typ_gl_map
贷款核算品种
LOAN_GL_ROLE_CDE
VARCHAR2(10)
★
最后到期日
LAST_DUE_DT
VARCHAR2(10)
★
合同到期日
起息日
INT_START_DT
VARCHAR2(10)
★
起息日
扣款日
DUE_DAY
NUMBER
(2)
★
指定还款日期(每月N日),建议扣款日<=28
利率模式
LOAN_RATE_MODE
VARCHAR2
(2)
★
利率模式
FX:
固定利率
RV:
浮动利率
利率基础
RATE_BASE
VARCHAR2
(1)
★
利率计算基础
Y:
年利率
M:
月利率
D:
日利率
利率类型
LOAN_RATE_TYP
VARCHAR2(10)
★
利率代码(基准利率代码)
selectrate_typfroms_int_rat;
基准利率
LOAN_BASE_RATE
NUMBER(16,9)
★
基准利率
利率浮动比例
INT_ADJ_PCT
NUMBER(16,9)
★
基准利率浮动比(浮动比)
利差
LOAN_SPRD
NUMBER(16,9)
★
基准利率浮动值(利差)
执行利率
LOAN_INT_RATE
NUMBER(16,9)
★
执行利率
罚息利率基础
OD_RATE_BASE
VARCHAR2
(1)
★
罚息利率计算基础
Y:
年利率
M:
月利率
D:
日利率
罚息利率类型
LOAN_OD_RATE_TYP
VARCHAR2(10)
☆
罚息基准利率代码
罚息基准利率
LOAN_OD_BASE_RATE
NUMBER(16,9)
☆
罚息基准利率值
罚息利率浮动比
OD_RATE_ADJ_PCT
NUMBER(16,9)
★
罚息基准利率浮动比
罚息执行利率
LOAN_OD_INT_RATE
NUMBER(16,9)
★
罚息执行利率
还款间隔单位
PAYM_FREQ_UNIT
VARCHAR2(10)
还款间隔单位
M:
月W:
周Q:
季Y:
年
还款间隔
PAYM_FREQ_FREQ
NUMBER(3)
★
还款间隔,数字,比如:
1,2,3,4,5…
还款方式
LOAN_PAYM_MTD
VARCHAR2(10)
★
还款方式,对应P_LOAN_MTD.MTD_CDE,该方式代码必须在还款方式配置表p_loan_mtd中已经配置,后台程序通过查询方式表构造每个借据的还款方式
还款方式类型
LOAN_PAYM_TYP
VARCHAR2(10)
★
还款方式类型:
00自由还款法(不确定还款日)
01等额本息
02本息不同间隔
03等额本金
04按期结息
05利随本清
06本金递增递减(本金递增如每期递增100第一期还100第二期200一次类推)
07弹性还款(分阶段)
08气球贷
对应还款方式中的P_LOAN_MTD.MTD_TYP
09其他
业务数据来源
BUSS_TYP
VARCHAR2(10)
★
业务数据来源
NLOAN普通贷款
DLOAN有贷款承诺的贷款
TLOAN:
委托贷款
宽限期类型
LOAN_GRACE_TYP
VARCHAR2(10)
★
宽限期类型
E:
逾期宽限期
P:
罚息宽限期
S:
滞纳金宽限期
宽限期天数
LOAN_OD_GRACE
NUMBER(3)
★
宽限期天数
扣款方式
LOAN_REPAY_MTHD
VARCHAR2(10)
★
扣款方式(是否自动扣款),可固定填:
AUTOPAY
AUTOPAY:
自动扣款
MANUAL:
手工主动还款
是否采用固定罚息利率
LOAN_FIX_OD_INT_IND
VARCHAR2
(1)
★
是否采用固定罚息利率
Y:
固定
N:
非固定
罚息利率种类
LOAN_OD_CAT
VARCHAR2(10)
★
罚息利率种类
L:
贷款执行利率
O:
其它利率
罚息利率浮动比
LOAN_OD_RATE_ADJ_PCT
NUMBER(16,9)
★
罚息利率浮动比例
计算罚息部分
LOAN_OD_COMM_PART
VARCHAR2(10)
★
计算罚息部分
A:
所有(计算罚息复利)
P:
本金(只计算罚息,无复利)
是否计算罚息复利
LOAN_