Skip to content

添加假期规则 ​

基本信息 ​

中文名: 添加假期规则

接口名: /attendance/vacation/type/create

所在目录: 假期管理

调用方式: POST(HTTPS)

Query参数 ​
名称类型是否必填示例值描述
tenantCodeString是0组织Code
Body参数 ​
名称类型是否必填示例值描述
leave_nameString是年假假期名称。
leave_view_unitString是day请假时长单位。<br/>+ day:天<br/>+ halfDay:半天<br/>+ hour:小时
biz_typeString是general_leave假期类型。<br/>+ general_leave:普通假期<br/>+ lieu_leave:加班转调休**说明一个企业全局只允许存在一个加班转调休的假期类型。
natural_day_leaveBoolean是true是否按照自然日统计请假时长。<br/>当为false的时候,用户发起请假时候会根据用户在请假时间段内的排班情况来计算请假时长。
op_useridString是03085665764167当前企业内拥有“OA审批”应用权限的管理员的userid,否则接口会报错部门的管理员不存在。
hours_in_per_dayNumber是1000每天折算的工作时长,百分之一。例如:1天=10小时=1000。<br/>该参数值一般与企业员工排班工作时长保持一致。
extrasString否{“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_ruleObject否限时提交规则。<br/>**说明<br/>本参数一般用在普通假期类型中,调休假期暂时不使用。
-time_unitString否day时间单位:<br/>+day:天<br/>+hour:小时
-time_valueNumber否1限制值。<br/>当timeUnit为day时,有效值范围是0至30天;<br/>timeUnit为hour时,有效值范围是0至24小时。
-time_typeString否before限制类型:<br/>+before:提前<br/>+after:补交
-enable_time_limitBoolean否false是否开启限时提交功能:仅且为true时开启。
leave_certificateObject否请假证明。<br/>**说明<br/>本参数一般用在普通假期类型中,调休假期暂时不使用。
-unitString否hour需提供请假证明时长单位:<br/>+ hour:小时<br/>+ day:天
-durationNumber否1超过多长时间需提供请假证明。<br/>+ 如果unit值为day,表示请假超过一天,需要提供请假证明。<br/>+ 如果unit值为hour,表示请假超过一小时,需要提供请假证明。**说明提交请假超过设置时间,审批单会自动出现请假证明填写项。
-enableBoolean否false是否开启请假证明。
-prompt_informationString否请假信息请假提示文案。
返回参数 ​
名称类型示例值描述
errcodeNumber0错误码。
errmsgString成功错误消息。
successBooleantrue是否正确访问。
resultObject业务结果。
-leave_nameString年假假期名称。
-leave_codeString037477ae-1009-4632-b8e9-e919ae5e7973假期规则唯一标识。
-leave_view_unitStringday请假单位。<br/>+day:天<br/>+halfDay:半天<br/>+hour:小时
-biz_typeStringgeneral_leave假期类型。<br/>+general_leave:普通假期<br/>+lieu_leave:加班转调休
-natural_day_leaveBooleantrue是否按照自然日统计请假时长。<br/>当为false的时候,用户发起请假时候会根据用户在请假时间段内的排班情况来计算请假时长。
-hours_in_per_dayNumber1000每天折算的工作时长,百分之一。例如:1天=10小时=1000。
-submit_time_ruleObject{“enableTimeLimit”:true,“timeType”:“before”,“timeUnit”:“day”,“timeValue”:1}限时提交规则,请求携带了submit_time_rule参数,才会返回该字段。
time_valueNumber1限制值。<br/>当timeUnit为day时,有效值范围是0至30天;<br/>timeUnit为hour时,有效值范围是0至24小时。
time_unitStringday时间单位:<br/>+day:天<br/>+hour:小时
time_typeStringbefore限制类型:<br/>+before:提前<br/>+after:补交
enable_time_limitBooleanfalse是否开启限时提交功能,仅且为true时开启。
leave_certificateObject请假证明,请求携带了leave_certificate参数,才会返回该字段。
unitStringhour需提供请假证明时长单位:<br/>+hour:小时<br/>+day:天
durationNumber1超过多长时间需提供请假证明。
enableBooleanfalse是否开启请假证明。
prompt_informationString请假信息请假提示文案