调薪记录
接口说明:该接口可分页查询公司内雇员的调薪记录。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/payroll/change/history
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| pageNo | Integer | N | 页数,默认从0开始，翻页+1 |
| pageSize | Integer | N | 每页条数，1～100之间。默认每页50条 |
| beginTime | String | Y | 开始时间,时间格式yyyy-MM-dd |
| endTime | String | Y | 结束时间,时间格式yyyy-MM-dd |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 操作结果描述 |
| data | PageResult | Y | 调薪记录列表 |
PageResult
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| totalPageSize | Long | Y | 总页数 |
| pageNo | Integer | Y | 当前页 |
| pageSize | Integer | Y | 每页显示条数 |
| result | List<PayrollChangeHistoryInfoModel> | Y | 调薪记录列表 |
| hasMore | boolean | Y | 是否有下一页 true-有，false-没有 |
PayrollChangeHistoryInfoModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工ID |
| name | String | Y | 员工姓名 |
| mobile | String | Y | 员工手机号 |
| jobNumber | String | Y | 工号 |
| departmentName | String | Y | 当前部门 |
| departmentId | String | Y | 部门ID |
| hireType | Integer | Y | 聘用类型,0-正式,10-实习,11-劳务,12-顾问,13-返聘,14-外包 |
| valueBefore | double | Y | 合计工资调整之前 |
| valueAfter | double | Y | 合计工资调整之后 |
| totalBasePayBefore | double | Y | 基本工资调整之前 |
| totalBasePayAfter | double | Y | 基本工资调整之后 |
| happenDate | String | Y | 调薪日期 |
| addtime | int | Y | 添加时间 |
| changeRate | String | Y | 调薪比例 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/payroll/change/history?sign=7omyqoNIY5QPWKCyQM3Q7Hk8mNQ=
请求Body示例:
{
"pageSize": 10,
"beginTime": "2020-01-01",
"endTime": "2020-11-25",
"pageNo": 0,
"timestamp": 1606275733052
}
SDK请求示例(java):
PayrollChangeHistoryRequest request = new PayrollChangeHistoryRequest(access_token);
request.setPageNo(0);
request.setPageSize(10);
request.setBeginTime("2020-01-01");
request.setEndTime("2020-11-25");
OpenapiResponse<PageResult<PayrollChangeHistoryInfoModel>> changeHistory = XrxsPayrollService.getChangeHistory(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"totalPageSize": 1,
"pageNo": 0,
"pageSize": 10,
"result": [
{
"employeeId": "9f8f841187e740f6a5a497ca6bb91be9",
"name": "张八",
"mobile": "19252526969",
"jobNumber": "",
"departmentName": null,
"departmentId": null,
"hireType": 0,
"valueBefore": 0,
"valueAfter": 7000,
"totalBasePayBefore": 0,
"totalBasePayAfter": 7000,
"happenDate": "2020-11-02",
"addtime": 1606215203,
"changeRate": ""
},
{
"employeeId": "d0a222320a8346e9a9aba14f890cc18c",
"name": "张七",
"mobile": "19400235449",
"jobNumber": "",
"departmentName": null,
"departmentId": null,
"hireType": 0,
"valueBefore": 0,
"valueAfter": 10000,
"totalBasePayBefore": 0,
"totalBasePayAfter": 10000,
"happenDate": "2020-11-23",
"addtime": 1606215211,
"changeRate": ""
}
],
"hasMore": false
}
}