预算冻结 、占用、释放

说明

可用于外部系统调用该接口冻结、占用、释放每刻的可用预算。

注：

1. 如需要做预算释放，amount参数传负数即可。
   
2. 如已冻结需要转为占用，则需要先释放相应金额，再调用占用接口冻结相应金额。
   
3. 此接口为全部失败，即一条数据错误则整批失败。
4. 预算组织传参规则：若不传orgBizCode而传具体匹配条件，则需根据对应预算组织匹配条件传参：
   1. 若配置的条件为且关系，则必须传入所有参数才能匹配成功。如配置了承担人为A1且承担部门为B2，则必须传入employeesNo为A1和departmentBizCode为B2。
   2. 若配置的条件为或关系，则传入任一参数均能匹配成功。如配置了承担人为A1或承担部门为B2，则传employeesNo为A1或departmentBizCode为B2均能成功。
5. 预算科目传参规则：若不传subjectBizCode而传具体匹配条件，则需根据对应预算科目配置类型传参：
   1. 若配置的类型为费用类型+自定义档案，则必须传入两个类型的参数才能匹配成功，但若某一参数有多个值，可传该参数任一值。如配置费用A1、A2、A3，自定义档案B1、B2，则传expenseTypeBizCode为A1/A2/A3和referenceDataDetailBizCodes包含B1/B2任一组合均可成功。
6. 当参数集合中有任一参数忽略弱控强占预算时，所有参数都会忽略弱控强占预算，参考3
7. 若写入金额的币种和预算方案的预算币种不一致，则会根据操作时间时的汇率转换（接口写入时生效汇率）。

接口限制

该接口单笔最多支持50条明细。

接口地址

/api/openapi/budget/{operationType}
冻结：operationType = "FREEZE"
占用：operationType ="OCCUPY"
释放：OCCUPY/FREEZE均可

请求类型

POST

请求参数

参数说明

参数样例

[{
  "uniqueCode": "uniqueCode_001",
  "type": "EXTERNAL_OPENAPI",
  "orgMatch": {
    "orgBizCode": "",
    "departmentBizCode": "",
    "employeesNo": "A1",
    "legalEntityBizCode": "",
    "referenceDataDetailBizCodes": []
  },
  "subjectMatch": {
    "subjectBizCode": "",
    "expenseTypeBizCode": "A1",
    "referenceDataDetailBizCodes": ["B1"]
  },
  "budgetTime": "1648025714000",
  "amount": "10000.00",
  "currency": "CNY",
  "reportCode": "",
  "desc": ""
}]

响应参数

响应参数说明

参数样例

正确示例返回

{
    "code": "ACK",
    "message": "",
    "data": [
        {
            "uniqueCode": "hs0039",
            "budgetUnitCode": "BDG2206011DUWY0SG",
            "budgetOrgCode": "BDG2206011DOBR75S",
            "budgetSubjectCode": "BDG2206011DPGNQ4G",
            "periodNum": 1,
            "usableAmount": 700.00,
            "excessAmount": 0,
            "matchSuccess": true,
            "errorMessage": null,
            "level": null
        }
    ],
    "errorCode": null,
    "success": true
}

错误示例返回

{
    "code": "NACK",
    "message": "",
    "data": [
        {
            "uniqueCode": "hs0038",
            "budgetUnitCode": "BDG2206011DUWY0SG",
            "budgetOrgCode": "budget_org_code_hs",
            "budgetSubjectCode": "budget_subject_hs",
            "periodNum": 1,
            "usableAmount": 900.00,
            "excessAmount": 4100.00,
            "matchSuccess": false,
            "errorMessage": "该预算 小狼的预算组织-小狼的预算科目-10期 已超标 CNY:4100.00",
            "level": "ERROR"
        }
    ],
    "errorCode": null,
    "success": false
}

{
   "code": "NACK",
   "message": "预算组织不存在,请检查 [orgBizCode]",
   "data": null,
   "errorCode": null,
   "success": false
}

常见错误提示说明--data.errorMessage

常见错误提示说明--message