企业应用每次调用接口时,可能获得正确或错误的返回码,企业可以根据返回码信息调试接口,排查错误。
注意:开发者的程序应该根据errcode来判断出错的情况,而不应该依赖errmsg来匹配,因为errmsg可能会调整。
如果请求的参数不符合json规范(如类型不匹配、格式有问题),可能会导致企业微信解析到的参数不完整,此时接口在返回的errmsg里会有 “Warning: wrong json format.”,开发者需要重新检查请求参数的json合法性。

全局返回码说明如下:

错误码错误说明排查方法
-1系统繁忙服务器暂不可用,建议稍候重试。建议重试次数不超过3次。
0请求成功接口调用成功
6000数据版本冲突可能有多个调用端同时修改数据,稍后重试
40001不合法的secret参数secret在应用详情/通讯录管理助手可查看
40003无效的UserID查看帮助
40004不合法的媒体文件类型不满足系统文件要求。参考:上传的媒体文件限制
40005不合法的type参数合法的type取值,参考:上传临时素材
40006不合法的文件大小系统文件要求,参考:上传的媒体文件限制
40007不合法的media_id参数查看帮助
40008不合法的msgtype参数合法的msgtype取值,参考:消息类型
40009上传图片大小不是有效值图片大小的系统限制,参考上传的媒体文件限制
40011上传视频大小不是有效值视频大小的系统限制,参考上传的媒体文件限制
40013不合法的CorpID需确认CorpID是否填写正确,在 web管理端-设置 可查看
40014不合法的access_token查看帮助
40016不合法的按钮个数菜单按钮1-3个
40017不合法的按钮类型支持的类型,参考:按钮类型
40018不合法的按钮名字长度长度应不超过16个字节
40019不合法的按钮KEY长度长度应不超过128字节
40020不合法的按钮URL长度长度应不超过1024字节
40022不合法的子菜单级数只能包含一级菜单和二级菜单
40023不合法的子菜单按钮个数子菜单按钮1-5个
40024不合法的子菜单按钮类型支持的类型,参考:按钮类型
40025不合法的子菜单按钮名字长度支持的类型,参考:按钮类型
40026不合法的子菜单按钮KEY长度-
40027不合法的子菜单按钮URL长度长度应不超过1024字节
40029不合法的oauth_code查看帮助
40031不合法的UserID列表指定的UserID列表,部分UserID不在通讯录中
40032不合法的UserID列表长度查看帮助
40033不合法的请求字符不能包含\uxxxx格式的字符
40035不合法的参数查看帮助
40036不合法的模板id长度-
40037无效的模板id-
40039不合法的url长度url长度限制1024个字节
40050chatid不存在会话需要先创建后,才可修改会话详情或者发起聊天
40054不合法的子菜单url域名[查看帮助](#10649/错误码:40054 40055)
40055不合法的菜单url域名[查看帮助](#10649/错误码:40054 40055)
40056不合法的agentid查看帮助
40057不合法的callbackurl或者callbackurl验证失败可自助到开发调试工具重现
40058不合法的参数传递参数不符合系统要求,需要参照具体API接口说明
40059不合法的上报地理位置标志位开关标志位只能填 0 或者 1
40063参数为空查看帮助
40066不合法的部门列表部门列表为空,或者至少存在一个部门ID不存在于通讯录中
40068不合法的标签/标签组ID标签/标签组ID未指定,或者指定的标签/标签组ID不存在
40070指定的标签范围结点全部无效查看帮助
40071不合法的标签名字标签名字已经存在
40072不合法的标签名字长度不允许为空,最大长度限制为32个字(汉字或英文字母)
40073不合法的openidopenid不存在,需确认获取来源
40074news消息不支持保密消息类型图文消息支持保密类型需改用mpnews
40077不合法的pre_auth_code参数预授权码不存在,参考:获取预授权码
40078不合法的auth_code参数需确认获取来源,并且只能消费一次
40080不合法的suite_secret套件secret可在第三方管理端套件详情查看
40082不合法的suite_token查看帮助
40083不合法的suite_idsuite_id不存在
40084不合法的permanent_code参数查看帮助
40085不合法的的suite_ticket参数suite_ticket不存在或者已失效
40086不合法的第三方应用appid至少有一个不存在应用id
40088jobid不存在请检查 jobid 来源
40089批量任务的结果已清理系统仅保存最近5次批量任务的结果。可在通讯录查看实际导入情况
40091secret不合法可能用了别的企业的secret
40092导入文件存在不合法的内容查看帮助
40093jsapi签名错误请检查用于签名的jsapi_ticket是否是正确的,是否过期。可以通过获取相应jsapi_ticket接口获取当前的jsapi_ticket跟用于签名的jsapi_ticket比对是否一致,若jsapi_ticket还在有效期内,当前获取到的jsapi_ticket是一致的。若jsapi_ticket没问题,请检查用于签名的url参数是不是正确的, url(当前网页的URL, 不包含#及其后面部分)。
40094不合法的URL缺少主页URL参数,或者URL不合法(链接需要带上协议头,以 http:// 或者 https:// 开头)
40096不合法的外部联系人userid-
40097该成员尚未离职离职成员外部联系人转移接口要求转出用户必须已经离职
40098成员尚未实名认证确认传入的userid是已经过实名认证成员的
40099外部联系人的数量已达上限-
40100此用户的外部联系人已经在转移流程中-
40102域名或IP不可与应用市场上架应用重复-
40123上传临时图片素材,图片格式非法请确认上传的内容是否为合法的图片内容
40124推广活动里的sn禁止绑定-
40125无效的openuserid参数-
40126企业标签个数达到上限,最多为3000个-
40127不支持的uri schema检查uri链接的schema是否符合参数要求
40128客户转接过于频繁(90个自然日内,在职成员的每位客户仅可被转接2次)-
40129当前客户正在转接中-
40130原跟进人与接手人一样,不可继承-
40131handover_userid 并不是外部联系人的跟进人-
40201当前操作包含敏感信息,被反垃圾拦截-
41001缺少access_token参数-
41002缺少corpid参数-
41004缺少secret参数-
41006缺少media_id参数media_id为调用接口必填参数,请确认是否有传递
41008缺少auth code参数-
41009缺少userid参数-
41010缺少url参数-
41011缺少agentid参数-
41016缺少title参数发送图文消息,标题是必填参数。请确认参数是否有传递。
41019缺少 department 参数查看帮助
41017缺少tagid参数-
41018缺少标签名-
41021缺少suite_id参数-
41022缺少suite_access_token参数-
41023缺少suite_ticket参数-
41024缺少secret参数-
41025缺少permanent_code参数-
41033缺少 description 参数发送文本卡片消息接口,description 是必填字段
41035缺少外部联系人userid参数-
41036不合法的企业对外简称企业对外简称必须是认证过的,如果要改回默认简称,传空字符串把对外简称清除就可以了
41037缺少「联系我」type参数-
41038缺少「联系我」scene参数-
41039无效的「联系我」type参数-
41040无效的「联系我」scene参数-
41041「联系我」使用人数超过限制默认限制不超过100人(包括部门展开后的人数)
41042无效的「联系我」style参数-
41043缺少「联系我」config_id参数-
41044无效的「联系我」config_id参数-
41045API添加「联系我」达到数量上限-
41046缺少企业群发消息id-
41047无效的企业群发消息id-
41048无可发送的客户-
41049缺少欢迎语code参数-
41050无效的欢迎语code欢迎语code(welcome_code)具有时效性,须在添加好友后20秒内使用
41051客户和服务人员已经开始聊天了已经开始的聊天的客户不能发送欢迎语
41052无效的发送时间-
41053客户未同意聊天存档须外部联系人同意服务须知后,成员才可发送欢迎语
41054该用户尚未激活-
41055群欢迎语模板数量达到上限-
41056外部联系人id类型不正确-
41057企业或服务商未绑定微信开发者账号-
41058无此群欢迎语模板的编辑权限-
41059缺少moment_id参数-
41060不合法的moment_id参数-
41061不合法朋友圈发送成员userid,当前朋友圈并非此用户发表-
41062企业创建的朋友圈尚未被成员userid发表-
41063群发消息正在被派发中,请稍后再试创建企业群发后,立刻调用获取企业的全部群发记录的相关接口,将可能出现该错误
41064附件数量超过限制-
41065无效的附件类型-
41066用户视频号名称错误-
41067朋友圈moment_id类型错误判断该朋友圈创建类型是否符合接口调用标准
41068聊天敏感词列表超过了限制-
41069聊天敏感词规则总数超过了限制-
41070无效的聊天敏感词规则id-
41071聊天敏感词规则已经被删除-
41072资源附件场景使用错误请注意使用上传附件资源接口的时候,media_type与attachment_type参数是否正确
41073商品图册描述不符合标准-
41074商品图册数据已经被删除-
41075无效的商品图册id或者数据不存在-
41076聊天敏感词规则适用范围超过限制建议使用部门id
41077聊天敏感词规则名称不唯一-
41078创建朋友圈正在进行的异步任务总数超过了限制-
41079朋友圈正在被派发中,请稍后再试-
41080附件资源大小超过限制请注意使用上传附件资源接口的时候,附件资源的大小是否正确
41081附件资源的图片分辨率超过限制请注意使用上传附件资源接口的时候,附件资源的图片分辨率是否正确
41082附件资源的视频时长超过限制请注意使用上传附件资源接口的时候,附件资源的视频时长是否正确
41083敏感词关键字错误-
41084敏感词拦截语义规则错误-
41085无效商品编码-
41086无效商品价格-
41087无效商品描述-
41088附件列表为empty-
41089朋友圈附件与内容不能同时为empty-
41090视频格式不合法确认是否为mp4格式,并且数据没有损坏
41091配置客户群进群方式最多只能关联5个群-
41093群发任务已取消-
41102缺少菜单名-
42001access_token已过期access_token有时效性,需要重新获取一次
42003code已过期-
42007pre_auth_code已过期pre_auth_code有时效性,需要重新获取一次
42009suite_access_token已过期suite_access_token有时效性,需要重新获取一次
42012jsapi_ticket不可用,一般是没有正确调用接口来创建jsapi_ticket如果是agentConfig使用,请特别注意是否是使用"获取应用身份的ticket"来获取jsapi_ticket
42013小程序未登陆或登录态已经过期需要重新走登陆流程
42014任务卡片消息的task_id不合法-
42015更新的消息的应用与发送消息的应用不匹配-
42016更新的task_id不存在-
42017按钮key值不存在-
42018按钮key值不合法-
42019缺少按钮key值不合法-
42020缺少按钮名称-
42021device_access_token 过期-
42022code已经被使用过。只能使用一次-
42027Template_Card.horizontal_content_list.keyname 字段缺失-
42028Template_Card 缺失 Url,card_action、horizontal_content_list、jump_list缺失该字段都可能报此错误-
42029Template_Card 缺失 mediaid,Template_Card.horizontal_content_list.mediaid 字段缺失-
42030Template_Card 缺失 appid,card_action、jump_list 缺失该字段都可能报此错误-
42031Template_Card.CardType 字段不合法-
42033Template_Card.缺失 Title,vertical_content_list、jump_list缺失该字段都可能报此错误-
42035Template_Card.horizontal_content_list 数组长度不合法-
42036Template_Card.vertical_content_list 数组长度不合法-
42037Template_Card.option_list 数组长度不合法-
42038Template_Card.button_list.text 缺失或不合法-
42039Template_Card.button_list.key 缺失或不合法-
42040Template_Card.option_list.id 缺失或不合法-
42041Template_Card.option_list.text 缺失或不合法-
42042Template_Card.jump_list 数组长度不合法-
42043Template_Card.question_Key 缺失或不合法-
42044Template_Card.card_image.url 缺失或不合法-
42045Template_Card.card_action 缺失或不合法-
42046Template_Card.submit_button.key 缺失或不合法-
42047Template_Card.select_list 数组长度不合法-
42049Template_Card.submit_button.text 缺失或不合法-
42050Template_Card.horizontal_content_list.userid 缺失或不合法-
42051Template_Card.action_menu.action_list.key key冲突-
43004指定的userid未绑定微信或未关注微信插件(原企业号)需要成员使用微信登录企业微信或者关注微信插件才能获取openid
43009企业未验证主体-
43012应用需配置回调url-
44001多媒体文件为空上传格式参考:上传临时素材,确认header和body的内容正确。
44004文本消息content参数为空发文本消息content为必填参数,且不能为空
45001多媒体文件大小超过限制图片不可超过5M;音频不可超过5M;文件不可超过20M
45002消息内容大小超过限制查看帮助
45004应用description参数长度不符合系统限制设置应用若带有description参数,则长度必须为4至120个字符
45007语音播放时间超过限制语音播放时长不能超过60秒
45008图文消息的文章数量不符合系统限制图文消息的文章数量不能超过8条
45009接口调用超过限制查看帮助
45022应用name参数长度不符合系统限制设置应用若带有name参数,则不允许为空,且不超过32个字符
45024帐号数量超过上限查看帮助
45026触发删除用户数的保护限制参考:全量覆盖成员
45029回包大小超过上限查看帮助
45032图文消息author参数长度超过限制最长64个字节
45033接口并发调用超过限制查看帮助
45034url必须有协议头在url前面加上协议头 http:// 或 https://
46003菜单未设置菜单需发布后才能获取到数据
46004指定的用户不存在需要确认指定的用户存在于通讯录中
48001API功能未授权-
48002API接口无权限调用查看帮助
48003不合法的suite_id确认suite_access_token由指定的suite_id生成
48004授权关系无效可能是无授权或授权已被取消
48005API接口已废弃接口已不再支持,建议改用新接口或者新方案
48006接口权限被收回由于企业长时间未使用应用,接口权限被收回,需企业管理员重新启用
48007API接口无权限调用,由于所需权限因互斥而未能拥有查看帮助
48008API接口无权限调用,通讯录编辑授权只能调用部分通讯录接口查看可调用接口列表
48009API接口无权限调用,为保障企业数据安全,不再允许通讯录同步助手从新增IP读取通讯录详情查看通讯录同步接口调整
49004签名不匹配-
49008群已经解散群主已经解散群聊
49009buyer_userid非法buyer_userid解析失败
50001redirect_url未登记可信域名查看帮助
50002成员不在权限范围请检查应用或管理组的权限范围
50003应用已禁用查看帮助
50100分页查询的游标无效-
60001部门长度不符合限制部门名称不能为空且长度不能超过32个字
60003部门ID不存在需要确认部门ID是否有带,并且存在通讯录中
60004父部门不存在需要确认父亲部门ID是否有带,并且存在通讯录中
60005部门下存在成员不允许删除有成员的部门
60006部门下存在子部门不允许删除有子部门的部门
60007不允许删除根部门-
60008部门已存在部门ID或者部门名称已存在
60009部门名称含有非法字符不能含有 :?*"<>&#124; 等字符
60010部门存在循环关系查看帮助
60011指定的成员/部门/标签参数无权限查看帮助
60012不允许删除默认应用默认应用的id为0
60020不安全的访问IP查看帮助
60021userid不在应用可见范围内-
60028不允许修改第三方应用的主页 URL第三方应用类型,不允许通过接口修改该应用的主页 URL
60102UserID已存在-
60103手机号码不合法长度不超过32位,字符仅支持数字,加号和减号
60104手机号码已存在同一个企业内,成员的手机号不能重复。建议更换手机号,或者更新已有的手机记录。
60105邮箱不合法长度不超过64位,且为有效的email格式
60106邮箱已存在同一个企业内,成员的邮箱不能重复。建议更换邮箱,或者更新已有的邮箱记录。
60107微信号不合法微信号格式由字母、数字、"-"、"_"组成,长度为 3-20 字节,首字符必须是字母或"-"或"_"
60110用户所属部门数量超过限制用户同时归属部门不超过20个
60111UserID不存在UserID参数为空,或者不存在通讯录中
60112成员name参数不合法不能为空,且不能超过64字符
60123无效的部门id部门不存在通讯录中
60124无效的父部门id父部门不存在通讯录中
60125非法部门名字不能为空,且不能超过64字节,且不能含有:*?"<>&#124;等字符
60127缺少department参数-
60129成员手机和邮箱都为空成员手机和邮箱至少有个非空
60132is_leader_in_dept和department的元素个数不一致-
60136记录不存在-
60137家长手机号重复同一个家校通讯录中,家长的手机号不能重复。建议更换手机号,或者更新已有的手机记录。
60140无效的response_code可能是response_code已经过期
60141个人邮箱非法,且没有手机号个人邮箱(即激活用邮箱)检查失败,且未传入手机号。
60142个人邮箱更新失败个人邮箱(即激活用邮箱)已存在,无法被更新。
60143企业邮箱非法可能是企业邮箱格式非法,或该邮箱已存在。
60144企业邮箱更新失败企业邮箱已无法更新,查看帮助
60145企业邮箱已存在同一个企业内,成员的企业邮箱不能重复。建议更换企业邮箱
60203不合法的模版ID-
60204模版状态不可用-
60205模版关键词不匹配-
60206该种类型的消息只支持第三方独立应用使用-
60207第三方独立应用只允许发送模板消息-
60208第三方独立应用不支持指定@all,不支持参数toparty和totag-
60209缺少操作者vid-
60210选择成员列表为空-
60211SelectedTicket为空-
60214仅支持第三方应用调用-
60215传入SelectedTicket数量超过最大限制(10个)-
60217当前操作者无权限,操作者需要授权或者在可见范围内-
60218仅支持成员授权模式的应用可调用-
60219消费SelectedTicket和创建SelectedTicket的应用appid不匹配-
60220缺少corpappid-
60221open_userid对应的服务商不是当前服务商-
60222非法SelectedTicket-
60223非法BundleId-
60224非法PackageName-
60225当前操作者并非SelectedTicket相关人,不能创建群聊-
60226选人数量超过最大限制(2000)-
60227缺少ServiceCorpid-
60228缺少bind_corpid字段-
60229成员或者部门id不正确-
60230缺少shareticket-
60231shareticket非法检查shareticket是否拼写错误
60233shareticket非法检查shareticket是否误用或者拼写错误
60234shareticket非法检查是否误用其他应用生成的shareticket或者拼写错误
60235缺少payment_id字段-
60236缺少trade_no字段-
60237传入的payment_id对应的收款项目不是由当前应用发起的检查payment_id是否误用或者拼写错误
60239收款人未实名-
60240收款企业尚未验证或者认证-
60241付款学生或者部门id不正确-
60242shareticket不能跨域名使用检查分享出去的页面与使用shareticket的页面域名是否一致
60243trade_no不合法检查trade_no是否拼写错误或者误用其他收款项目的trade_no
60244shareticket不能跨APP使用检查分享出去的小程序与使用shareticket的小程序appid是否一致
60246第三方应用未上线检查第三方应用上线状态
65000学校已经迁移-
65001无效的关注模式-
65002导入家长信息数量过多批量导入家长每次最多1000个
65003学校尚未迁移-
65004组织架构不存在-
65005无效的同步模式-
65006无效的管理员类型-
65007无效的家校部门类型-
65008无效的入学年份-
65009无效的标准年级类型-
65010此userid并不是学生-
65011家长userid数量超过限制每次最多批量处理100个家长
65012学生userid数量超过限制每次最多批量处理10个学生
65013学生已有家长-
65014非学校企业-
65015父部门类型不匹配添加学校部门,需满足层级关系,班级需要以年级为父部门
65018家长人数达到上限未验证的学校\企业最多可添加2000名家长,验证过的学校\企业最多可添加20000名家长
65022家校通迅录无权限无权限获取家校通迅录
65023家校通迅录无权限无权限获取该学生或家长
65024家长关联的老师不在应用可见范围检查学生的班主任、任课教师或家长所在班级群群主是否在应用可见范围内
660001无效的商户号请检查商户号是否正确
660002无效的企业收款人id请检查payee_userid是否正确
660003userid不在应用的可见范围-
660004partyid不在应用的可见范围-
660005tagid不在应用的可见范围-
660006找不到该商户号-
660007申请已经存在不需要重复申请
660008商户号已经绑定不需要重新提交申请
660009商户号主体和商户主体不一致-
660010超过商户号绑定数量限制-
660011商户号未绑定-
670001应用不在共享范围-
670002无效上下游chain_id-
670003无效上下游分组id-
670004企业不在上下游范围内-
670005超过上下游人企业数上限-
670006无效上下游规则id-
670007上下游规则id数量超出限制-
670008分组不唯一-
670009自定义id不唯一-
670010负责人数量超出限制-
670011不合法的自定义id。上下游企业自定义id只支持64个字符以内的字母和数字-
670012导入企业名称为空-
670013不合法的企业名称。企业名只支持30个字符以内的中/英文、数字、合法字符-
670014上下游联系人姓名为空-
670015不合法的上下游联系人姓名-
670016不合法的身份字段。身份字段只支持填写负责人或成员-
670017分组名和同层级企业名重复-
670018该联系人帐号异常,无法邀请其加入上下游-
670019导入上下游后单个企业人数超出限制-
670020分组层级不可超过9层-
670021不合法的分组名称-
670022有导入任务正在进行-
670023超过每日导入人数限制-
670024帐号异常,不能进行导入-
670025导入数据超出限制。检查导入数据单个企业人数、企业数以及总人数是否超出限制-
670026上下游空间加入企业超出限制-
670027不可以移除上下游创建者-
670028企业名称不唯一-
670029成员、部门不在上下游范围-
670030无权限操作此groupid。检查groupid是否在应用共享范围内-
670031根据管理员设置,存在联系人无权加入其他企业创建的上下游-
72023发票已被其他公众号锁定查看帮助
72024发票状态错误reimburse_status状态错误,参考:更新发票状态
72037存在发票不属于该用户只能批量更新该openid的发票,参考:批量更新发票状态
80001可信域名不正确,或者无ICP备案查看帮助
81001部门下的结点数超过限制(3W)-
81002部门最多15层-
81003标签下节点个数超过30000个-
81011无权限操作标签查看帮助
81012缺失可见范围请求没有填写UserID、部门ID、标签ID
81013UserID、部门ID、标签ID全部非法或无权限查看帮助
81014标签添加成员,单次添加user或party过多-
81015邮箱域名需要跟企业邮箱域名一致-
81016logined_userid字段缺失-
81017请求个数超过限制-
81018该服务商可获取名字数量配额不足-
81019items数组成员缺少id字段-
81020items数组成员缺少type字段-
81021items数组成员的type字段不合法-
81023logined_userid 不合法-
81024logined_userid 不合法-
82001指定的成员/部门/标签全部为空查看帮助
82002不合法的PartyID列表长度发消息,单次不能超过100个部门
82003不合法的TagID列表长度发消息,单次不能超过100个标签
82004不合法的消息内容消息内容中可能存在使客户端crash的内容
84005第三方应用不存在检查access_token和应用id是否正确
84014成员票据过期查看帮助
84015成员票据无效确认user_ticket参数来源是否正确。参考接口:根据code获取成员信息
84019缺少templateid参数-
84020templateid不存在确认参数是否有带,并且已创建
84021缺少register_code参数-
84022无效的register_code参数-
84023不允许调用设置通讯录同步完成接口-
84024无注册信息查看帮助
84025不符合的state参数必须是[a-zA-Z0-9]的参数值,长度不可超过128个字节
84052缺少caller参数-
84053缺少callee参数-
84054缺少auth_corpid参数-
84055超过拨打公费电话频率同一个客服5秒内只能调用api拨打一次公费电话
84056被拨打用户安装应用时未授权拨打公费电话权限-
84057公费电话余额不足-
84058caller 呼叫号码不支持-
84059号码非法-
84060callee 呼叫号码不支持-
84061不存在外部联系人的关系-
84062未开启公费电话应用-
84063caller不存在-
84064callee不存在-
84065caller跟callee电话号码一致不允许自己拨打给自己
84066服务商拨打次数超过限制单个企业管理员,在一天(以上午10:00为起始时间)内,对应单个服务商,只能被呼叫【4】次。
84067管理员收到的服务商公费电话个数超过限制单个企业管理员,在一天(以上午10:00为起始时间)内,一共只能被【3】个服务商成功呼叫。
84069拨打方被限制拨打公费电话-
84070不支持的电话号码拨打方或者被拨打方电话号码不支持
84071不合法的外部联系人授权码非法或者已经消费过
84072应用未配置客服-
84073客服userid不在应用配置的客服列表中-
84074没有外部联系人权限-
84075不合法或过期的authcode-
84076缺失authcode-
84077订单价格过高,无法受理-
84078购买人数不正确-
84079价格策略不存在-
84080订单不存在-
84081存在未支付订单-
84082存在申请退款中的订单-
84083非服务人员-
84084非跟进用户-
84085应用已下架-
84086订单人数超过可购买最大人数-
84087打开订单支付前禁止关闭订单-
84088禁止关闭已支付的订单-
84089订单已支付-
84090缺失user_ticket-
84091订单价格不可低于下限-
84092无法发起代下单操作-
84093代理关系已占用,无法代下单-
84094该应用未配置代理分润规则,请先联系应用服务商处理-
84095免费试用版,无法扩容-
84096免费试用版,无法续期-
84097当前企业有未处理订单-
84098固定总量,无法扩容-
84099非购买状态,无法扩容-
84100未购买过此应用,无法续期-
84101企业已试用付费版本,无法全新购买-
84102企业当前应用状态已过期,无法扩容-
84103仅可修改未支付订单-
84104订单已支付,无法修改-
84105订单已被取消,无法修改-
84106企业含有该应用的待支付订单,无法代下单-
84107企业含有该应用的退款中订单,无法代下单-
84108企业含有该应用的待生效订单,无法代下单-
84109订单定价不能未0-
84110新安装应用不在试用状态,无法升级为付费版-
84111无足够可用优惠券-
84112无法关闭未支付订单-
84113无付费信息-
84114虚拟版本不支持下单-
84115虚拟版本不支持扩容-
84116虚拟版本不支持续期-
84117在虚拟正式版期内不能扩容-
84118虚拟正式版期内不能变更版本-
84119当前企业未报备,无法进行代下单-
84120当前应用版本已删除-
84121应用版本已删除,无法扩容-
84122应用版本已删除,无法续期-
84123非虚拟版本,无法升级-
84124非行业方案订单,不能添加部分应用版本的订单-
84125购买人数不能少于最少购买人数-
84126购买人数不能多于最大购买人数-
84127无应用管理权限-
84128无该行业方案下全部应用的管理权限-
84129付费策略已被删除,无法下单-
84130订单生效时间不合法-
84200文件转译解析错误只支持utf8文件转译,可能是不支持的文件类型或者格式
85002包含不合法的词语-
85004每企业每个月设置的可信域名不可超过20个-
85005可信域名未通过所有权校验查看帮助
85006IP列表超过限制-
85007不合法的IP地址-
85008可信域名ICP备案不通过-
85009应用信息不完整检查回调参数以及可信域名是否填写
85010回调参数填写不符合要求检查回调参数是否正确
85011校验回调地址失败
85012存在不合法的权限名称检查权限名称拼写是否正确、是否重复
85111可信域名是第三方服务商域名若需要第三方服务商为企业代开发自建应用 请查看 企业应用代开发指引
86001参数 chatid 不合法-
86003参数 chatid 不存在-
86004参数 群名不合法-
86005参数 群主不合法-
86006群成员数过多或过少-
86007不合法的群成员-
86008非法操作非自己创建的群-
86101仅群主才有操作权限-
86201参数 需要chatid-
86202参数 需要群名-
86203参数 需要群主-
86204参数 需要群成员-
86205参数 字符串chatid过长-
86206参数 数字chatid过大-
86207群主不在群成员列表-
86214群发类型不合法-
86215会话ID已经存在-
86216存在非法会话成员ID查看帮助
86217会话发送者不在会话成员列表中会话的发送者,必须是会话的成员列表之一
86220指定的会话参数不合法查看帮助
86224不是受限群,不允许使用该接口-
90001未认证摇一摇周边-
90002缺少摇一摇周边ticket参数-
90003摇一摇周边ticket参数不合法-
90100非法的对外属性类型-
90101对外属性:文本类型长度不合法文本长度不可超过12个UTF8字符
90102对外属性:网页类型标题长度不合法标题长度不可超过12个UTF8字符
90103对外属性:网页url不合法-
90104对外属性:小程序类型标题长度不合法标题长度不可超过12个UTF8字符
90105对外属性:小程序类型pagepath不合法-
90106对外属性:请求参数不合法-
90200缺少小程序appid参数-
90201小程序通知的content_item个数超过限制item个数不能超过10个
90202小程序通知中的key长度不合法不能为空或超过10个汉字
90203小程序通知中的value长度不合法不能为空或超过30个汉字
90204小程序通知中的page参数不合法-
90206小程序未关联到企业中-
90207不合法的小程序appid-
90208小程序appid不匹配-
90211登录时传入的suiteid不合法-
90212登录时传入的suiteid和使用的小程序绑定的第三方应用不匹配-
90300orderid 不合法-
90302付费应用已过期-
90303付费应用超过最大使用人数-
90304订单中心服务异常,请稍后重试-
90305参数错误,errmsg中有提示具体哪个参数有问题-
90306商户设置不合法,详情请见errmsg-
90307登录态过期-
90308在开启IP鉴权的前提下,识别为无效的请求IP-
90309订单已经存在,请勿重复下单-
90310找不到订单-
90311关单失败, 可能原因:该单并没被拉起支付页面; 已经关单;已经支付;渠道失败;单处于保护状态;等等-
90312退款请求失败, 详情请看errmsg-
90313退款调用频率限制,超过规定的阈值-
90314订单状态错误,可能未支付,或者当前状态操作受限-
90315退款请求失败,主键冲突,请核实退款refund_id是否已使用-
90316退款原因编号不对-
90317尚未注册成为供应商-
90318参数nonce_str 为空或者重复,判定为重放攻击-
90319时间戳为空或者与系统时间间隔太大-
90320订单token无效-
90321订单token已过有效时间-
90322旧套件(包含多个应用的套件)不支持支付系统-
90323单价超过限额-
90324商品数量超过限额-
90325预支单已经存在-
90326预支单单号非法-
90327该预支单已经结算下单-
90328结算下单失败,详情请看errmsg-
90329该订单号已经被预支单占用-
90330创建供应商失败-
90331更新供应商失败-
90332还没签署合同-
90333创建合同失败-
90338已经过了可退款期限-
90339供应商主体名包含非法字符-
90340创建客户失败,可能信息真实性校验失败-
90341退款金额大于付款金额-
90342退款金额超过账户余额-
90343退款单号已经存在-
90344指定的付款渠道无效-
90345超过5w人民币不可指定微信支付渠道-
90346同一单的退款次数超过限制-
90347退款金额不可为0-
90348管理端没配置支付密钥-
90349记录数量太大-
90350银行信息真实性校验失败-
90351应用状态异常-
90352延迟试用期天数超过限制-
90353预支单列表不可为空-
90354预支单列表数量超过限制-
90355关联有退款预支单,不可删除-
90356不能0金额下单-
90357代下单必须指定支付渠道-
90358预支单或代下单,不支持部分退款-
90359预支单与下单者企业不匹配-
90381参数 refunded_credit_orderid 不合法-
90456必须指定组织者-
90457日历ID异常-
90458日历ID列表不能为空-
90459日历已删除-
90460日程已删除-
90461日程ID异常-
90462日程ID列表不能为空-
90463不能变更组织者-
90464参与者数量超过限制-
90465不支持的重复类型-
90466不能操作别的应用创建的日历/日程-
90467星期参数异常-
90468不能变更组织者-
90469每页大小超过限制-
90470页数异常-
90471提醒时间异常-
90472没有日历/日程操作权限-
90473颜色参数异常-
90474组织者不能与参与者重叠-
90475不是组织者的日历-
90479不允许操作用户创建的日程-
90500群主并未离职-
90501该群不是客户群-
90502群主已经离职-
90503满人 & 99个微信成员,没办法踢,要客户端确认-
90504群主没变-
90507离职群正在继承处理中-
90508离职群已经继承-
90509非企业微信客户群当前群不是企业微信的客户群
90510企业一年内无活跃用户-
90511opengid不存在或者无效-
90602会议Id不合法检查会议id是否拼写正确,并且为本应用创建的会议
90603事件分类id不合法-
90604网格单元id不合法-
90606该网格单元管理员达到上限,一个网格单元最多有20个管理员-
90607含有成员的网格单元不能被删除-
90608网格单元的名字重复了-
90609网格单元的成员数超过上限-
90610网格单元的成员数超过上限-
91040获取ticket的类型无效查看帮助
92000成员不在应用可见范围之内-
92001应用没有敏感信息权限-
92002不允许跨企业调用-
92003不允许跨应用调用-
92006该直播已经开始或取消-
92007该直播回放不能被删除-
92008当前应用没权限操作这个直播-
93000机器人webhookurl不合法或者机器人已经被移除出群-
93004机器人被停用-
93008不在群里-
94000应用未开启工作台自定义模式请在管理端后台应用详情里面开启自定义工作台模式
94001不合法的type类型-
94002缺少keydata字段-
94003keydata的items列表长度超出限制-
94005缺少list字段-
94006list的items列表长度超出限制-
94007缺少webview字段-
94008应用未设置自定义工作台模版类型-
95000不合法的open_kfid-
95001发送客服消息次数限制当用户主动发送消息给微信客服时,企业最多可发送5条消息给用户;若用户继续发送消息,企业可再次下发消息
95002发送客服消息时间限制当用户在主动发送消息给微信客服时,可在48小时内调用该接口发送消息给用户
95003发送客服消息可接待客户咨询数限制企业未验证或未绑定视频号
95004open_kfid不存在跨企业使用,或对已删除的帐号操作
95005客服帐号数超过限制客服账号数不能多于最大的数量限制,且至少有一个
95006不合法的客服帐号名-
95007不合法的msgtokenmsgtoken有时效性,可能为失效或者非法
95008菜单消息的菜单项个数超过上限目前最多允许10个菜单项
95009不合法的菜单消息的菜单项类型-
95011已在企业微信使用微信客服微信客服当前处于联合版模式,而调用接口的access_token是通过独立版secret获取的
95012未在企业微信使用微信客服微信客服当前处于独立版模式,而调用接口的access_token是通过联合版secret获取的
95013会话已经结束-
95014用户不是接待人员不是接待人员,或未在企业微信激活
95015管理端已经配置了专属服务-
95016不允许这种状态转移参考概述中的状态流转图
95017基础应用权限下,api开关处于关闭状态-
95018发送客服消息时当前会话状态不允许发送可能是会话状态不能通过api调用发送,或者会话已经超过48小时
95019接待人员已停止接待,无法完成指定的操作可通过获取接待人员列表获取接待人员的状态
95022location_type非法-
95023基础应用权限下,api开关已经授权给代开发自建应用可通过管理端-微信客服进行权限切换
95026客服账号使用率较低,暂无法创建请改善后再试
95027企业未认证,仅可创建10个客服帐号认证企业后即可继续创建
301002无权限操作指定的应用查看帮助
301005不允许删除创建者创建者不允许从通讯录中删除。如果需要删除该成员,需要先在WEB管理端转移创建者身份。
301012参数 position 不合法长度不允许超过128个字符
301013参数 telephone 不合法telephone必须由1-32位的纯数字或'-'号组成。
301014参数 english_name 不合法参数如果有传递,不允许为空字符串,同时不能超过64字节,只能是由字母、数字、点(.)、减号(-)、空格或下划线(_)组成
301015参数 mediaid 不合法请检查 mediaid 来源,应该通过上传临时素材的图片类型获得mediaid
301016上传语音文件不符合系统要求语音文件的系统限制,参考上传的媒体文件限制
301017上传语音文件仅支持AMR格式语音文件的系统限制,参考上传的媒体文件限制
301021参数 userid 无效至少有一个userid不存在于通讯录中
301022获取打卡数据失败系统失败,可重试处理
301023useridlist非法或超过限额列表数量不能为0且不超过100
301024获取打卡记录时间间隔超限保证开始时间大于0 且结束时间大于 0 且结束时间大于开始时间,且间隔少于一个月
301025审批开放接口参数错误请参考参数说明正确填写
301026获取审批模板数据失败可能是审批模板未通过审核
301036不允许更新该用户的userid查看帮助
301039请求参数错误,请检查输入参数-
301042ip白名单限制,请求ip不在设置白名单范围-
301048sdkfileid对应的文件不存在或已过期-
301052会话存档服务已过期-
301053会话存档服务未开启-
301055无审批应用权限/无审批应用数据拉取权限-
301058拉取会话数据请求超过大小限制,可减少limit参数-
301059非内部群,不提供数据-
301060拉取同意情况请求量过大,请减少到100个参数以下-
301061userid或者exteropenid用户不存在-
302003批量导入任务的文件中userid有重复-
302004组织架构不合法(1不是一棵树,2 多个一样的partyid,3 partyid空,4 partyid name 空,5 同一个父节点下有两个子节点 部门名字一样 可能是以上情况,请一一排查)-
302005批量导入系统失败,请重新尝试导入-
302006批量导入任务的文件中partyid有重复-
302007批量导入任务的文件中,同一个部门下有两个子部门名字一样-
302008已经有一个导入任务在进行中,需要等待上一个任务完成后再能调用-
400020会议参与人超过限制-
400021会议参与人或者主持人不合法,或者不在应用可见范围。若为外部联系人,则外部联系人跟进人不在应用可见范围-
400025remind_scope参数不合法。-
400026repeat_type参数不合法。-
400027主持人超过会议主持人上限。-
400028会议系统应用关闭,不允许调用会议相关接口-
400029主持人必须在参与人列表中-
400030不合法的会议密码-
400031不合法的会议settings-
400032不合法的repeat_until参数-
400033不合法的repeat_interval参数-
400034不合法的meeting_start参数-
400035不合法的meeting_duration参数-
400036会议的创建者不具备指定的日历权限-
400037指定的响铃用户不在会议参与人列表中-
2000002CorpId参数无效指定的CorpId不存在
600001不合法的snsn可能尚未进行登记
600002设备已注册可能设备已经建立过长连接
600003不合法的硬件activecode-
600004该硬件尚未授权任何企业-
600005硬件Secret无效-
600007缺少硬件sn-
600008缺少nonce参数-
600009缺少timestamp参数-
600010缺少signature参数-
600011签名校验失败-
600012长连接已经注册过设备-
600013缺少activecode参数-
600014设备未网络注册-
600015缺少secret参数-
600016设备未激活-
600018无效的起始结束时间-
600020设备未登录-
600021设备sn已存在-
600023时间戳已失效-
600024固件大小超过5M-
600025固件名为空或者超过20字节-
600026固件信息不存在-
600027非法的固件参数-
600028固件版本已存在-
600029非法的固件版本-
600030缺少固件版本参数-
600031硬件固件不允许升级-
600032无法解析硬件二维码-
600033设备型号id冲突-
600034指纹数据大小超过限制-
600035人脸数据大小超过限制-
600036设备sn冲突-
600037缺失设备型号id-
600038设备型号不存在-
600039不支持的设备类型-
600040打印任务id不存在-
600041无效的offset或limit参数值-
600042无效的设备型号id-
600043门禁规则未设置-
600044门禁规则不合法-
600045设备已订阅企业信息-
600046操作id和用户userid不匹配-
600047secretno的status非法请确认是否是使用统一初始secretno的设备,如果是无有正确执行换secretno的流程
600048无效的指纹算法-
600049无效的人脸识别算法-
600050无效的算法长度-
600051设备过期-
600052无效的文件分块-
600053该链接已经激活-
600054该链接已经订阅-
600055无效的用户类型-
600056无效的健康状态-
600057缺少体温参数-
610001永久二维码超过每个员工5000的限制-
610003scene参数不合法有效的scene长度为1~64字符,由英文字母、数字、中划线、下划线以及点号构成
610004输入参数不是企业客户-
610014无效的unionid-
610015小程序对应的开放平台账号未认证-
610016企业未认证-
610017小程序和企业主体不一致-
610018openid和unionid不在同一个开放平台账号下-
610019没有安装第三方应用-
610020没有安装与待开发应用是同一个服务商的第三方应用-
610021已经安装的与待开发应用为同一个服务商的第三方应用暂无企业客户权限-
610022授权企业与服务商为同一企业,无需设置迁移-
640001微盘不存在当前空间判断spaceid是否填错
640002文件不存在判断fileid是否填错
640003文件已删除判断fileid对应的文件是否已经被删除
640004无权限访问判断当前用户是否有访问
640005成员不在空间内判断当前成员是否在空间内
640006超出当前成员拥有的容量判断当前用户的个人容量是否超出了限制
640007超出微盘的容量在管理端查看微盘的容量是否要满了
640008没有空间权限判断当前userid是否有空间权限
640009非法文件名判断file_name字段是否为空
640010超出空间的最大成员数判断当前空间的成员数是否超过了管理端设置的空间最大成员数
640011json格式不匹配判断是否的json格式是否有误
640012非法的userid判断userid字段是否设置错误
640013非法的departmentid判断departmentid字段是否设置错误
640014空间没有有效的管理员判断当前空间是否没有有效的管理员
640015不支持设置预览权限文件预览权限只有VIP用户才能设置
640016不支持设置文件水印文件水印只有VIP用户才能设置
640017微盘管理端未开通API 权限在微盘管理端进行打开
640018微盘管理端未设置编辑权限在微盘管理端进行打开编辑权限
640019API 调用次数超出限制免费版:1000次/企业/月; 付费版:100,000次/企业/月
640020非法的权限类型普通文件:可下载、仅预览; 微文档:可编辑、仅浏览
640021非法的fatheridfatherid应该为:文件所在的目录fileid, 在根目录时为fileid(判断当前字段是否为空)
640022非法的文件内容的base64文件内容base64,判断本字段是否为空
640023非法的权限范围auth_scope应该为三个中的其中一个:1:指定人 2:企业内 3:企业外
640024非法的fileid判断fileid字段是否为空
640025非法的space_name判断space_name字段是否空
640026非法的spaceid判断spaceid字段是否空
640027参数错误判断输入的参数是否有误
640028空间设置了关闭成员邀请链接查看空间的安全设置的成员邀请链接按钮是否处于关闭状态
640029只支持下载普通文件,不支持下载文件夹等其他非文件实体类型检查fileid对应的文件是否为普通文件
640032企业管理员已禁止此成员创建空间-
640044空间已开启保密模式检查空间相关设置
640045没有权限设置“可上传下载”权限检查操作者账号类型
640046没有权限设置“自定义”权限检查操作者账号类型
640047上传文件大小超过限制单个文件大小不能超过20G
640048上传流程异常不能重复调用file_upload_finish
680000参数错误结合返回的errmsg排查
680001邮件群组地址非法检查邮箱地址格式是否正确,是否为本企业域名
680002邮件群组名称非法名称是否为空,名称是否过长
680003群组成员非法检查群组成员邮箱格式是否正确
680004群组中的群组非法检查群组邮箱格式是否正确,是否为本企业群组
680006群组使用权限仅支持0: 企业成员, 1任何人, 2:组内成员,3:自定义成员
680007允许使用群组成员邮箱非法检查群组成员邮箱格式是否正确
680008群组成员为空检查userlist/grouplist/department是否都为空
680010邮件群组地址重复检查群组地址在企业内是否已经被用户占用
680011邮件群组地址重复检查群组地址在企业内是否已经被其他群组占用
680012邮件群组不存在检查群组地址是否有误,是否存在于本企业
680015模糊搜索fuzzy参数非法检查fuzzy值是否为0或1
680032业务邮箱地址非法检查邮箱地址格式是否正确,是否为本企业域名
680033业务邮箱地址重复检查业务邮箱地址在企业内是否已经被占用
680034业务邮箱名称非法名称是否为空,名称是否过长
680035业务邮箱ID不存在检查id是否存在
680036业务邮箱ID非法检查id数据类型是否正确,是否传值
680037vid账号余量不足检查vid账号数是否用完
680040业务邮箱名称重复检查名称是否已经被其他业务邮箱占用
680041获取用户功能属性type字段非法仅支持1: 强制启用安全登录 2: IMAP/SMTP服务 3: POP/SMTP服务 4: 是否启用安全登录
680042更改用户功能属性type字段非法仅支持1: 强制启用安全登录 2: IMAP/SMTP服务 3: POP/SMTP服务 4: 是否启用安全登录
680043禁用/启用邮箱时type参数非法仅支持 1:启用,2:禁用
680044不允许禁用超级管理员、企业创建者检查userid是否为超级管理员或企业创建者
680045无法禁用已关闭的邮箱检查邮箱账号是否为关闭
680046启用邮箱数量达到最大限制检查企业中已启用的邮箱数量
842002代开发应用模版未上线-
842003不是代开发应用模版-
842004代开发应用模版数量不合法-
842005不支持的应用类型检查应用类型是否与文档说明一致
842006已存在代开发应用授权
844001非法的output_file_format判断输出文件格式是否正确
844002最近安装应用时间已超过7天,不再允许拨打公费电话联系管理员请检查最近一次安装应用时间是否超过7天
845001openid账号类型不是公众号或小程序-
845002openid认证主体和企业认证主体不一致-
845003unionid认证主体和企业认证主体不一致-
710000非法的open_corpid-
60252非法的openkfid检查openkfid是否拼写正确
60251缺少openkfid-
60253客服不在接待人员列表中检查传入的客服id是否在接待人员列表中
60257设置直属上级数量超过最大数量限制(5个)-
301007企业不可用,可能已经被解散或者被禁封-
701001不是license基础帐号-
701002不合法的license帐号-
701003激活码已绑定-
701004用户未激活该类型激活码,不允许续期-
701005无效的license订单-
701006不合法的license帐号类型-
701007不合法的帐号类型-
701008没有合法的有互通license的用户-
701009灰度期间,month只能为1个月-
701010所有的account_code都非法-
701011userid已经绑定-
701012active_code 超过绑定有效期-
701013灰度期间只允许续期一次-
701014jobid最多关联100w个userid-
701015没有第三方或者代开发授权,不允许下单-
701016帐号未激活或者已经过期-
701017帐号30天内迁移过-
701018迁移帐号重叠,接收帐号已有相同类型的帐号
701019用户userid非法或者跨企业-
701020有重复的userid-
701021非法的激活码-
701022激活码还在生成中,稍后再试-
701023有重复的激活码-
701024批量操作全部失败了-
701025批量操作传了空列表-
701026列表数量超过最大值-
701027测试企业购买帐号个数超限。-
701028测试企业购买月份超限,最多只能购买一个月-
701029测试企业只允许续期一次-
701030新激活码有效期累加用户绑定的旧激活码有效期超过5年-
701031有订单在迁移中,请迁移完成后再下单-
701032有订单未支付,请完成后再下单-
701033有订单正在生成激活码中,请稍后重试-
701034历史企业,需迁移完成后才能购买license订单,可以去服务商管理端购买license订单页面点击主动迁移-
701035有正式订单,所以无法添加测试订单-
701036有生效中的测试订单,所以无法添加订单-
701037存在订单申请退款中-
701038民生企业,只允许下单12个月-
701039民生企业,只允许下单12个月-
701040民生企业,不允许购买数量超过某个限制-
701081更新激活码的时候写冲突,请获取激活码最新详情再根据激活码最新情况处理-
701082该用户已经激活的情况-下,使用新码重新激活的场景,旧码剩余的时长不能超过20天

 

排查方法

错误码:40003

不合法的UserID。确认:
1)有效的UserID需要满足:长度1~64字符,由英文字母、数字、中划线、下划线以及点号构成。
2)除了创建用户,其余使用UserID的接口,还要保证UserID必须在通讯录中存在。

错误码:40007

不合法的媒体文件。确认:
1)媒体文件ID的获取方式,是否存在。注:上传临时素材生成的media_id,有效期是3天。
2)媒体文件类型应符合接口要求(比如发送图片消息,此时不能用音频文件的media_id)。

