Ikhtisar

Topik ini menjelaskan kemampuan API terbuka Absensi dan cara mengintegrasikannya.

Apa itu Absensi

Absensi adalah aplikasi resmi DingTalk yang menyediakan solusi manajemen kehadiran karyawan bagi organisasi. Aplikasi ini menampilkan status tim Anda kapan saja dan di mana saja, memberikan gambaran sekilas tentang siapa yang hadir, serta menghitung data absensi secara otomatis tanpa pemeriksaan manual. Untuk informasi selengkapnya, lihat Panduan memulai cepat untuk admin Absensi. Fitur utama:

Beragam metode absen untuk berbagai skenario kehadiran: Lakukan absen berdasarkan lokasi GPS, lokasi Wi-Fi, dan lainnya.
Pengelolaan terpadu kerja di kantor dan kerja lapangan untuk statistik yang lebih mudah: Absensi lapangan mencatat kehadiran karyawan yang sedang berada di luar kantor sementara atau melakukan perjalanan dinas.
Persetujuan cuti dan absensi terintegrasi untuk statistik kehadiran dalam satu tabel: Persetujuan cuti, lembur, keluar kantor, dan perjalanan dinas dirangkum dan dihitung secara otomatis, sehingga Anda tidak perlu lagi mencocokkan banyak laporan.

Cara mengaktifkan Absensi

Absensi adalah aplikasi resmi yang terpasang secara default di DingTalk. Karyawan membuka dan menggunakannya dari Workbench di DingTalk.

Seluler: Klien seluler DingTalk > Workbench Di klien seluler DingTalk:
1. Ketuk Workbench di bilah navigasi bawah.
2. Buka aplikasi Absensi.
Desktop: Klien desktop DingTalk > Workbench Di klien DingTalk, buka Workbench. Di bagian Semua Staf, pilih aplikasi Absensi untuk memulai pengaturan.

Ikhtisar kemampuan terbuka

Daftar API

Absensi menyediakan beragam API terbuka. Gunakan API ini untuk menghubungkan Absensi dengan sistem bisnis organisasi Anda.

Kelola grup absensi

API	Deskripsi API	Versi API
Buat grup absensi	Panggil API ini untuk membuat grup absensi.	Lama
Perbarui grup absensi	Panggil API ini untuk memperbarui informasi grup absensi berdasarkan ID grup absensi.	Lama
Hapus grup absensi	Panggil API ini untuk menghapus grup absensi secara massal.	Lama
Cari ringkasan grup absensi	Panggil API ini untuk melakukan pencarian fuzzy grup absensi berdasarkan nama dan mendapatkan informasi ringkasannya.	Lama
Dapatkan detail grup absensi	Panggil API ini untuk mendapatkan detail grup absensi berdasarkan ID grup absensi.	Lama
Kueri informasi grup absensi berdasarkan groupKey	Panggil API ini untuk mengkueri informasi grup absensi berdasarkan ID grup absensi.	Lama
Konversi groupKey ke groupId	Panggil API ini untuk mengonversi groupKey grup absensi menjadi groupId-nya.	Lama
Konversi groupId ke groupKey	Panggil API ini untuk mengonversi groupId grup absensi menjadi groupKey-nya.	Lama
Dapatkan ringkasan grup absensi secara massal	Panggil API ini untuk mendapatkan informasi ringkasan semua grup absensi di organisasi Anda per halaman.	Lama
Dapatkan detail grup absensi secara massal	Panggil API ini untuk mengkueri detail semua grup absensi.	Lama
Dapatkan grup absensi pengguna	Panggil API ini untuk mendapatkan informasi grup absensi seorang karyawan.	Lama
Tambahkan anggota absensi secara massal	Panggil API ini untuk menambahkan anggota ke grup absensi tertentu secara massal.	Lama
Perbarui anggota absensi	Panggil API ini untuk memperbarui anggota grup absensi. Tambahkan atau hapus pengguna, departemen, dan anggota bebas absensi.	Lama
Dapatkan anggota absensi	Panggil API ini untuk mendapatkan anggota grup absensi berdasarkan ID pengguna operator dan ID grup absensi.	Lama
Dapatkan ID pengguna anggota absensi	Panggil API ini untuk mendapatkan ID pengguna semua karyawan dalam grup absensi per halaman.	Lama
Hapus anggota absensi secara massal	Panggil API ini untuk menghapus anggota dari grup absensi tertentu secara massal.	Lama
Kueri daftar anggota absensi	Panggil API ini untuk mengkueri daftar karyawan dalam grup absensi tertentu.	Lama
Periksa apakah pengguna milik grup absensi	Panggil API ini untuk memeriksa apakah departemen atau karyawan termasuk dalam grup absensi. API mengembalikan ID departemen atau karyawan yang termasuk dalam grup absensi tersebut.	Lama
Tambahkan informasi Wi-Fi secara massal	Panggil API ini untuk menambahkan informasi Wi-Fi ke grup absensi tertentu secara massal.	Lama
Kueri informasi Wi-Fi secara massal	Panggil API ini untuk mengkueri daftar Wi-Fi grup absensi tertentu secara massal.	Lama
Hapus informasi Wi-Fi secara massal	Panggil API ini untuk menghapus informasi Wi-Fi dari grup absensi tertentu secara massal.	Lama
Tambahkan lokasi secara massal	Panggil API ini untuk menambahkan lokasi (posisi) ke grup absensi tertentu secara massal.	Lama
Kueri lokasi secara massal	Panggil API ini untuk mengkueri daftar lokasi (posisi) grup absensi tertentu secara massal.	Lama
Hapus lokasi secara massal	Panggil API ini untuk menghapus lokasi (posisi) dari grup absensi tertentu secara massal.	Lama
Kueri izin tulis absensi	Kueri izin operasi karyawan dalam grup absensi.	Baru

