新建组织编制和新建细分编制

POST

/TenantBaseExternal/api/v5/OrganizationEstablishment/CreateEstablishment

接口限制：100次/秒/企业 3000次/分钟/企业

适用场景：新建组织编制和新建细分编制

警告信息：不适用场景：同时新建组织编制和细分编制，批量新建编制

tips：必填项：组织，年份，编制类型；如果是细分编制，则要有对应的细分维度
若新建成功，则返回编制数据id

错误码示例

{
"data": null,
"code": "00908-010107",
"message": "操作失败！检查到该组织已存在日期范围重叠的编制记录"
}

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/OrganizationEstablishment/CreateEstablishment' \
--header 'Content-Type: application/json' \
--data-raw '{
    "OrganizationEstablishment":{
        "year" : 2021, //编制年份
        "month": "9", //编制月份
        "establishmentType" : 2, //编制类型= 细分编制
        "estestablishmentScheme": "2059acc8-00cc-4a6f-a2a0-5864f35c0978", //编制方案
        "oIdOrganization": 4637750, //编制所属组织
        "employType":"1", //雇佣关系=实习生
        "employmentType": "6d2d300e-71f8-4dc4-896d-5c2749d4f9bf",//人员类别
        "strictControl":0,//非严格控制
        "thisLevelEstablishmentOrSubdivideEstablishment": 1,//本级细分编制数
        "withLowerEstablishmentOrSubdivideEstablishment":1, //含下级细分编制数
        "customProperties":{ //自定义字段集合
            "exttext": "自定义文本"
        }
    }
}'

响应示例

{
    "data": "string",
    "code": "string",
    "message": "string"
}

请求参数

Body 参数application/json

organizationEstablishment

object

可选

establishmentType

integer <int32>

必需

编制类型 1是组织编制，2是细分编制

oIdOrganization

integer <int32> | null

必需

任职部门（如技术部），对应组织单元业务实体下部门OId，示例：23091

year

integer <int32>

必需

年份，新建编制所属年份，示例：2021

thisLevelEstablishmentOrSubdivideEstablishment

integer <int32>

必需

本级编制或本级细分编制（编制类型为组织编制时，业务含义对应本级编制；否则对应本级细分编制），示例：4

withLowerEstablishmentOrSubdivideEstablishment

integer <int32>

必需

含下级编制或含下级细分编制（编制类型为组织编制时，业务含义对应含下级编制；否则对应含下级细分编制），示例：5

quarterly

string

可选

季度（编制方案为季度方案时必填）,为1-4的数值,示例："1"

month

string

可选

月份（编制方案为月度方案时必填）,为1-12的数值,示例："12"

oIdJobSequence

string

可选

职务序列实体（实体编码：TenantBase.JobSequence）OId字段的值，示例：1459

oIdJobPost

integer <int32> | null

可选

职务实体（实体编码：TenantBase.JobPost）OId字段的值，示例：62797

employmentType

string

可选

人员类别实体对象（实体编码：TenantBase.EmploymentType）业务数据GUID

oIdJobPosition

string

可选

职位实体（实体编码：TenantBase.JobPosition）OId字段的值，示例：a29c442e-b101-4cba-bd7c-6411c0b672a4

employType

string

可选

雇佣关系：0内部员工，1外部员工，2实习生。默认0内部员工

place

string

可选

工作地点详细地址

estestablishmentScheme

string

可选

编制方案（实体编码：TenantBase.EstestablishmentScheme）业务数据GUID
（如果是组织编制，不填则为默认方案；如果是细分编制，则可为空（读取传入的组织编制上的方案信息））

strictControl

integer <int32> | null

可选

严格控制，1是；0否（默认为否）

remarks

string

备注

可选

establishmentDate

string <date-time> | null

可选

制定日期，必须大于等于1900-01-01，示例：2020-1-12

optionalSysProperties

object

可选

非必填（可选）标准字段Key（字段编码）-Value（字段值）字典，暂不使用，仅预留方便后续扩展使用。(区分大小写，自动忽略自定义字段和不存在的字段)，若有同名属性，则优先使用属性值。示例：key=Remarks,value="可选标准字段"

customProperties

object

可选

租户级别自定义字段Key（字段编码）-Value（字段值）字典(区分大小写，自动忽略非自定义字段和不存在的字段)，示例：key=exthtxybeizhua_127666_1123139652,value="自定义字段"

示例

返回响应

🟢200核心人力操作结果

application/json

Body

data

string

可选

code

string

可选

响应码（正常情况必须200）或异常错误编码（异常情况）：200-OK，417-参数异常、业务不合法，500-内部服务器异常。示例："200"

message

string

结果消息

可选

修改于 2021-10-13 10:54:25

获取全部编制或者指定部门编制

根据时间窗滚动查询变动的专业条线信息

新建组织编制和新建细分编制

错误码示例#

请求参数

返回响应

错误码示例