# 附录一:错误码说明

企业每次调用接口时,可能获得正确或错误的返回码,企业可以根据返回码信息调试接口,排查错误。 注意:开发者的程序应该根据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是否按要求填写,建议二者传一个即可