错误码:40014

access_token参数错误。确认:
1)access_token的获取方式
2)access_token是否已过期
可以重新获取一次access_token解决

错误码:40029

oauth_code参数错误。确认:
1)code只能消费一次,不能重复消费。比如说,是否存在多个服务器同时消费同一code情况。
2)code需要在有效期间消费(5分钟),过期会自动失效。

错误码:40032

不合法的UserID列表长度。确认:
1)发消息接口,最多指定1000人。
2)批量删除成员接口,最多指定200人。

错误码:40035

不合法的参数。确认:
1)userlist和partylist不能同时为空
2)userlist包含的成员个数不能大于1000
3)partylist包含的部门个数不能大于100
4)指定的userlist和partylist为数组格式,不是字符串格式。比如说, "userlist":[ "user1","user2"],而不是 "userlist": "user1|user2"

错误码:40054 40055

菜单设置URL不合法。确认:
1)链接需要带上协议头。以 http:// 或者 https:// 开头。比如:https://work.weixin.qq.com
2)微信支付的链接,必须以 weixin://wxpay/bizpayurl 开头

错误码:40056

agentid不合法。确认:
1)agentid为整型数字
2)在web管理端存在该应用

错误码:40063

必填的参数缺少,需要参照具体API接口说明。同时确认:
1)Http请求方法,是否正确。比如说接口要求以Post方法,就不能使用Get方式
2)Http请求参数,是否正确。比如说,接口内容要求json结构体,就不能以url参数传递或者form-data方式。

