销外出
接口说明: 销外出接口,撤销考勤记录中的外出状态(请与考勤模块的外出状态同步接口配合使用)。
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/attendance/cancelleaveout
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工id |
approvalId | String | Y | 外出申请id, 详见外出状态同步接口中返回的approvalId |
timeUnit | Integer | Y | 外出时间类型 0--按天外出,1–按小时外出 |
startDate | String | Y | 外出开始日期,日期格式:yyyy-MM-dd HH:mm:ss |
startTime | Integer | N | 如果是按天申请外出的话 则必填 其中0:表示上半天 1:表示下半天 |
endDate | String | Y | 外出结束日期,日期格式:yyyy-MM-dd HH:mm:ss |
endTime | Integer | N | 如果是按天申请外出的话 则必填 其中0:表示上半天 1:表示下半天 |
reason | String | N | 申请原因 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
data | String | N | 处理成功时返回 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/attendance/cancelleaveout?sign=231SDSFDFWdewd
请求Body示例:
- 按天申请
{ "endDate":"2021-05-21 12:00:01", "employeeId":"3cfd59661b0642659f12eb8c75ad0f18", "approvalId":"9330567", "startTime":0, "endTime":1, "startDate":"2021-05-20 13:22:00", "timeUnit":0, "timestamp":1629862969555 }
- 按小时申请
SDK请求示例(java):{ "employeeId":"3cfd59661b0642659f12eb8c75ad0f18", "approvalId":"9330567", "endDate":"2021-05-21 12:00:00", "startDate":"2021-05-20 13:00:00", "timeUnit":1, "timestamp":1629862969555 }
AttendanceLeaveOutRequest request = new AttendanceLeaveOutRequest(access_token()); request.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18"); request.setStartDate("2021-05-20 00:00:00"); request.setTimeUnit(0); request.setStartTime(0); request.setEndDate("2021-05-21 12:00:00"); request.setEndTime(1); request.setApprovalId("9330567"); OpenapiResponse<void> cancelLeaveout = XrxsAttendanceService.cancelLeaveout(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": null
}