核算微服务消息队列
核算微服务消息队列
1. 概览
- 系统名称: 核算微服务
- 消息队列类型: Redis Stream
- 消息格式: JSON,
2. 消息消费入口
2.1 放款消息
消费者名称: 放款消息
消费的业务逻辑: 放款
消费的服务：ycloans-own-lend-service-s1、ycloans-own-lend-service-s2、ycloans-own-lend-service-s3、ycloans-own-lend-service-s9
消费的队列/主题: WF0003_1、WF0003_2、WF0003_3、WF0003_9
消费的消息类型: String（消息体在 Redis 缓存的 Key，通过 Key 在 Redis 缓存获取消息体）
消息体结构
LoanOwnDownInputDTO 字段表格
字段名 字段类型 是否必输 字段说明 genGlNo String 是 授权编号 inputDt String 是 申请日期 loanContNo String 是 贷款合同号 orgCde String 是 机构码 loanNo String 是 借据编号 custName String 是 客户名称 idType String 是 证件类型 idNo String 是 证件号码 issCtry String 否 发证国家 dealerCde String 否 经销商代码 loanCcy String 是 币种 origPrcp Double 是 申请金额 loanActvDt String 是 发放日期 fstPaymDt String 否 首次还款日 typGrp String 否 贷款组 loanTyp String 是 贷款品种 loanGlRoleCde String 否 贷款核算品种 lastDueDt String 否 最后到期日 intStartDt String 是 起息日 dueDay Integer 是 扣款日 loanRateMode String 是 利率模式 rateBase String 是 利率基础 loanRateTyp String 是 利率类型 loanBaseRate Double 是 基准利率 intAdjPct Double 是 利率浮动比例 loanSprd Double 是 利差 loanIntRate Double 是 执行利率 odRateBase String 是 罚息利率基础 loanOdRateTyp String 否 罚息利率类型 loanOdBaseRate Double 否 罚息基准利率 odIntRate BigDecimal 是 罚息执行利率 paymFreqUnit String 是 还款间隔单位 paymFreqFreq Integer 是 还款间隔 loanPaymMtd String 是 还款方式 loanPaymTyp String 是 还款方式类型 bussTyp String 是 业务数据来源 loanGraceTyp String 是 宽限期类型 prcpGrace Integer 是 本金宽限期天数 intGrace Integer 是 利息宽限期天数 loanRepayMthd String 是 扣款方式 fixOdIntInd String 是 是否采用固定罚息利率 loanOdCat String 是 罚息利率种类 loanOdRateAdjPct Double 是 罚息利率浮动比 odRateSprd Double 是 罚息利率浮动点差 odCommPart String 否 计算罚息部分 odCpdInd String 否 是否计算罚息 nextRepcOpt String 否 下一次利率调整选项 nextRepcNum Integer 否 下一次利率调整间隔 nextRepcUnit String 否 下一次利率调整间隔单位 diverAdjPct Double 否 挪用利率浮动比例 firstRepcDt String 否 第一次调整日 loanOdIntRate1 Double 是 逾期执行利率 loanOdRateAdjPct1 Double 是 逾期利率浮动比 prcpBuyInd String 是 是否资产买入 trustLoanNo String 否 委托协议 instmInd String 否 期供标志 fstPerdCalcOpt String 否 首期计算方式 instAdjOpt String 否 期供调整选项 typVer Double 否 贷款品种版本号 loanProm String 否 营销专案 tnr Integer 否 贷款期数 oldLoanNo String 否 借新还旧借据号 payTyp String 否 支付类型 sbsyInd String 否 贴息贷款标志 sbsyIntRate Double 否 贴息利率 dnChannelCde String 否 放款渠道 paymChannelCde String 否 还款渠道 paymInd String 否 是否延迟支付 intFreeDays Integer 否 利息折扣天数 discRate Double 否 利息折扣率 vatRate Double 否 增值税率 ddaPayTyp String 否 资金划转方式 deferPayDt String 否 延迟支付日期 loanHtedInd String 否 是否额度贷款 loanTypLine String 否 业务条线 grdMtdCde String 是 五级分类方法代码 cmisLoanContNo String 否 信贷合同号 advRevFeeInd String 否 是否收取提前还款手续费 advRevFeeMode String 否 提前还款手续计算模式 advRevFeeRate Double 否 提前还款手续计算比例 loopLoanInd String 是 是否循环贷 isUnLoan String 否 是否联合贷款 partnerCode String 否 合作方代码 trustPlanCode String 否 信托计划编号 passageWayCode String 否 支付通道方向代码 partnerLoanNo String 否 合作方借据编号 isStandardOfTrust String 否 信息是否以信托为准 trustPlanPerd String 否 信托计划期数 partnerDt String 否 合作方信息流日期 bankTransferSeq String 否 银行资金划拨流水 lmDnShdMtdTList List 否 还款方式策略信息 lmPmShdTList List 否 自由还款方式下还款计划 lmFeeTxTList List 否 一次性费用信息 lmHoldFeeTxTList List 否 分期收取费用信息 lmAcctInfoTList List 否 账户信息 synShdInd String 否 是否同步第三方还款计划 criditOdGrace String 否 征信宽限期 rtFeePct Double 否 消金收益率 channelCde String 否 渠道编号字段（用于宽限期调整） detlDt String 否 划扣日期 nextDetlDt String 否 下一划扣日 isTail String 否 是否算头算尾 syncInd String 否 是否同步还款计划 stampDutyPct String 否 印花税率 thirdNo String 否 第三方流水 amountFlag String 否 是否启用摊销模式的渠道返费 amountPct BigDecimal 否 摊销模式的渠道返费比例 amountTyp String 否 渠道返费的类型 amountOdDays String 否 借据不再摊销逾期天数 amountOdInd String 否 逾期是否返费 chlCde String 否 自营渠道编号 realtimePay String 否 实时支付 isNotSaveTemp String 否 是否保存临时表 applSeq String 是 申请书编号 applCde String 否 申请编号 cooprCde String 否 合作机构代码 cooprLvl String 否 合作机构级别 appOrigin String 是 进单渠道 salerName String 否 销售员姓名 lmtNo String 否 额度协议号 lmFlag String 否 是否自营业务 intBase String 是 计息方式 endDt String 否 协议到期日期 dnSeq String 否 放款流水号 applyDt String 否 放款申请日期 depositPct BigDecimal 否 保证金比例 ignorePay boolean 否 是否忽略支付服务开户 trialOrder String 否 是否是一个试单报文 batchDayCount Integer 否 提前批扣天数 isNewCus String 否 是否为新客户 irr BigDecimal 否 小鱼分润IRR rdpProductId String 否 小鱼产品ID uniteMark String 否 联合贷产品借据标识 custType String 否 客群类型 fundersList List 是 出资方信息 areaCde String 否 区域码 lendRatio BigDecimal 否 放款返费占比 payRatio BigDecimal 否 还款返费占比 isBatch String 否 转贷标识 LmDnShdMtdTDto 字段表格
字段名 字段类型 字段是否必输 字段说明 genGlNo String 是 授权编号 loanNo String 是 借据号 termNo short 是 阶段号 frmPerd int 是 从第几期 toPerd int 是 到第几期 prcpAmt Double 是 该阶段本金 paymFreqUnit String 是 还款间隔单位 paymFreqFreq long 是 还款间隔 loanIntRate Double 是 贷款执行利率值 termPrcpAmt Double 是 阶段本金额(拟还本金) calTotInstm int 是 实际计算期数 prcpPct Double 是 本金比例 intStartDt String 是 起息日 loanOdIntRate Double 是 罚息执行利率 paymTyp String 是 还款类型 paymOpt String 是 还款方式 intBase String 是 利息计算基础 pgsPrcpPct Double 否 等比递增还款增加额 pgsPrcpAmt Double 否 等额递增还款增加额 pgsPrcpFreq Integer 否 递增还款周期 payPrcpFreq short 是 本息不同间隔还本间隔 rateTyp String 是 利率代码 baseRate Double 是 基准利率 sprd Double 否 浮动利率 intAdjPct Double 否 浮动比例 intPerdType String 是 利息计算方式（按天还是按月） LmPmShdTDto 字段表格
字段名 字段类型 字段是否必输 字段说明 genGlNo String 是 授权编号 loanNo String 是 借据号 psPerdNo Integer 是 期号 psDueDt String 是 还款日期 psPrcpAmt Double 是 本金 psNormIntAmt Double 是 利息 intStartDt String 是 上一账单日日期 LmFeeTxTDto 字段表格
字段名 字段类型 是否必输 字段说明 genGlNo String 是 出账授权编号 loanNo String 是 借据号 feeCde String 是 费用代码 feeCcyCde String 是 费用币种 feeAmt BigDecimal 是 费用金额 recvPayInd String 是 收付标志 feeTyp String 是 费用类型 baseAmt BigDecimal 是 基准金额 chrgPct BigDecimal 否 费用比率 feeSetlDt String 否 结清日期 feeRmk String 否 备注 loanAcctTyp String 否 费用收取账户类型 feeAcctNo String 否 费用收取账号 feeCalcTyp String 否 费用计算方式 feeMinAmt BigDecimal 否 费用最小金额 feeMaxAmt BigDecimal 否 费用最大金额 accInd String 否 摊销标志 feeResource String 否 费用收取方 feeHoldId String 否 费用收取方代码 pyclTyp String 否 收取类型 paymInd String 否 是否已扣款 isVatFlag String 否 价税分离标志 ppFeeInd String 否 是否体现在还款计划 wvFeeAmt BigDecimal 否 费用减免金额 feeAccStrPredNo Short 否 费用摊销开始期号 feeAccSpan int 否 费用摊销期数 channelPct BigDecimal 否 返费比例 accAmtTyp String 否 费用入账金额类型 accDtInd String 否 摊销时间标示 beAccAmtTyp String 否 待摊销金额类型 calcAccInd String 否 是否按周期均摊 dueDay String 否 扣费日 feePctBase String 否 计算基础：01-贷款金额、02-剩余本金、03-还款本金、04-还款本息、05-欠款金额 feeSpan String 否 费用收取期数 feeStrPerdNo String 否 费用收取开始期号 feeTnrType String 否 费用收取类型 txLogSeq String 否 交易流水 holdFeeInd String 否 待收费标志 holdFeeSetlDt String 否 待收费结清日期 genGlInd String 否 授权状态 paymFreqFreq String 否 扣费频率,例如1，2，每2月扣一次款 paymFreqUnit String 否 费用收取频率单位 srcTxLogSeq String 否 源申请流水号 srcSeqNo String 否 源申请子序号 amountBackAmt String 否 宇信预提金额 LmHoldFeeTxTDto 字段表格
字段名 字段类型 是否必输 字段说明 genGlNo String 否 出账授权编号 loanNo String 是 借据号 feeCde String 是 费用代码 feeCcyCde String 是 费用币种 feeAmt BigDecimal 是 费用金额 recvPayInd String 是 收付标志 feeTyp String 是 费用类型 baseAmt BigDecimal 否 基准金额 chrgPct BigDecimal 否 费用比率 feeRmk String 否 备注 holdFeeSetlDt String 否 收费日期 feeSpan int 是 费用收取期数 feeCalcTyp String 是 费用计算方式 feeMinAmt BigDecimal 否 费用最小金额 feeMaxAmt BigDecimal 否 费用最大金额 feeStrPerdNo int 是 费用收取开始期号 feePctBase String 是 费用计算基础 calcAccInd String 是 是否按周期均摊 accInd String 是 摊销标志 loanAcctTyp String 是 费用收取账户类型 feeAcctNo String 否 费用收取账号 feeResource String 否 费用收取方 feeHoldId String 否 费用收取方代码 isVatFlag String 否 价税分离标志 toPerd int 是 费用收取结束期号 owedInd String 否 逾期费用标识 feePayTyp String 否 逾期费用类型 channelPct BigDecimal 否 渠道返费比例 beAccAmtTyp String 否 待摊销金额类型 LmAcctInfoTDto 字段表格
字段名 字段类型 是否必输 字段说明 genGlNo String 是 出账授权编号 loanNo String 是 借据号 acctUsg String 是 账户用途(PAYM:还款账号,ACTV:放款账号) acctNo String 是 账号 acctCcyCde String 是 账户币种 acctBankCde String 是 帐号银行代码 acctBchCde String 是 帐号机构代码 acctName String 是 户名 acctIssCtry String 是 发证国家 acctIdType String 否 证件类型 acctIdNo String 否 证件号码 acctRmk String 否 备注 acctCardNo String 否 卡号 acctNttInd String 否 钞汇标志 acctTyp String 否 账户类型 acctCde String 否 账户代码 acctLdgrCde String 否 账号科目代码 actvAmt Double 否 受托支付发放金额 acctAmt Double 否 账户余额 fundRatio Double 否 委托人分配比例 fundAmt Double 否 委托人出资金额 bankProv String 否 银行省份 bankCity String 否 银行城市 acctBchNam String 否 账号分支机构名称 isRlAcct String 否 账户 acctNoTyp String 否 账户类型 accountSelf String 否 是否本行放款 acctPriNo Integer 否 优先级别 acctBankNam String 否 银行名称 acctBankAdd String 否 银行地址 mobileNo String 是 客户手机号 FundersDto 字段表格
字段名 字段类型 是否必输 字段说明 loanNo String 是 借据号 fundLoanNo String 是 第三方借据号，对账使用（出资方标识为HBCFC时不传） fundRatio BigDecimal 是 出资比例 fundMark String 是 出资方标识，JMXCF（金美信），HBCFC（湖北消金）, LZBCF 兰州银行 isChie String 是 是否为主出资方，Y是主出资方，N不是主出资方
2.2 还款消息
消费者名称: 还款消息
消费的业务逻辑: 还款
消费的服务：ycloans-own-repay-service-s1、ycloans-own-repay-service-s2、ycloans-own-repay-service-s3、ycloans-own-repay-service-s9
消费的队列/主题: PaymMsgInQueueForNonSeqBatch1、PaymMsgInQueueForNonSeqBatch2、PaymMsgInQueueForNonSeqBatch3、PaymMsgInQueueForNonSeqBatch9
消费的消息类型: String（JSON）
消息体结构
PaymInMsgBody 类字段表格
字段名 数据类型 是否必输 字段说明 paymentInput LoanOwnPaymentInput 是 还款交易输入参数 paymMsgType String 是 还款交易消息类型：
0 - 主动还款消息
1 - 批量还款消息
99 - 试单还款消息responseQueueName String 是 由调用方指定的还款计算结果队列名 LoanOwnPaymentInput 字段表格
字段名 数据类型 是否必输 字段说明 isDeductUnkown String 否 是否扣款未明 genGlNo String 是 授权编号 loanContNo String 是 合同号 loanNo String 是 借据号 setlAmt BigDecimal 是 还款金额 setlFeeAmt BigDecimal 是 还费金额 paymDt String 是 还款日期 paymMode String 是 还款模式 paymInd String 否 是否扣款 paymPerdCnt String 否 缩期期数 bchCde String 是 业务机构 payNormInt BigDecimal 否 归还利息 payOdInt BigDecimal 否 归还罚息 payCommInt BigDecimal 否 归还复利 actvPayMode String 是 提前还款金额类型：P: 本金 A: 总额 ppRatBase String 是 提前还款利息选项OSP 剩余本金 PPP 提前还款的本金 NA 不归还利息 dpTyp String 否 置换类型 01:股权置换 02: 票据置换 03: 其它置换 loanTyp String 否 置换后贷款品种 paymPerdAmt String 否 缩短后期供金额 setlmTyp String 是 还款类型 01:客户账号还款 02:溢缴款账号还款 repayTyp String 否 还款类型 YY:预约还款 TQ:提前还款 isRtn String 否 是否退货 flag String 否 标识 isAdtFee String 否 是否红冲保费服务费 isRtnMode String 否 线上线下退货标识 version String 否 版本号 replaceInd String 否 是否代偿 continueRightInd String 否 代偿是否保留债权 isOwnCompSetl String 否 自营代偿是否结清 repayOrigin String 否 代偿渠道 remTyp String 否 代偿渠道类型 isSupIntr String 否 代偿借据不保留债权还款 isPartRt String 否 退货是否结记部分贴息 feeAmountRules String 否 提前还款是否摊销剩余未摊金额标识 thirdPaymInd String 否 是否参与入账查询 paymSrcMode String 否 还款来源模式 revsInd String 否 撤销标识 feeTransList List<LmFeeTxDto> 否 费用信息 LmAcctInfoTList List<LmAcctInfodto> 否 LmFeeTxTList List<LmFeeTxTdto> 否 LmSetlPmShdTList List<LmSetlPmShdT> 否 paymentSceneCatory PaymentSceneCatory 否 buzTypeCode BuzTypeCode 否 tPaymentInfo TPaymentInfo 否 postFlag String 否 还款后处理使用标记，0-原处理；1-改造版处理 isBatchPaym boolean 否 标识是否为批扣还款 isCompSetl String 否 是否代偿结清 thirdTxLogSeq String 否 第三方交易流水号 billNo String 否 老核算第三方交易流水号 paymSetlDt String 否 还款对账日期 marketType String 否 营销类型 marketAmt String 否 营销利息金额 ignoreGrace String 否 是否忽略宽限期 delayInd String 否 延期标识 channelNo String 否 扣款通道 rollFlag String 否 转贷标识 newLoanNo String 否 转贷新借据号 checkBillNo String 否 对账流水号 onlineFlag String 否 是否线上还款 setlSeq String 否 核心还款流水号，用于第三方渠道进行流水号对账 LmFeeTxDto 字段表格
字段名 数据类型 是否必输 字段说明 genGlNo String 是 出账授权编号 loanNo String 是 借据号 feeCde String 是 费用代码 feeCcyCde String 是 费用币种 feeAmt BigDecimal 是 费用金额 recvPayInd String 是 收付标志 feeTyp String 是 费用类型 baseAmt BigDecimal 是 基准金额 chrgPct BigDecimal 是 费用比率 txLogSeq long 是 交易流水号 feeSetlDt String 是 结清日期 feeRmk String 是 备注 holdFeeInd String 是 是否周期性收费 holdFeeSetlDt String 是 收费日期 genGlInd String 是 生成分录标志 paymFreqFreq int 是 费用收取频率 feeSpan int 是 费用收取期数 loanAcctTyp String 是 费用收取账户 dueDay int 是 扣费日 feeCalcTyp String 是 费用计算方式 paymFreqUnit String 是 费用收取频率单位 feeMinAmt BigDecimal 是 费用最小金额 feeMaxAmt BigDecimal 是 费用最大金额 feeStrPerdNo int 是 费用收取开始期号 feePctBase String 是 01-贷款金额 02-剩余本金 03-还款本金 04-还款本息 05-欠款金额 calcAccInd String 是 是否按周期均摊 accInd String 是 摊销标志 feeAcctNo String 是 费用收取账号 feeResource String 是 费用收取方：CUSTER: 客户收取，DEALER:商户收取 accAmtTyp String 是 费用入账金额类型 beAccAmtTyp String 是 待摊销金额类型 feeHoldId String 是 费用收取方代码,用于标识该笔费用是哪个商户或第三方来收取的 srcTxLogSeq long 是 源交易流水 srcSeqNo int 是 源交易流水序号 pyclTyp String 是 收取类型 paymInd String 是 是否扣款 isVatFlag String 是 价税分离标志 ppFeeInd String 是 是否体现在还款计划 wvFeeAmt BigDecimal 是 费用减免金额 lastChgUsr String 是 最后更新用户 lastChgDt String 是 最后更新日期 bankCde String 是 银行代码 owedInd String 是 是否为逾期费用 feePayTyp String 是 费用收取类型 toPerd int 是 截止期号。FEE_PAY_TYPE=02时使用 LmAcctInfodto字段表格：字段名 数据类型 是否必输 字段说明 genGlNo String 是 出账授权编号 loanNo String 是 借据号 loanAcct String 是 系统账户类型 acctNo String 是 账号 acctCcyCde String 是 账户币种 acctBchCde String 是 账户机构代码 acctBankCde String 是 账户银行代码 acctName String 是 户名 acctIssCtry String 是 发证国家 acctIdType String 是 证件类型 acctIdNo String 是 证件号码 acctRmk String 是 备注 acctCardNo String 是 卡号 acctNttInd String 是 钞汇标志 acctTyp String 是 账户类型 acctCde String 是 账户代码 acctLdgrCde String 是 账号科目代码 [LmFeeTxTDto 字段表格](#LmFeeTxTDto 字段表格)
LmSetlPmShdT 字段表格
字段名 数据类型 是否必输 字段说明 PerdNo short 是 期号 setlAmt BigDecimal 是 结算金额
3. 消息发送出口
- 生产者名称: ycloans-own-lend-service-s1、ycloans-own-lend-service-s2、ycloans-own-lend-service-s3、ycloans-own-lend-service-s9
- 发送的队列/主题: 对应的消息队列或主题名称。
- 发送的消息类型: 消息的类型或结构。
- 触发条件: 触发消息发送的条件或事件（如接口调用、定时任务）。
- 发送的业务逻辑: 简要描述消息生成和发送的业务逻辑。
- 异常处理: 描述消息发送过程中的异常处理机制（如重试机制、错误日志记录）。
- 依赖的外部服务: 列出消息发送过程中依赖的外部服务（如配置中心、数据库）。
4. 监控和报警
- 监控项: 描述针对消息队列的监控项（如队列长度、消息延迟）。
- 报警规则: 说明报警规则（如消费失败率、队列积压）。
- 日志记录: 记录消费和发送消息时的重要日志点。
5. 示例代码
- 消费代码示例: 给出关键的消息消费代码段。
- 发送代码示例: 给出关键的消息发送代码段。
6. 配置项
- 消息队列配置: 列出 Spring Boot 中与消息队列相关的配置项（如连接配置、线程池配置）。
- 其他配置: 列出其他重要的配置项（如重试策略配置、序列化配置）。
喜欢这篇的人也看了
Tony Xia
只有迎风，风筝才能飞得更高。