browser-docs-archive/repos/skill-hub/skills/ziniao-erp-api-doc/reference/department-staff.md

部门员工管理接口

本文件是 ziniao-erp-api-doc 的 Level 2 参考文档。 仅在需要查阅部门增删改查移动、员工新增/修改/查询/启禁用、部门变更接口时加载。

所有接口方法均为 POST。

---

ERP-部门查询

• 路径：/superbrowser/rest/v1/erp/department/list　权限点：ERP-部门与员工接口

参数	说明	必须	类型
companyId	公司id	是	number

响应 data：数组，每项含 id(number)、name(string)、hierarchy(number 层级)、parentId(number)、ordering(number)。另有 count。

---

ERP-部门新增

• 路径：/superbrowser/rest/v1/erp/department/add　权限点：ERP-部门与员工接口

参数	说明	必须	类型
companyId	公司id	是	number
name	部门名称	是	string
hierarchy	部门级别	是	string
parentId	父级部门id	是	string

响应 data：含 id(string 部门id)。

---

ERP-部门修改

• 路径：/superbrowser/rest/v1/erp/department/update　权限点：ERP-部门与员工接口

参数	说明	必须	类型
companyId	公司id	是	number
id	部门id	是	number
name	部门新名称	否	string
parentId	父部门id	否	number

响应：ret / status / msg

---

ERP-部门删除

• 路径：/superbrowser/rest/v1/erp/department/delete　权限点：ERP-部门与员工接口

参数	说明	必须	类型
companyId	公司id	是	string
id	部门id	是	string

响应：ret / status / msg

---

ERP-部门移动

• 路径：/superbrowser/rest/v1/erp/department/order　权限点：ERP-部门与员工接口

参数	说明	必须	类型
companyId	公司id	是	number
parentId	父部门id	是	string
order	更新后的部门顺序（部门id数组）	是	string[]

响应：ret / status / msg

---

ERP-员工查询

• 路径：/superbrowser/rest/v1/erp/staff/list　权限点：ERP-部门与员工接口

参数	说明	必须	类型
companyId	公司id	是	number
page	页码	是	number
limit	每页条数	是	number
username	用户账号	否	string
name	真实姓名	否	string
departmentIds	部门id数组	否	number[]
level	角色类型（0boss/1经理/2员工/3超管）	否	string
delflag	0正常 1禁用 2删除（不传全部）	否	string
isAccurate	0模糊 1精确（默认0）	否	number

响应 data：含 username、userId、name、level、mobile、delflag、authPhone (均 string)。另有 count。

---

ERP-员工新增v2

• 路径：/superbrowser/rest/v2/erp/staff/add　权限点：ERP-部门与员工接口

参数	说明	必须	类型
companyId	公司id	是	string
nickname	用户账号	是	string
name	真实姓名	是	string
password	密码	是	string
mobile	手机号	否	string
departmentIds	部门id数组	是	string[]
roleId	角色id	是	number
authDevide	设备授权方式（1/2/3/4）	是	number
isUpdatePersonInfo	1允许修改个人信息 0不允许	是	number
isLimitLogin	0否 1是	是	number
isTwoStepVerify	0否 1是	是	number
authClient	登录终端控制对象	是	object
authClient.allowLoginWindows	1允许 0不允许	是	string
authClient.allowLoginMac	1允许 0不允许	是	string
authClient.allowLoginAndroid	1允许 0不允许	是	string
authClient.allowLoginWeb	1允许 0不允许	是	string
authClient.allowLoginIos	1允许 0不允许	是	string
authClient.allowLoginMiniprog	1允许 0不允许	是	string
authClient.allowLoginLinux	1允许 0不允许	否	string
loginLimitStartTime	HH:mm（分钟仅00或30）	否	string
loginLimitEndTime	HH:mm	否	string
loginLimitStartDate	yyyy-MM-dd	否	string
loginLimitEndDate	yyyy-MM-dd	否	string
enablePhoneLogin	0否 1是	否	number

响应：含 id(用户id)、password(string)。

---

ERP-员工修改v2

• 路径：/superbrowser/rest/v2/erp/staff/modify　权限点：ERP-部门与员工接口

参数结构与「员工新增v2」基本一致，差异：

• 新增 id(string, 必须) — 用户id
• 多数字段变为非必须（不传不更新）
• 新增 isResetAuthPhone(number) — 1重置登录手机号 0不重置
• areaCode 和 authPhone 已废弃

响应：ret / status / msg

---

ERP-员工启用禁用接口

• 路径：/superbrowser/rest/v1/erp/staff/status　权限点：ERP-部门与员工接口

参数	说明	必须	类型
companyId	公司id	是	number
staffIds	用户id数组	是	string[]
status	0启用 1禁用 2删除	是	string

响应：ret / status / msg

---

ERP-用户的部门变更

• 路径：/superbrowser/rest/v1/erp/staff/department　权限点：ERP-用户的部门变更

参数	说明	必须	类型
companyId	公司id	是	string
staffIds	用户id列表	是	number[]
departmentIds	部门id列表	是	number[]

响应：ret / msg / status