预算校验
接口:/budget/validate
Method:POST
数据格式:JSON
请求参数:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
budgetAttributionType | String | Y | 预算归属类型,可选值为ASIA_PAINT_PROCUREMENT, FEE_ALLOCATION。 亚士采购单用ASIA_PAINT_PROCUREMENT |
budgetaryAccountCode | String | N | 预算科目编码, 预算科目编码和业务编码两者需要有一个必填。如果budgetaryAccountBizCode 没有值,用budgetaryAccountCode查询预算科目 |
budgetaryAccountBizCode | String | N | 预算科目业务编码, 预算科目编码和业务编码两者需要有一个必填。如果budgetaryAccountBizCode 有值,用budgetaryAccountBizCode查询预算科目 |
budgetEntryTargetType | String | Y | 目标预算类型,可选值为:SUBSIDIARY - 业务实体预算, DEPARTMENT - 部门预算, AUX_ACCOUNTING - 项目预算, PERSONAL - 个人预算 |
budgetAttributionDate | Date | Y | 预算归属日期 |
departmentBizCode | String | N | 部门业务编码,当目标预算类型为DEPARTMENT时,需要传入此参数 |
subsidiaryBizCode | String | Y | 业务实体业务编码 |
auxAccountingBizCode | String | N | 项目业务编码,当目标预算类型为AUX_ACCOUNTING时,需要传入此参数 |
employeeId | String | N | 人员工号,当目标预算类型为PERSONAL时,需要传入此参数 |
- 返回参数:
字段 | 类型 | 描述 |
---|---|---|
budgetEntryCode | String | 预算单元编码 |
budgetaryAccountCode | String | 预算科目编码 |
periodCode | String | 预算期间编码 |
totalAmount | BigDecimal | 总金额 |
allocatedAmount | BigDecimal | 已分配金额 |
usedAmount | BigDecimal | 已使用金额 |
freezedAmount | BigDecimal | 已冻结金额 |
childOverSpendAmount | BigDecimal | 下级已超标金额 |
availableAmount | BigDecimal | 可用金额 |
principaIUserCode | String | 预算负责人编码 |
principalUserName | String | 预算负责人姓名 |
principalEmployeeId | String | 预算负责人工号 |
budgetaryAccountBizCode | String | 预算科目业务编码 |
请求示例:
{ "timestamp":"1488879382", "data":[{ "budgetAttributionType":"ASIA_PAINT_PROCUREMENT", "budgetaryAccountCode":"BGTA170220XM691XC", "budgetEntryTargetType":"SUBSIDIARY", "budgetAttributionDate":"2017-04-02", "subsidiaryBizCode":"SU1606291CRREVWG" }] }
返回示例:
{ "code":"ACK", "message":"message.success", "data":[{ "budgetEntryCode":"BGTE1703061BOIR2M8", "budgetaryAccountCode":"BGTA170220XM691XC", "periodCode":"BGTP170220X4VLQF4", "totalAmount":2333, "allocatedAmount":0, "usedAmount":250, "freezedAmount":0, "availableAmount":2083, "childOverSpendAmount":0, "principalUserCode":"", "principalUserName":"", "principalEmployeeId":"", "budgetaryAccountBizCode":"BGTA2004201MT8H9YG" }], "args":null, "linkDetail":false, "nonBizError":false }
系统异常提示对照表
异常提示 | 描述 |
---|---|
* 预算归属类型不正确 | 预算归属类型(budgetAttributionType)为空时抛出 |
* 目标预算类型不能为空 | 目标预算类型(budgetEntryTargetType)为空时抛出 |
* 当目标预算类型为DEPARTMENT时,部门业务编码不能为空 | 部门业务编码(departmentBizCode)为空时抛出 |
* 当目标预算类型为SUBSIDIARY时,业务实体业务编码不能为空 | 业务实体业务编码(subsidiaryBizCode)为空时抛出 |
* 当目标预算类型为AUX_ACCOUNTING时,项目业务编码不能为空 | 项目业务编码(auxAccountingBizCode)为空时抛出 |
* 当目标预算类型为PERSONAL时,人员工号不能为空 | 人员工号(employeeId)为空时抛出 |
* 部门未找到 | 部门业务编码(departmentBizCode)不存在时抛出 |
* 业务实体未找到 | 业务实体业务编码(subsidiaryBizCode)不存在时抛出 |
* 辅助核算未找到 | 项目业务编码(auxAccountingBizCode)不存在时抛出 |
* 人员未找到 | 人员工号(employeeId)那不存在时抛出 |
* 预算期间未找到 | 预算归属日期(根据预算时间(budgetAttributionDate)找预算期间)当找不到对应的预算期间的是时抛出 |
* 未找到相关的预算编制 | 没有编制对应预算单元的预算时候抛出 |
* 系统异常 | 其他未知异常产生的时候抛出 |