概要

多くの組織には、休暇付与に関する独自のルールがあります。たとえば、社員の職位に応じて異なる休暇残数を付与する場合があります。現在、DingTalkの休暇ルールはこのようなカスタムロジックに対応していません。そこでDingTalkでは、こうした独自の運用に対応できるよう、休暇関連の Open API を提供しています。

​

権限をリクエストする

休暇管理 API を呼び出す前に、API 権限をリクエストします。

1. 開発者コンソールにログインし、対象のアプリをクリックします。
2. 権限管理をクリックし、勤怠をクリックします。
3. 休暇管理の API 権限を追加し、権限をリクエストまたは一括リクエストをクリックします。

​

注意事項

権限のリクエストが辞退された場合は、リクエスト列で休暇管理の API 権限を確認してください。辞退にカーソルを合わせると、理由が表示されます。 アプリのコンソールで基本情報 > 権限管理に移動し、一覧から休暇管理の権限を探します。 各権限の横にある権限をリクエストをクリックします。

​

シナリオ 1：休暇ルールを同期する

休暇 API を使用して、社内の既存の休暇ルールをDingTalkの休暇管理システム（DingTalk管理コンソール > ワークベンチ > アプリ管理 > OA承認）に同期します。 OA承認の管理コンソールで休暇管理 > 休暇ルールに移動し、休暇を追加をクリックして休暇ルールを定義します。各ルールでは、次の項目を設定します。 次に、休暇申請フォームのフォーム設計で、DingTalkが提供する承認用の勤怠キットを追加します。このキットは休暇残数を自動で計算し、DingTalkの勤怠アプリに同期します。 OA承認のフォームエディターでは、基本設定 > フォーム設計 > プロセス設計 > 詳細設定の順に設定を行います。フォーム設計画面でキットタブを開き、勤怠キットから休暇キットをフォームに追加します。

​

シナリオ 2：社内の休暇残数をDingTalk承認に同期する

社内独自の休暇ルールがあり、社内の休暇残数をDingTalk承認に同期する必要がある場合は、次の API を使用します（ここでは社内アプリを例に説明します）。

1. 休暇残数の初期化 API を呼び出します。
2. 管理者としてDingTalk管理コンソール > ワークベンチ > アプリ管理 > OA承認 > 休暇管理 > 社員の休暇残数に移動し、更新された社員の休暇残数を確認します。

社員の休暇残数ページで、社員の休暇ルールを設定またはExcel で残数を一括編集をクリックします。組織の範囲で絞り込み、必要に応じて90日以内に退職した社員を含めるを選択します。各レコードには社員 1 名分の情報が表示され、名前、部門、入社日、初出勤日、私用休暇（時間）、代休（時間）、病気休暇（時間）、年次有給休暇（日）、産前産後休暇（日） の各列が含まれます。