外部借款核销
业务场景说明
当使用借款核销套件时,需要使用该功能。在进行借款核销时,调用您在自定义表单中,配置的借款核销组件的接口,来获取可核销的借款单列表。在获得到借款单列表后,用户可以在进行提单时,选择需要核销的单据。核销的金额,支持让用户自己进行填写。核销信息提交流程可以查看文档webhook节点推送说明。
单据提交流程
开启借款核对后查看表单详情流程
获取可核销借款信息接口说明
请求方式
POST
请求参数说明
{
"formType":"xxxxxx", // 每刻单据标示 REIMBURSE表示报销单, PRECONSUME表示申请单,LITE为轻表单
"formData":{xxxxx} //具体参数可以查看末尾的每刻推送的formData字段格式
}
响应参数说明
响应参数示例
{
"success": true, // 标记请求是否成功返回 false表示请求失败(即使触发校验也应该是成功返回,异常返回是指触发某些不受检异常)
"errorMsg": "", // 当success为false的时候需要返回错误信息,当success为false时,会将该部分的信息弹出提示给用户
"data": {
"loanDeductionList": [{
"owedAmount": 800.00,
"title": "借款单1000元,已核销200元",
"repaymentAt": 1546272000000,
"loanCode": "CODE001001",
"loanAmount": 1000.00,
"loanCcy": "CNY",
"description": ["借款单备注:因为XX原因借款","借款单位:每刻科技公司"]
},{
"owedAmount": 1000.00,
"title": "借款单1000元",
"repaymentAt": 1546272000000,
"loanCode": "CODE002002",
"loanAmount": 1000.00,
"loanCcy": "CNY",
"description": ["借款单备注:因为XX原因借款","借款单位:每刻科技公司"]
}]
}
}
响应参数说明
参数名称 | 参数说明 | 是否可以为空 |
---|---|---|
owedAmount | 剩余未核销金额 | 不能为空 |
title | 借款单的标题 | 不能为空 |
repaymentAt | 预计还款时间 | 不能为空 |
loanCode | 借款code,可以与借款单code相同。但是必须唯一 | 不能为空 |
loanAmount | 借款单最初的借款金额 | 可以为空 |
loanCcy | 借款币种 | 可以为空,默认值为CNY |
description | 描述列表 | 可以为空 |
已选中可核销借款校验接口说明
请求方式
POST
请求参数说明
{
"formDataCode":"xxxxxxxx", // 每刻单据code
"formCode": "您的单据code", //如果您在webHook节点处理时返回了formCode则该Code为您的单据code,否则每刻会自动生成一个唯一code
"formType":"xxxxxx", // 每刻单据标示 REIMBURSE表示报销单, PRECONSUME表示申请单,LITE为轻表单
"formData":{xxxxx}, //具体参数可以查看末尾的每刻推送的formData字段格式
"loanCodes": ["LOANCODE001", "LOANCODE002"]
}
响应参数说明
本接口与上方获取可核销借款信息接口响应参数完全一致 响应参数示例
{
"success": true, // 标记请求是否成功返回 false表示请求失败(即使触发校验也应该是成功返回,异常返回是指触发某些不受检异常)
"errorMsg": "", // 当success为false的时候需要返回错误信息,当success为false时,会将该部分的信息弹出提示给用户
"data": {
"loanDeductionList": [{
"owedAmount": 800.00,
"title": "借款单1000元,已核销200元",
"repaymentAt": 1546272000000,
"loanCode": "CODE001001",
"loanAmount": 1000.00,
"loanCcy": "CNY",
"description": ["借款单备注:因为XX原因借款","借款单位:每刻科技公司"]
},{
"owedAmount": 1000.00,
"title": "借款单1000元",
"repaymentAt": 1546272000000,
"loanCode": "CODE002002",
"loanAmount": 1000.00,
"loanCcy": "CNY",
"description": ["借款单备注:因为XX原因借款","借款单位:每刻科技公司"]
}]
}
}
响应参数说明
参数名称 | 参数说明 | 是否可以为空 |
---|---|---|
owedAmount | 剩余未核销金额 | 不能为空 |
title | 借款单的标题 | 不能为空 |
repaymentAt | 预计还款时间 | 不能为空 |
loanCode | 借款code,可以与借款单code相同。但是必须唯一 | 不能为空 |
loanAmount | 借款单最初的借款金额 | 可以为空 |
loanCcy | 借款币种 | 可以为空,默认值为CNY |
description | 描述列表 | 可以为空 |
每刻推送的formData字段格式
详细文档地址:每刻推送的表单数据格式
更新记录
2020-03-12:新增了《已选中可核销借款校验接口说明》,新增了接口业务时序图