企业微信接口错误代码汇总

|-1 | 系统繁忙 | 服务器暂不可用，建议稍候重试。建议重试次数不超过3次。 |
| 0 | 请求成功 | 接口调用成功 |
| 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 | 不合法的参数 | 查看帮助 |
| 40039| 不合法的url长度| url长度限制1024个字节|
| 40050 | chatid不存在 | 会话需要先创建后，才可修改会话详情或者发起聊天 |
| 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 | 不合法的openid | openid不存在，需确认获取来源 |
| 40074 | news消息不支持保密消息类型 | 图文消息支持保密类型需改用mpnews |
| 40077 | 不合法的pre_auth_code参数 | 预授权码不存在，参考： 获取预授权码 |
| 40078 | 不合法的auth_code参数 | 需确认获取来源，并且只能消费一次 |
| 40080 | 不合法的suite_secret | 套件secret可在第三方管理端套件详情查看 |
| 40082 | 不合法的suite_token | 查看帮助 |
| 40083 | 不合法的suite_id | suite_id不存在 |
| 40084 | 不合法的permanent_code参数 | 查看帮助 |
| 40085 | 不合法的的suite_ticket参数 | suite_ticket不存在或者已失效 |
| 40086 | 不合法的第三方应用appid | 至少有一个不存在应用id |
| 40088 | jobid不存在 | 请检查 jobid 来源 |
| 40089 | 批量任务的结果已清理 | 系统仅保存最近5次批量任务的结果。可在通讯录查看实际导入情况 |
| 40091 | secret不合法 | 可能用了别的企业的secret |
| 40092 | 导入文件存在不合法的内容 | 查看帮助 |
| 40093 | jsapi签名错误 | 请检查用于签名的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个|-|
| 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参数 | - |
| 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参数|-|
|41045|API添加「联系我」达到数量上限|-|
|41046|缺少企业群发消息id|-|
|41047|无效的企业群发消息id|-|
|41048|无可发送的客户|-|
|41049|缺少欢迎语code参数|-|
|41050|无效的欢迎语code|欢迎语code(welcome_code)具有时效性，须在添加好友后20秒内使用|
|41051|客户和服务人员已经开始聊天了|已经开始的聊天的客户不能发送欢迎语|
|41052|无效的发送时间|-|
|41053|客户未同意聊天存档|须外部联系人同意服务须知后，成员才可发送欢迎语|
|41054|该用户尚未激活|-|
|41055|群欢迎语模板数量达到上限|-|
|41056|外部联系人id类型不正确|-|
|41057|企业或服务商未绑定微信开发者账号|-|
| 41102 | 缺少菜单名 | - |
| 42001 | access_token已过期 | access_token有时效性，需要重新获取一次 |
| 42007 | pre_auth_code已过期 | pre_auth_code有时效性，需要重新获取一次 |
| 42009 | suite_access_token已过期 | suite_access_token有时效性，需要重新获取一次 |
|42012 | jsapi_ticket不可用，一般是没有正确调用接口来创建jsapi_ticket| 如果是agentConfig使用，请特别注意是否是使用" 获取应用身份的ticket"来获取jsapi_ticket|
| 42013 | 小程序未登陆或登录态已经过期 | 需要重新走登陆流程 |
| 42014 | 任务卡片消息的task_id不合法 | - |
| 42015 | 更新的消息的应用与发送消息的应用不匹配 | - |
| 42016 | 更新的task_id不存在| - |
| 42017 | 按钮key值不存在| - |
| 42018 | 按钮key值不合法| - |
| 42019 | 缺少按钮key值不合法| - |
| 42020 | 缺少按钮名称| - |
| 42021 | device_access_token 过期| - |
| 42022 | code已经被使用过。只能使用一次| - |
| 43004 | 指定的userid未绑定微信或未关注微工作台（原企业号） | 需要成员使用微信登录企业微信或者关注微工作台才能获取openid |
| 43009 | 企业未验证主体|-|
| 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 | 接口并发调用超过限制 | 查看帮助 |
| 45034 | url必须有协议头| 在url前面加上协议头 http:// 或 https:// |
| 46003 | 菜单未设置 | 菜单需发布后才能获取到数据 |
| 46004 | 指定的用户不存在 | 需要确认指定的用户存在于通讯录中 |
| 48002 | API接口无权限调用 | 查看帮助 |
| 48003 | 不合法的suite_id | 确认suite_access_token由指定的suite_id生成 |
| 48004 | 授权关系无效 | 可能是无授权或授权已被取消 |
| 48005 | API接口已废弃 | 接口已不再支持，建议改用新接口或者新方案 |
| 48006 | 接口权限被收回 | 由于企业长时间未使用应用，接口权限被收回，需企业管理员重新启用 |
| 50001 | redirect_url未登记可信域名 | 查看帮助 |
| 50002 | 成员不在权限范围 | 请检查应用或管理组的权限范围 |
| 50003 | 应用已禁用 | 查看帮助 |
| 60001 | 部门长度不符合限制 | 部门名称不能为空且长度不能超过32个字 |
| 60003 | 部门ID不存在 | 需要确认部门ID是否有带，并且存在通讯录中 |
| 60004 | 父部门不存在 | 需要确认父亲部门ID是否有带，并且存在通讯录中 |
| 60005 | 部门下存在成员 | 不允许删除有成员的部门 |
| 60006 | 部门下存在子部门 | 不允许删除有子部门的部门 |
| 60007 | 不允许删除根部门 | - |
| 60008 | 部门已存在 | 部门ID或者部门名称已存在 |
| 60009 | 部门名称含有非法字符 | 不能含有 \:?\ "\u003c>| 等字符 |
| 60010 | 部门存在循环关系 | 查看帮助 |
| 60011 | 指定的成员/部门/标签参数无权限 | 查看帮助 |
| 60012 | 不允许删除默认应用 | 默认应用的id为0 |
| 60020 | 访问ip不在白名单之中 | 查看帮助 |
| 60021 | userid不在应用可见范围内 | - |
| 60028 | 不允许修改第三方应用的主页 URL | 第三方应用类型，不允许通过接口修改该应用的主页 URL |
| 60102 | UserID已存在 | - |
| 60103 | 手机号码不合法 | 长度不超过32位，字符仅支持数字，加号和减号 |
| 60104 | 手机号码已存在 | 同一个企业内，成员的手机号不能重复。建议更换手机号，或者更新已有的手机记录。 |
| 60105 | 邮箱不合法 | 长度不超过64位，且为有效的email格式 |
| 60106 | 邮箱已存在 | 同一个企业内，成员的邮箱不能重复。建议更换邮箱，或者更新已有的邮箱记录。 |
| 60107 | 微信号不合法 |微信号格式由字母、数字、"-"、"\“组成，长度为 3-20 字节，首字符必须是字母或”-“或”\"|
| 60110 | 用户所属部门数量超过限制 | 用户同时归属部门不超过20个 |
| 60111 | UserID不存在 | UserID参数为空，或者不存在通讯录中 |
| 60112 | 成员name参数不合法 | 不能为空，且不能超过64字符 |
| 60123 | 无效的部门id | 部门不存在通讯录中 |
| 60124 | 无效的父部门id | 父部门不存在通讯录中 |
| 60125 | 非法部门名字 | 不能为空，且不能超过64字节，且不能含有\:\?"\u003c>|等字符 |
| 60127 | 缺少department参数 | - |
| 60129 | 成员手机和邮箱都为空 | 成员手机和邮箱至少有个非空 |
| 60132 | is_leader_in_dept和department的元素个数不一致| - |
| 60136 | 记录不存在| - |
| 60137 | 家长手机号重复 |同一个家校通讯录中，家长的手机号不能重复。建议更换手机号，或者更新已有的手机记录。 |
|60203|不合法的模版ID|-|
|60204|模版状态不可用|-|
|60205|模版关键词不匹配|-|
|60206|该种类型的消息只支持第三方独立应用使用|-|
|60207|第三方独立应用只允许发送模板消息|-|
|60208|第三方独立应用不支持指定@all，不支持参数toparty和totag|-|
|65000|学校已经迁移|-|
|65001|无效的关注模式|-|
|65002|导入家长信息数量过多|批量导入家长每次最多1000个|
|65003|学校尚未迁移|-|
|65004|组织架构不存在|-|
|65005|无效的同步模式|-|
|65006|无效的管理员类型|-|
|65007|无效的家校部门类型|-|
|65008|无效的入学年份|-|
|65009|无效的标准年级类型|-|
|65010|此userid并不是学生|-|
|65011|家长userid数量超过限制|每次最多批量处理100个家长|
|65012|学生userid数量超过限制|每次最多批量处理10个学生|
|65013|学生已有家长|-|
|65014|非学校企业|-|
|65015|父部门类型不匹配|添加学校部门，需满足层级关机，班级需要以年级为父部门|
| 72023 | 发票已被其他公众号锁定 | 查看帮助 |
| 72024 | 发票状态错误 | reimburse_status状态错误，参考： 更新发票状态 |
| 72037 | 存在发票不属于该用户 | 只能批量更新该openid的发票，参考： 批量更新发票状态 |
| 80001 | 可信域名不正确，或者无ICP备案 | 查看帮助 |
| 81001 | 部门下的结点数超过限制（3W） | - |
| 81002 | 部门最多15层 | - |
| 81003 | 标签下节点个数超过30000个|-|
| 81011 | 无权限操作标签 | 查看帮助 |
| 81012 | 缺失可见范围 | 请求没有填写UserID、部门ID、标签ID |
| 81013 | UserID、部门ID、标签ID全部非法或无权限 | 查看帮助 |
| 81014 | 标签添加成员，单次添加user或party过多 | - |
| 81015 | 邮箱域名需要跟企业邮箱域名一致 | - |
| 81016 | logined_userid字段缺失 | - |
| 81017 | items字段大小超过限制（20） | - |
| 81018 | 该服务商可获取名字数量配额不足 | - |
| 81019 | items数组成员缺少id字段 | - |
| 81020 | items数组成员缺少type字段 | - |
| 81021 | items数组成员的type字段不合法 | - |
| 82001 | 指定的成员/部门/标签全部为空 | 查看帮助 |
| 82002 | 不合法的PartyID列表长度 | 发消息，单次不能超过100个部门 |
| 82003 | 不合法的TagID列表长度 | 发消息，单次不能超过100个标签 |
| 84014 | 成员票据过期 | 查看帮助 |
| 84015 | 成员票据无效 | 确认user_ticket参数来源是否正确。参考接口： 根据code获取成员信息 |
| 84019 | 缺少templateid参数 |-|
| 84020 | templateid不存在 | 确认参数是否有带，并且已创建 |
| 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 | 公费电话余额不足| - |
| 84058 | caller 呼叫号码不支持| - |
| 84059 | 号码非法| - |
| 84060 | callee 呼叫号码不支持| - |
| 84061 | 不存在外部联系人的关系| - |
| 84062 | 未开启公费电话应用| - |
| 84063 | caller不存在| - |
| 84064 | callee不存在| - |
| 84065 | caller跟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 | 可信域名未通过所有权校验 | 查看帮助|
| 86001 | 参数 chatid 不合法 | - |
| 86003 | 参数 chatid 不存在 | - |
| 86004 | 参数 群名不合法 | - |
| 86005 | 参数 群主不合法 | - |
| 86006 | 群成员数过多或过少 | - |
| 86007 | 不合法的群成员 | - |
| 86008 | 非法操作非自己创建的群 | - |
| 86101 | 仅群主才有操作权限 | - |
| 86201 | 参数 需要chatid | - |
| 86202 | 参数 需要群名 | - |
| 86203 | 参数 需要群主 | - |
| 86204 | 参数 需要群成员 | - |
| 86205 | 参数 字符串chatid过长 | - |
| 86206 | 参数 数字chatid过大 | - |
| 86207 | 群主不在群成员列表 | - |
| 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不匹配|-|
|90300| orderid 不合法|-|
|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| 预支单与下单者企业不匹配 |-|
|90456| 必须指定组织者 |-|
|90457| 日历ID异常 |-|
|90458| 日历ID列表不能为空 |-|
|90459| 日历已删除 |-|
|90460| 日程已删除 |-|
|90461| 日程ID异常 |-|
|90462| 日程ID列表不能为空 |-|
|90463| 不能变更组织者 |-|
|90464| 参与者数量超过限制 |-|
|90465| 不支持的重复类型 |-|
|90466| 不能操作别的应用创建的日历/日程 |-|
|90467| 星期参数异常 |-|
|90468| 不能变更组织者 |-|
|90469| 每页大小超过限制 |-|
|90470| 页数异常 |-|
|90471| 提醒时间异常 |-|
|90472| 没有日历/日程操作权限 |-|
|90473| 颜色参数异常 |-|
|90474| 组织者不能与参与者重叠 |-|
|90475| 不是组织者的日历 |-|
|90500| 群主并未离职 |-|
|90501| 该群不是客户群 |-|
|90502| 群主已经离职 |-|
|90503| 满人 & 99个微信成员，没办法踢，要客户端确认 |-|
|90504| 群主没变 |-|
|90507| 离职群正在继承处理中 |-|
|90508| 离职群已经继承 |-|
| 91040 | 获取ticket的类型无效 | 查看帮助|
|92000| 成员不在应用可见范围之内 |-|
|92001| 应用没有敏感信息权限 |-|
|92002| 不允许跨企业调用 |-|
| 93000 | 机器人webhookurl不合法或者机器人已经被移除出群|-|
| 93004 | 机器人被停用|-|
|93008|不在群里|-|
|94000|应用未开启工作台自定义模式|请在管理端后台应用详情里面开启自定义工作台模式|
|94001|不合法的type类型|-|
|94002|缺少keydata字段|-|
|94003|keydata的items列表长度超出限制|-|
|94005|缺少list字段|-|
|94006|list的items列表长度超出限制|-|
|94007|缺少webview字段|-|
|94008|应用未设置自定义工作台模版类型|-|
| 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 | 获取打卡数据失败 | 系统失败，可重试处理 |
| 301023 | useridlist非法或超过限额 | 列表数量不能为0且不超过100 |
| 301024 | 获取打卡记录时间间隔超限 | 保证开始时间大于0 且结束时间大于 0 且结束时间大于开始时间，且间隔少于一个月 |
| 301025 | 审批开放接口参数错误 | 请参考参数说明正确填写 |
| 301036 | 不允许更新该用户的userid | 查看帮助|
| 302003 | 批量导入任务的文件中userid有重复 | - |
| 302004 | 组织架构不合法（1不是一棵树，2 多个一样的partyid，3 partyid空，4 partyid name 空，5 同一个父节点下有两个子节点 部门名字一样 可能是以上情况，请一一排查） | - |
| 302005 | 批量导入系统失败，请重新尝试导入 | - |
| 302006 | 批量导入任务的文件中partyid有重复 | - |
| 302007 | 批量导入任务的文件中，同一个部门下有两个子部门名字一样 | - |
| 2000002 | CorpId参数无效 | 指定的CorpId不存在 |
|600001|不合法的sn|sn可能尚未进行登记|
|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不匹配|-|
|600047|secretno的status非法|请确认是否是使用统一初始secretno的设备，如果是无有正确执行换secretno的流程|
|600048|无效的指纹算法|-|
|600049|无效的人脸识别算法|-|
|600050|无效的算法长度|-|
|600051|设备过期|-|
|600052|无效的文件分块|-|
|600053|该链接已经激活|-|
|600054|该链接已经订阅|-|
|600055|无效的用户类型|-|
|600056|无效的健康状态|-|
|600057|缺少体温参数|-|
|610001|永久二维码超过每个员工5000的限制|-|
|610003|scene参数不合法|有效的scene长度为1~64字符，由英文字母、数字、中划线、下划线以及点号构成|
|610004|userid不在客户联系配置的使用范围内|请在管理端后台 客户联系->配置->配置使用范围配置该用户|

