获取员工薪资标准

• 调用此接口来获取员工匹配的薪资标准信息
• 请求时，可选传递员工的部门 ID、职级 ID、职务ID 、序列 ID 等筛选条件，用于匹配薪资标准
• 此接口将返回员工可匹配到的薪资标准全部信息，包括薪资标准表 ID、薪级薪等、薪资带宽、薪资标准值等

Tip: 该接口会按照应用拥有的「薪资标准资源」的权限范围返回数据，请确定在「开发者后台 - 权限管理 - 数据权限-飞书人事(企业版)数据权限范围」中已申请「薪资标准资源」权限范围

请求

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

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

查询参数

名称	类型	必填	描述
user_id_type	string	否	用户 ID 类型 示例值：open_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来识别用户 默认值：open_id 当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
department_id_type	string	否	此次调用中使用的部门 ID 类型，传入部门ID时传入 示例值：open_department_id 可选值有： - open_department_id: 【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同。 - department_id: 【飞书】用来标识租户内一个唯一的部门。 - people_corehr_department_id: 【飞书人事】用来标识「飞书人事」中的部门。 默认值：people_corehr_department_id
employment_id	string	否	雇员ID，可通过接口【批量查询员工信息】获取 示例值：7124293751317038636
reference_object_api	string	否	薪资标准的关联对象，项目或者指标 示例值：cpst_item 可选值有： - cpst_item: 薪资项目 - cpst_indicator: 薪资统计指标
reference_object_id	string	是	薪资标准表关联对象ID，即薪资项目/统计指标ID，可通过接口【批量查询薪资项】、【批量查询薪资统计指标】获取 示例值：7156853394442044972
department_id	string	否	部门ID，可通过接口【批量查询部门】获取 示例值：od-53899868dd0da32292a2d809f0518c8f
work_location_id	string	否	工作地点ID，可通过接口【批量查询地点】获取 示例值：7094869485965870636
company_id	string	否	公司ID，可通过接口【批量查询公司】获取 示例值：7091599096804394540
job_family_id	string	否	职务序列ID，可通过接口【批量查询职务序列】获取 示例值：7039313681989502508
job_id	string	否	职务ID，可通过接口【批量查询职务】 示例值：7342883436321097257
job_level_id	string	否	职级ID，可通过接口【批量查询职务级别】获取 示例值：7086415175263258156
employee_type_id	string	否	人员类型ID，可通过接口【批量查询人员类型】获取 示例值：7039310401359775276
recruitment_type	string	否	招聘类型 示例值：experienced_professionals 可选值有： - experienced_professionals: 社招 - recent_graduates: 校招 - routine_intern: 日常实习
cpst_change_reason_id	string	否	定调薪原因ID，可通过接口【批量查询定调薪原因】获取 示例值：6967639606963471117
cpst_plan_id	string	否	薪资方案ID，可通过接口【批量查询薪资方案】获取 示例值：6967639606963471118
cpst_salary_level_id	string	否	薪级薪等ID 示例值：6967639606963471119
effective_time	string	否	生效时间（毫秒级时间戳） 示例值：1660924800000

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	cpst_match_item	-
└ standard_id	string	薪资标准表ID
└ grade	cpst_grade	薪资等级
└ grade_id	string	薪资等级ID
└ grade_tid	string	薪资等级时间轴ID
└ grade_standard_value	cpst_grade_standard_value	带宽上下限和标准值
└ reference_object	reference_object	薪资标准的关联对象，项目或者指标
└ api_name	string	cpst_item(项目)、 cpst_indicator(指标) 可选值有： - cpst_item: 项目 - cpst_indicator: 指标
└ id	string	值列表 例如薪资项和薪资统计指标ID
└ standard_type	cpst_standard_type	薪资标准类型
└ api_name	string	薪资标准类型 可选值有： - standard_value: 标准值 - bandwidth_and_standard_value: 上下限和标准值 - bandwidth_upper_and_lower_limit: 上下限
└ band_width	cpst_band_width	上下限
└ upper_limit	string	上限
└ lower_limit	string	下限
└ standard_value	string	标准值
└ currency	cpst_currency	币种
└ currency_id	string	币种ID，可通过接口【查询货币信息】获取
└ code	string	币种code
└ name	cpst_i18n	币种名称
└ zh_cn	string	中文
└ en_us	string	英文
└ description	cpst_i18n	薪资标准描述
└ zh_cn	string	中文
└ en_us	string	英文
└ effective_time	string	生效时间（毫秒级时间戳）

响应体示例

{
    "code": 0,
    "data": {
        "effective_time": "1660924800000",
        "grade": {
            "currency": {
                "code": "CNY",
                "currency_id": "6863329932261459464",
                "name": {
                    "en_us": "Renminbi (Chinese) yuan",
                    "zh_cn": "人民币元"
                }
            },
            "grade_id": "7174758360888215084",
            "grade_standard_value": {
                "band_width": {
                    "lower_limit": "5000",
                    "upper_limit": "10000"
                },
                "reference_object": {
                    "api_name": "cpst_item",
                    "id": "7156853394442044972"
                },
                "standard_type": {
                    "api_name": "bandwidth_and_standard_value"
                },
                "standard_value": "8888"
            },
            "grade_tid": "7174758360888247852"
        },
        "standard_id": "7174758593538295340"
    },
    "msg": "success"
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1161001	RPC call error	请重试，如重试后仍失败，请咨询技术支持
400	1161004	parameter invalid	参数错误，请检查传入参数
500	1161999	internal error	请重试，如重试后仍失败，请咨询技术支持
400	1160001	parameter invalid	参数错误，请检查传入参数
400	1160002	Rehire person is in the onboarding process, pre_hire_id: xxx.	参数错误，请检查传入参数
400	1160003	matching compensation standards no permission	无匹配标准的权限