修改
优质
小牛编辑
136浏览
2023-12-01
请求地址
https://api.es.xiaojukeji.com/river/Member/edit
返回数据格式
JSON
请求方式
POST
是否需要登录
是 关于登录授权，参见 如何登录授权
访问授权限制
暂无
请求参数
| 名称 | 类型 | 必选 | 描述 |
| client_id | string | yes | 申请应用时分配的AppKey |
| access_token | string | yes | 授权后的access token |
| timestamp | bigint | yes | 当前时间戳 |
| company_id | bigint | yes | 企业ID |
| member_id | bigint | yes | 员工在滴滴企业的ID（同员工新增接口中返回的id） |
| data | string | yes | 员工数据json格式 |
| sign | string | yes | 签名 |
员工信息
| 名称 | 类型 | 必选 | 描述 |
| phone | string | no | 员工手机号 |
| realname | string | no | 员工姓名 |
| employee_number | string | no | 员工ID（员工在公司的员工号） |
| string | no | 邮箱 | |
| department | string | no | 部门名称（老），后续此参数会去掉 |
| branch_name | string | no | 所在分公司名称（老），后续此参数会去掉 |
| system_role | int | no | 系统角色(0-车辆预定人员，1-普通管理员，2-超级管理员) |
| role_ids | string | no | 角色（默认为员工），通过角色获取API 。可以填多个，以_分隔。初始管理员、主管不支持新增 |
| immediate_superior_phone | string | no | 员工直属上级的手机号码（需为本企业中已存在账号），直属上级可在审批流中担任审批人 |
| residentsname | string | no | 常驻地中文 |
| use_company_money | int | no | 是否企业支付余额（0-否，1-是） |
| total_quota | string | no | 每月配额(单位：元，可为小数) |
| is_remark | int | no | 叫车时备注信息是否必填(0-选填，1-必填，2-按制度填写) |
| budget_center_id | bigint | no | 所在部门ID（新），默认为1（企业）。通过成本中心查询api获取id（类型为1） |
| regulation_id | string | no | 用车制度ID（从 9.1用车制度查询 中选取，可以填多个，以_分隔，如 123_456_789）注:如不传用车制度ID,无法使用企业支付 |
| project_ids | string | no | 所在项目ID（新）。可以填多个，以_分隔。通过成本中心查询api获取id（类型为2） |
| set_dismiss_time | string | no | 设置员工离职日期，到期后自动加入已离职名单，不传或为空时认为不设置离职时间，格式为 "2018-07-01“ |
| invoice_info | string | no | 开票主体信息，必须为json串，且需包含taxpayer_subject(纳税人主体) |
注意事项
参数data为json格式，如:
{
"email":"yanqing2@didichuxing.com",
"department":"QA",
"branch_name":"TEST",
"system_role":0,
"set_dismiss_time":"2018-07-01"
}
设置员工离职日期字段 set_dismiss_time，离职时间默认为日期当天23时59分。
请求示例
curl -X POST -H "content-type:application/json" \
-d '{"client_id":"client_id_test","access_token":"access_token_test","timestamp":"1565875844","company_id":"12345678980","member_id":"112345678980","data":"{\"realname\":\"\u5f20\u4e09\",\"employee_number\":\"D123456\",\"email\":\"1234@test.com\"}","sign":"7473eb9bff6e1aa352dd2e433ed1924a"}' \
https://api.es.xiaojukeji.com/river/Member/edit
返回示例
{
"errno":0,
"errmsg":"SUCCESS",
"data":null
}
接口错误解决方案
通用错误解决文档
- 4xx 错误
- 1xxx 错误
50221(member_id错误(该员工信息不存在))
- company_id没有对应的管理员，检查company_id填写正确，或者是否已被解散
- 需要编辑的员工为管理员
50222(员工与指定的企业不匹配)
- 员工是否已被删除
- 员工id和company_id是否在同一企业
50223(员工信息更新失败(xxxxx))
原因可能如下：
- 员工不存在(仔细检查member_id是否填写正确)
- 只有正常状态下的员工才可以被编辑(仔细检查员工是否已被删除)
- 手机号已存在(检查更新信息中的手机号是否其他员工手机号)
- 更新的离职时间需晚于今天
50224(员工存在未支付的订单,请先联系其支付)
- 如果员工手机号修改了，会先判断之前的手机号是否有未支付的订单