Absen kehadiran

API	Deskripsi API	Versi API
Dapatkan hasil absen	Panggil API ini untuk mengembalikan hasil absen aktual karyawan di organisasi Anda.	Lama
Dapatkan detail absen	Panggil API ini untuk mengembalikan detail absen aktual karyawan di organisasi Anda.	Lama
Unggah catatan absen	Panggil API ini untuk mengunggah catatan gesek kartu atau pengenalan wajah dari sistem absensi pihak ketiga ke Absensi DingTalk sebagai catatan absen DingTalk.	Baru

Shift absensi

API	Deskripsi API	Versi API
Buat shift	Panggil API ini untuk membuat shift absensi DingTalk.	Lama
Hapus shift	Panggil API ini untuk menghapus shift absensi berdasarkan ID shift.	Lama
Cari shift berdasarkan nama	Panggil API ini untuk melakukan pencarian fuzzy shift berdasarkan nama. API mengembalikan nama dan ID shift.	Lama
Dapatkan ringkasan shift	Panggil API ini untuk mengkueri informasi semua shift.	Lama
Dapatkan detail shift	Panggil API ini untuk mengkueri detail shift berdasarkan ID shift.	Lama
Kueri riwayat shift	Panggil API ini untuk mengkueri riwayat shift berdasarkan ID shift dan versi.	Lama
Ubah pengaturan rentang waktu absen	Panggil API ini untuk mengubah pengaturan titik absen pada shift absensi.	Lama

Penjadwalan shift absensi

API	Deskripsi API	Versi API
Kueri informasi penjadwalan shift pengguna	Panggil API ini untuk mengkueri informasi penjadwalan shift pengguna pada hari kerja tertentu.	Lama
Kueri informasi penjadwalan shift pengguna secara massal	Panggil API ini untuk mengkueri informasi penjadwalan shift karyawan pada hari kerja secara massal.	Lama
Jadwalkan shift untuk grup absensi berbasis shift	Panggil API ini untuk menjadwalkan shift bagi anggota grup absensi berbasis shift.	Lama
Kueri hasil absen terjadwal	Panggil API ini untuk mengkueri hasil absen dari shift terjadwal. Hasilnya mencakup waktu absen, keterlambatan, pulang lebih awal, kerja di kantor, dan informasi kerja lapangan.	Lama
Kueri detail penjadwalan shift absensi organisasi	Panggil API ini untuk mengkueri informasi penjadwalan shift absensi pada hari tertentu.	Lama
Kueri ringkasan penjadwalan shift pengguna secara massal	Panggil API ini untuk mengkueri ringkasan penjadwalan shift pengguna dalam periode waktu tertentu.	Lama

Aturan absensi

API	Deskripsi API	Versi API
Dapatkan aturan lembur per halaman	Panggil API ini untuk mendapatkan daftar aturan lembur yang dikonfigurasi di Absensi per halaman.	Baru
Dapatkan aturan absen susulan per halaman	Panggil API ini untuk mendapatkan daftar aturan absen susulan yang dikonfigurasi di Absensi per halaman.	Baru
Dapatkan pengaturan aturan lembur secara massal	Panggil API ini untuk mendapatkan detail pengaturan beberapa aturan lembur secara massal berdasarkan ID aturan lembur.	Baru

