预算组织按时间区间匹配接口
说明
该接口用于根据起止时间获取对应时间段内更新过的层级组织的相关信息。
接口地址
/api/openapi/budget/org/v2/match/time
请求类型
POST
请求参数
参数说明
若不传endTime则默认到当前日期，查询范围最大不能超过90天。
| 字段名称 | 类型 | 是否必填 | 字段说明 | 默认值 |
|---|---|---|---|---|
| rootCode | String | 是 | 组织树根节点 | |
| startTime | String | 是 | 起始时间（yyyymmdd） | |
| endTime | String | 否 | 结束时间（yyyymmdd） | |
| pageNo | Integer | 否 | 分页编码 | 1 |
| pageSize | Integer | 否 | 分页大小 | 20 |
参数样例
{
"rootCode": "123456",
"startTime": "20260102",
"endTime": "20260202",
"pageNo": 1,
"pageSize": 20
}
响应参数
响应参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 | 默认值 |
|---|---|---|---|---|
| bizCode | String | 预算组织编码 | ||
| nameZh | String | 预算组织中文名 | ||
| nameEn | String | 预算组织英文名 | ||
| parentBizCode | String | 上级预算组织编码 | ||
| parentName | String | 上级预算组织名称 | ||
| resourceBizCode | String | 来源数据编码 | ||
| resourceName | String | 来源数据名称 | ||
| resourceType | String | 来源数据类型 | ||
| resourceStatus | String | 来源数据状态 | ||
| desc | String | 预算组织描述 | ||
| priority | Integer | 预算组织优先级 | ||
| enabled | Boolean | 是 | 预算组织是否启用；可用于增量同步启停变化，true 表示启用，false 表示禁用 |
参数样例
{
"code": "ACK",
"message": "",
"data": {
"list": [
{
"bizCode": "NBDG2410231I4V9PJ4",
"nameZh": "科技有限公司",
"nameEn": "",
"parentBizCode": "NBDG24082911M8ZIIO",
"parentName": "xx科技有限公司",
"resourceName": "科技有限公司",
"resourceType": "DEPARTMENT",
"resourceBizCode": "DI2304281EROXQJN",
"resourceStatus": "已启用",
"desc": "描述",
"priority": 1,
"enabled": false
}
],
"hasNextPage": false
},
"errorCode": null,
"success": true
}
兼容说明
enabled是分页列表项的新增响应字段；旧响应消费者可以忽略，灰度期间字段缺失时可按true理解。- 禁用是软下线；按更新时间增量同步时，可根据
enabled更新本地组织状态，无需删除本地组织。 - 原接口路径和分页结构不变，本次变更仅适用于层级预算组织 V2；经典预算组织 V1 不变。
- 预算冻结、释放、占用、转占、预算方案和预算金额写入接口不因本次变更新增组织启停校验。
修改记录
2026-02-02 新增组织按时间区间匹配接口
2026-07-28 响应新增预算组织启用状态