创建成本中心

单个创建成本中心；可定义成本中心的名称，父级成本中心，成本中心负责人，生效时间等

Tip: 此接口字段是否必填以【飞书人事-组织配置】为准。建议参照【飞书人事-组织管理-成本中心-新建】页面来传参

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/cost_centers
HTTP Method	POST
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	corehr:cost_center:write 创建、更新、删除成本中心信息
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

查询参数

名称	类型	必填	描述
user_id_type	string	否	用户 ID 类型 示例值：people_corehr_id 可选值有： - open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ - people_corehr_id: 以飞书人事的 ID 来识别用户 默认值：people_corehr_id 当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID

请求体

名称	类型	必填	描述
name	i18n\[\]	是	成本中心名称 - 名称不能包含「/」「；」「;」「\」「'」字符 - 成本中心中英文名称会有全局唯一校验
└ lang	string	是	名称信息的语言，支持中文和英文。中文用zh-CN；英文用en-US 示例值："zh-CN"
└ value	string	是	文本内容 示例值："基础架构相关"
code	string	否	成本中心编码 (不能与其他记录的编码重复) - 开启自动编码时，以自动生成的编码值为准，传入值不生效 - 未开启自动编码时，编码字段值以传入值为准 示例值："MDPD00000023"
parent_cost_center_id	string	否	上级成本中心ID，详细信息可通过【搜索成本中心信息】接口查询获得 示例值："6862995757234914824"
managers	string\[\]	否	成本中心负责人ID 列表。ID获取方式： - 调用【添加人员】返回雇佣信息ID - 调用【搜索员工信息】接口返回雇佣信息ID 示例值：["6862995757234914824"]
description	i18n\[\]	否	成本中心描述
└ lang	string	是	信息的语言，支持中文和英文。中文用zh-CN；英文用en-US 示例值："zh-CN"
└ value	string	是	成本中心描述的具体内容 示例值："基础架构相关业务"
effective_time	string	是	版本生效日期 - 填写格式：YYYY-MM-DD - 系统默认为填写日期当天的 00:00:00 生效 - 该接口只支持到最小单位为日 - 日期范围要求:1900-01-01～9999-12-31 - 详情可以参考时间轴介绍 示例值："2020-01-01"

请求体示例

{
    "name": [
        {
            "lang": "zh-CN",
            "value": "基础架构相关"
        }
    ],
    "code": "MDPD00000023",
    "parent_cost_center_id": "6862995757234914824",
    "managers": [
        "6862995757234914824"
    ],
    "description": [
        {
            "lang": "zh-CN",
            "value": "基础架构相关业务"
        }
    ],
    "effective_time": "2020-01-01"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ cost_center	cost_center	成本中心信息
└ cost_center_id	string	成本中心ID - 详细信息可通过【搜索成本中心信息】接口查询获得
└ cost_center_version_id	string	成本中心版本ID - 详细信息可通过【搜索成本中心信息】接口查询获得
└ name	i18n\[\]	成本中心名称
└ lang	string	信息的语言，支持中文和英文。中文用zh-CN；英文用en-US
└ value	string	文本内容
└ code	string	编码
└ parent_cost_center_id	string	上级成本中心ID，详细信息可通过【搜索成本中心信息】接口查询获得
└ managers	string\[\]	成本中心负责人ID 列表；详细信息可通过【搜索员工信息】接口获取
└ description	i18n\[\]	成本中心描述
└ lang	string	信息的语言，支持中文和英文。中文用zh-CN；英文用en-US
└ value	string	文本内容
└ effective_time	string	版本生效日期 - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59
└ expiration_time	string	版本失效日期 - 返回格式：YYYY-MM-DD （最小单位到日） - 日期范围:1900-01-01 ～9999-12-31
└ active	boolean	成本中心启用状态，true为启用，fasle为停用

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "cost_center": {
            "cost_center_id": "6969828847121885087",
            "cost_center_version_id": "6969828847121885087",
            "name": [
                {
                    "lang": "zh-CN",
                    "value": "基础架构"
                }
            ],
            "code": "MDPD00000023",
            "parent_cost_center_id": "6862995757234914824",
            "managers": [
                "6862995757234914824"
            ],
            "description": [
                {
                    "lang": "zh-CN",
                    "value": "基础架构相关内容"
                }
            ],
            "effective_time": "2020-01-01",
            "expiration_time": "2020-01-01",
            "active": true
        }
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1160402	Param is invalid	输入参数格式不合法
400	1160404	Name already exists	名称不可重名
400	1160403	Code already exists	Code 不可重名
400	1160405	Some objects will expire soon	请检查填入的 上级成本中心 或 人员 状态，有如下几种情况 1. 上级成本中心的需要在生效时间为生效状态 2. 上级成本中心在当前成本中心的生效期间需要一直为「启用」状态 3. 上级成本中心存在停用的审批流程 (本期没有) 4. 填入的人员在生效时间需要为已入职状态
400	1160406	Invalid structure	出现环状结构，请检查填入的上级成本中心是否为当前成本中心的下级成本中心