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