外出申请审批发起接口

接口说明: 通过接口发起外出申请的审批。需要保证外出审批流程已配置且处于开启状态(与审批模块销外出审批接口配合使用,不能用考勤模块的销外出接口,防止接口混用,导致数据完整性出现问题)。

请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/workflow/apply/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 ApprovalApplyResult N 处理成功时返回

ApprovalApplyResult

参数 类型 必传(Y/N) 说明
sid Long Y 返回创建成功的外出申请审批流程对应的审批id
approveId String Y 返回创建成功的外出申请审批流程对应的申请id

请求示例(HTTPS):

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

请求Body示例:

  • 按天申请
    {
      "endDate":"2021-05-21 12:00:01",
      "employeeId":"3cfd59661b0642659f12eb8c75ad0f18",
      "startTime":0,
      "endTime":1,
      "startDate":"2021-05-20 13:22:00",
      "timeUnit":0,
      "timestamp":1629862969555
    }
    
  • 按小时申请
    {
      "employeeId":"3cfd59661b0642659f12eb8c75ad0f18",
      "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("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);
OpenapiResponse<String> leaveOut = XrxsAttendanceService.leaveOut(request);

响应示例:

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

results matching ""

    No results matching ""