错误编码如下

错误编码	错误描述	备注
310001	岗位来源系统(sourceSystem)不能为空	预校验阶段，position.sourceSystem未传或为空白。补充来源系统后重新推送。
310002	岗位来源编码(sourceCode)不能为空	预校验阶段，position.sourceCode未传或为空白。补充该岗位在上游的唯一来源编码后重新推送。
310003	删除岗位时在本租户未找到该岗位	DELETE按sourceSystem、sourceCode和tenantId查询不到目标岗位。核对来源键及租户；确认目标岗位本来就不存在时可忽略。删除分支不按positionCode兜底匹配。
310004	处理岗位时发生未归类异常	未被专用错误码识别的异常兜底。实际文案可附带原始异常，请一并提供给研发排查。旧版也使用此码归并编码重复、并发冲突、组织字段缺失等不同原因。
310005	本租户下岗位编码已存在，无法重复创建	捕获到DuplicateKeyException，包括包装异常最内层为该异常。核对岗位编码占用及来源映射；非DELETE操作在来源键未命中时会按positionCode兜底查找并更新，因此来源键变化不一定返回此码。
310006	岗位正被并发更新	捕获到OptimisticLockException。修复版具有重取最新版本后重试一次的逻辑；重试仍失败，或无法取得可用的最新记录、版本信息时可返回。稍后重推；持续出现时携带岗位标识联系管理员。
310007	根据上级岗位编码未找到上级岗位	仅定义，未接入实际报错分支。已核对的修复实现中，上级岗位找不到只记录警告，不返回此码；不能将其描述为当前必然触发的校验。
310008	根据单位编码未找到组织，无法确定岗位所属公司	新建岗位前，unitId或unitCompanyId任一为空。先同步组织，或修正unitCode后重推。更新已有岗位时，组织解析不到会保留原归属，并非每次unitCode查不到都会返回此码。
310009	岗位必填字段缺失，无法写入	标准文案提示检查所属公司、组织、排序等必填信息；实际分类条件为DataIntegrityViolationException，也可能涉及其他数据完整性约束，应结合报文及原始异常判断。

请求参数

Header 参数

Body 参数application/json

示例

{
    "data": [
        {
            "position": {
                "operation": "UPDATE_WITH_NULL",
                "sourceSystem": "OA",
                "sourceCode": "a3e413097a73489394ffca7a1d5e21e0",
                "positionCode": "P10001",
                "positionName": "研发工程师",
                "positionNameEn": "R & D Engineer",
                "description": "",
                "supervisorFlag": "1",
                "orderSeq": "1",
                "enabledFlag": "1",
                "parentPositionCode": "",
                "unitCode": "TECH"
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

4.2 岗位创建及更新

错误编码如下

请求参数

请求示例代码

返回响应

4.2 岗位创建及更新

错误编码如下#

请求参数

请求示例代码

返回响应

错误编码如下