信贷管理与核算系统接口开发规范标准
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
信贷管理系统与核算系统
接口规范
Revision Record 修订记录
目录
1. 概述: (5)
1.1. 编写目的 (7)
1.2. 适用范围 (7)
2. 接口清单说明 (7)
3. 接口通讯报文规范 (7)
3.1. 交易码描述 (7)
32 报文规范 (9)
3.3. 请求报文结构 (9)
3.4. 响应报文结构 (10)
3.5. 渠道编号 (11)
3.6. 错误代码描述 (11)
3.7. 请求报文示例 (11)
3.8. 响应报文示例 (13)
4. 交易类接口说明 (13)
4.1. 贷款发放 (13)
4.2. 贷款展期 (22)
4.3. 贷款核销 (23)
4.4. 退货 (23)
4.5. 还款账号变更 (24)
4.6. 银承出账 (25)
4.7. 保函结清 (28)
4.8. 保函出账 (28)
4.9. 贴现出账 (30)
4.10. 抵质押品出入库 (33)
4.11. 单项减值确认和计提 (34)
4.12. 组合减值计提 (35)
4.13. 交易撤销 (35)
4.14. 资产卖出 (36)
4.15. 日终步骤 (38)
4.16. 主动还款试算 (39)
4.17. 主动还款 (40)
4.18. 还款计戈U调整 (43)
4.19. 贷款停息 (45)
4.20. 归还委托贷款利息 (46)
4.21. 保函付款 (48)
4.22. 授权交易处理 (49)
5. 查询类接口说明 (60)
5.1. 欠款查询 (60)
5.2. 记帐状态查询 (61)
5.3. 还款计划试算 (61)
5.4. 日终步骤状态查询 (67)
5.5. 贷款发放授权查询 (67)
5.6. 主动还款授权查询 (70)
6. 参数类接口说明 (83)
6.1. 核算规则 (83)
6.2. 费用类型 (85)
6.3. 还款方式 (86)
6.4. 还款顺序配置 (88)
6.5. 会计分录配置 (89)
6.6. 会计科目设置 (90)
7. 系统参数对照表 (94)
7.1. 币种对照表 (94)
7.2. 钞汇标志对照表 (94)
7.3. 证件类型对照表 (94)
7.4. 账户状态对照表 (95)
7.5. 贷款品种对照表 (95)
7.6. 利率模式 (95)
7.7. 利率代码(基准利率代码) (96)
7.8. 罚息利率类型(罚息基准利率代码) (96)
7.9. 还款间隔单位 (96)
7.10. 还款方式 (96)
7.11. 还款方式类型 (96)
7.12. 业务数据来源 (97)
7.13. 宽限期类型 (97)
7.14. 扣款方式 (97)
7.15. 罚息利率种类 (97)
7.16. 计算罚息部分 (98)
7.17. 下一次利率调整选项 (98)
7.18. 系统账户类型 (98)
7.19. 账户类型 (98)
7.20. 利息计算基础 (99)
7.21. 收付标志 (99)
7.22. 贴现种类 (99)
信贷管理系统与核算系统接口规范
1. 概述:
核算系统与信贷管理系统的接口,具有开放、灵活、方便的特点,核算系统考虑到与外围系统接口的多样性,而核算系统与管理系统有可能是统一部署,也有可能独立部署,核算系统在设计中考虑了上述两种情况,如果是统一部署则信贷管理系统可以采用共享表方式,只需要在调用核算接口处理前将数据插入到共享表中即可;如果是独立部署,则调用核算提供的WEB 服务调用即可,由于目前绝大部分项目都是统一部署,所以下面就统一方面进行说明。
由于核算系统的核算交易本身也是具有工作流支持,所以发放后核算交易的处理可以支持工作流的审批。
核算系统与信贷管理系统、核心系统接口架构如下图所示:
步骤如上所示:
1. 信贷管理系统完成业务操作的审批流程后,调用核算提供的接口,核算将数据放到
相关的授权表中。
2. 会计人员在信贷核算系统中发起记账交易的流程,流程
结束后,核算系统完成记账处理。
3. 核算系统调用核心记账。
4. 核算系统调用管理系统提供的更新台账接口,更新信贷管理系统台账信息。
1.1. 编写目的
本文档用于描述信贷管理系统(包括对公及对私)与核算系统之间的接口规范。
1.2. 适用范围
信贷管理系统与信贷核算系统之间接口开发及维护人员。
2. 接口清单说明
3. 接口通讯报文规范
3.1. 交易码描述
32报文规范
(HTTP渠道方式)
3.3. 请求报文结构
系统报文头:CMIS;servi0000000021;
5位:渠道编号(系统命名)
1位:分割‘;’
15 位:交易码(serviceld+funld)
1位:分割‘;’
报文体:
<?xml version="1.0" encoding="GB2312" ?>
<msgbody>
<Request_Name>Loan Drawdown</Request_Name>
<Loan_Info>-- 借据信息表
</Loan_Info>
<Loan_Acct_Info_List>-- 账号信息列表<Loan_Acct_Info>-- 账号信息表
</Loan_Acct_Info>
</Loan_Acct_Info_List>
<Loan_Paym_Mtd_List>-- 还款方式表,会有多条的情况
<Loan_Paym_Mtd>-- 还款方式表
</Loan_Paym_Mtd >
</Loan_Paym_Mtd_List>
<Loan_Fee_Info_List>-- 费用有可能存在多条的情况
<Loan_Fee_Info >
</Loan_Fee_Info >
</Loan_Fee_Info_List>
</msgbody>
报文例子如下所示:
kfs;servi0000000021;
<?xml version="1.0" encoding="GB2312" ?>
<msgbody>
<Request_Name>Contract_Detail</Request_Name>
<ID>110104************</ID>
<Contract_Num />
<Bue_Bill/>
</msgbody>
3.4. 响应报文结构
报文体:
kfs;servi0000000021;
<?xml version="1.0" encoding="GB2312" ?>
<msgall>
<errorCode> <errorCode/>
<errorMsg> </errorMsg/>
<msgbody>
</msgbody>
</msgall>
报文例子如下所示:
kfs;servi0000000021;
<?xml version="1.0" encoding="GB2312" ?>
<errorCode> 1000000023<errorCode/>
<errorMsg>没有找到对应的服务信息</errorMsg/>
<msgbody>
<Name> Loa n Drawdow n </n ame>
</msgbody>
</msgall>
3.5. 渠道编号
3.6. 错误代码描述
3.7. 请求报文示例
CMIS;servi0000000021;
<?xml version="1.0" encoding="GB2312" ?>
<msgbody>
<Request_Name>Loa n Drawdow n</Request_Name>
<Loan」nfo>--借据信息表<gen_gl_ no>10021 </gen_gl_no> <appl_seq>102389
</appl_seq> <i nput_dt>2011-03-09 </in put_dt> <lend_office>user1</lend_office>
<cont_no>C10009 </cont_no> <bch_cde>101</bch_cde> <loan_no>102120090
</loan_no> <bank_cde> 1000 </bank_cde> <cust_id> 1021 </cust_id>
<cust_name>ABCD </cust_name> <id_type> 01 </id_type> <id_no>
522337190899813 </id_no> <iss_ctry>CNY </iss_ctry> <dealer_cde>
D1009</dealer_cde> <loan_ccy> CCY </loan_ccy> <orig_prcp> 10000 </orig_prcp>
<loan_actv_dt>2011-03-09 </loan_actv_dt> <loan_typ> 1024</loan_typ>
<last_due_dt> 2019-09-08 </last_due_dt> <int_start_dt> 2011-03-09 </int_start_dt>
<due_day> 21 </due_day> <loan_rate_mode> FX </loan_rate_mode> <rate_base>D
</rate_base> <loan_rate_typ>R02 </loan_rate_typ> <loan_base_rate>0.0783
</loan_base_rate> <int_adj_pct> 0.2</int_adj_pct> <loan_sprd> 0.1 </loan_sprd>
<loan_od_rate_typ>R02 </loan_od_rate_typ> <loan_od_base_rate> 0.076
</loan_od_base_rate> <loan_od_sprd> 0.1 </loan_od_sprd> <loan_od_int_rate>0.6
</loan_od_int_rate> <paym_freq_unit> M </paym_freq_unit> <paym_freq_freq> 1
</paym_freq_freq> <loan_paym_mtd> M01 </loan_paym_mtd> <loan_paym_typ> 01
</loan_paym_typ>
<buss_typ>LOAN </buss_typ>
<loan_grace_typ> </loan_grace_typ> <loan_od_grace> </loan_od_grace>
<loan_repay_mthd> </loan_repay_mthd> <loan_fix_od_int_ind> N
</loan_fix_od_int_ind> <loan_od_cat> </loan_od_cat> <loan_od_rate_adj_pct>
</loan_od_rate_adj_pct> <loan_od_comm_part> A</loan_od_comm_part>
<loan_od_cpd_ind> Y </loan_od_cpd_ind> <next_repc_opt> NYF</next_repc_opt>
<next_repc_num></next_repc_num>
<next_repc_unit> </next_repc_unit> <loan_diver_adj_pct>0.2 </loan_diver_adj_pct>
</Loan_Info>
<Loan_Acct_Info_List>-- 账号信息表
<Loan_Acct_Info>-- 账号信息表
</Loan_Acct_Info>
</Loan_Acct_Info_List>
<Loan_Paym_Mtd_List>-- 还款方式表
<Loan_Paym_Mtd>-- 还款方式表
</Loan_Paym_Mtd >
</Loan_Paym_Mtd_List>
<Loan_Fee_Info_List >
<Loan_Fee_Info > </Loan_Fee_Info >
</Loan_Fee_Info_List>
</msgbody>
3.8. 响应报文示例
kfs;servi0000000021;
<?xml version="1.0" encoding="GB2312" ?> <msgall>
<errorCode> 1000000023<errorCode/>
<errorMsg> 没有找到对应的服务信息</errorMsg/>
<msgbody>
<Name> Loan Drawdown </name>
</msgbody>
</msgall>
4. 交易类接口说明4.1. 贷款发放
可以用于资产买入。
注意:对于委托账户,需要3条账户信息。
需要提供委托人账户信息。
服务名:serv10000000022
应用场景:本交易接口用于当信贷管理系统已经完成审批流程后,信贷管理系统将相关核算信息通过该交易发送到信贷核算系统,包据借据信息、账号信息、费用等信息。
请求报文:
LM_LOAN_T g理与核算接口数据表):51
还款方式策略信息LmD nShdMtdTList (该部分数据可以不填写,但要保证报文存在,如
LM_PM_SHD_买入或者自由还款方式)对应于核算的lm_PM_shd_tmp 当前日期以前的还款计划
有多条记录
备注:只有在有费用的情况下,才需要传这部分信息。
LM ACCT INFO T账号信息表)
有多条记录
42贷款展期
服务名:serv10000000023
应用场景:本交易接口根据传入的展期相关信息进行还款计划的变更调整,系统根据传入参数实时进行调整。
请求报文:
43贷款核销
服务名:serv10000000023
应用场景:当信贷管理系统或者核心系统在前端操作界面发起交易请求后,核算系统根
据核销相关信息完成后续的账务处理。
请求报文:
4.4. 消费信贷退货
服务名:serv10000100028
应用场景:本交易接口主要运用于消费信贷系统,当消费者触发退货交易后,将相关退货请求发送到核算系统后,核算系统根据退货信息完成记账处理。
请求报文:
4.5. 还款账号变更
服务名:servl
应用场景:当借款人发起变更账号时,调用该接口变更还款账号。
请求报文:
46银承出账
服务名:serv10000000025
应用场景:银承业务在信贷管理系统完成审批流程后通过调用该交易接口将相关信息发送到信贷核算系统,信贷核算系统完成后续相关的处理。
请求报文:
LM ACCP T银承授权接口表)30
LM GUTR AMT LOG保证金授权登记簿)
LM FEE TX T费用授权信息表)
备注:只有在有费用的情况下,才需要传这部分信息。
4.7. 保函结清
服务名:serv10000000037
应用场景:当信贷管理系统或核心系统完成保函结清申请后,通过调用该交易接口将交易信息发送到核算系统。
请求报文:
4.8. 保函出账
服务名:serv10000000026
应用场景:信贷管理系统完成保函的审批流程后调用该接口将保函开立的相关信息发送到信贷核算系统,核算系统完成后续的账务处理。
请求报文:
LM GUTR LETER保函授权接口表)24
LM_GUTR_AMT_LOG保证金授权登记簿)
LM_FEE_TX_T费用授权信息表)
4.9. 贴现出账
服务名:serv10000000027
应用场景:贴现业务在信贷管理系统完成业务审批流程后通过调用该交易接口将贴现相关信息发送到信贷核算系统。
请求报文:
LM_DISC_HDR_T
贴现批量发放主信息
LM_DISC_TList(贴现授权接口表)31 多条记录
LM_ACCT_INFO_T账号信息表)
LM_FEE_TX_T费用授权信息表)
4.10. 抵质押品出入库
服务名:serv10000000028
应用场景:本交易接口用于当信贷管理系统完成抵质押品的出入库操作后,最后调用该
交易完成抵押品的出入库记账处理。
请求报文:
LM_COLL_INOUT_T抵质押品出入库授权)
单条记录
4.11. 单项减值确认和计提
服务名:serv10000100032
应用场景:本交易接口用于当信贷管理系统完成单项减值模型的确认操作后,最后调用该交易完成单项减值的记账处理。
请求报文:
4.12. 组合减值计提
服务名:serv10000100033
应用场景:本交易接口用于当信贷管理系统完成组合减值模型的确认操作后,最后调用该交易完成组合减值的记账处理。
请求报文:
4.13. 交易撤销
服务名:serv10000000031
应用场景:本交易接口用于当信贷管理系统由于某些原则需要撤销交易或者冲正交易时
调用该接口,撤销仅支持在lm_tdcl_cfg中配置了相关表的处理逻辑的交易请求报文:
返回报文:
4.14. 资产卖出/收回
服务名:serv10000100036
(待完成)
请求报文:
4.1
5. 日终步骤处理
服务名:serv10000100039
生成日终步骤。
需要调用方法:
检查DE_ERROR_LOG有没有错误数据
I.ServiceC ontain er.getBatchService().ge nN ightBatchStep(c onn) ___
2. R _______
3. ______
日终调用时需要先调用先传入OP_ID为“ GEN_STEP ”生成日终步骤,然后再传入“RUN_BEFORE ”及“ RUN_AFTER ”完成日终步骤。
请求报文:
返回报文:
4.16. 主动还款试算服务名:serv10000100040 请求报文:
返回报文:
4.17. 主动还款/资产置换服务名:serv10000100041
请求报文:
备注:只有在有费用的情况下,才需要传这部分信息。
返回报文:
4.18. 还款计划调整
服务名:serv10000100029
应用场景:本交易接口根据传入的调整类型进行还款计划的变更调整,调整类型包括: 扣款日变更、贷款利率变更、期数变更三种方式。
请求报文:
返回报文:
4.19. 贷款停息
服务名:serv10000100042
停止贷款相关操作,包括停止计罚息、自动扣款或者取消相应功能请求报文:
返回报文:
4.20. 利息减免
服务名:serv10000000038
对应内部交易码:LR02 适用于减免借款人的利息请求报文:lm_wv_int_t):
明细信息
lm_wv_int_dtl_t)
返回报文:
4.21. 归还委托贷款利息
服务名:serv10000100046
请求报文:
返回报文:
4.22. 保函付款
服务名:serv10000100047 调用:ImGutrLeterPay
请求报文:
返回报文:
4.23. 授权交易处理
适用场景:当相关交易被管理系统发送到核算系统后,但核算系统并未做真正的记账处理, 所以调用该接口完成记账处理。
服务名:serv10000000099
该接口实际调用如下方法:
public Gen GITra ns executeTra ns(Stri ng gen GINo, Connection conn.
Con text con text, OperaUserl nf userl nf)
请求报文:
返回报文:
4.24. 贷款平移
适用场景:当银行机构发生合并时,需要将撤销行的业务所属行变更到新的机构,该步骤仅
放到授权表中,然后可以通过调用授权交易处理完成会计分录的记账处理。
后台调用方法:Imloa nbuz().
public void loa nTra nslati on Acco un ts( On li neParam on li neParam,
ListvStri ng> loa nN oList)
服务名:serv10000000040
请求报文:
返回报文:
4.2
5. 贷款承诺签发
LM_LOAN_CMMT_T贷款承诺接口表)30。