# 用户和员工修改

# 接口地址

/merchant/user/updateUserOrEmployeeInfo

# 入参

# 字段说明

名称	类型	必填	示例	描述
employeeId	String	是	"19120923409303999291"	被修改人的员工id
modifier	String	是	"18113334512630726541"	修改人的用户id。建议使用权限较大的用户作为修改人。修改人最好满足以下条件： 1、建议使用超管或者主店主账户。 2、修改人最好有所有门店的数据权限，否则调用可能会报没有权限的错（当被修改人的_门店权限超出修改人的范围时）。_ _3、管理范围最好是 "全公司"。否则调用可能会报没有权限的错（如果修改人的管理范围是 "所属部门及下级"，当被修改人的部门范围超出修改人的部门范围时）。 4、要有通讯录的权限（通讯录该用户可见）。通讯录中门店权限和管理范围的设置位置参见 __图1_
modifiedTime	Date	否	"2022-09-01 00:00:00"	修改时间。如果不填写，则接口自动使用调用时间作为修改时间。
departmentIdList *注	List	否	["19133","21091"]	新的部门id列表（用户或者未开通用户的员工都可修改）用户的部门将被该入参重置。
roleId *注	String	否	"12789"	新的角色id（仅用户可修改）用户的角色将被该入参重置。
orgPermissionList_*注_	List	否	["19120923409303999291","19120923409303999292"]	新的门店数据权限（仅用户可修改）用户的门店权限将被该入参重置。
defaultOrgId *注	String	否	"19120923409303999291"	默认管理门店（仅用户可修改）用户的默认管理门店将被该入参重置。

*注）__本接口只支持修改这四个属性（部门列表、角色、门店数据权限、默认管理门店），调用时这四个参数至少填写一个，否则调用返回result=false。

*图1）

# JSON示例

{
    "paramValues": [
        {
            "employeeId": "19120923409303999291",
            "modifier":"18113334512630726541",
            "modifiedTime":"2020-04-10 21:40:00",
            "departmentIdList": ["19133","21091"],
            "roleId": "12789",
            "orgPermissionList": ["19120923409303999291","19120923409303999292"],
            "defaultOrgId": "19120923409303999291"
        }
    ]
}

# 出参

# 字段说明

名称	类型	示例	描述
result	boolean	true	true：调用成功 false: 调用失败
message	String	"不允许创建门店权限比自己高的用户"	错误消息

错误消息说明

假设修改人为用户A，被修改人为用户B。公司下有门店1，门店2，门店3。

	错误场景	错误消息
1	A的门店数据权限是[门店1,门店2],B的门店数据权限是[门店1,门店2,门店3]，此时调用本接口修改用户属性，则报错。	不允许创建门店权限比自己高的用户
2	B的门店数据权限是[门店1,门店2]，且传入的默认管理门店是[门店3]，此时调用接口修改默认管理门店，则报错。	默认管理门店不在门店权限列表范围内，请重新选择
3	如果B是门店1的门店负责人，则用户B的门店数据权限中必须包含门店1。如果此时传入门店数据权限[门店2]去修改B的门店数据权限为门店2，则报错。	用户为【门店1】的负责人，门店权限必须包含该门店
4	门店2的账户限制数为5，此时门店2下已经有5个用户（默认管理门店是门店2的用户数）。如果此时调用接口修改B的默认管理门店为门店2，则报错	门店账号数上限5个，目前启用账号数5个已达上限
5	只有超管角色的用户才能给其他用户赋予超管的角色。如果A不是超管，此时想给B赋予超管角色，则报错。	不允许创建角色比自己高的用户
6	四个属性值都是空，没有传入修改的内容。此时调用接口，则报错	用户没有需要变更的内容。
7	试图修改主店主账户时，调用接口，则报错。	主店主账户不允许被修改。
8	修改人没有通讯录权限，看不到通讯录时，调用接口，则报错。	修改人没有修改员工的权限。
9	传入的员工id没有开通用户，但是却尝试调用接口去修改角色、默认管理门店或者门店数据权限，则报错。	可以更新员工的部门属性。但是由于员工未开通用户，不能更新用户属性。
10	入参中必填项缺失。	提示入参中字段缺失的错误。
11	接口调用频率超过1秒1次，则触发限流。	接口请求太过频繁，触发限流。

# JSON示例

{
    "code": 200,
    "data": {
      "result": false,
      "message": "主店主账户不允许被修改。"
    },
    "message": "SUCCESS"
}

← 员工列表替换门店负责人 →