预算详情按日期查询

  • 接口：common/budgets/v2/findDetailsByDate
  • Method：POST
  • 数据格式：JSON
  • 接口说明：按预算最后更新时间分页查询预算详情
  • 多语言环境：在接口请求头中添加Key为locale，Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体)，请选取其中一种
  • 请求特点：首次查询不传 bizId，接口会返回本次查询对应的 bizId；第二次及后续翻页查询，需要传回上次响应中的 bizId
  • 其他补充信息：
    • start_date 和 end_date 至少传一个
    • 本接口响应中 null 字段默认不返回
    • 日期时间字段实际返回为13位时间戳

参数:

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
page_num Integer 分页页数；首次查询不传时默认返回第1页 FALSE 无
page_size Integer 分页条数 FALSE 无
bizId String 快照标识；首次查询不传，后续翻页传首次响应返回的 bizId FALSE 64
start_date String 查询开始日期，格式 yyyy-MM-dd ONE-OF``1 10
end_date String 查询结束日期，格式 yyyy-MM-dd ONE-OF``1 10
period_name String 财年期间 FALSE 64
period_type String 财年类型 FALSE 64
department_code String 部门编码/成本中心编码 FALSE 64
budget_code String 预算科目编码 FALSE 64
project_code String 项目编码 FALSE 64
employee_number String 员工工号 FALSE 64
user_name String 用户名称 FALSE 128
supplier_code String 供应商编码 FALSE 64
column1 String 自定义字段1 FALSE 255
column2 String 自定义字段2 FALSE 255
column3 String 自定义字段3 FALSE 255
column4 String 自定义字段4 FALSE 255
column5 String 自定义字段5 FALSE 255

说明：

  1. start_date 和 end_date 至少传一个。
  2. 首次查询通常只传日期范围和分页参数，不传 bizId。
  3. 第二次及后续分页查询，需传回首次响应中的 bizId，以便在同一个快照内继续翻页。
  4. 当只传 start_date 且当前查询窗口未超过12个自然月时，响应中可能只返回 start_date，不返回 end_date。
  5. 当 end_date 早于 start_date 时，接口会返回参数异常。

返回参数

字段名称 字段类型 字段描述
resCode Integer 响应状态码
resMsg String 返回信息描述
bizId String 本次查询对应的快照标识；后续翻页继续使用该值
data Object 分页结果
data.page_size Integer 每页条数
data.page_num Integer 当前页数
data.total_count Integer 总条数
data.total_page Integer 总页数
data.is_first_page Boolean 是否第一页
data.is_last_page Boolean 是否最后一页
data.start_date String 实际生效的开始日期
data.end_date String 实际生效的结束日期；未补齐时可能不返回
data.page_info Array 预算详情列表
data.page_info[].creation_date Long 创建时间（13位时间戳，非所有记录都会返回）
data.page_info[].last_update_date Long 最后更新时间（13位时间戳）
data.page_info[].cid Integer 预算维度组合唯一编码
data.page_info[].plan_names Array 预算计划名称列表
data.page_info[].period_name String 财年期间
data.page_info[].budget_code String 预算科目编码
data.page_info[].department_code String 部门编码/成本中心编码
data.page_info[].employee_number String 员工工号
data.page_info[].user_name String 用户名称
data.page_info[].project_code String 项目编码
data.page_info[].supplier_code String 供应商编码
data.page_info[].budget_amount BigDecimal 预算金额
data.page_info[].frozen_amount BigDecimal 冻结金额
data.page_info[].request_amount BigDecimal 占用金额
data.page_info[].expense_amount BigDecimal 消耗金额
data.page_info[].used_amount BigDecimal 已使用金额
data.page_info[].reference_amount BigDecimal 参考金额
data.page_info[].warning_pct BigDecimal 预警比例
data.page_info[].error_pct BigDecimal 超支比例
data.page_info[].validate_rule String 预算校验规则
data.page_info[].budget_breakdown_amount BigDecimal 预算分解金额
data.page_info[].budget_breakdown_overrun_amount BigDecimal 预算分解超支金额
data.page_info[].budget_breakdown_balance BigDecimal 预算分解余额
data.page_info[].balance_amount BigDecimal 余额
data.page_info[].request_date Long 占用日期（13位时间戳）
data.page_info[].expense_date Long 消耗日期（13位时间戳）
data.page_info[].gba_last_update_date Long 预算金额最后更新时间（13位时间戳）
data.page_info[].column1 String 自定义字段1
data.page_info[].column2 String 自定义字段2
data.page_info[].column3 String 自定义字段3
data.page_info[].column4 String 自定义字段4
data.page_info[].column5 String 自定义字段5

