业务接口错误码

全局错误码

错误码	错误说明	排查方法
500	服务器内部错误（此错误码为目前唯一不是5位数字的错误码）
10001	认证错误：请提供正确的access_token ~~~~
10010	企业微信api调用错误，具体错误提示和企业微信侧的错误码见errmsg中提示
10041	body 参数类型错误。具体错误字段会在 errmsg 中提示
10042	缺少必填的 query 或 body 参数。具体缺少的字段会在errmsg中提示
10043	列表长度参数（offset）超出查询条目总数(total)
10044	列表长度参数（offset）超过最大100000000限制
10045	列表长度参数（limit）超过最大限制，具体限见文档对应字段描述
10046	列表偏移参数（offset）必须为正数
10047	列表长度参数（limit）必须为正数
10048	时间参数必须为10位或13位的时间戳
10049	请求参数错误，详细信息可以在 `errors` 中查看
10050	资源不存在
10051	服务器正忙,请稍后再试
10052	并发访问超过限制（详情请查看openapi文档-访问频率限制）
10053	api访问超过限制（详情请查看openapi文档-访问频率限制）
10054	corp_id受限，详情请联系客服
30001	无效的external_user_id
30002	不合法的external_user_id列表
30003	不合法的external_user_id列表长度	查看帮助

错误码：30003

不合法的external_user_id列表长度。确认：

1）批量获取客户积分接口，最多指定100人。

获取访问凭据

错误码	说明
20101	secret 或 corp_id 非法
20102	未同意Api接口使用条款，禁止使用，请移步微伴后台-API-阅读OpenAPI使用条款-同意使用条款以获取使用权限，详情参考OpenAPI基本介绍

根据加入时间获取客户列表

错误码	说明
20201	staff_id 错误，找不到对应员工
20202	type 不合法
20202	order 不合法

获取流失客户列表

错误码	说明
20201	staff_id 错误，找不到对应员工
20202	type 不合法
20202	order 不合法

根据信息变更时间获取客户列表

错误码	说明
20201	order 错误，找不到对应员工
20202	staff_id 不合法
20203	type 不合法

获取客户详情

错误码	说明
20206	id 错误，找不到对应客户
20207	unionid 错误，找不到对应客户
20208	unionid 和 id 必须至少提供一个

获取客户所在群聊

错误码	说明
20206	id 错误，找不到对应客户
20207	unionid 错误，找不到对应客户
20208	unionid 和 id 必须至少提供一个

获取群聊详情

错误码	说明
20209	group_chat_id非法，不存在对应群聊

导入客户信息

错误码	说明
20210	客户external_user_id错误
20211	客户unionid错误
20212	请提供客户external_user_id或客户external_user_unionid
20213	员工与客户无关联
20214	external_user_fields格式有误
20215	自定义字段不存在
20216	该值内容长度超过500, 请重新修改
20217	下拉框的选项值不存在

添加客户评分

错误码	说明
20210	客户external_user_id错误
20211	客户unionid错误
20212	请提供客户id或客户unionid
20215	score必须为大于0的整数

external_user_id换unionid

错误码	说明
20216	传入ext_id列表大小超过1000

unionid换external_user_id

错误码	说明
20217	传入unionid_list列表大小超过1000

获取有赞订单列表

错误码	说明
20301	unionid 和 userid 必须至少提供一个

给客户添加企业标签

错误码	说明
20301	请同时提供标签组名称和标签名称
20350	external_user_id错误
20351	external_user_unionid错误
20352	请提供external_user_id或external_user_unionid
20353	找不到对应员工

给客户删除企业标签

错误码	说明
20301	请同时提供标签组名称和标签名称
20350	external_user_id错误
20351	external_user_unionid错误
20352	请提供external_user_id或external_user_unionid
20353	找不到对应员工

批量更新客户企业标签

错误码	说明
20350	add_tag_id_list和rm_tag_id_list不可同时为空
20351	最多允许批量添加或删除10个标签
20352	客户不存在或没有添加客服
20353	批量打标签失败
20354	add_tag_id_list中存在非法tag_id:{tag_ext_id},请检查并确保标签合法
20355	remove_tag_id_list中存在非法tag_id:{tag_ext_id},请检查并确保标签合法

给客户添加微伴个人标签

错误码	说明
20350	external_user_id错误
20351	external_user_unionid错误
20352	请提供external_user_id或external_user_unionid
20353	找不到对应员工

删除客户的微伴个人标签

错误码	说明
20350	external_user_id错误
20351	external_user_unionid错误
20352	请提供external_user_id或external_user_unionid
20353	找不到对应员工

添加预打标签任务

错误码	说明
20351	type错误
20352	请同时提供标签组名称和标签名称
20353	任务已存在,task_id为xxx。 task_id为预打标签在系统中的唯一id

批量预打企业标签

错误码	说明
20351	type错误

删除预打标签任务

错误码	说明
20355	task_id错误,预打标签任务不存

获取标签列表

错误码	说明
20356	access_token 不合法
20357	limit 不合法
20358	offset 不合法

