关联申请单预提费用导入接口

说明

在目标预提申请单已经通过申请单导入接口关联来源普通申请单后，按来源费用编码逐条生成目标预提费用。建议先调用可预提费用明细查询接口取得来源编码及参考金额。

首次导入目标单并准备随后导入费用时，应在申请单导入请求中设置 stagingFlag=true，使目标单处于草稿状态。目标单必须配置“关联申请单预提”组件。

接口限制与处理规则

• 一次最多导入 10 条预提费用。每行单独保存；某行失败不会回滚同批其他已成功行。
• 本次预提金额必须 大于 0，但允许超过查询接口返回的 availableAmount。
• currency 必须与来源费用的消费币种一致；费用编码必须属于对应的来源普通申请单，且该来源单已经关联目标预提单。
• 接口只生成目标费用的最小字段并记录来源费用编码，不复制发票、参与人或分摊行。integrity=false 表示目标费用表单仍有必填项待补齐。
• customCode 仅用于请求与结果行对应，不作为生成费用的编码保存。重试前请先核对成功行返回的目标费用编码。

接口地址

/api/openapi/receive/application/expense/accrual/import

请求类型

POST

请求参数

Expense 明细参数

请求样例

{
  "accrualFormCode": "MK26020001",
  "employeeId": "200070",
  "sourceFormCodes": ["MK26010001"],
  "expenses": [
    {
      "customCode": "LINE001",
      "sourceFormCode": "MK26010001",
      "sourceApplicationExpenseCode": "AE26010001",
      "currentAccrualAmount": 120,
      "currency": "CNY"
    }
  ]
}

响应参数

ExpenseResult 明细结果

响应样例：部分失败

{
  "code": "NACK",
  "message": "操作失败",
  "data": {
    "expenses": [
      {
        "customCode": "LINE001",
        "sourceFormCode": "MK26010001",
        "sourceApplicationExpenseCode": "AE26010001",
        "accrualApplicationExpenseCode": "AE26020001",
        "integrity": false,
        "consumeAmount": 120,
        "currency": "CNY",
        "success": true
      },
      {
        "customCode": "LINE002",
        "sourceFormCode": "MK26010001",
        "sourceApplicationExpenseCode": "WRONG_EXPENSE",
        "consumeAmount": 50,
        "currency": "CNY",
        "success": false,
        "errorMessage": "费用明细与来源申请单不匹配，请核对费用明细编码和来源申请单号"
      }
    ]
  },
  "success": false
}

异常场景

修改记录

2026-10-25  DB-61831 新增关联申请单预提费用导入接口文档