滴滴企业版

接口说明

说明

用于删除滴滴ES后台人员信息

基本信息

HTTP URL	/river/Member/del
HTTP Method	POST
权限要求

请求头

参数名称	参数值
Content-Type	application/json

请求参数

字段名	字段说明	字段类型	必填	备注
client_id	申请应用时分配的AppKey	string	Y
access_token	授权后的access token	string	Y
company_id	企业ID	string	Y
timestamp	当前时间戳(精确到秒级)	int	Y
sign	签名	string	Y
member_id	员工在滴滴企业的ID	string	N	员工在滴滴企业的ID（同员工新增接口中返回的id；删除多个员工时，员工号需要以"_"隔开，一次最多删除100条）member_id与employee_number同时存在以member_id为准。
employee_number	员工工号	string	N	员工在滴滴企业的工号，json 字符串（一次最多删除100条），member_id和employee_number，employee_phone，employee_email仅有一个生效，不能同时为空，member_id 优先级最高, 示例： [\"D1001\", \"D1002\", \"D1003\"]，员工的工号，手机号，邮箱多个存在时，以手机号优先级大于工号，工号优先级大于邮箱处理，且不同关于memberid,使用非memberid请求时，对于不存在的员工信息，不会报错。请求一个不存在的员工编号，仍会返回成功。
employee_phone	员工手机号	string	N	员工在滴滴企业的手机号，json 字符串（一次最多删除100条），member_id和employee_number，employee_phone，employee_email仅有一个生效，不能同时为空，member_id 优先级最高,手机号支持海外手机号格式：+86 13700000000. 示例: "[\"18012345678\",\"+86 00012014076\"]"
employee_email	员工邮箱	string	N	员工在滴滴企业的邮箱，json 字符串（一次最多删除100条），memmember_id和employee_number，employee_phone，employee_email仅有一个生效，不能同时为空，member_id 优先级最高,

请求示例

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":"4595547807125341222_4596091316915930212","sign":"7473eb9bff6e1aa352dd2e433ed1924a"}' \
https://api.es.xiaojukeji.com/river/Member/del

响应参数

字段名	字段说明	字段类型	备注
errno	错误编码	string	数字 0 表示成功，非0 表示失败
errmsg	错误信息	string	errno=0时为常量"SUCCESS"，errno!=0时为错误信息
data	返回值对象	object

响应示例

全部删除

{
    "errno":0,
    "errmsg":"success",
    "data":[
        2992137043884639000,
        2992137043884639000,
        2992137043884639000
    ]
}

部分删除

{
    "errno":0,
    "errmsg":"以下员工有未结束或未支付订单:2992137043884639250_2992137043884639251_2992137043884639252",
    "data":[
        2992137043884639000,//成功的数据
        2992137043884639000,
        2992137043884639000
    ]
}

使用电话部分删除

{
    "errno": 0,
    "errmsg": "以下员工删除失败:我们已将00012014076设为离职,离职员工不能继续企业支付用车, 原因：有1笔用车订单未完结，不能删除(+86 00012014076)",
    "data": [
        "18012345678"//成功的数据
    ],
    "request_id": "+xvHWIzBGl3h+v3n4ZG7gxrQYgQg+7rQwsZNk06\/oPFPTiaKdPRtB6tJtD2PlcXR"
}

错误码

通用错误解决方案

4xx 错误

1xxx 错误

员工删除失败的可能原因

删除的员工id不存在

初始管理员不能删除(如果想要删除初始管理员，需要先将管理员权限转让给其他人，然后再删除)

删除的员工有待报销单或未支付的订单

删除的员工已离职

版本记录

日期	更新人	更新内容	上线时间
2023.11.07	陈继诗	迁移文档
2023.11.10	陈继诗	请求增加employee_number字段	2024.01.04
2025.06.18	杨露佳	请求增加employee_phone，employee_email	2025.06.18