# 附录一:错误码说明

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

# 返回码return_code定义

编码 描述 排查方法
0 成功 接口调用成功
101 企业唯一授权标识校验失败 企业唯一授权标识校验失败,首先排查openID和Appkey录入是否有误,如果录入无误,再向客户经理确认openApi接口访问能力是否已经开通
102 数据签名校验失败 签名错误,请参考业务接口格式规范 (opens new window)生成签名信息。注意:生成签名时的数据要和请求体中数据保持一致,包括空格回车等。
103 企业应用或销户 -
104 企业授权接入地址校验失败 表示实际请求接口的IP地址不在企业授权访问接口的IP地址列表中
105 OPENAPI接口未授权访问 请客户经理协助开通该接口访问权限
106 企业数据源不存在 确认信息企业是否在SaaS云服务器,是否销户或停用
405 接口请求方法错误 勤策(原外勤365)的API接口仅支持POST请求,如果请求方式为GET,服务器会返回405状态码
1 其他原因失败,详细用return_msg描述 -
100101 部门唯一标识已经存在! 来源第三方系统的部门唯一标识org_id必须唯一,不能重复
100102 部门名称或编号已经存在! 部门名称org_name或部门编码org_code必须唯一,不能重复
100103 部门唯一标识不存在 id是勤策(原外勤365)的唯一标识,org_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策(原外勤365)的id。首先排查id和org_id是否按要求填写,建议二者传一个即可
100104 上级部门唯一标识不存在 waiqin365_parent_id是勤策(原外勤365)的唯一标识,org_parent_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策(原外勤365)的waiqin365_parent_id。首先排查waiqin365_parent_id和org_parent_id是否按要求填写,建议二者传一个即可
100201 员工唯一标识已经存在 -
100202 员工登录账号已经存在 -
100203 员工名称已经存在 -
100204 员工手机号码已经存在 -
100205 员工唯一标识不存在 id是勤策(原外勤365)的唯一标识,emp_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策(原外勤365)的id。首先排查id和emp_id是否按要求填写,建议二者传一个即可
100206 上级员工唯一标识不存在 waiqin365_parent_id是勤策(原外勤365)的唯一标识,emp_parent_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策(原外勤365)的waiqin365_parent_id。首先排查waiqin365_parent_id和emp_parent_id是否按要求填写,建议二者传一个即可
100301 客户唯一标识已存在 -
100302 客户名称已存在 -
100303 客户唯一标识不存在 id是勤策(原外勤365)的唯一标识,cm_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策(原外勤365)的id。首先排查id和cm_id是否按要求填写,建议二者传一个即可
100304 客户经理不存在 -
100601 商品唯一标识已经存在 -
100602 商品编码已经存在 -
100603 商品名称已经存在 -
100605 商品唯一标识不存在 id是勤策(原外勤365)的唯一标识,prd_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策(原外勤365)的id。首先排查id和prd_id是否按要求填写,建议二者传一个即可
100606 商品类型名称或者唯一标识已经存在 -
100607 商品类型父节点不存在 -
100608 商品类型不存在 prd_waiqin365_id是勤策(原外勤365)的唯一标识,prd_id是第三方系统的唯一标识。注意:如果同时存在优先取勤策(原外勤365)的prd_waiqin365_id。首先排查prd_waiqin365_id和prd_id是否按要求填写,建议二者传一个即可