预算计划查询

批量查询

  • url
    • 使用code批量查询: common/budgets/v2/glBudgetPlan/findByCodes
    • 使用id批量查询: common/budgets/v2/glBudgetPlan/findByIds
  • method: GET
  • 数据格式：json
  • 说明: 预算计划查询.

参数

请求参数（RequestParams）

使用code批量查询
字段名称 字段类型 字段描述 是否必填 长度限制
bizId String 当前请求唯一标识 TRUE 36
timestamp Long 当前请求对应的时间戳 TRUE 13
codes List<String> 预算计划名称 重复传参，如 codes=xxx&codes=yyy TRUE 200
使用id批量查询
字段名称 字段类型 字段描述 是否必填 长度限制
bizId String 当前请求唯一标识 TRUE 36
timestamp Long 当前请求对应的时间戳 TRUE 13
ids List<Long> 预算计划id 重复传参，如 ids=xxx&ids=yyy TRUE 200

返回参数

  • 说明： data 为数组，data[] 表示数组中元素（对象）
字段名称 字段类型 字段描述
bizId String 当前次接口同步的唯一标识
resCode Integer 响应状态码（见附录）
resMsg String 返回信息描述
data Array 当前请求响应的数据集合
data[].plan_id Long 预算计划ID
data[].branch_id Long 分公司ID
data[].plan_name String 预算计划名称
data[].warning_pct BigDecimal 预算金额报警阈值
data[].plan_dimension String 预算编制时预算组合范围限制(前端控制)
data[].status String 预算计划状态(published: 已发布; planning: 保存未发布/生效)

示例

1 使用code批量查询

请求数据

完整 URL：

/common/budgets/v2/glBudgetPlan/findByCodes?bizId=b2bc76ab-58e6-419d-8798-8aefaaab7f88&timestamp=1675180800000&codes=1月预算&codes=2月预算&codes=3月预算&codes=4月预算

参数拆解： | 参数 | 值 | | --------- | ----------------------------------------| | bizId | b2bc76ab-58e6-419d-8798-8aefaaab7f88 | | timestamp | 1675180800000 | | codes | 1月预算 | | codes | 2月预算 | | codes | 3月预算 | | codes | 4月预算 |

返回数据
{
    "resCode": 200000,
    "resMsg": "success",
    "data": [
        {
            "code": "3月预算",
            "creation_date": 1614744438000,
            "last_update_date": 1652184445000,
            "plan_id": 576,
            "branch_id": 0,
            "plan_name": "3月预算",
            "plan_dimension": "[{\"range\": [1681], \"display\": \"column\", \"column_name\": \"gl_period\"}, {\"range\": [14577], \"display\": \"column\", \"column_name\": \"department_id\"}, {\"range\": [1646, 1647, 1669, 1648, 1649], \"display\": \"row\", \"column_name\": \"budget_id\"}]",
            "status": "published"
        },
        {
            "code": "4月预算",
            "creation_date": 1617938404000,
            "last_update_date": 1652184445000,
            "plan_id": 579,
            "branch_id": 0,
            "plan_name": "4月预算",
            "plan_dimension": "[{\"range\": [1683], \"display\": \"column\", \"column_name\": \"gl_period\"}, {\"range\": [14577], \"display\": \"column\", \"column_name\": \"department_id\"}, {\"range\": [1646, 1647, 1669, 1648, 1649], \"display\": \"row\", \"column_name\": \"budget_id\"}]",
            "status": "published"
        }
    ]
}

2 使用id批量查询

请求数据
{
    "bizId": "b2bc76ab-58e6-419d-8798-8aefaaab7f88",
    "timestamp": 1675180800000,
    "ids": [697, 693, 696, 695]
}

完整 URL：

/common/budgets/v2/glBudgetPlan/findByIds?bizId=b2bc76ab-58e6-419d-8798-8aefaaab7f88&timestamp=1675180800000&ids=697&ids=693&ids=696&ids=695

参数拆解： | 参数 | 值 | | --------- | --------------------------------------| | bizId | b2bc76ab-58e6-419d-8798-8aefaaab7f88 | | timestamp | 1675180800000 | | ids | 697 | | ids | 693 | | ids | 696 | | ids | 695 |