错误码:40070

指定的标签范围结点全部无效。确认:
1)指定的参数格式是否正确。比如,"userlist":[ "user1"],而不是指定为 "userlist" : "user1"。
2)指定的成员或者部门,是否存在于通讯录中。

错误码:40082

suite_token参数错误。确认:
1)suite_token的获取方式
2)suite_token是否已过期
可以重新获取一次suite_token解决

错误码:40084

不合法的永久授权码。确认:
1)是否填写有误
2)企业是否已取消授权该套件
3)永久授权码不能跨服务商使用

错误码:40092

导入文件存在不合法的内容。确认:
1)不允许上传空文件
2)文件内容缺少必填字段,比如:手机/邮箱,姓名,UserID或者部门。

错误码:41019

缺少 department 参数。确认:
1)创建成员接口,成员所属部门是必填信息。
2)所属部门是数字数组格式,不是字符串。如:"department: [1, 2]

错误码:45002

消息内容大小超过限制。确认:
1)文本消息类型:最长不超过2048个字节。
2)图文消息类型:最长不超过666k个字节

错误码:45009

接口调用超过限制。
1) 具体频率策略,参考:主动调用频率限制
2) 频率拦截时长一般与调用的限制时长相同,比如说是分钟级别的限制,则在中频率后的1分钟后自动解除。小时、天、以及月份,也是以此类推。
3) 我们对接口调用的频率限制是比较宽松的。对于接口中频率的调用,考虑以下优化:
- 接口实现时,仅系统失败需要重试。其余错误码,应该排查下调用失败原因
- 发消息应该控制合理调用,对于单个成员来说,一天收到大量的推送,体验是不好的
4) 获取access_token获取jsapi_ticket务必在服务端发起请求,并在服务端做好缓存,access_token或jsapi_ticket获取之后可以使用2小时。
5) 获取access_token时,如果应用的secret错误多次,会导致同一个IP被禁用一小时,所以重置应用secret之后,请及时调整获取access_token的secret配置。
6) 手机号换userid的接口,需确保手机号的正确性,若出错的次数超出企业规模人数的20%,会导致1天不可调用。
7) 开发者在调用时,可能会在请求url上加上debug=1参数以开启debug模式,该模式的频率限制很小,每分钟只有5次,开发者在正式上线前请务必去掉debug=1参数。
8) 部分频率拦截,可自助解封,访问:频率自助解封工具

 

