Langsung ke konten utama
Sebagian besar organisasi memiliki aturan sendiri dalam pemberian cuti. Misalnya, organisasi dapat memberikan saldo cuti yang berbeda berdasarkan jabatan karyawan. Saat ini, aturan cuti DingTalk belum mendukung logika kustom semacam ini. Untuk itu, DingTalk menyediakan Open API cuti agar organisasi dapat mendukung skenario kustom tersebut.
Sebelum memanggil API cuti, minta Izin API yang diperlukan di Developer Console.

Minta izin

Minta Izin API sebelum memanggil API manajemen cuti:
  1. Masuk ke Developer Console, lalu klik Aplikasi yang dituju.
  2. Klik Kelola izin, lalu klik Absensi.
  3. Tambahkan Izin API manajemen cuti, lalu klik Minta izin atau Minta secara massal.

Catatan

Jika permintaan izin ditolak, cari Izin API manajemen cuti di kolom Permintaan. Arahkan kursor ke Ditolak untuk melihat alasannya. Di konsol Aplikasi, buka Informasi Dasar > Kelola izin, lalu cari izin manajemen cuti dalam daftar: Klik Minta izin di samping setiap izin.

Skenario 1: Sinkronkan aturan cuti

Gunakan API cuti untuk menyinkronkan aturan cuti yang sudah ada di organisasi Anda ke sistem manajemen cuti DingTalk (Admin Console DingTalk > Workbench > Kelola Aplikasi > Persetujuan OA). Di Admin Console Persetujuan OA, buka Manajemen Cuti > Aturan Cuti, lalu klik Tambah cuti untuk menentukan aturan cuti. Konfigurasikan setiap aturan dengan kolom berikut: Selanjutnya, pada desain formulir untuk Formulir pengajuan cuti, tambahkan kit absensi Persetujuan yang disediakan oleh DingTalk. Kit ini secara otomatis menghitung saldo cuti dan menyinkronkannya ke Aplikasi Absensi DingTalk. Editor Formulir Persetujuan OA terdiri atas empat langkah: Pengaturan Dasar > Desain Formulir > Desain Proses > Pengaturan Lanjutan. Pada langkah Desain Formulir, buka tab Kit. Di bagian Kit absensi, tambahkan Kit Cuti/Izin Tidak Masuk ke Formulir.

Skenario 2: Sinkronkan saldo cuti internal ke Persetujuan DingTalk

Jika organisasi Anda memiliki aturan cuti sendiri dan perlu menyinkronkan saldo cuti internal ke Persetujuan DingTalk, gunakan API berikut (Aplikasi internal digunakan sebagai contoh):
  1. Panggil API Inisialisasi saldo cuti.
  2. Sebagai Admin, buka Admin Console DingTalk > Workbench > Kelola Aplikasi > Persetujuan OA > Manajemen Cuti > Saldo Cuti Karyawan untuk melihat saldo Karyawan yang telah diperbarui.
Di halaman Saldo Cuti Karyawan, klik Atur Aturan Cuti Karyawan atau Edit Saldo Massal via Excel. Filter berdasarkan cakupan organisasi, dan jika perlu, pilih Sertakan karyawan yang keluar dalam 90 hari terakhir. Setiap catatan menampilkan satu Karyawan dengan kolom berikut: Nama, Departemen, Tanggal Bergabung, Tanggal Mulai Bekerja Pertama, Cuti Pribadi (jam), Cuti Pengganti (jam), Cuti Sakit (jam), Cuti Tahunan (hari), dan Cuti Melahirkan (hari).