Appearance
添加假期规则
基本信息
中文名: 添加假期规则
接口名: /attendance/vacation/type/create
所在目录: 假期管理
调用方式: POST(HTTPS)
Query参数
| 名称 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| tenantCode | String | 是 | 0 | 组织Code |
Body参数
| 名称 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| leave_name | String | 是 | 年假 | 假期名称。 |
| leave_view_unit | String | 是 | day | 请假时长单位。<br/>+ day:天<br/>+ halfDay:半天<br/>+ hour:小时 |
| biz_type | String | 是 | general_leave | 假期类型。<br/>+ general_leave:普通假期<br/>+ lieu_leave:加班转调休**说明一个企业全局只允许存在一个加班转调休的假期类型。 |
| natural_day_leave | Boolean | 是 | true | 是否按照自然日统计请假时长。<br/>当为false的时候,用户发起请假时候会根据用户在请假时间段内的排班情况来计算请假时长。 |
| op_userid | String | 是 | 03085665764167 | 当前企业内拥有“OA审批”应用权限的管理员的userid,否则接口会报错部门的管理员不存在。 |
| hours_in_per_day | Number | 是 | 1000 | 每天折算的工作时长,百分之一。例如:1天=10小时=1000。<br/>该参数值一般与企业员工排班工作时长保持一致。 |
| extras | String | 否 | {“validity_type”:“absolute_time”,“validity_value”:“12-31”} | 调休假有效期规则<br/>+validity_type:有效类型<br/> -absolute_time:绝对时间<br/> -relative_time:相对时间<br/>+validity_value:延长日期<br/> - 当validity_type为absolute_time该值该值不为空且满足“yy-mm”格式。<br/> - 当validity_type为relative_time该值为大于1的整数。**说明假期类型biz_type值为lieu_leave时,该参数必传。 |
| submit_time_rule | Object | 否 | 限时提交规则。<br/>**说明<br/>本参数一般用在普通假期类型中,调休假期暂时不使用。 | |
| -time_unit | String | 否 | day | 时间单位:<br/>+day:天<br/>+hour:小时 |
| -time_value | Number | 否 | 1 | 限制值。<br/>当timeUnit为day时,有效值范围是0至30天;<br/>timeUnit为hour时,有效值范围是0至24小时。 |
| -time_type | String | 否 | before | 限制类型:<br/>+before:提前<br/>+after:补交 |
| -enable_time_limit | Boolean | 否 | false | 是否开启限时提交功能:仅且为true时开启。 |
| leave_certificate | Object | 否 | 请假证明。<br/>**说明<br/>本参数一般用在普通假期类型中,调休假期暂时不使用。 | |
| -unit | String | 否 | hour | 需提供请假证明时长单位:<br/>+ hour:小时<br/>+ day:天 |
| -duration | Number | 否 | 1 | 超过多长时间需提供请假证明。<br/>+ 如果unit值为day,表示请假超过一天,需要提供请假证明。<br/>+ 如果unit值为hour,表示请假超过一小时,需要提供请假证明。**说明提交请假超过设置时间,审批单会自动出现请假证明填写项。![]() |
| -enable | Boolean | 否 | false | 是否开启请假证明。 |
| -prompt_information | String | 否 | 请假信息 | 请假提示文案。 |
返回参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| errcode | Number | 0 | 错误码。 |
| errmsg | String | 成功 | 错误消息。 |
| success | Boolean | true | 是否正确访问。 |
| result | Object | 业务结果。 | |
| -leave_name | String | 年假 | 假期名称。 |
| -leave_code | String | 037477ae-1009-4632-b8e9-e919ae5e7973 | 假期规则唯一标识。 |
| -leave_view_unit | String | day | 请假单位。<br/>+day:天<br/>+halfDay:半天<br/>+hour:小时 |
| -biz_type | String | general_leave | 假期类型。<br/>+general_leave:普通假期<br/>+lieu_leave:加班转调休 |
| -natural_day_leave | Boolean | true | 是否按照自然日统计请假时长。<br/>当为false的时候,用户发起请假时候会根据用户在请假时间段内的排班情况来计算请假时长。 |
| -hours_in_per_day | Number | 1000 | 每天折算的工作时长,百分之一。例如:1天=10小时=1000。 |
| -submit_time_rule | Object | {“enableTimeLimit”:true,“timeType”:“before”,“timeUnit”:“day”,“timeValue”:1} | 限时提交规则,请求携带了submit_time_rule参数,才会返回该字段。 |
| time_value | Number | 1 | 限制值。<br/>当timeUnit为day时,有效值范围是0至30天;<br/>timeUnit为hour时,有效值范围是0至24小时。 |
| time_unit | String | day | 时间单位:<br/>+day:天<br/>+hour:小时 |
| time_type | String | before | 限制类型:<br/>+before:提前<br/>+after:补交 |
| enable_time_limit | Boolean | false | 是否开启限时提交功能,仅且为true时开启。 |
| leave_certificate | Object | 请假证明,请求携带了leave_certificate参数,才会返回该字段。 | |
| unit | String | hour | 需提供请假证明时长单位:<br/>+hour:小时<br/>+day:天 |
| duration | Number | 1 | 超过多长时间需提供请假证明。 |
| enable | Boolean | false | 是否开启请假证明。 |
| prompt_information | String | 请假信息 | 请假提示文案 |

