费用类型导入接口

说明

该接口用于客户批量导入费用类型。

注意事项

接口地址

/api/openapi/expense/type/import

请求类型

  1. 该接口为全部失败,在进行费用类型导入时,如果有一条费用类型导入失败,将会导致全部失败,返回全部失败的费用类型信息
  2. 每次导入最大值为10条费用类型,导入过多费用类型时,直接抛出异常
POST

请求参数

参数说明

字段名称 字段类型 是否必填 字段说明
reqList List<expenseType> 是 费用类型列表

expenseType

字段名称 字段类型 是否必填 字段说明
expenseTypeName String 是 费用类型名称
expenseTypeCategoryName String 是 所属分类名称
expenseTypeEnName String 否 费用类型英文名
bizPrefixCode String 否 编码前缀
bizSuffixCode String 否 编码
notSubjectApplicationQuotaLimit boolean 否 该费用类型不受申请单额度控制
personExpense boolean 否 是否用于对私报销场景
corpExpense boolean 否 是否用于对公报销场景
personExpenseScene boolean 否 默认支付场景
enable boolean 否 启用状态
sort int 否 费用类型顺序,默认为999
auxiliaryExpenseTypeBizCodeList List<String> 否 可选的辅助费用类型完整业务编码列表

auxiliaryExpenseTypeBizCodeList 仅接受当前企业中已存在费用类型的完整业务编码。该字段采用 presence 语义:

  • 字段缺失或值为 null:本次请求不设置辅助费用类型范围(scopePresent=false)。
  • 显式传入空数组 []:明确清空范围配置(scopePresent=true);对于当前只新增的导入接口,新建费用类型不限制辅助费用类型。
  • 传入非空数组:将列表中的完整业务编码设置为可选辅助费用类型范围。

如列表中存在无效编码,对应行返回以下精确错误:填写的辅助费用类型编码不在系统内,请检查。

参数样例

{
  "reqList": [
    {
      "expenseTypeName": "zz-exp01",
      "expenseTypeCategoryName": "zz-zone",
      "personExpense": true,
      "corpExpense": true,
      "bizPrefixCode": "zz-",
      "bizSuffixCode": "0023",
      "notSubjectApplicationQuotaLimit": true,
      "enabled": false,
      "personExpenseScene": false,
      "sort": 1,
      "auxiliaryExpenseTypeBizCodeList": ["TRAVEL-001", "TRAVEL-002"]
    }
  ]
}

响应参数

成功参数样例

{
  "code": "ACK",
  "message": "操作成功",
  "data": [
    {
      "index": 1,
      "saveSuccess": true,
      "errorMsg": null,
      "expenseTypeCode": "ET000xxxxxx1"
    }
  ],
  "errorCode": null,
  "success": true
}

失败参数样例

{
  "code": "NACK",
  "message": "操作失败",
  "data": [
    {
      "index": 1,
      "saveSuccess": false,
      "errorMsg": "费用类型名称不能为空",
      "expenseTypeCode": null
    }
  ],
  "errorCode": null,
  "success": false
}
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-09-23 10:19:53

results matching ""

    No results matching ""

    results matching ""

      No results matching ""