開発ガイド勤怠とは
勤怠は、組織向けに社員の勤怠管理ソリューションを提供する DingTalk の公式アプリです。チームの状況をいつでもどこでも確認できます。誰が出勤しているかがひと目でわかり、手作業で確認しなくても勤怠データを自動で集計します。詳しくは、勤怠管理者向けクイックスタートを参照してください。 主な機能：- 多様な勤怠シーンに対応する複数の打刻方法：GPS 位置情報や Wi-Fi などで打刻できます。
- 社内勤務と外勤を一元管理し、集計を効率化：外勤打刻により、一時的に外出している社員や出張中の社員の勤怠を記録できます。
- 休暇・勤怠承認と連携し、勤怠統計を 1 つの表に集約：休暇、残業、外出、出張の承認が自動で集計・計算されるため、複数のレポートを照合する必要がありません。
勤怠を有効にする方法
勤怠は、DingTalk にデフォルトでインストールされている公式アプリです。社員は DingTalk のワークベンチから開いて利用します。-
モバイル：DingTalk モバイルクライアント > ワークベンチ
DingTalk モバイルクライアントで、次の操作を行います。
- 下部のナビゲーションバーで ワークベンチ をタップします。
- 勤怠 アプリを開きます。
- デスクトップ：DingTalk デスクトップクライアント > ワークベンチ DingTalk クライアントで ワークベンチ を開きます。全社員 セクションで 勤怠 アプリを選択し、設定を開始します。
オープン機能の概要
API 一覧
勤怠では、豊富なオープン API を提供しています。これらの API を使用して、勤怠と社内の業務システムを連携できます。勤怠グループ管理
勤怠打刻
勤怠シフト
勤怠シフト設定
勤怠ルール
勤怠統計
休暇承認
休暇管理
コールバックイベント一覧
勤怠では、シフト変更、勤怠グループ変更、社員の打刻イベント、社員の残業イベントなど、複数のコールバックイベントをサポートしています。その他のイベントについては、イベントサブスクリプションの概要を参照してください。連携ソリューション
社内システムにさらに多くの勤怠機能を組み込むには、次のソリューションを参照してください。- 勤怠データの可視化：リアルタイムの出勤状況モニタリングと異常アラート
- 打刻修正の自動同期：承認後に DingTalk 勤怠のステータスをリアルタイムで更新
- 勤怠ルールの設定：勤怠グループの一括作成と柔軟な調整
- 勤怠対象者の割り当て：メンバーの一括登録と精緻な管理
- 日次勤怠レポート：日次統計と多角的なデータ分析
- 打刻データの同期：ハードウェアの打刻記録を DingTalk に自動アップロード
- 休暇・勤怠承認の連携：休暇・勤怠データを DingTalk 勤怠に自動同期
用語集
勤怠グループ
勤怠グループとは、組織管理者が社員向けに設定する勤怠ルールのまとまりです。社内の職種に応じて、異なるタイプの勤怠グループを作成できます。旧バージョンと新バージョンの API 仕様の違いにより、勤怠グループは group_id または groupKey のいずれかで一意に識別されます。groupKey の値を対応する group_id に変換するには、groupKey から groupId への変換 API を呼び出してください。
- 固定シフト制勤怠グループ：毎日 9:00〜18:00 勤務で週末が固定休みなど、勤務時間と休日が固定されている社員向けです。
- シフト制勤怠グループ：早番・遅番がある社員、日ごとにシフトが異なる社員、休日をシフトで設定する必要がある社員向けです。
- フレックスタイム勤怠グループ：勤務時間が柔軟な社員向けです。