说明：

  1. page_info 中字段按实际数据返回，值为 null 的字段可能被省略。
  2. last_update_date 与 gba_last_update_date 在实际响应中都可能出现。
  3. 第二页开始通常会继续沿用第一次查询生成的同一个 bizId。

示例：

01 首次查询预算详情

请求数据

{
  "start_date": "2026-06-20",
  "page_size": 6
}

返回数据

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "7521529865178389937",
  "data": {
    "page_size": 6,
    "page_num": 1,
    "total_count": 196,
    "total_page": 33,
    "is_first_page": true,
    "is_last_page": false,
    "page_info": [
      {
        "last_update_date": 1782367906000,
        "cid": 142120,
        "period_name": "2026年12月",
        "department_code": "2050014",
        "employee_number": "kwy8@qq.com",
        "user_name": "kwy8@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check_ptd(header_id,0)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "last_update_date": 1782367906000,
        "cid": 146183,
        "period_name": "2026年12月",
        "department_code": "2050064",
        "employee_number": "wanru@qq.com",
        "user_name": "wanru@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check(header_id)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "last_update_date": 1782367906000,
        "cid": 146184,
        "period_name": "2026年12月",
        "department_code": "2050064",
        "employee_number": "789168",
        "user_name": "jiacheng@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check_ptd(header_id,1)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "last_update_date": 1782367906000,
        "cid": 146185,
        "period_name": "2026年12月",
        "department_code": "2050064",
        "employee_number": "kwy8@qq.com",
        "user_name": "kwy8@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check_ptd(header_id,0)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "last_update_date": 1782367906000,
        "cid": 146186,
        "period_name": "2026年12月",
        "department_code": "2050064",
        "employee_number": "kwy@qq.com",
        "user_name": "kwy@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check_total(header_id,1)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "last_update_date": 1782367906000,
        "cid": 146187,
        "period_name": "2026年12月",
        "department_code": "2050064",
        "employee_number": "kwy1@qq.com",
        "user_name": "kwy1@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check_total(header_id,0)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      }
    ],
    "start_date": "2026-06-20"
  }
}

02 第二次查询预算详情（翻页查询）

请求数据

{
  "start_date": "2026-06-20",
  "bizId": "7521529865178389937",
  "page_size": 6,
  "page_num": 2
}

返回数据

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "7521529865178389937",
  "data": {
    "page_size": 6,
    "page_num": 2,
    "total_count": 196,
    "total_page": 33,
    "is_first_page": false,
    "is_last_page": false,
    "page_info": [
      {
        "creation_date": 1784201257848,
        "last_update_date": 1782367906000,
        "cid": 146188,
        "period_name": "2026年12月",
        "department_code": "2050020",
        "employee_number": "wanru@qq.com",
        "user_name": "wanru@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check(header_id)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "creation_date": 1784201257848,
        "last_update_date": 1782367906000,
        "cid": 146189,
        "period_name": "2026年12月",
        "department_code": "2050020",
        "employee_number": "789168",
        "user_name": "jiacheng@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check_ptd(header_id,1)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "creation_date": 1784201257848,
        "last_update_date": 1782367906000,
        "cid": 146190,
        "period_name": "2026年12月",
        "department_code": "2050020",
        "employee_number": "kwy8@qq.com",
        "user_name": "kwy8@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check_ptd(header_id,0)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "creation_date": 1784201257848,
        "last_update_date": 1782367906000,
        "cid": 146191,
        "period_name": "2026年12月",
        "department_code": "2050020",
        "employee_number": "kwy@qq.com",
        "user_name": "kwy@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check_total(header_id,1)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "creation_date": 1784201257848,
        "last_update_date": 1782367906000,
        "cid": 146192,
        "period_name": "2026年12月",
        "department_code": "2050020",
        "employee_number": "kwy1@qq.com",
        "user_name": "kwy1@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check_total(header_id,0)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      },
      {
        "creation_date": 1784201257848,
        "last_update_date": 1782367906000,
        "cid": 146193,
        "period_name": "2026年12月",
        "department_code": "2050014",
        "employee_number": "wanru@qq.com",
        "user_name": "wanru@qq.com",
        "budget_amount": 9000.00,
        "used_amount": 0.00,
        "reference_amount": 9000.00,
        "validate_rule": "wf_budget_check(header_id)",
        "balance_amount": 9000.00,
        "gba_last_update_date": 1782367906000
      }
    ],
    "start_date": "2026-06-20"
  }
}

03 日期范围非法

请求数据

{
  "start_date": "2026-06-20",
  "end_date": "2026-05-20",
  "page_size": 6,
  "page_num": 2
}

返回数据

{
  "resCode": 500060,
  "resMsg": "参数异常, endDate cannot be earlier than startDate"
}

results matching ""

    No results matching ""