> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 概述

> 介绍假期管理接口的权限申请流程及同步假期规则、同步内部假期余额到审批的使用场景。

企业都有假期的发放规则，例如根据企业员工的职位发放不同的假期余额。目前钉钉假期规则不支持此类定制化逻辑。钉钉开放假期相关的接口，满足企业更多的定制化场景。

> [!WARNING]
>
> 在调用假期接口前，确保已经在开发者后台申请了接口权限。

## 权限申请

在调用假期管理相关接口前，需要先申请接口权限：

1. 登录[开发者后台](https://open-dev.dingtalk.io/#/appMgr/provider/eapp/53642/1)，然后单击目标应用。
2. 单击**权限管理**，然后单击**考勤**。![权限申请](https://img.alicdn.com/imgextra/i1/O1CN01iYXWMNsxvrE5bwGa_!!6000000002438-2-tps-2764-1032.png)
3. 添加假期管理相关接口权限，然后单击**申请权限**或**批量申请**。

### 说明

如果接口申请被拒绝，可在**申请栏**中找到**假期管理**的接口权限，然后将鼠标移至**已拒绝**上查看拒绝原因。

![权限申请](https://img.alicdn.com/imgextra/i2/O1CN01kBOkuXohZAI5fSqq_!!6000000002978-2-tps-2792-1244.png)

## 场景一：同步假期规则

企业可以根据使用提供的假期API，将企业已有的假期发放规则同步到钉钉假期管理系统（[钉钉管理后台](https://oa.dingtalk.io/?lang=zh_CN) **> 工作台 > 应用管理 > OA审批**）。![场景一：同步假期规则](https://img.alicdn.com/imgextra/i3/O1CN01W5iPGr7fCFE5dRxc_!!6000000003124-2-tps-2776-1180.png)

然后在请假表单设计中使用钉钉提供的审批出勤套件，自动进行假期余额计算，并同步到钉钉考勤应用。![场景一：同步假期规则](https://img.alicdn.com/imgextra/i4/O1CN01hJ107UNIQjG5fiUY_!!6000000000785-2-tps-2794-1364.png)

## 场景二：企业内部假期余额同步到钉钉审批

企业有内部的假期发放规则，希望将内部假期余额同步到钉钉审批时，可通过以下接口实现（以企业内部应用为例）：

1. 调用[初始化假期余额](https://help.dingtalk.io/zh/open/development/initialize-holiday-balance.md)接口。
2. 管理员[钉钉管理后台](https://oa.dingtalk.io/?lang=zh_CN) **> 工作台 > 应用管理 > OA审批 > 假期管理 > 员工假期余额**，查看更新后的员工余额。![场景二：企业内部假期余额同步到钉钉审批](https://img.alicdn.com/imgextra/i2/O1CN01QMNpY5AfmLE5Zfmi_!!6000000005595-2-tps-2746-1038.png)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.