外出状态同步

接口说明: 同步员工的外出打卡记录

请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/attendance/leaveout

请求Header:

key value
access_token 获取的access_token的实际值

Query参数:

key value
sign 签名值

Body参数:

参数 类型 必传(Y/N) 说明
employeeId String Y 员工id
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 AttendanceLeaveOutResult N 处理成功时返回

AttendanceLeaveOutResult

参数 类型 必传(Y/N) 说明
approvalId String Y 返回的外出记录ID 销外出的时候需要用到

请求示例(HTTPS):

https://api.xinrenxinshi.com/v5/attendance/leaveout?sign=231SDSFDFWdewd

请求Body示例:

  • 按天申请
    {
      "endDate":"2021-05-21 12:00:01",
      "employeeId":"805f8c65825b4c2fae96f64ffb7d6901",
      "startTime":0,
      "endTime":1,
      "startDate":"2021-05-20 13:22:00",
      "timeUnit":0,
      "timestamp":1629862969555
    }
    
  • 按小时申请
    {
      "employeeId":"805f8c65825b4c2fae96f64ffb7d6901",
      "endDate":"2021-05-21 12:00:00",
      "startDate":"2021-05-20 13:00:00",
      "timeUnit":1,
      "timestamp":1629862969555
    }
    

SDK请求示例(java):

AttendanceLeaveOutRequest request = new AttendanceLeaveOutRequest(access_token());
request.setEmployeeId("805f8c65825b4c2fae96f64ffb7d6901");
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);
OpenapiResponse<String> leaveOut = XrxsAttendanceService.leaveOut(request);

响应示例:

{
  "errcode": 0,
  "errmsg": "成功",
  "data": {
    "approvalId": "9330567"
  }
}
2024 © 企家有道网络技术(北京)有限公司版权所有@京ICP备15035315号 all right reserved,powered by Gitbookupdate by: 2024-01-15 15:26:15

results matching ""

    No results matching ""