Statistik kehadiran

API	Deskripsi API	Versi API
Periksa apakah laporan statistik cerdas diaktifkan	Panggil API ini untuk memeriksa apakah organisasi Anda telah mengaktifkan laporan absensi cerdas. Jika laporan cerdas dinonaktifkan, API laporan statistik lainnya tidak tersedia.	Lama
Dapatkan data absensi pengguna	Panggil API ini untuk mendapatkan data absensi pengguna tertentu pada hari tersebut, termasuk catatan absen, hasil absen, dan daftar persetujuan.	Lama
Dapatkan data cuti dari laporan	Panggil API ini untuk mendapatkan data cuti dari laporan absensi cerdas DingTalk berdasarkan nama cuti dan ID pengguna.	Lama
Dapatkan definisi kolom laporan absensi	Panggil API ini untuk mendapatkan informasi kolom dalam laporan absensi cerdas organisasi Anda.	Lama
Dapatkan nilai kolom laporan absensi	Panggil API ini untuk mendapatkan nilai kolom laporan absensi cerdas DingTalk.	Lama

Persetujuan cuti

API	Deskripsi API	Versi API
Beri tahu persetujuan selesai	Panggil API ini untuk memberi tahu Absensi bahwa persetujuan telah selesai. Mendukung jenis lembur, cuti, keluar kantor, dan perjalanan dinas.	Lama
Beri tahu pencabutan persetujuan	Panggil API ini untuk memberi tahu Absensi bahwa persetujuan telah dicabut. Mendukung jenis lembur, cuti, keluar kantor, perjalanan dinas, dan absen susulan.	Lama
Beri tahu persetujuan absen susulan	Panggil API ini untuk memberi tahu Absensi bahwa absen susulan telah disetujui.	Lama
Beri tahu persetujuan tukar shift	Setelah tukar shift disetujui, panggil API ini untuk memberi tahu Absensi agar melakukan tukar shift. Karyawan dapat menukar shift dengan dirinya sendiri atau dengan orang lain.	Lama
Hitung durasi di muka	Panggil API ini untuk menghitung di muka durasi lembur, perjalanan dinas, dan cuti karyawan berdasarkan penjadwalan shift di Absensi.	Lama
Hitung durasi cuti	Panggil API ini untuk mendapatkan durasi cuti setiap karyawan, yang dihitung secara otomatis berdasarkan aturan penjadwalan shift.	Lama
Kueri status cuti	Panggil API ini untuk mengkueri status cuti pengguna tertentu di organisasi tertentu dalam periode waktu tertentu.	Lama

Manajemen cuti

API	Deskripsi API	Versi API
Tambahkan aturan cuti	Panggil API ini untuk membuat aturan cuti.	Baru
Perbarui aturan cuti	Panggil API ini untuk memperbarui aturan jenis cuti tertentu.	Baru
Hapus aturan cuti	Panggil API ini untuk menghapus aturan cuti tertentu.	Lama
Kueri daftar aturan cuti	Panggil API ini untuk mengkueri daftar aturan cuti di organisasi Anda.	Lama
Inisialisasi saldo cuti	Panggil API ini untuk menginisialisasi saldo cuti secara massal.	Lama
Kueri saldo cuti	Panggil API ini untuk mendapatkan informasi saldo cuti berdasarkan organisasi atau karyawan per halaman. Setiap panggilan mengembalikan 50 catatan.	Lama
Perbarui saldo cuti secara massal	Panggil API ini untuk memperbarui informasi saldo cuti secara massal.	Lama
Kueri catatan perubahan saldo cuti karyawan secara massal	Panggil API ini untuk mendapatkan catatan saldo cuti berdasarkan karyawan per halaman.	Lama
Kueri informasi libur absensi pengguna	Panggil API ini untuk mengkueri informasi libur karyawan dalam periode waktu tertentu.	Baru

Daftar peristiwa Callback

Absensi mendukung berbagai peristiwa Callback, seperti perubahan shift, perubahan grup absensi, peristiwa absen karyawan, dan peristiwa lembur karyawan. Untuk peristiwa lainnya, lihat ikhtisar langganan peristiwa.

Solusi integrasi

Untuk mengintegrasikan lebih banyak kemampuan absensi ke dalam sistem organisasi Anda, lihat solusi berikut:

Glosarium

Grup absensi

Grup absensi adalah sekumpulan aturan absensi yang dikonfigurasi oleh Admin Organisasi untuk karyawan. Buat berbagai jenis grup absensi sesuai jenis pekerjaan yang berbeda di organisasi Anda.

