费用台账查询接口

说明

费用台账查询接口

接口限制

接口地址

/api/openapi/account-book/expense/search

请求类型

POST

请求参数

参数说明

参数名称 类型 是否必填 参数说明
startCreateDate Long 费用创建开始时间
endCreateDate Long 费用创建结束时间
pageNo Integer 页码(默认为1)
pageSize Integer 分页大小(默认为50,最大为100)
employeeIds List<String> 费用归属人工号列表
expenseStatuses List<String> 费用状态列表("OPEN"、"PROCESSING"、"CLOSED"、"FREE")

参数样例

{
    "startCreateDate": 1759161600000,
    "endCreateDate": 1767110399999,
    "employeeIds": ["XXXX"],
    "expenseStatuses": ["PROCESSING"],
    "pageNo": 1,
    "pageSize": 50
}

响应参数

响应参数说明

字段名称 字段类型 字段说明
hasNextPage Boolean 是否有下一页
list List<AccountBookExpense> 费用台账列表

费用台账

字段名称 字段类型 字段说明
code String 费用内码
expenseTypeName String 费用类型名称
expenseTypeCode String 费用类型编码
reimburseStatus String 费用状态(未报销、报销中、已报销、免报销)
createdAt Long 创建日期
consumeTime DateInput 消费日期
userName String 费用归属人姓名
employeeId String 费用归属人工号
legalEntityName String 费用归属人所属公司抬头
departmentName String 费用归属人所在部门
receiptAmount MonetaryAmount 费用金额
approvedConsumeAmount MonetaryAmount 付款金额
taxAmount MonetaryAmount 税额(合计)
taxDeductionAmount MonetaryAmount 抵扣税额
settleType String 结算方式(个人垫付、企业支付、月结支付、事后统一结算、事后兑换积分)
corpType String 业务场景(个人报销、对公全部到票、对公未到票、对公核销)
dynaTags List<DynaTag> 标签
sourceType String 费用来源(记费用、第三方平台)
reimburseCode String 关联单号
corpExpenseResponsibleUsers List<CoverUserDto> 责任人
budgetFailReason String 预算占有失败原因
comments String 费用备注

MonetaryAmount

参数名称 类型 描述
amount BigDecimal 金额
currency String 币种

DynaTag

参数名称 类型 描述
bizCode String 标签外码
label String 标签
labelEn String 标签英文名
labelZh String 标签中文名
color String 标签颜色
preDefinedTag Boolean 是否免审标签
tagType String 标签类型(预定义标签:"PRE_DEFINED"、自定义标签:"CUSTOM_DEFINED")

参数样例

{
  "code": "ACK",
  "message": null,
  "data": {
    "total": 49,
    "offset": 0,
    "pageSize": 0,
    "list": [
      {
        "code": "FD2512291EPSE6FY",
        "expenseTypeName": "税额",
        "expenseTypeCode": "ET2511161PP950UZ",
        "reimburseStatus": "报销中",
        "createdAt": 1767057182886,
        "consumeTime": {
          "currentTime": 1767057181184,
          "timeRange": null,
          "currentTimeStr": null
        },
        "userName": "XX",
        "employeeId": "XXXX",
        "legalEntityName": "每时每刻有限公司3",
        "departmentName": "杭州每时每刻有限公司",
        "receiptAmount": {
          "amount": 1.00,
          "currency": "CNY",
          "customExchangeRate": 1,
          "amountStr": "¥1.00"
        },
        "approvedConsumeAmount": {
          "amount": 1.00,
          "currency": "CNY",
          "customExchangeRate": 1,
          "amountStr": "¥1.00"
        },
        "taxAmount": {
          "amount": 0.00,
          "currency": "CNY",
          "customExchangeRate": 1,
          "amountStr": "¥0.00"
        },
        "taxDeductionAmount": null,
        "settleType": "personal_advance",
        "corpType": "个人报销",
        "dynaTags": [
          {
            "bizCode": "BILL_INVOICE_EXPENSE",
            "color": "#FFAB00",
            "label": "月结发票",
            "labelEn": "bill invoice expense",
            "labelZh": "月结发票",
            "name": "月结发票",
            "preDefinedTag": false,
            "tagType": "PRE_DEFINED"
          }
        ],
        "sourceType": "记费用",
        "reimburseCode": "MK25120153",
        "corpExpenseResponsibleUsers": null,
        "budgetFailReason": null,
        "comments": ""
      }
    ],
    "hasNextPage": true
  },
  "requestId": null,
  "errorCode": null,
  "success": true
}

修改记录

2025-12-30  新增费用台账查询接口文档
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-02-25 08:20:09

results matching ""

    No results matching ""

    results matching ""

      No results matching ""