获取员工会话

错误码	说明
20401	排序字段值错误，请输入"id_asc"或者"last_updated_desc"
20402	会话类型错误，请输入"ext_user"，"room"或"other_staff"

创建自定义客户事件

错误码	说明
20601	staff_id 错误，找不到对应员工
20602	external_user_id 错误
20603	external_user_unionid 错误
20604	请提供external_user_id或external_user_unionid
20605	content 不可为空
20606	title 长度超过32个字符限制
20607	custom_event_type_id对应事件类型不存在

删除自定义客户事件类型

错误码	说明
20607	custom_event_type_id对应事件类型不存在

更新自定义客户事件类型

错误码	说明
20607	custom_event_type_id对应事件类型不存在
20608	custom_event_type_name超出8字符长度限制
20609	该custom_event_type_name已存在
20610	custom_event_type_name不能为空
20611	custom_event_type_name不能与微伴基础事件类型重名

获取客户阶段状态

错误码	说明
20607	external_user_ids不能为空
20608	external_user_ids列表长度超过限制（50）
20609	未查询到任何客户阶段状态,请检查external_user_id是否合法或客户是否存在客户阶段

添加自定义客户事件类型

错误码	说明
20608	custom_event_type_name超出8字符长度限制
20609	该custom_event_type_name已存在
20610	custom_event_type_name不能为空
20611	custom_event_type_name不能与微伴基础事件类型重名
20612	自定义事件类型和微伴基础事件类型总数不能超过20个

发送员工通知

错误码	说明
20701	staff_id 错误，找不到对应员工
20702	msgtype 不合法
20703	content 不可为空

批量创建添加客户任务（原客户信息批量导入接口）

错误码	说明
20800	参数staff_ids错误,选择分配的员工不存在
20801	参数staff_id错误,操作员工不存在
20802	每次最多导入1000条客户数据
20803	参数customer_detail_list错误
20804	参数remark_name错误, 最大长度不能超过64
20805	参数phone_number错误，电话号码格式错误
20806	没有可以导入的数据,请检查参数customer_detail_list是否为空
20807	phone_number为[xxx、xxy] 的客户已存在，其他n个客户导入成功

获取渠道码列表

错误码	说明
20901	staff_id 错误，找不到对应员工
20902	order 不合法

订单信息同步

错误码	说明
21001	type错误

订单信息删除

错误码	说明
21005	订单不存在

订单信息批量同步

错误码	说明
21006	列表长度超过最大限制100

批量新建手机线索转化

错误码	说明
21101	线索添加失败，请重新添加
21102	找不到该员工
21103	线索不存在
21104	自定义字段不存在
21105	手机线索数量超过20的限制
21106	时间格式不正确
21107	电话号码不合法，不合法包括：（字母、文字、特殊字符）

获取拉新排行榜活动列表

错误码	说明
21201	获取拉新排行榜失败

新增素材

错误码	说明
21301	传递过来的标签id重复或不存在
21307	参数缺失
21308	mtype参数不正确，只能选择（"poster", "pdf", "word", "excel", "ppt"）

更新素材

错误码	说明
21303	素材不存在
21301	传递过来的标签id重复或不存在
21307	参数缺失
21308	mtype参数不正确，只能选择（"poster", "pdf", "word", "excel", "ppt"）

删除素材

错误码	说明
21303	素材不存在

添加素材库标签

错误码	说明
21304	添加素材标签条数最多为100条
21305	标签长度最大不能超过6
21306	标签名重复

获取企微任务宝对应的客户数据列表

错误码	说明
21401	main_misson_id错误，对应裂变活动不存在
21402	任务宝对应的活动id和af_type不匹配

获取企微任务宝任务详情

错误码	说明
21408	corp_id 错误，找不到对应的企业
21409	main_session_id 不合法
21410	finished 不合法
21411	order 不合法
21412	limit 不合法
21413	offset 不合法

获取员工个人群发记录结果列表

错误码	说明
21501	staff_id 错误，找不到对应员工
21502	msg_id 错误，找不到对应的群发记录
21503	msg_id 不能为空

获取群裂变活动列表

错误码	说明
21501	corp_id 错误，找不到对应的企业
21502	mission_status不合法
21503	start_time 不合法
21504	end_time 不合法
21505	order 不合法
21506	limit 不合法
21507	offset 不合法

获取群裂变任务详情

错误码	说明
21508	corp_id 错误，找不到对应的企业
21509	main_session_id 不合法
21510	finished 不合法
21511	order 不合法
21512	limit 不合法
21513	offset 不合法

获取群裂变客户详情列表

错误码	说明
21514	群裂变活动不存在
21515	获取群列表客户数据详情失败

获取群打卡活动列表

错误码	说明
21601	corp_id 错误，找不到对应的企业
21602	mission_status不合法
21603	start_time 不合法
21604	end_time 不合法
21605	order 不合法
21606	limit 不合法
21607	offset 不合法

获取群打卡任务详情

错误码	说明
21608	corp_id 错误，找不到对应的企业
21609	act_id 不合法
21610	phase 不合法
21611	order 不合法
21612	limit 不合法
21613	offset 不合法

