对公预付预计到票日期批量变更接口

说明

按报销单号批量修改普通对公未清预付费用的预计到票日期。同一请求中的目标费用统一使用传入的新日期，同时更新普通预付费用日期、对公未清台账，刷新尚未发送的预计到票提醒，并记录操作人、修改时间、各费用的原日期、新日期及修改原因。已经发送的历史消息保持不变。

责任人变更请参见对公预付责任人批量变更接口。

注意事项

• 企业身份由开放平台鉴权确定。operatorId 为当前企业的操作人工号，操作人须具有对公未清台账权限。
• formCodeList 使用对外报销单号，至少 1 个，默认最多 10 个，实际上限以服务端配置为准。不允许空单号或重复单号。
• 报销单须属于当前企业，处于 COMPLETED（已完成）状态且未作废。
• 仅修改普通对公未清预付费用：费用为对公 NO_RECEIPT 类型，未清记录类型为 NORMAL 或历史空值；目标费用须已完结（CLOSED），且至少存在一条未核销完成（DEDUCTION_UNCOMPLETED）的记录。
• 费用已完结且其全部未清记录均已核销完成（DEDUCTION_COMPLETED）时，该费用不参与修改。押金、保证金及非预付费用也不参与修改。筛选后整张单据没有目标费用时，请求失败。
• 所有单据和目标费用均校验通过后才执行更新；任一校验失败，整批返回 NACK，不修改任何费用，不触发本批提醒刷新或成功操作日志。错误信息返回首个校验错误，单据或费用错误包含对应单据号。
• 同一单据包含两笔未清普通预付费用、一笔已清预付费用和一笔非预付费用时，仅两笔未清普通预付费用更新为新日期，其余费用保持原值。更新按费用编码匹配，不受各费用原日期或排列顺序影响。

接口地址

/api/openapi/form/reimburse/prepayment/expected-arrival-date/change

请求类型

POST

请求参数

请求头

先通过接口认证获取 tokenId 和 entCode，调用时放入请求头。

请求体

请求样例

{
  "operatorId": "EMP001",
  "formCodeList": ["MK26100001", "MK26100002"],
  "expectedArrivalDate": "2027-01-15",
  "modifyReason": "项目验收延期，预计到票日期调整已审批通过"
}

响应参数

响应参数说明

成功响应样例

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

失败响应样例

{
  "code": "NACK",
  "message": "预计到票日期不能为空",
  "data": null,
  "requestId": null,
  "errorCode": null,
  "success": false
}

错误场景

下表为中文错误信息示例；{单据号}、{上限}、{数量} 会替换为本次请求的实际值。

修改记录

2026-10-23 新增对公预付预计到票日期批量变更接口文档
2026-10-29 预计到票日期支持过去、当天和未来日期