飞书开放平台 Server API 文档

主题

创建成本中心版本 ​

创建成本中心版本；每次调用可创建一个成本中心版本，可定义成本中心的名称，描述，上级成本，成本中心负责人，版本生效时间等信息，接口内会做相关规则的校验

Tip: 非必填字段，不传时默认为空

请求 ​

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

请求头 ​

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

路径参数 ​

名称类型描述
cost_center_idstring成本中心ID，可通过【搜索成本中心信息】接口查询获得
示例值："6862995757234914824"

查询参数 ​

名称类型必填描述
user_id_typestring否用户 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

请求体 ​

名称类型必填描述
namei18n\[\]是成本中心名称
  └ langstring是信息的语言，支持中文和英文。中文用zh-CN；英文用en-US
示例值："zh-CN"
  └ valuestring是文本内容
示例值："基础架构"
codestring否成本中心编码(不能与其他记录的编码重复) - 开启自动编码时，以自动生成的编码值为准，传入值不生效 - 未开启自动编码时，编码字段值以传入值为准 - 新建版本不支持将code设置为空，如需要将 code 设置为空请使用【更正成本中心版本】
示例值："MDPD00000023"
parent_cost_center_idstring否上级成本中心ID，可通过【搜索成本中心信息】接口查询获得
示例值："6862995757234914824"
managersstring\[\]否成本中心负责人ID 列表，可通过【搜索员工信息】接口获取
示例值：["6862995757234914824"]
descriptioni18n\[\]否成本中心描述
  └ langstring是信息的语言，支持中文和英文。中文用zh-CN；英文用en-US
示例值："zh-CN"
  └ valuestring是文本内容
示例值："基础架构相关业务"
effective_timestring是版本生效时间 - 填写格式：YYYY-MM-DD - 系统默认为填写日期当天的 00:00:00 生效 - 该接口只支持到最小单位为日 - 日期范围要求:1900-01-01～9999-12-31 - 详情可以参考时间轴介绍
示例值："2020-01-01"
operation_reasonstring是操作原因
示例值："过期作废"

请求体示例 ​

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

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ versioncost_center.version成本中心版本信息
    └ cost_center_idstring成本中心ID
    └ version_idstring成本中心版本ID
    └ namei18n\[\]成本中心名称
      └ langstring信息的语言，支持中文和英文。中文用zh-CN；英文用en-US
      └ valuestring文本内容
    └ codestring编码
    └ parent_cost_center_idstring上级成本中心ID，详细信息可通过【搜索成本中心信息】接口查询获得
    └ managersstring\[\]成本中心负责人ID 列表，详细信息可通过【搜索员工信息】接口获取
    └ descriptioni18n\[\]成本中心描述
      └ langstring信息的语言，支持中文和英文。中文用zh-CN；英文用en-US
      └ valuestring文本内容
    └ effective_timestring版本生效日期 - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 - 详情可以参考时间轴介绍
    └ expiration_timestring版本失效日期 - 返回格式：YYYY-MM-DD 00:00:00（最小单位到日） - 日期范围:1900-01-01 00:00:00～9999-12-31 23:59:59 - 详情可以参考时间轴介绍
    └ activeboolean当前实体是否启用

响应体示例 ​

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "version": {
            "cost_center_id": "6969828847121885087",
            "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状态码错误码描述排查建议
4001160402Param is invalid输入参数格式不合法
4001160404Name already exists名称 不可重名
4001160403Code already existsCode 不可重名
4001160405Some objects will expire soon请检查填入的 上级成本中心 或 人员 状态，有如下几种情况 1. 上级成本中心的需要在生效时间为生效状态 2. 上级成本中心在当前成本中心的生效期间需要一直为「启用」状态 3. 上级成本中心存在停用的审批流程 (本期没有) 4. 填入的人员在生效时间需要为已入职状态
4001160406Invalid structure出现环状结构，请检查填入的上级成本中心是否为当前成本中心的下级成本中心

内容来源：飞书开放平台 · 自动爬取整理

本镜像仅供学习与查阅，文档版权归飞书所有