员工薪资调整

最后更新于:2019-12-30 13:45:01

调整一个员工的薪资档案

接口调用请求说明

https请求方式:PUT

请求地址:

https://openapi.ihr360.com/openapi/payroll/v1/staffSalaryProfiles/{staffId}

请求参数说明

调用前,在请求头信息中必须包含以下2项

Content-Type:application/json;charset=UTF-8

Authorization: Bearer access_token;

例如,获取到的有效凭证为8f87b9b1-9f66-4b32-9269-0d41a0face00,则头信息中数据应为:

Content-Type:application/json;charset=UTF-8

Authorization: Bearer 8f87b9b1-9f66-4b32-9269-0d41a0face00。

请求参数属性描述

参数 类型 是否必须 说明
access_token String 调用接口凭证
staffId String 员工Id
dataId String 业务数据Id(例:薪资调整归档数据id)
effectiveAt date 生效时间,数据格式:yyyy-MM-dd
inValidAt date 失效时间,数据格式:yyyy-MM-dd
adjustmentValue map 调整值{key: value}

请求参数样例

{
"dataId": "abc",
"effectiveAt": "2019-11-20",
"inValidAt": "2019-11-20",
"adjustmentValue": {"basesalary", 50000}
}

注:具体的参数名称可在花名册的薪资页签通过查看HTML源码,找到相应的字段ID,以此作为参数名称,如基本工资,对应的ID为basesalary


返回说明

正常情况下,"i人事"会返回如下JSON数据给第三方:

返回数据说明

属性 类型 说明
code Int 返回代码,成功是为0
message String 返回消息,成功时为SUCCESS
data String null

错误时,"i人事"会返回错误码等信息,JSON数据包示例如下:

返回数据样例

成功:{ "code": 0, "message": null,"data": null }

失败:{ "code": -1, "message": "员工不存在", "data": null, "errorResult": true }