erpnew/api_v2/user_quick_create.md

快速创建员工用户 API

• URL: POST /api/v2/users/quick-create/
• 说明: 一次性创建 Django User 与 basic_info.Employee 并建立关联，为前端提供统一的员工开通入口。
• 权限: 需要登录（任意已绑定员工的用户）。

请求体

字段	类型	必填	说明
username	string	是	登录名，全局唯一
password	string	是	至少 6 位密码
display_name	string	是	员工姓名，同时写入 User.first_name
merchant_id	int	是	员工所属商户
email	string	否	邮箱
mobile	string	否	联系电话
area	string	否	区域信息
description	string	否	备注
status	enum	否	员工状态，默认 active

响应示例

{
  "user": {
    "id": 12,
    "username": "new_user",
    "display_name": "新员工"
  },
  "employee": {
    "id": 45,
    "name": "新员工",
    "status": "active",
    "merchant": 3
  }
}

失败响应

• 400 用户名已存在
• 400 商户不存在
• 401 未认证