错误码:45033

接口并发调用超过限制。出现这种拦截限制,一般是开发者的程序有bug,导致对同一份资源有过高的并发且持续不断的请求,例如对一个media_id一直持续不断请求“获取临时素材”接口。

错误码:45024

帐号数量超过上限。请确认:
1)通讯录是否有无效或者无用的帐号,可以删除,让出额度
2)提高帐号上限,可以提交重新认证或者申请扩容

错误码:45029

回包大小超过上限。请确认:
1)/cgi-bin/user/list:由于通讯录组织架构庞大,建议按部门分别拉取,同时不要指定fetch_child=1。

错误码:48002

API接口无权限调用,一般是应用的权限与所调用的接口不匹配,开发者调用接口前,请先仔细阅读每个接口的“权限说明”。以下是常见的错误情况:
1)写通讯录接口,只能由通讯录同步助手的access_token来调用。同时需要保证通讯录同步功能是开启的。
2)通讯录同步助手的access_token,仅用于同步通讯录,不能用于发消息
3)设置应用可见范围,仅支持注册定制化安装情况,详情见:设置授权应用可见范围
4)客户联系相关的接口,只能由系统应用“客户联系”调用,或由配置到客户联系“可调用应用”列表中的自建应用调用,或由申请了客户联系权限的第三方应用/代开发应用调用。
5) 打卡相关的接口,只能由系统应用“打卡”调用,或由配置到打卡“可调用应用”列表中的自建应用调用,或由申请了打卡权限的第三方应用/代开发应用调用。
6) 第三方应用申请了权限之后,需要重新提交审核发布,发布之后再由授权企业的管理员确认通过后,该类权限才正式生效,才能调用该类接口。
7) 应用群聊会话接口,仅支持自建应用调用,且自建应用的可见范围需要设置为根部门。
8) 非小程序的应用不能调用小程序通知消息。
9) 代开发应用获取access_token,应使用自建应用获取access_token的接口,而非第三方应用获取access_token的接口。

