员工接口
获取员工预算列表
URL: GET /staff/budget/list?page=1
Query:
| 字段 | 必填 | 说明 |
|---|---|---|
| page | 否 | 页码，从1开始 |
| size | 否 | 每页大小 |
| search | 否 | 搜索关键词 |
| status | 否 | 状态 |
| user_id | 否 | 用户ID |
| employee_id | 否 | 员工ID |
输出: list<StaffBudget>
StaffBudget
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | id |
| user_id | string | 用户id |
| username | string | 用户名 |
| company_name | string | 公司名称 |
| person_name | string | 个人名称 |
| title | string | 名称 |
| amount | number | 预算金额, 单位元 |
| status | string | 状态, NORMAL正常, SUSPENDED已停用 |
| manager_id | string | 管理员工id |
| manager_name | string | 管理员工名称 |
| total_consume | number | 累计消费, 单位元 |
| total_consume_count | number | 累计消费笔数 |
| card_count | number | 关联卡数量 |
| created_at | string | 创建时间 |
| updated_at | string | 更新时间 |
新增预算
URL: POST /staff/budget/create
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 用户id |
| title | string | 是 | 名称 |
| amount | number | 是 | 预算金额 所有金额都是整数且精确到分，如1850，表示18.5元 |
| manager_id | string | 是 | 管理员工id |
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 预算id |
更新预算
URL: POST /staff/budget/{budget_id}/update
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 是 | 名称 |
输出: 无
预算充值
注意: 当前仅支持从钱包充值
URL: POST /staff/budget/{budget_id}/recharge
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| amount | number | 是 | 充值金额 所有金额都是整数且精确到分，如1850，表示18.5元 |
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| budget_amount | number | 预算新金额, 单位元 |
| wallet_balance | number | 钱包新余额, 单位元 |
预算转出
注意: 当前仅支持转出到钱包
URL: POST /staff/budget/{budget_id}/transfer_out
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| amount | number | 是 | 转出金额 所有金额都是整数且精确到分，如1850，表示18.5元 |
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| budget_amount | number | 预算新金额, 单位元 |
| wallet_balance | number | 钱包新余额, 单位元 |
修改预算状态
URL: POST /staff/budget/{budget_id}/change_status
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | string | 是 | 状态, NORMAL正常, SUSPENDED已停用 |
输出: 无
删除预算
URL: POST /staff/budget/{budget_id}/delete
输入: 无
输出: 无
获取员工列表
URL: GET /staff/employee/list?page=1
Query:
| 字段 | 必填 | 说明 |
|---|---|---|
| page | 否 | 页码，从1开始 |
| size | 否 | 每页大小 |
| search | 否 | 搜索关键词 |
| status | 否 | 员工状态 |
| employee_type | 否 | 员工身份, NORMAL普通员工, BUDGET_MANAGER预算管理员 |
| main_user_id | 否 | 主帐号id |
输出: list<Employee>
Employee
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | id |
| main_user_id | string | 主帐号id |
| main_user_username | string | 主帐号用户名 |
| main_user_company_name | string | 主帐号公司名称 |
| main_user_person_name | string | 主帐号个人名称 |
| username | string | 邮箱/用户名 |
| role | string | 角色 |
| area_code | string | 手机区号, 如852 |
| mobile | string | 手机号，如13900000000 |
| employee_name | string | 员工名 |
| employee_type | string | 员工身份, NORMAL普通员工, BUDGET_MANAGER预算管理员 |
| status | string | 员工状态, NORMAL正常, SUSPENDED已停用 |
| employee_remark | string | 员工备注 |
| employee_card_count | number | 关联卡数 |
| employee_total_consume | number | 累计消费, 单位元 |
| last_login | string | 最后登录时间 |
| created_at | string | 创建时间 |
| updated_at | string | 更新时间 |
编辑员工
URL: POST /staff/employee/{employee_id}/update
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| username | string | 是 | 邮箱(用户名) |
| area_code | string | 是 | 手机区号, 如852 |
| mobile | string | 是 | 手机号，如13900000000 |
| employee_name | string | 是 | 员工名 |
| employee_type | string | 是 | 员工身份, NORMAL普通员工, BUDGET_MANAGER预算管理员 |
| employee_remark | string | 否 | 员工备注 |
| password | string | 否 | 密码如果不填，表示不更新密码 |
| card_ids | list<string> | 否 | 关联员工卡id列表 |
输出: 无
修改员工状态
URL: POST /staff/employee/{employee_id}/change_status
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | string | 是 | 员工状态, NORMAL正常, SUSPENDED已停用 |
输出: 无
删除员工
URL: POST /staff/employee/{employee_id}/delete
输入: 无
输出: 无