出差申请审批发起接口

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

请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/workflow/apply/travel/v2

请求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,开始日期与结束日期的时间范围不能超过31天
startTime Integer N 按天时必传,出差开始时间 0:表示上半天 1:表示下半天
endDate String Y 出差结束日期,日期格式:yyyy-MM-dd HH:mm:ss
endTime Integer N 按天时必传,出差结束时间 0:表示上半天 1:表示下半天
timeUnit Integer Y 时间单位,0-按天,1-按小时
reason String N 申请原因
placeOfDeparture String Y 出发地
destination String Y 目的地
vehicleType Integer Y 交通工具 1:高铁 2:动车 3:火车 4:飞机 5:汽车 6:轮船 7:自驾 8:其他
budget Double Y 预算 0-100000
remark String N 备注
timestamp Long Y 请求时间戳(精确到毫秒)

返回结果:

参数 类型 必传(Y/N) 说明
errcode Integer Y 0成功,其他失败
errmsg String Y 结果描述
data ApprovalApplyResult N 处理成功时返回

ApprovalApplyResult

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

请求示例(HTTPS):

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

请求Body示例:

{
    "employeeId":"3cfd59661b0642659f12eb8c75ad0f18",
    "startDate":"2021-05-13 09:00:00",
    "startTime":0,
    "endDate":"2021-05-14 18:00:00",
    "endTime":1,
    "timeUnit": 0,
    "destination":"北京",
    "placeOfDeparture":"武汉",
    "reason":"出差",
    "vehicleType":1,
    "budget":2000,
    "timestamp":1630911591800
}

SDK请求示例(java):

TravelApprovalApplyV2Request request =new TravelApprovalApplyV2Request(access_token());
request.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18");
request.setStartDate("2021-05-13 09:00:00");
request.setStartTime(0);
request.setEndDate("2021-05-14 18:00:00");
request.setEndTime(1);
request.setReason("出差");
request.setBudget(2000.00);
request.setDestination("北京");
request.setPlaceOfDeparture("武汉");
request.setVehicleType(1);
request.setTimeUnit(0);
OpenapiResponse<ApprovalApplyResponse> approvalApplyResponseOpenapiResponse = XrxsApprovalService.travelApprovalApplyV2(request);

响应示例:

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

results matching ""

    No results matching ""