错误码:48007

API接口无权限调用,由于所需权限因互斥而未能拥有。请确认:
1) 微信客服相关接口,要求「微信客服->管理帐号、分配会话和收发消息」权限,因为权限被占用,实际并未拥有。可在企业管理后台“微信客服”进行权限管理。

错误码:50001

redirect_url未登记可信域名。请确认:
1)颁发code的场景在哪个应用点击的。消费code使用的access_token是否有该应用权限。(通过查询access_token权限可确认)
2)secret的获取来源
- 来源于应用:url的域名,需设置到应用可信域名中。
- 来源于通讯录同步助手:仅可同步通讯录,不可用于发消息或者消费code
- 来源于第三方套件授权:套件中至少有一个应用,设置了该url域名为可信域名
- 来源于管理组:管理组配置的应用列表,至少有一个应用设置了该url域名为可信域名

3)url填写的域名,必须与设置的可信域名 完全匹配(包括端口号)。比如:填可信域名填qq.com,访问url域名为www.qq.com,就不匹配;或者可信域名填www.qq.com,访问url域名为www.qq.com:8008,也不匹配。

错误码:50003

应用禁用之后,将无法再调用api,可在"管理端-应用管理"重新启用该应用。

错误码:60010

部门存在循环关系。请确认:
1)创建部门和更新部门时,指定的parentid参数不能是 部门id 或者 子部门id

