预算科目查询

  • url: common/budgetAccounts/v2/findByCodes
  • method: GET
  • 数据格式：json
  • 说明: 预算科目查询.

参数

请求参数（RequestParams）

使用code批量查询

字段名称 字段类型 字段描述 是否必填 备注
bizId String 当前请求唯一标识 TRUE 非空，建议使用 36 位 UUID
timestamp Long 当前请求对应的时间戳 TRUE 非空，通常使用 13 位毫秒时间戳
codes List<String> 当前请求的预算科目代码集合 TRUE 推荐重复传参，如 codes=xxx&codes=yyy&codes=zzzz；不建议使用 codes=xxx,yyy,zzzz的写法
  • 说明：
  • GET请求受URL总长度限制，code较长或数量较多时，建议拆分多次调用；
  • 返回的 data[].language 和 data[].budget_name 受请求头 locale 影响，建议调用时显式传入 locale。

返回参数

  • 说明：
  • data 为数组，data[] 表示数组中元素（对象）；当查询结果为空时，data 返回 null
  • 返回字段值为 null 时，响应中省略该字段
字段名称 字段类型 字段描述
bizId String 当前次接口同步的唯一标识
resCode Integer 响应状态码（见附录）
resMsg String 返回信息描述
data Array / null 当前请求的数据集合
data[].budget_id Long 预算科目ID（必需）
data[].code String 预算科目代码（必需）
data[].enabled_flag String 是否启用(存在且值='Y'已启用)
data[].budget_control String 预算控制标识
data[].budget_disabled String 是否已禁用(存在且值='Y'已禁用)
data[].language String 语言，与请求头 locale 对应
data[].budget_name String 对应 data[].language 语言的预算科目名称
data[].parent_id Long 上级预算科目ID（不存在表示没有上级预算科目）
data[].parent_code String 上级预算科目代码（不存在表示没有上级预算科目）

示例

请求示例

{{baseURL}}/common/budgetAccounts/v2/findByCodes?bizId=e0adcc76-7014-477f-8c37-497341f05244&timestamp=1777336560456&codes=1.1&codes=1.2&codes=1.3&codes=1&codes=1060011&codes=106001&codes=100002&codes=100001

返回数据

{
    "resCode": 200000,
    "resMsg": "success",
    "bizId": "e0adcc76-7014-477f-8c37-497341f05244",
    "data": [
        {
            "code": "1",
            "enabled_flag": "Y",
            "budget_name": "测试科目1",
            "language": "zh_CN",
            "budget_id": 19661
        },
        {
            "code": "1.1",
            "parent_code": "1",
            "enabled_flag": "Y",
            "budget_name": "测试科目1-1",
            "language": "zh_CN",
            "budget_id": 19662,
            "parent_id": 19661
        },
        {
            "code": "1.2",
            "parent_code": "1",
            "enabled_flag": "Y",
            "budget_name": "测试科目1-2",
            "language": "zh_CN",
            "budget_id": 19663,
            "parent_id": 19661
        },
        {
            "code": "1.3",
            "parent_code": "1",
            "enabled_flag": "Y",
            "budget_name": "测试科目1-3",
            "language": "zh_CN",
            "budget_id": 19664,
            "parent_id": 19661
        },
        {
            "code": "100001",
            "enabled_flag": "Y",
            "budget_control": "Y",
            "budget_name": "差旅费_zhCN",
            "language": "zh_CN",
            "budget_id": 1646
        },
        {
            "code": "100002",
            "parent_code": "100001",
            "enabled_flag": "Y",
            "budget_control": "N",
            "budget_name": "差旅住宿费",
            "language": "zh_CN",
            "budget_id": 1670,
            "parent_id": 1646
        },
        {
            "code": "106001",
            "enabled_flag": "Y",
            "budget_control": "Y",
            "budget_name": "abc456测试预算科目",
            "language": "zh_CN",
            "budget_id": 2184
        },
        {
            "code": "1060011",
            "parent_code": "106001",
            "enabled_flag": "Y",
            "budget_control": "Y",
            "budget_name": "test1",
            "language": "zh_CN",
            "budget_id": 2773,
            "parent_id": 2184
        }
    ]
}

results matching ""

    No results matching ""