返回数据
{
    "resCode": 200000,
    "resMsg": "success",
    "bizId": "b2bc76ab-58e6-419d-8798-8aefaaab7f88",
    "data": [
        {
            "last_update_date": 1672992557000,
            "plan_id": 693,
            "branch_id": 0,
            "plan_name": "2023年1月预算-餐费",
            "plan_dimension": "[{\"range\": [1791], \"display\": \"header\", \"column_name\": \"gl_period\"}, {\"range\": [223562], \"display\": \"row\", \"column_name\": \"user_id\"}, {\"range\": [18476], \"display\": \"column\", \"column_name\": \"budget_id\"}]",
            "status": "published"
        },
        {
            "last_update_date": 1672992515000,
            "plan_id": 695,
            "branch_id": 0,
            "plan_name": "2023年预算-餐费",
            "plan_dimension": "[{\"range\": [1786], \"display\": \"header\", \"column_name\": \"gl_period\"}, {\"range\": [223562], \"display\": \"row\", \"column_name\": \"user_id\"}, {\"range\": [18476], \"display\": \"column\", \"column_name\": \"budget_id\"}]",
            "status": "published"
        },
        {
            "last_update_date": 1672992530000,
            "plan_id": 696,
            "branch_id": 0,
            "plan_name": "2023年1季度预算-餐费",
            "plan_dimension": "[{\"range\": [1787], \"display\": \"header\", \"column_name\": \"gl_period\"}, {\"range\": [223562], \"display\": \"row\", \"column_name\": \"user_id\"}, {\"range\": [18476], \"display\": \"column\", \"column_name\": \"budget_id\"}]",
            "status": "published"
        },
        {
            "last_update_date": 1673397805000,
            "plan_id": 697,
            "branch_id": 0,
            "plan_name": "2023年1月预算",
            "plan_dimension": "[{\"range\": [1791, 1792, 1793], \"display\": \"row\", \"column_name\": \"gl_period\"}, {\"range\": [18494, 18478, 18480, 18472, 18468], \"display\": \"column\", \"column_name\": \"budget_id\"}]",
            "status": "planning"
        }
    ]
}

单个查询

  • url
    • 使用code查询: common/budgets/v2/glBudgetPlan/findByCode
    • 使用id查询: common/budgets/v2/glBudgetPlan/findById
  • method: GET
  • 数据格式：json
  • 说明: 预算计划查询.

参数

请求参数（RequestParams）

使用code查询
字段名称 字段类型 字段描述 是否必填 长度限制
bizId String 当前请求唯一标识 TRUE 36
timestamp Long 当前请求对应的时间戳 TRUE 13
code String 预算计划名称 TRUE 64
使用id查询
字段名称 字段类型 字段描述 是否必填 长度限制
bizId String 当前请求唯一标识 TRUE 36
timestamp Long 当前请求对应的时间戳 TRUE 13
id Long 预算计划名称 TRUE 64

返回参数

字段名称 字段类型 字段描述
bizId String 当前次接口同步的唯一标识
resCode Integer 响应状态码（见附录）
resMsg String 返回信息描述
data Object 当前请求响应对象
data.plan_id Long 预算计划ID
data.branch_id Long 分公司ID
data.plan_name String 预算计划名称
data.warning_pct BigDecimal 预算金额报警阈值
data.plan_dimension String 预算编制时预算组合范围限制(前端控制)
data.status Long 预算计划状态(published: 已发布; planning: 保存未发布/生效)

示例

使用code查询

请求数据

完整 URL：

/common/budgets/v2/glBudgetPlan/findByCode?bizId=b2cc76ab-58e6-419d-8798-8aefaaab7f88&timestamp=1675180800000&codes=3月预算

参数拆解： | 参数 | 值 | | --------- | --------------------------------------| | bizId | a1ac76ab-58e6-419d-8798-8aefaaab7f88 | | timestamp | 1673798400000 | | codes | 3月预算 |

返回数据
{
    "resCode": 200000,
    "resMsg": "success",
    "data": {
        "code": "3月预算",
        "creation_date": 1614744438000,
        "last_update_date": 1652184445000,
        "plan_id": 576,
        "branch_id": 0,
        "plan_name": "3月预算",
        "plan_dimension": "[{\"range\": [1681], \"display\": \"column\", \"column_name\": \"gl_period\"}, {\"range\": [14577], \"display\": \"column\", \"column_name\": \"department_id\"}, {\"range\": [1646, 1647, 1669, 1648, 1649], \"display\": \"row\", \"column_name\": \"budget_id\"}]",
        "status": "published"
    }
}

使用id查询

请求数据

完整 URL：

/common/budgets/v2/glBudgetPlan/findById?bizId=b2cc76ab-58e6-419d-8798-8aefaaab7f88&timestamp=1675180800000&id=695

参数拆解：

参数 值
bizId a1ac76ab-58e6-419d-8798-8aefaaab7f88
timestamp 1673798400000
id 695
返回数据
{
    "resCode": 200000,
    "resMsg": "success",
    "bizId": "b2bc76ab-58e6-419d-8798-8aefaaab7f88",
    "data": {
        "last_update_date": 1672992515000,
        "plan_id": 695,
        "branch_id": 0,
        "plan_name": "2023年预算-餐费",
        "plan_dimension": "[{\"range\": [1786], \"display\": \"header\", \"column_name\": \"gl_period\"}, {\"range\": [223562], \"display\": \"row\", \"column_name\": \"user_id\"}, {\"range\": [18476], \"display\": \"column\", \"column_name\": \"budget_id\"}]",
        "status": "published"
    }
}

results matching ""

    No results matching ""