错误码:60011

指定的成员/部门/标签参数无权限。请确认:
1) 指定的成员或部门或标签不在应用的可见范围之内。
2) 指定的成员或部门或标签,虽然在应用的可见范围,但应用对这些成员或部门或标签没有编辑权限。例如往标签添加成员时,若标签并非该应用所创建,那么即使该标签在应用的可见范围,也没有编辑该标签的权限。
3) 其他情况一般是应用不满足该接口调用的权限要求,请阅读相应接口说明文档中的“权限说明”。

错误码:60020

不安全的访问IP。请根据调用的应用类型分别按如下方法确认:
1)若调用者是企业自建应用或通讯录同步助手,请确认该IP是本企业服务器IP,并已经配置到应用详情的“企业可信IP”项目中。第三方服务商IP不能调用。
2)若调用者是第三方应用或服务商代开发应用,请确认该IP已经配置到“服务商管理后台”-“服务商信息”-“基本信息”-“IP白名单”。
3) 配置完可信IP之后,需要1分钟后才生效。

错误码:72023

一般为发票已进入后续报销流程,报销企业公众号/企业微信/App锁定了发票。

错误码:80001

可信域名不正确,未校验域名所有权归属或者可信域名没有ICP备案。请确认:
1)可信域名,只支持全域名匹配,无法通过配置父域来让所有子域都成为可信域名。
2)可信域名,不支持IP地址、端口号及短链域名。
3)如果确认域名已经通过ICP备案,但依然提示这个错误,请尝试重新设置。