排查方法

• 错误码：40003

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

• 错误码：40007

不合法的媒体文件。确认：
1）媒体文件ID的获取方式，是否存在。注：上传临时素材生成的medida_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. 我们对接口调用的频率限制是比较宽松的。对于接口中频率的调用，考虑以下优化：

- 接口实现时，仅系统失败需要重试。其余错误码，应该排查下调用失败原因
- 发消息应该控制合理调用，对于单个成员来说，一天收到大量的推送，体验是不好的

\t
4) 部分频率拦截，可自助解封，访问：频率自助解封工具
5) 发送应用消息的频率拦截，可用api接口查询各个应用消息发送统计，访问：查询应用消息发送统计

• 错误码：45033

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

• 错误码：45024

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

• 错误码：45028

素材数量超过上限。请确认：
1）图片和图文素材上限各为5000个。
2）其他类型的素材的上限各为1000个。

• 错误码：45029

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

• 错误码：48002

API接口无权限调用。请确认：
1）写通讯录接口，只能由通讯录同步助手的access_token来调用。同时需要保证通讯录同步功能是开启的。
2）通讯录同步助手的access_token，仅用于同步通讯录，不能用于发消息
3）设置应用可见范围，仅支持注册定制化安装情况，详情见：设置授权应用可见范围
4）客户联系相关的接口，只能由系统应用“客户联系”，或配置到“可调用应用”列表中的自建应用的access_token来调用。
5) 小程序应用仅支持发送小程序通知消息，暂不支持文本、图片、语音、视频、图文等其他类型的消息。

