请求地址

https://api.es.xiaojukeji.com/river/Member/edit

返回数据格式

JSON

请求方式

POST

是否需要登录

是 关于登录授权，参见 如何登录授权

访问授权限制

暂无

请求头格式

Cntent-Type:application/json

请求参数

名称 类型 必选 描述
client_id string yes 申请应用时分配的AppKey
access_token string yes 授权后的access token
timestamp bigint yes 当前时间戳(精确到秒级)
company_id string yes 企业ID
member_id bigint yes 员工在滴滴企业的ID（同员工新增接口中返回的id）
data string yes 员工数据json格式
has_card_info int no data 中是否包含证件信息，0：不包含，1：包含， 当data中包含证件信息时，此字段必须传1
sign string yes 签名

员工信息

名称 类型 必选 描述
phone string no 员工手机号(手机号支持修改,修改后员工ID不变)
realname string no 员工姓名
employee_number string no 员工ID（员工在公司的员工号）
email string no 邮箱
system_role int no 系统角色(0-车辆预定人员，1-普通管理员，2-超级管理员)tip：老接口不再使用，建议使用role_ids更新角色
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, 获取方式 通过成本中心查询api获取ID（类型为1）,如需传参需填入部门ID
regulation_id string no 用车制度ID（获取方式，可以填多个，以_分隔，如 123_456_789）
注:若该员工的所有制度都是在es后台通过部门/职级/全员方式分配，则员工身上的制度字段不用传；同时注意检查use_company_money字段是否传输，制度和企业支付权限都有才能企业支付。
传空清空指定该员工可用的制度
project_ids string no 所在项目ID（新）。可以填多个，以_分隔。通过成本中心查询api获取id（类型为2）
set_dismiss_time string no 设置员工离职日期，到期后自动加入已离职名单，不传或为空时认为不设置离职时间，格式为 "2018-07-01“
invoice_info string no 开票主体信息，必须为json串，且需包含taxpayer_subject(纳税人主体)
legal_entity_id string no 滴滴侧公司主体 ID，获取方式
rank_id string no 滴滴侧职级 ID，获取方式
out_rank_id string no 外部职级ID，当 rank_id 和 out_rank_id 同时存在时，以 rank_id 为主
english_surname string no 英文姓，长度不大于26个字符，且只支持数字、字母、下划线和空格
english_name string no 英文名，长度不大于26个字符，且只支持数字、字母、下划线和空格
nickname string no 昵称
sex int no 性别，0.不填 1.男 2. 女，默认为0
birth_date string no 出生日期，格式2000-01-01（需用AES算法加密）
card_list []object no 证件信息(不传不变，传空表示清空，传证件信息则覆盖原始证件信息)

证件信息(card_list每个记录的字段)

名称 类型 必选 描述
card_type int yes 证件类型:
1. 身份证
2. 护照
3. 港澳台居民居住证
4. 台胞证
5. 军官证
6. 回乡证
7. 外国人永久居留身份证
8.往来港澳通行证
9. 公务护照
10. 外交护照
11.其他
card_no string yes 证件号码（需用AES算法加密）
expire_date string no 证件过期日期，格式：2050-01-01（需用AES算法加密）

注意事项

参数data为json格式，如:

{
    "email":"yanqing2@didichuxing.com",
    "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
}

接口错误解决方案

通用错误解决文档

  1. 4xx 错误
  2. 1xxx 错误

50221(member_id错误(该员工信息不存在))

  1. company_id没有对应的管理员，检查company_id填写正确，或者是否已被解散
  2. 需要编辑的员工为管理员

50222(员工与指定的企业不匹配)

  1. 员工是否已被删除
  2. 员工id和company_id是否在同一企业

50223(员工信息更新失败(xxxxx))

原因可能如下：

  1. 员工不存在(仔细检查member_id是否填写正确)
  2. 只有正常状态下的员工才可以被编辑(仔细检查员工是否已被删除)
  3. 手机号已存在(检查更新信息中的手机号是否其他员工手机号)
  4. 更新的离职时间需晚于今天

50224(员工存在未支付的订单,请先联系其支付)

  1. 如果员工手机号修改了，会先判断之前的手机号是否有未支付的订单

results matching ""

    No results matching ""