《信贷管理与核算系统接口开发规范.docx》由会员分享，可在线阅读，更多相关《信贷管理与核算系统接口开发规范.docx（100页珍藏版）》请在三一办公上搜索。
1、04. 12信贷管理系统与核算系统接口规范信贷管理系统与核算系统接口规范Revision Record 修订记录Date日期Revision Version修订版本Sec No. 修改章节Change Description修改描述Author作者2014-08-071.34贷款发放的接口增加贴息的接收内容张德富2014-08-081.34需要增加费用配置的同步接口2014-08-261.34贷款发放接口有四个字段代码值修改名称伞萍萍2014-08-271.34还款计划试算接口增加输入报文、返回报文伞萍萍2014-09-011.34增加还款账号变更及退货接口张德富2015-01-051.34撤
2、销接口中增加“撤销类型”，支持金融公司中的资金撤销情况张德富目 录1.概述：51.1.编写目的71.2.适用范围72.接口清单说明73.接口通讯报文规范73.1.交易码描述73.2.报文规范83.3.请求报文结构93.4.响应报文结构103.5.渠道编号103.6.错误代码描述103.7.请求报文示例113.8.响应报文示例124.交易类接口说明134.1.贷款发放134.2.贷款展期204.3.贷款核销214.4.退货224.5.还款账号变更234.6.银承出账244.7.保函结清264.8.保函出账264.9.贴现出账294.10.抵质押品出入库324.11.单项减值确认和计提334.12
3、.组合减值计提334.13.交易撤销344.14.资产卖出354.15.日终步骤364.16.主动还款试算364.17.主动还款384.18.还款计划调整414.19.贷款停息424.20.归还委托贷款利息434.21.保函付款444.22.授权交易处理455.查询类接口说明465.1.欠款查询465.2.记帐状态查询465.3.还款计划试算475.4.日终步骤状态查询495.5.贷款发放授权查询505.6.主动还款授权查询526.参数类接口说明546.1.核算规则546.2.费用类型576.3.还款方式586.4.还款顺序配置596.5.会计分录配置606.6.会计科目设置617.系统参数对
4、照表627.1.币种对照表627.2.钞汇标志对照表637.3.证件类型对照表637.4.账户状态对照表637.5.贷款品种对照表647.6.利率模式647.7.利率代码（基准利率代码）647.8.罚息利率类型(罚息基准利率代码)647.9.还款间隔单位657.10.还款方式657.11.还款方式类型657.12.业务数据来源657.13.宽限期类型667.14.扣款方式667.15.罚息利率种类667.16.计算罚息部分667.17.下一次利率调整选项667.18.系统账户类型677.19.账户类型677.20.利息计算基础677.21.收付标志677.22.贴现种类68信贷管理系统与核算系
5、统接口规范1. 概述：核算系统与信贷管理系统的接口，具有开放、灵活、方便的特点，核算系统考虑到与外围系统接口的多样性，而核算系统与管理系统有可能是统一部署，也有可能独立部署，核算系统在设计中考虑了上述两种情况，如果是统一部署则信贷管理系统可以采用共享表方式，只需要在调用核算接口处理前将数据插入到共享表中即可；如果是独立部署，则调用核算提供的WEB服务调用即可，由于目前绝大部分项目都是统一部署，所以下面就统一方面进行说明。由于核算系统的核算交易本身也是具有工作流支持，所以发放后核算交易的处理可以支持工作流的审批。核算系统与信贷管理系统、核心系统接口架构如下图所示：步骤如上所示：1. 信贷管理系统
6、完成业务操作的审批流程后，调用核算提供的接口，核算将数据放到相关的授权表中。2. 会计人员在信贷核算系统中发起记账交易的流程，流程结束后，核算系统完成记账处理。3. 核算系统调用核心记账。4. 核算系统调用管理系统提供的更新台账接口，更新信贷管理系统台账信息。1.1. 编写目的本文档用于描述信贷管理系统（包括对公及对私）与核算系统之间的接口规范。1.2. 适用范围信贷管理系统与信贷核算系统之间接口开发及维护人员。2. 接口清单说明报文编号报文名称方向处理模式01贷款发放授权通知管理=核算手工触发02贷款核销授权通知管理=核算手工触发03贷款展期授权通知管理=核算批处理触发04银承汇票出票授权通
7、知管理=核算手工触发05保函开立授权通知管理=核算手工触发06保函核销授权通知管理=核算手工触发07贴现发放授权通知管理=核算手工触发3. 接口通讯报文规范3.1. 交易码描述serviceIdfunId说明状态serv10000000022贷款发放出账serv10000000023贷款展期serv10000000024贷款核销serv10000000025银承出账serv10000000026保函出账serv10000000027贴现出账serv10000000028抵质押品出入库serv10000000029还款方式查询serv10000000030记账状态查询serv1000000003
8、1交易撤销serv10000100028消费信贷退货serv10000100029还款计划调整serv10000100030还款账户变更serv10000100032单项减值确认与计提serv10000100033组合减值确认serv10000100035单项减值确认serv10000000036资产卖出/收回serv10000000037保函结清serv10000000038利息减免serv10000000039日终步骤处理serv10000000040贷款平移serv10000000041费用收取serv10000000099授权交易处理serv10000100040主动还款试算serv1
9、0000100041主动还款serv10000100042贷款停息serv10000000043欠款查询serv10000000044日终状态查询serv10000000045贷款发放授权查询serv10000000046主动还款授权查询serv10000000053贷款承诺签发serv10000000054收费交易serv10000000055银行承兑汇票生成垫款交易serv10000000056贷款产品变更serv10000000057资产证券化卖出/赎回serv10000100046归还委托贷款利息serv10000100043欠款查询serv10000100027还款计划试算serv1
10、0000100028还款计划查询serv10000100047保函付款serv10000100048授权交易处理serv10000100049可撤销/冲正交易查询serv10000100050帐务交易流水查询serv10000100051还款计划调整试算serv10000100052客户还款记录查询serv10000100053贷款信息查询serv10000100054费用记录查询serv10000100055押品出入库记录serv10000100056还款计划查询serv10000100057可买回贷款查询serv10000000153贷款承诺签发授权查询serv1P0000100001核算
11、规则参数同步serv1P0000100002费用类型参数同步serv1P0000100003还款方式参数同步serv1P0000100004还款顺序参数同步serv1P0000100005会计分录参数同步serv1P0000100006会计科目设置参数同步serv1P0000100007会计科目设置参数同步serv1P0000100008系统参数加载serv1P0000100009分支机构信息同步serv1P0000100010金融机构信息同步（交易码将会随接口文档而变化）3.2. 报文规范（HTTP渠道方式）3.3. 请求报文结构系统报文头：CMIS;servi0000000021;5位：渠
12、道编号（系统命名）1位：分割;15位：交易码（serviceId+funId）1位：分割;报文体： Loan Drawdown -借据信息表-账号信息列表-账号信息表-还款方式表，会有多条的情况 -还款方式表 . -费用有可能存在多条的情况.报文例子如下所示：kfs;servi0000000021; Contract_Detail 110104196310041662 3.4. 响应报文结构报文体：kfs;servi0000000021; 报文例子如下所示：kfs;servi0000000021; 1000000023 没有找到对应的服务信息 Loan Drawdown 3.5. 渠道编号渠道
13、编号（系统命名）说明CMIS信贷管理系统3.6. 错误代码描述errorCodeerrorMsg00000调用成功返回10001调用没有注册的服务10002调用服务所对应的渠道不正确20001调用服务所对应的渠道报文保存异常90000调用服务所对应的其它3.7. 请求报文示例CMIS;servi0000000021; Loan Drawdown -借据信息表10021 102389 2011-03-09 user1 C10009 101 102120090 1000 1021 ABCD 01 522337190899813 CNY D1009 CCY 10000 2011-03-09 1024
14、 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; 1000000023 没有找到对应的服务信息 Loan Drawdown 4. 交易类接口说明4.1. 贷款发放可以用于资产买入。注意：对于委托账户，需要3条账户信息。需要提供委托人账户信息。服务名：serv10000000022应用场景：本交易接口用于当信贷管理系统已
15、经完成审批流程后，信贷管理系统将相关核算信息通过该交易发送到信贷核算系统，包据借据信息、账号信息、费用等信息。请求报文：LM_LOAN_T(管理与核算接口数据表)：51单条记录名称代码数据类型必填注释授权编号GEN_GL_NOVARCHAR2(30)出账授权编号申请书编号APPL_SEQNUMBER(20)申请日期INPUT_DTVARCHAR2(10)业务申请日期合同编号LOAN_CONT_NOVARCHAR2(30)贷款合同号机构码BCH_CDEVARCHAR2(10)出账机构，分支机构代码借据号LOAN_NOVARCHAR2(30)借据号银行代码BANK_CDEVARCHAR2(10)银
16、行代码客户编号CUST_IDVARCHAR2(30)客户编号客户名称CUST_NAMEVARCHAR2(200)借款人姓名证件类型ID_TYPEVARCHAR2(10)借款人证件类型证件号码ID_NOVARCHAR2(40)借款人证件号发证国家ISS_CTRYVARCHAR2(10)默认填:CN经销商代码DEALER_CDEVARCHAR2(20)经销商代码：不填币种LOAN_CCYVARCHAR2(10)币种申请金额ORIG_PRCPNUMBER(16,2)发放金额发放日期LOAN_ACTV_DTVARCHAR2(10)放款日期贷款组TYP_GRPVARCHAR2(10)贷款分组，比如汽车类
17、品种是一组、住房类是一组新增字段贷款品种LOAN_TYPVARCHAR2(10)贷款品种代码，核算品种与信贷品种对应关系：p_loan_typ_gl_map贷款核算品种LOAN_GL_ROLE_CDEVARCHAR2(10)新增最后到期日LAST_DUE_DTVARCHAR2(10)合同到期日起息日INT_START_DTVARCHAR2(10)起息日扣款日DUE_DAYNUMBER(2)指定还款日期（每月N日），建议扣款日=28利率模式LOAN_RATE_MODEVARCHAR2(2)利率模式FX: 固定利率RV: 浮动利率利率基础RATE_BASEVARCHAR2(1)利率计算基础Y: 年
18、利率M: 月利率 D: 日利率利率类型LOAN_RATE_TYPVARCHAR2(10)利率代码（基准利率代码）select rate_typ from s_int_rat;基准利率LOAN_BASE_RATENUMBER(16,9)基准利率利率浮动比例INT_ADJ_PCTNUMBER(16,9)基准利率浮动比（浮动比）利差LOAN_SPRDNUMBER(16,9)基准利率浮动值（利差）执行利率LOAN_INT_RATENUMBER(16,9)执行利率罚息利率基础OD_RATE_BASEVARCHAR2(1)罚息利率计算基础Y: 年利率M: 月利率 D: 日利率罚息利率类型LOAN_OD_R
19、ATE_TYPVARCHAR2(10)罚息基准利率代码罚息基准利率LOAN_OD_BASE_RATENUMBER(16,9)罚息基准利率值罚息利率浮动比OD_RATE_ADJ_PCTNUMBER(16,9)罚息基准利率浮动比 删除罚息执行利率LOAN_OD_INT_RATENUMBER(16,9)罚息执行利率还款间隔单位PAYM_FREQ_UNITVARCHAR2(10)还款间隔单位M: 月 W:周 Q: 季 Y:年还款间隔PAYM_FREQ_FREQNUMBER(3)还款间隔，数字，比如：1,2,3,4,5还款方式LOAN_PAYM_MTDVARCHAR2(10)还款方式，对应P_LOAN_
20、MTD. MTD_CDE，该方式代码必须在还款方式配置表p_loan_mtd中已经配置，后台程序通过查询方式表构造每个借据的还款方式还款方式类型LOAN_PAYM_TYPVARCHAR2(10)还款方式类型：00 自由还款法（不确定还款日）01等额本息02 本息不同间隔增加03等额本金04按期结息05 利随本清06本金递增递减（本金递增如每期递增100第一期还100第二期200一次类推）07弹性还款（分阶段）08气球贷对应还款方式中的P_LOAN_MTD.MTD_TYP09 其他新增业务数据来源BUSS_TYPVARCHAR2(10)业务数据来源NLOAN普通贷款DLOAN有贷款承诺的贷款TL
21、OAN:委托贷款宽限期类型LOAN_GRACE_TYPVARCHAR2(10)宽限期类型E: 逾期宽限期P: 罚息宽限期S: 滞纳金宽限期宽限期天数LOAN_OD_GRACENUMBER(3)宽限期天数扣款方式LOAN_REPAY_MTHDVARCHAR2(10)扣款方式（是否自动扣款），可固定填：AUTOPAYAUTOPAY: 自动扣款MANUAL: 手工主动还款是否采用固定罚息利率LOAN_FIX_OD_INT_INDVARCHAR2(1)是否采用固定罚息利率Y:固定N:非固定罚息利率种类LOAN_OD_CATVARCHAR2(10)罚息利率种类L: 贷款执行利率O: 其它利率罚息利率浮动
22、比LOAN_OD_RATE_ADJ_PCTNUMBER(16,9)罚息利率浮动比例计算罚息部分LOAN_OD_COMM_PARTVARCHAR2(10)计算罚息部分A: 所有（计算罚息复利）P: 本金（只计算罚息，无复利）是否计算罚息复利LOAN_OD_CPD_INDVARCHAR2(1)是否计算罚息复利Y:是N:否下一次利率调整选项NEXT_REPC_OPTVARCHAR2(10)下一次利率调整选项DDA: 满一年调整NYF: 每年1月1日调整NNR: 还款周期FIX: 固定日调整IMM: 立即调整下一次利率调整间隔NEXT_REPC_NUMNUMBER(2)下一次利率调整间隔下一次利率调整
23、间隔单位NEXT_REPC_UNITVARCHAR2(10)下一次利率调整间隔单位M: 月 W:周 Q: 季 Y:年挪用利率浮动比例DIVER_ADJ_PCTNUMBER(16,9)挪用利率浮动比例第一次调整日FIRST_REPC_DTVarchar(10)填发放日期逾期执行利率LOAN_OD_INT_RATE1NUMBER(16,9)常用于某些银行的对公按期还息贷款，逾期后使用该利率逾期利率浮动比LOAN_OD_RATE_ADJ_PCT1NUMBER(16,9)添加注释常用于某些银行的对公按期还息贷款，逾期后使用该利率是否资产买入PRCP_BUY_INDVARCHAR(1)Y 资产买入N 普
24、通放款委托协议TRUST_LOAN_NOVARCHAR(30)期供标志INSTM_INDVARCHAR(1)一般等额本金、等额本息填Y否则填N操作用户APP_USER_IDVARCHAR(30)用户名称APP_USER_NAMEVARCHAR(30)用户机构APP_USER_ORG_NOVARCHAR(10)贷款品种版本号TYP_VERNUMBER(20)新增营销专案LOAN_PROMVARCHAR2(10)新增贷款月数TNRNUMBER(3)贷款月数及最后到期日二者选一，如果传入贷款月数系统则根据贷款月数计算最后到期日，如果传入最后到期日则系统根据最后到期日计算期数。还款方式策略信息 LmD
25、nShdMtdTList （该部分数据可以不填写，但要保证报文存在，如果不填写，则根据还款方式LOAN_PAYM_MTD计算）名称代码数据类型必填注释阶段号TERM_NONUMBER(3)从第几期FRM_PERDNUMBER(3)到第几期TO_PERDNUMBER(3)该阶段本金PRCP_AMTNUMBER(16,2)还款间隔单位PAYM_FREQ_UNITVARCHAR2(10)M: 月 W:周 Q: 季 Y:年还款间隔PAYM_FREQ_FREQNUMBER(3)贷款执行利率值LOAN_INT_RATENUMBER(16,9)阶段本金额(拟还本金)TERM_PRCP_AMTNUMBER(1
26、6,5)等比递增还款增加额PGS_PRCP_PCTNUMBER(16,5)等额递增还款增加额PGS_PRCP_AMTNUMBER(16,5)递增还款周期PGS_PRCP_FREQNUMBER(3)多少期后考虑递增或递减实际计算期数CAL_TOT_INSTMNUMBER(3)气球贷计算月供期数本金比例PRCP_PCTNUMBER(16,9)计算类型RAT_BASEVARCHAR2(10)M: 按整月计息 D: 按实际天数计息起息日INT_START_DTVARCHAR2(10)罚息执行利率LOAN_OD_INT_RATENUMBER(16,9)还款类型PAYM_TYPVARCHAR2(1)当前阶
27、段内利息计算方式:T:等额本息P:等额本金还款方式PAYM_OPTVARCHAR2(3)IO: 仅利息IP: 本金和利息NO: 不还LM_PM_SHD_T(买入或者自由还款方式)对应于核算的lm_PM_shd_tmp当前日期以前的还款计划有多条记录名称代码数据类型必输注释期号PS_PERD_NONUMBER(4,0)期号还款日期PS_DUE_DTVARCHAR2(10)借据号本金PS_PRCP_AMTNUMBER(16,2)利息PS_NORM_INT_AMTNUMBER(16,2)代码值由PS_NORM_INT改为PS_NORM_INT_AMT费用授权信息LmFeeTxTList(有可能有多条
28、记录)名称代码数据类型必输注释费用代码FEE_CDEVARCHAR(10)999表示贴息费用币种FEE_CCY_CDEVARCHAR(10)币种费用金额FEE_AMTNUMBER(16,2)收付标志RECV_PAY_INDVARCHAR(10)R: 收P: 付费用类型FEE_TYPVARCHAR(10)费用类型,来自于P_FEE_TYP 表，必须存在如下费用：01:账户管理费02：滞纳金03：违约金04：提现费05：年费06：分期收取费99：其它费用计算方式FEE_CALC_TYPVARCHAR(10)PCT：按比例计算AMT 按固定金额新增加计算基础FEE_PCT_BASEVARCHAR(1
29、0)01-贷款金额02-剩余本金03-还款本金04-还款本息05-欠款金额费用最小金额FEE_MIN_AMTNUMBER(15,2)费用最大金额FEE_MAX_AMTNUMBER(15,2)基准金额BASE_AMTNUMBER(15,2)基准金额，如果没有传入，则根据计算基础及费用计算方式计算费用金额费用比率CHRG_PCTNUMBER(16,5)费率扣款账户LOAN_ACCT_TYPVARCHAR(10)系统账户类型：PAYM: 还款账户PAYM1: 还款账户1PAYM2: 还款账户2PAYM3: 还款账户3PAYMP: 还本账户，仅用于业务类型为SLOAN的贷款ACTV: 放款账号TURE
30、: 委托账号FEE:收费账户FEE1:收费账户FEE2:收费账户FEE3:收费账户EACT: 最后付款帐号EACT1: 最后付款帐号1EACT2: 最后付款帐号EACT3: 最后付款帐号3GUTR，GUTR1，GUTR2保证金账号备注，对于受托支付，放款账户填存款人帐号，实际付款帐号填EACT是否周期性收费HOLD_FEE_INDVARCHAR(10)是否周期性收费Y 周期性费用N 直接收取费用收取频率单位PAYM_FREQ_UNITVARCHAR(10)适用于按周期收取方式，传入：M新增加费用收取频率PAYM_FREQ_FREQNUMBER适用于按周期收取方式，传入： 1、2、3、4新增加代码值由PAYM_FREQ改为PAYM_FREQ_FREQ费用收取期数FEE_SPANN
