# 附录一:错误码说明
企业每次调用接口时,可能获得正确或错误的返回码,企业可以根据返回码信息调试接口,排查错误。 注意:开发者的程序应该根据return_code来判断出错的情况,而不应该依赖return_msg来匹配,因为return_msg可能会调整。 如果请求的参数不符合json规范(如类型不匹配、格式有问题),可能会导致勤策解析到的参数不完整,此时接口在返回的return_msg里会有 “服务器忙,调用远程接口失败.”,开发者需要重新检查请求参数的json合法性。
# 返回码return_code定义
编码 | 描述 | 排查方法 |
---|---|---|
0 | 成功 | 接口调用成功 |
101 | 企业唯一授权标识校验失败 | 企业唯一授权标识校验失败,首先排查openID和Appkey录入是否有误,如果录入无误,再向客户经理确认openApi接口访问能力是否已经开通 |
102 | 数据签名校验失败 | 签名错误,请参考业务接口格式规范 (opens new window)生成签名信息。注意:生成签名时的数据要和请求体中数据保持一致,包括空格回车等。 |
103 | 企业应用或销户 | - |
104 | 企业授权接入地址校验失败 | 表示实际请求接口的IP地址不在企业授权访问接口的IP地址列表中 |
105 | 请求OpenAPI响应失败 | 请求勤策API服务网络失败,请检查网络是否畅通 |
106 | 请求OpenAPI失败 | 请求访问勤策API失败,请检查网络或URL是否畅通 |
107 | 请求编码失败 | 请求编码失败,请检查参数字符编码 |
108 | 请求参数有误 | 调用API接口参数有误,请检查是否正确 |
109 | 生成签名失败 | 生成数据签名失败 |
205 | OPENAPI接口未授权访问 | 请客户经理协助在API授权页面开通该接口访问权限 |
206 | 企业数据源不存在 | 确认信息企业是否在SaaS云服务器,是否销户或停用 |
207 | 并发请求超限额, 建议您联系客户经理确认调用并发数 | 建议您联系客户经理确认调用并发数 |
405 | 接口请求方法错误 | 勤策的API接口仅支持POST请求,如果请求方式为GET,服务器会返回405状态码 |
415 | 服务器无法处理请求附带的媒体格式 | 勤策的API接口仅支持JSON格式的数据,解决方法就是在请求头中添加: "Content-Type":"application/json" |
1 | 其他原因失败,详细用return_msg描述 | - |
100101 | 部门唯一标识已经存在! | 来源第三方系统的部门唯一标识org_id必须唯一,不能重复 |
100102 | 部门名称或编号已经存在! | 部门名称org_name或部门编码org_code必须唯一,不能重复 |
100103 | 部门唯一标识不存在 | id是勤策的唯一标识,org_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策的id。首先排查id和org_id是否按要求填写,建议二者传一个即可 |
100104 | 上级部门唯一标识不存在 | waiqin365_parent_id是勤策的唯一标识,org_parent_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策的waiqin365_parent_id。首先排查waiqin365_parent_id和org_parent_id是否按要求填写,建议二者传一个即可 |
100201 | 员工唯一标识已经存在 | - |
100202 | 员工登录账号已经存在 | - |
100203 | 员工名称已经存在 | - |
100204 | 员工手机号码已经存在 | - |
100205 | 员工唯一标识不存在 | id是勤策的唯一标识,emp_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策的id。首先排查id和emp_id是否按要求填写,建议二者传一个即可 |
100206 | 上级员工唯一标识不存在 | waiqin365_parent_id是勤策的唯一标识,emp_parent_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策的waiqin365_parent_id。首先排查waiqin365_parent_id和emp_parent_id是否按要求填写,建议二者传一个即可 |
100301 | 客户唯一标识已存在 | - |
100302 | 客户名称已存在 | - |
100303 | 客户唯一标识不存在 | id是勤策的唯一标识,cm_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策的id。首先排查id和cm_id是否按要求填写,建议二者传一个即可 |
100304 | 客户经理不存在 | - |
100601 | 商品唯一标识已经存在 | - |
100602 | 商品编码已经存在 | - |
100603 | 商品名称已经存在 | - |
100605 | 商品唯一标识不存在 | id是勤策的唯一标识,prd_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策的id。首先排查id和prd_id是否按要求填写,建议二者传一个即可 |
100606 | 商品类型名称或者唯一标识已经存在 | - |
100607 | 商品类型父节点不存在 | - |
100608 | 商品类型不存在 | prd_waiqin365_id是勤策的唯一标识,prd_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策的prd_waiqin365_id。首先排查prd_waiqin365_id和prd_id是否按要求填写,建议二者传一个即可 |