销出差接口
接口说明: 销出差接口,撤销考勤记录中的出差状态(请与考勤模块的出差状态同步接口配合使用)。
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/attendance/canceltravel/v3
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工id |
startDate | String | Y | 销出差开始日期,日期格式:yyyy-MM-dd HH:mm:ss |
startTime | String | N | 按天时,必传 销出差开始时间,AM:上半天、PM:下半天 |
endDate | String | Y | 销出差结束日期,日期格式:yyyy-MM-dd HH:mm:ss |
endTime | String | N | 按天时,必传,销出差结束时间,AM:上半天、PM:下半天 |
srcApproveId | String | Y | 原申请id,即出差状态同步返回的出差记录ID |
timeUnit | Integer | Y | 时间单位,0-按天,1-按小时 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/attendance/canceltravel/v3?sign=Rorz2AZsCp%2BpikYQM58sCDSwuh0%3D
请求Body示例:
{
"employeeId": "a42c11aed7b645a2be77cd0a54cc33da",
"startTime": "AM",
"endTime": "PM",
"endDate": "2023-03-03 18:00:00",
"startDate": "2023-03-02 09:00:00",
"timeUnit": 0,
"srcApproveId": "9397381",
"timestamp": 1681374785391
}
SDK请求示例(java):
AttendanceCancelTravelV3Request request = new AttendanceCancelTravelV3Request(access_token());
request.setEmployeeId("a42c11aed7b645a2be77cd0a54cc33da");
request.setStartDate("2023-03-02 09:00:00");
request.setStartTime("AM");
request.setEndDate("2023-03-03 18:00:00");
request.setEndTime("PM");
request.setSrcApproveId("9397381");
request.setTimeUnit(0);
XrxsAttendanceService.cancelTravelV3(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": null
}