Karena perbedaan antara spesifikasi API lama dan baru, grup absensi diidentifikasi secara unik oleh group_id atau groupKey. Panggil API Konversi groupKey ke groupId untuk mengonversi nilai groupKey menjadi group_id yang sesuai.

Terdapat tiga jenis grup absensi:

Grup absensi shift tetap: Untuk karyawan dengan jam kerja dan istirahat tetap, misalnya pukul 09.00 hingga 18.00 setiap hari dengan libur akhir pekan tetap.
Grup absensi berbasis shift: Untuk karyawan yang bekerja dengan shift pagi dan malam, yang shift-nya berbeda setiap hari, atau yang hari liburnya harus dijadwalkan.
Grup absensi jam kerja fleksibel: Untuk karyawan dengan jam kerja fleksibel.

Masuk ke DingTalk Admin Console dan buka Workbench > Kelola Aplikasi > Absensi > Kelola Grup Absensi untuk menambahkan grup absensi.

Aturan cuti (leave_code)

Aturan cuti diidentifikasi secara unik oleh leave_code. Di DingTalk Admin Console, buka Manajemen Cuti > Aturan Cuti untuk melihat dan mengonfigurasi aturan cuti. Klik Tambah Cuti untuk membuat aturan cuti. Setiap aturan cuti memiliki atribut berikut:

Bidang	Deskripsi
Nama Cuti	Nama jenis cuti (misalnya, Cuti Pribadi, Cuti Pengganti, Cuti Sakit, Cuti Tahunan, Cuti Melahirkan, Cuti Ayah, Cuti Menikah)
Satuan Cuti	Satuan pengajuan minimum: per jam, per setengah hari, atau per hari
Metode Perhitungan Durasi	Cara durasi cuti dihitung (misalnya, berdasarkan hari kerja)
Berbayar	Apakah cuti dibayar atau tidak dibayar
Aturan Saldo	Batas saldo (misalnya, saldo tidak terbatas)
Cakupan	Pihak yang dikenai aturan (misalnya, seluruh organisasi)
Tindakan	Edit atau hapus aturan

Shift

Ikat shift saat Anda membuat grup absensi. Shift menentukan waktu absen dan jam kerja bagi karyawan dalam grup absensi. Sesuaikan shift absensi dengan kebutuhan organisasi Anda, termasuk pengaturan absen fleksibel, datang terlambat dan pulang terlambat, datang lebih awal dan pulang lebih awal, keterlambatan, serta mangkir. Masuk ke DingTalk Admin Console dan buka Kelola Aplikasi > Absensi > Kelola Shift untuk menambahkan shift. Di halaman Kelola Shift, klik Tambah Shift untuk membuat shift baru. Shift yang sudah ada ditampilkan dengan kolom berikut:

Kolom	Deskripsi
Nama Shift	Nama shift (misalnya, Shift Default)
Waktu Kehadiran	Rentang waktu kerja (misalnya, 09.00–18.00)
Tindakan	Edit atau Hapus shift

Panduan pemanggilan API

Autentikasi & otorisasi

Kontak

Kalender

Konferensi

AI Table

Absensi

Dokumen & file

IM

Apa itu Absensi

Cara mengaktifkan Absensi

Ikhtisar kemampuan terbuka

Daftar API

Kelola grup absensi

Absen kehadiran

Shift absensi

Penjadwalan shift absensi

Aturan absensi

Statistik kehadiran

Persetujuan cuti

Manajemen cuti

Daftar peristiwa Callback

Solusi integrasi

Glosarium

Grup absensi

Aturan cuti (leave_code)

Shift

​Apa itu Absensi

​Cara mengaktifkan Absensi

​Ikhtisar kemampuan terbuka

​Daftar API

​Kelola grup absensi

​Absen kehadiran

​Shift absensi

​Penjadwalan shift absensi

​Aturan absensi

​Statistik kehadiran

​Persetujuan cuti

​Manajemen cuti

​Daftar peristiwa Callback

​Solusi integrasi

​Glosarium

​Grup absensi

​Aturan cuti (leave_code)

​Shift

Apa itu Absensi

Cara mengaktifkan Absensi

Ikhtisar kemampuan terbuka

Daftar API

Kelola grup absensi

Absen kehadiran

Shift absensi

Penjadwalan shift absensi

Aturan absensi

Statistik kehadiran

Persetujuan cuti

Manajemen cuti

Daftar peristiwa Callback

Solusi integrasi

Glosarium

Grup absensi

Aturan cuti (leave_code)

Shift