费用调整同步
说明
当财务在每刻系统内进行费用调整时,每刻会调用所配置的指定接口进行费用调整的数据同步。
费用调整同步接口说明
请求方式
POST
请求参数
{
"formDataCode":"xxxxxxxx",
"formCode": "您的单据code",
"formType":"REIMBURSE",
"operation" :"EXPENSE_ADJUST",
"payableAmount": {
"currencyCode": "CNY",
"text": "1000.00"
},
"approvedAmount": {
"currencyCode": "CNY",
"text": "1000.00"
},
"reason": "调整原因",
"operatorEmployeeId": "USER001",
"deductionHistory":[{
"owedAmount": 800.00,
"owedCurrency": "CNY",
"deductionAmount": 800.00,
"approvedDeductionAmount": 800.00,
"deductionCurrency": "CNY",
"title": "借款单1000元,已核销200元",
"repaymentAt": 1546272000000,
"loanCode": "CODE001001",
"comment": "评论信息",
"description": ["描述信息"]
}],
"formData":{
}
}
请求参数说明
参数名称 | 类型 | 是否必填 | 参数说明 |
---|---|---|---|
formDataCode | String | 是 | 每刻表单内码 |
formCode | String | 是 | 每刻单据外码。如果您在webHook节点处理时返回了formCode则该Code为您的单据code,否则每刻会自动生成一个唯一code |
formType | String | 是 | 每刻单据类型: PRECONSUME申请单 |
operation | String | 是 | 事件类型(固定值) |
payableAmount | AmountInput | 是 | 应付金额 |
approvedAmount | AmountInput | 是 | 审批通过金额 |
reason | String | 是 | 调整理由 |
operatorEmployeeId | String | 是 | 操作人工号 |
deductionHistory | List<deductionHistoryDto> | 是 | 事件类型 |
formData | 是 | 单据推送内容,详细文档地址:每刻推送的表单数据格式 |
AmountInput 金额信息
参数名称 | 参数说明 |
---|---|
currencyCode | 币种 |
text | 金额 |
deductionHistoryDto 借款核销信息
参数名称 | 参数说明 | 是否可以为空 |
---|---|---|
owedAmount | 可核销金额 | 不能为空 |
owedCurrency | 核销币种 | 不能为空 |
deductionAmount | 本次核销的金额 | 不能为空 |
approvedDeductionAmount | 批准核销金额 | 不能为空 |
deductionCurrency | 核销币种 | 不能为空 |
title | 借款单的标题 | 不能为空 |
repaymentAt | 预计还款时间 | 不能为空 |
loanCode | 借款code,可以与借款单code相同。但是必须唯一 | 不能为空 |
comment | 评论 | 可能为空 |
description | 描述信息 | 可能为空 |
响应参数
响应参数示例
{
"success": true,
"errorMsg": "",
"data": {
}
}
响应参数说明
参数说明 | 描述 |
---|---|
success | 标记请求是否成功返回。true:流程直接成功 false:将外部返回错误信息弹窗显示(业务失败/请求异常等返回该值) |
errorMsg | 当success为false的时候需要返回错误信息,系统会将该错误信息弹出提示给用户,并阻止流程 |
data | 可返回参数 |