借款单预计归还日期变更接口

说明

申请单完成后，集成可调用本接口批量修改借款单的预计归还日期。接口同时更新借款单明细和借款台账，记录操作人、变更前后的日期及修改原因，并刷新尚未发送的预计归还时间逾期提醒。已经发送的历史消息不变。

注意事项

• 企业身份由开放平台鉴权确定；operatorId 必须是当前企业的员工工号。
• 一次请求须传入至少 1 个不同的借款单号，默认上限为 50 个，实际上限以服务端配置为准。单据号使用对外单据号，不使用借款台账内部编码。
• 借款单须处于 COMPLETED（已完成）状态，且尚未完全核销。
• 请求中的所有借款单校验通过后才会更新；任一单据校验失败，整批失败，不返回部分成功清单。

接口地址

/api/openapi/form/loan/repayment/date/change

请求类型

POST

请求参数

参数说明

请求样例

{
  "operatorId": "EMP001",
  "formCodeList": ["MK26100001", "MK26100002"],
  "expectedPaybackDate": 1798761600000,
  "reason": "延期申请已审批完成"
}

响应参数

响应参数说明

成功响应样例

{
  "code": "ACK",
  "message": null,
  "data": {
    "successFormCodeList": ["MK26100001", "MK26100002"]
  },
  "errorCode": null,
  "success": true
}

失败响应样例

{
  "code": "NACK",
  "message": "借款单 MK26100002 已全部核销，不能修改预计归还时间",
  "data": null,
  "errorCode": null,
  "success": false
}

必填参数缺失、单次超过服务端配置的上限（默认 50 张）、借款单号重复、修改原因超长、借款单号无效、借款单未完成或已全部核销时，请求失败。错误信息按开放平台多语言机制返回。

单据不是借款单、单据号不存在或不属于当前企业时，返回“单据 {formCode} 不是借款单”。

修改记录

2026-10-16 新增借款单预计归还日期变更接口
2026-10-19 单次批量上限支持服务端配置，默认 50 张