单据小类查询接口
业务场景说明
该接口用于根据员工工号查询该员工有权限使用的单据小类列表，支持按单据类型筛选和分页查询。返回结果仅包含已启用且员工可见的单据小类基础信息。
注意事项
- employeeId 为必填参数，需传入有效的员工工号
- 若员工已离职，接口将返回错误提示
- 返回的单据小类仅包含该员工所在部门及用户组有权限查看的单据小类
- 单据小类可见性取决于单据小类配置的可见范围设置
接口限制
10次/秒/企业
接口地址
/api/openapi/form/subtype/query
请求类型
POST
请求参数
参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| employeeId |
String |
是 |
员工工号 |
| formType |
String |
否 |
单据类型，不传则返回所有类型。可选值：REIMBURSE（报销单）、PRECONSUME（申请单）、LOAN（借款单）、CONTRACT（合同）、REPAYMENT（还款单） |
| pageNo |
int |
否 |
页码，默认值1 |
| pageSize |
int |
否 |
分页条数，默认值100 |
参数样例
{
"employeeId": "MK001",
"formType": "REIMBURSE",
"pageNo": 1,
"pageSize": 20
}
响应参数
响应参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| hasNextPage |
boolean |
是 |
是否有下一页 |
| list |
List<FormSubTypeDto> |
是 |
单据小类列表 |
| 字段名称 |
字段类型 |
字段说明 |
| code |
String |
单据小类编码 |
| bizCode |
String |
单据小类业务编码 |
| nameZh |
String |
单据小类中文名称 |
| nameEn |
String |
单据小类英文名称 |
| formType |
String |
单据类型 |
| categoryName |
String |
单据小类分类名称，根据请求语言环境自动返回中文名称或英文名称 |
响应参数示例
正常响应
{
"code": "ACK",
"message": "",
"data": {
"hasNextPage": true,
"list": [
{
"code": "FST001",
"bizCode": "RMBX001",
"nameZh": "差旅报销",
"nameEn": "Travel Reimbursement",
"formType": "REIMBURSE",
"categoryName": "出差"
},
{
"code": "FST002",
"bizCode": "RMBX002",
"nameZh": "日常报销",
"nameEn": "Daily Reimbursement",
"formType": "REIMBURSE",
"categoryName": "日常"
}
]
}
}
异常响应
{
"code": "NACK",
"message": "员工工号不存在:MK999",
"data": null
}
修改记录
2026-04-15 新增单据小类查询接口