新增休假单

最后更新于:2020-06-10 14:39:00

可通过本接口新增一条休假单

接口调用请求说明

https请求方式:POST

请求地址:

https://openapi.ihr360.com/openapi/tm/v1/vacations/orders

请求参数说明

调用前,在请求头信息中必须包含以下2项

Content-Type:application/json;charset=UTF-8

Authorization: Bearer access_token;

例如,获取到的有效凭证为8f87b9b1-9f66-4b32-9269-0d41a0face00,则头信息中数据应为:

Content-Type:application/json;charset=UTF-8

Authorization: Bearer 8f87b9b1-9f66-4b32-9269-0d41a0face00。

请求参数属性描述

参数 类型 是否必须 说明
access_token String 调用接口凭证
staffId String 员工Id
vacationId String 假期类型的id
startTime Date 休假开始时间,格式 yyyy-MM-dd HH:mm
endTime Date 休假结束时间,格式 yyyy-MM-dd HH:mm
startPeriod String 开始时间段(MORNING/AFTERNOON)如果假期设置的最小申请时长是0.5天,那么必填
endPeriod String 结束时间段(MORNING/AFTERNOON)如果假期设置的最小申请时长是0.5天,那么必填
startHour Date 哺乳假的每天开始时间(格式 HH:mm),如果是哺乳假就必填
endHour Date 哺乳假的每天结束时间(格式 HH:mm),如果是哺乳假就必填
duration Double 休假时长,单位同假期类型的计算单位
processId String 调用方的业务id,作废时需要这个字段的值,最大40字符

请求参数样例

{
"staffId": "xxxxxxxxxxxxxx",

"vacationId":"xxxxxxxxx",

"startTime":"2020-06-06 09:00",

"endTime":"2020-06-06 18:00",

"duration": 8,

"processId":"xxxxxxxxxxxxxxxxx"
}

返回说明

正常情况下,"i人事"会返回如下JSON数据给第三方:

返回数据说明

属性 类型 说明
code Int 返回代码,成功是为0
message String 返回消息,成功时为null

错误时,"i人事"会返回错误码等信息,JSON数据包示例如下:

返回数据样例

成功:{ "code": 0, "message": null }

失败:{ "code": -2, "message": "休假时间与已有的休假单据时间上存在重叠"}