获取雷达列表

错误码	说明
21701	互动雷达参数校验失败
21702	互动雷达查询失败

获取雷达详情

错误码	说明
21701	互动雷达参数校验失败
21702	互动雷达查询失败

添加雷达

错误码	说明
21701	参数校验失败
21702	数据库查询失败
21703	操作失败
21704	链接解析失败
21705	雷达标题已存在

修改雷达

错误码	说明
21701	参数校验失败
21702	数据库查询失败
21703	操作执行失败
21704	链接解析失败
21705	雷达标题已存在

上传file

错误码	说明
21800	文件上传参数无效
21801	文件上传大小超过限制
21802	文件上传失败
21803	文件读取失败
21804	文件保存失败
21805	文件上传类型不支持(目前仅支持png,jpg,jpeg,pdf格式)

导入客户信息

错误码	说明
21801	最多允许批量修改10个自定义字段
21802	参数option_id，field_value，field_datetime不能同时为空
21803	存在无效的员工或外部联系人
21804	存在无效的field_id
21805	存在无效的option_id
21806	存在外部联系人和员工没有好友关系
21807	存在字段类型和传入的参数不正确
21808	时间格式不正确
21809	缺少参数
21810	自定义信息更新失败，请重试
21811	field_id为${field_id}的自定义字段不存在

批量修改自定义字段的值

错误码	说明
21801	最多允许批量修改10个自定义字段
21802	参数option_id，field_value，field_datetime不能同时为空
21803	存在无效的员工或外部联系人
21804	存在无效的field_id
21805	存在无效的option_id
21806	存在外部联系人和员工没有好友关系
21807	存在字段类型和传入的参数不正确
21808	时间格式不正确
21809	缺少参数
21810	自定义信息更新失败，请重试
21811	field_id为${field_id}的自定义字段不存在

添加自定义字段

错误码	说明
21811	字段类型必须为"text"或"option_text"或"datetime"
21812	option_text类型必须添加至少一个选项
21813	选项条数最多支持100条
21814	添加的选项中存在重复的选项名称
21815	选项名称长度最多支持15个字符
21816	字段名称长度最多支持5个字符
21817	当前已存在相同名称的自定义字段
21818	字段总数量不能超过50条
21819	option_name不能为空

批量预设客户属性

错误码	说明
21820	员工id错误
21821	手机号格式不正确
21822	union_id格式不正确
21823	生日格式不正确
21824	时间格式不正确
21825	预设属性最少录入两列
21826	无效的field_id
21827	自定义字段缺少对应的类型参数
21828	field_id和field_name不匹配
21829	field_id和option_id不匹配
21830	创建预设属性失败
21831	缺少必传参数union_id或phone_number
21832	value_list长度限制最多50个

自定义表单列表

错误码	说明
21901	自定义表单参数校验失败
21902	自定义表单数据查询失败

自定义表单用户与表单关系列表

错误码	说明
21901	自定义表单参数校验失败
21902	自定义表单数据查询失败

自定义表单提交数据详情列表

错误码	说明
21901	自定义表单参数校验失败
21902	自定义表单数据查询失败

批量增减客户积分

错误码	说明
22001	批量增加或削减积分参数校验失败

自定义侧边栏身份校验

错误码	说明
22101	code不存在或已过期

获取商机列表

错误码	说明
22201	未找到商机记录

获取组织列表

错误码	说明
22202	未找到组织记录

获取工单的流内处理人

错误码	说明
22301	order_no非法，对应工单不存在
22306	stage非法，工单无此阶段

流转工单

错误码	说明
22301	order_no非法，对应工单不存在
22302	handler_id非法，对应员工不存在
22303	cc_list内的id:“LiMei”非法，对应员工不存在
22304	staff_id非法，对应员工不存在
22305	staff_id对应员工无处理本工单权限
22307	工单已关闭，不可操作

关闭工单

错误码	说明
22301	order_no非法，对应工单不存在
22303	cc_list内的id:“LiMei”非法，对应员工不存在
22304	staff_id非法，对应员工不存在
22305	staff_id对应员工无处理本工单权限
22307	工单已关闭，不可操作

评论工单

错误码	说明
22301	order_no非法，对应工单不存在
22304	staff_id非法，对应员工不存在
22305	staff_id对应员工无处理本工单权限
22307	工单已关闭，不可操作

批量更新客户企业标签

错误码	说明
40096	企业微信api调用失败，客户id非法，请参~~~~考https://open.work.weixin.qq.com/devtool/query?e=40096
40003	企业微信api调用失败，员工id非法，请参考https://open.work.weixin.qq.com/devtool/query?e=40003
40068	企业微信api调用失败，标签id非法，请参考https://open.work.weixin.qq.com/devtool/query?e=40068

批量导入线索

错误码	说明
22207	线索公海不存在
22208	staff_id非法，对应员工不存在

错误码参考表

业务接口错误码#

全局错误码#

错误码：30003#

业务接口错误码

全局错误码

错误码：30003