错误码:81011

无权限操作标签。请确认:
1)除了通讯录同步助手和通讯录应用,其他应用和管理组都只能操作自己创建的标签。
2)通讯录同步助手或者通讯录应用,除了能管理自己的标签,还能操作超级管理组创建的标签。

错误码:81013

UserID、部门ID、标签ID全部非法或无权限。一般有以下两种原因:
1)成员、部门或标签已被删除,此种情况需要调整调用接口的接收人参数。
2)成员、部门或标签被移出应用的可见范围,可在管理端将接收人添加到应用的可见范围内。

错误码:82001

指定的成员/部门/标签全部为空。请确认:
参数是否有传递,且至少有一个参数非空。

错误码:84014

成员票据过期。确认:
1)user_ticket 有时效性,有效时长由expires_in指定。参考接口:根据code获取成员信息
2)若需再次获取用户详情,需要用户重新点击链接后,根据新的code获取新的user_ticket

错误码:84024

无注册信息。可能是以下两种情况:
1)注册流程未完成。
2)注册成功已超过24小时。

错误码:85005

域名未通过所有权校验,仅oauth2生效,jssdk功能将受限,请根据调用的应用类型按以下不同方式完成校验:
1)若调用者是企业自建应用,请登录企业微信管理端,进入应用详情,按照指引完成域名的所有权校验。
2)若调用者是第三方应用,请登录企业微信服务管理端,进入第三方应用详情,按照指引完成域名的所有权校验。

错误码:86216

存在非法会话成员ID。确认:
1)添加会话成员时,指定的成员ID不存在通讯录
2)删除会话成员时,指定的成员ID不存在于会话中

错误码:86220

指定的会话参数不合法。请确认:
1)参数 type 只能指定 single/group
2)参数 msgtype 只能指定 text/image/file/voice/link

错误码:91040

获取ticket的类型无效。jsapi ticket可以通过以下几种获取:
1)获取jsapi_ticket。这里参数只需要传access_token,不需要带其余的参数,比如type=jsapi
2)获取电子发票ticket。需要同时指定access_token及type,同时type=wx_card是固定的。

错误码:301002

无权限操作指定的应用。access_token来源需要有指定应用的权限。
比如说,发消息接口 指定了参数 "agentid": 14,但使用的 access_token 是通过应用agentid: 100032 生成的调用凭证,这种就会报该错误码。
access_token的权限查询,可在 错误码查询工具 确认。

错误码:301036

不允许更新该用户的userid。确认:
只有当userid由系统自动生成时,才被允许修改一次
比如,邀请关注时用户提交登记信息,审批通过后系统会自动分配userid,此时可修改userid

上一篇
访问频率限制
下一篇
企业规模与行业信息