• 错误码：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，可在"管理端-应用管理"重新启用该应用。
\u003cimg src=“https://p.qpic.cn/pic_wework/1283325914/090fad19ebf740ce78b1e49f2cc0f0f8d1791c3262b8e946/0” style=“width:800px;”/>

• 错误码：60010

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

• 错误码：60011

指定的成员/部门/标签参数无权限。请确认：

1. 变更通讯录接口，需要有通讯录编辑权限。

   • 普通应用的secret仅有只读权限，可使用通讯录同步助手的secret同步。

2. 其它接口，需要满足配置的通讯录范围。

   • 成员：通讯录同步助手access_token可指定任意成员id；应用access_token仅能指定可见范围配置的成员，以及部门/标签包含的成员（递归展开）
   • 部门：通讯录同步助手access_token可指定任意部门id；应用access_token仅能指定可见范围配置的部门id(创建或移动部门，还需要具有父部门的管理权限)，标签包括的部门id，以及上述部门的子部门id
   • 标签：通讯录同步助手access_token可指定超级管理组及通讯录同步助手创建的标签；应用access_token仅能由应用API创建的标签

• 错误码：60020

访问ip不在白名单之中。请确认：
1）请确认访问ip是否在服务商白名单IP列表。
登录 服务商管理后台，在“服务商信息” - “基本信息” - “IP白名单”配置

• 错误码：72023

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

• 错误码：80001

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

• 错误码：81011

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

• 错误码：81013

UserID、部门ID、标签ID全部非法或无权限。一般有以下两种原因：
1）成员、部门或标签已被删除，此种情况需要调整调用接口的接收人参数。
2）成员、部门或标签被移出应用的可见范围，可在管理端将接收人添加到应用的可见范围内。
\u003cimg src=“https://p.qpic.cn/pic_wework/1283325914/4e48eb5ea14e98977a1687c6cceab0d61ad57eea9af062f0/0” style=“width:800px;”/>

• 错误码：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