离职员工
接口说明: 操作员工离职接口。此接口相当于薪人薪事页面中的离职操作。此接口不支持预离职。
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/employee/dismiss
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 参数类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工id |
dismissDate | String | Y | 离职时间,格式2017-03-02, 时间不能晚于当天 |
dismissionType | Integer | Y | 离职类型,0表示主动离职,1表示被动离职,2表示退休 |
insuranceSub | Integer | Y | 社保减员月,0表示当月,1表示下月 |
houseFundSub | Integer | Y | 公积金减员月,0表示当月,1表示下月 |
payrollSub | String | N | 工资减员月,格式:yyyyMM 如果工资模块 设置- 计薪 里面的"离职员工减员" 勾选的不是 "自动减员",则该参数必填。 |
dismissionReason | String | N | 离职原因(最长1000个字符) |
dismissRemark | String | N | 离职备注(最长1000个字符) |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/dismiss?sign=qiS6p5nHDlz%2FeJlyDrdI5PAoicw%3D
请求正文:
{
"dismissionType": 0,
"insuranceSub": 0,
"payrollSub": "202011",
"employeeId": "9f8f841187e740f6a5a497ca6bb91be9",
"houseFundSub": 1,
"dismissDate": "2020-11-23",
"timestamp": 1606212570192
}
SDK请求示例(java):
EmployeeDismissRequest request = new EmployeeDismissRequest(access_token);
request.setEmployeeId("9f8f841187e740f6a5a497ca6bb91be9");
request.setDismissDate("2020-11-23");
request.setDismissionType(DismissionTypeEnum.TAKE_INITIATIVE_TO_LEAVE);
request.setInsuranceSub(InsuranceSubEnum.DURING_MONTH);
request.setHouseFundSub(HouseFundSubEnum.NEXT_MONTH);
request.setPayrollSub("202011");
OpenapiResponse<Void> response = XrxsEmployeeService.dismissEmployee(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功"
}