内部单据预算操作

说明

可用于外部系统关联每刻内部单据，冻结、占用、释放每刻的层级预算。

注：

1. 仅支持当前已生效的层级预算，单据类型支持申请、报销和合同。ps:后续支持平/层级
   
2. 一次请求对应一张单据，freezeBudgets、occupyBudgets、unfreezeBudgets 必须恰好一个非空。
   
3. 冻结先匹配预算；占用和释放按 uniqueCode 查找原冻结明细，不重新匹配。占用将冻结金额转为占用，释放仅支持释放冻结金额。
   
4. 三种动作的 amount 均不得为负数。占用、释放金额换算后不能超过原明细的剩余冻结金额。
   
5. 此接口为整批成功或整批失败，一条数据错误则整批失败。
   
6. 同一单据的 uniqueCode 在有余额时不能重复新增冻结；全部释放后可以重新冻结。相同释放请求再次调用，会再次扣减冻结余额。
   
7. 未指定预算组织、科目业务编码时，需按对应预算组织和科目配置的匹配条件传参。
   
8. 冻结明细中任一 ignoreWeakControl 为 true，整批忽略弱控提示，强控仍然生效。
   
9. 币种与预算方案币种不一致时，按 exchangeTime 对应汇率换算；未传时取当前时间。
   
10. 单据节点的预算动作由外部系统调用本接口处理。

接口限制

该接口单批默认最多支持1000条明细。

接口地址

/api/openapi/budget/operation

请求类型

POST

请求参数

参数说明

freezeBudgets 参数说明

orgMatch：

subjectMatch：

occupyBudgets、unfreezeBudgets 参数说明

参数样例

冻结

{
  "formType": "PRECONSUME",
  "formDataCode": "FORM_DEMO_001",
  "freezeBudgets": [
    {
      "uniqueCode": "A",
      "budgetPlanBizCode": "PLAN_2026",
      "orgMatch": {
        "orgBizCode": "ORG_SALES"
      },
      "subjectMatch": {
        "subjectBizCode": "SUBJECT_TRAVEL"
      },
      "budgetTime": 1791849600000,
      "amount": "100.00",
      "currency": "CNY",
      "desc": "申请时冻结",
      "ignoreWeakControl": false,
      "exchangeTime": 1791849600000
    }
  ]
}

冻结转占用

{
  "formType": "PRECONSUME",
  "formDataCode": "FORM_DEMO_001",
  "occupyBudgets": [
    {
      "uniqueCode": "A",
      "amount": "80.00",
      "currency": "CNY",
      "desc": "审批完成转占用"
    }
  ]
}

释放剩余冻结金额

{
  "formType": "PRECONSUME",
  "formDataCode": "FORM_DEMO_001",
  "unfreezeBudgets": [
    {
      "uniqueCode": "A",
      "amount": "20.00",
      "currency": "CNY",
      "desc": "释放剩余冻结金额"
    }
  ]
}

响应参数

响应参数说明

参数样例

正确示例返回

{
  "code": "ACK",
  "message": "成功",
  "data": null,
  "errorCode": null,
  "success": true
}

错误示例返回

{
  "code": "NACK",
  "message": "预算操作金额不能为负数",
  "data": null,
  "errorCode": "999997",
  "success": false
}

常见错误提示说明--message