全局返回码

附录

附录包含了开放平台api接口返回的错误码。

每次调用接口时，可能获得正确或错误的返回码，企业应用可以根据返回码信息调试接口，排查错误。

全局返回码说明如下：

返回码	说明
-2	系统错误
-1	系统繁忙
0	请求成功
10001	缺少参数appId
10002	缺少参数appSecret
10003	缺少参数appAccessToken
10004	缺少参数redirectUri
10005	缺少参数responseType
10006	缺少参数scope
10007	缺少参数state
10008	缺少参数code
10009	缺少参数appAccount
10010	缺少参数openUserId
10012	缺少参数permanentCode
10013	缺少参数corpAccessToken
10014	缺少参数corpId
10015	缺少参数toUser
11001	参数appId不合法
11002	参数appSecret不合法
11003	参数appAccessToken不合法
11004	参数redirectUri不合法
11005	参数responseType不合法
11006	参数scope不合法
11007	参数state不合法
11008	参数openUserId不合法
11009	参数departmentId不合法
11010	参数code不合法
11011	参数appAccount不合法
11013	参数permanentCode不合法
11014	参数corpAccessToken不合法
11015	参数corpId不合法
11016	参数toUser不合法
11017	参数msgType不合法
11018	参数templateId不合法
12002	登录状态错误
12003	未支持的消息类型
12004	POST的数据包为空
12005	文本消息内容为空
14001	接口调用超过限制
15002	参数不合法
15003	APP没有访问权限
20005	accessToken不存在或者已经过期
20006	appId或appSecret错误
20010	CODE不存在或者已经过期
20012	openUserId未找到
20014	应用没有获取该员工的数据的权限
20015	永久授权码错误
20016	corpAccessToken不存在或者已经过期
20017	corpId未找到
20020	应用没有获取该企业的数据的权限
20021	在当前企业下，该app的状态为停用
20022	企业没有对该app授权
20023	APP没有访问department的权限
30003	客户没有购买openapi配额，需要提open api订单进行购买
30007	部门不存在
30027	员工不存在
32000	参数错误
40010	templateId不合法

接口报错【无此操作的数据权限】

1.查看参数【openUserId】对应用户对应的角色是否具备查看该条数据的权限。CRM管理员默认具备查看、修改等所有数据（除人员对象）的操作权限。故可以尝试使用CRM管理员的【openUserId】作为参数进行查询。

人员对象查不到数据

有时候在使用人员对象会有查不到数据，或者查到的数据不全的问题。此时需要创建共享规则将人员对象的数据共享给对应接口调用时【openUserId】参数对应的员工。

数据共享文档说明: https://www.fxiaoke.com/mob/guide/crmdoc/src/7-1-3%E6%95%B0%E6%8D%AE%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86.html

配置人员对象共享规则：

配置完成后生效时间比较长，请耐心等待。当使用【openUserId】对应的用户登录，进行人员对象的列表页面，如果可以看到数据，则表明共享规则以及生效，此时可以使用接口查到数据。

接口报错【没有XXXX权限】

调用一次查询销售订单接口相当于用户访问了一次销售订单的列表数据。系统会判断该用户是否具备访问销售订单列表数据的权限，如果没有权限会报错：【没有XXXX权限】，而接口中标识用户的参数就是currentOpenUserId。所以解决这个问题的方式就是给这个人增加权限。或者更换该参数为具备权限的人。纷享销客系统中，CRM管理员默认具备所有权限，所以通常会使用CRM管理员的参数值。

但是有些时候，这个人具备该权限，还是会报错【没有XXX权限】，这是因为受到业务逻辑限制，以下列表表明了业务场景和解决办法：

业务场景	报错信息	解决方法
调用更改线索负责人接口	无此操作的数据权限	当线索处于线索池中时，任何人都没有操作权限，需要将线索从线索池中领取后，才能进行操作
调用更改客户负责人接口	无此操作的数据权限	当客户处于公海中时，任何人都没有操作权限，需要将客户从公海中领取后，才能进行操作

接口报错【Bad Request】

当在调用v1版本自定义对象时候，如果currentOpenuserId不是管理员会报错【Bad Request】，需要将currentOpenUserId更换为CRM管理员的openUserId，获取CRM管理员的方式见文档 https://open.fxiaoke.com/wiki.html#artiId=1122

查看当天调用次数

根据条件查询对象数据接口缺少数据

当调用条件查询对象接口缺少数据，请按照以下步骤解决：

确认调用接口时是否进行了分页查询，offset是偏移量而非页码。

如果是人员对象，请参考上文人员对象数据缺少进行解决。

登录进CRM系统，进入对应对象列表页面，判断浏览器页面显示的数据是否与接口返回数据一致。

若接口返回的数据与浏览器页面数据相比，缺少了数据，则因为currentOpenUserId参数对应的用户没有权限查看，需要将该参数更换为CRM管理员或者给对应的人员添加权限。

全局返回码

附录#