Hubungkan sistem lain melalui API terbuka HR

API terbuka HR memungkinkan sistem lain membaca orang, kehadiran, cuti, dan penggajian final, serta mengirim catatan waktu menggunakan kunci yang Anda buat. Webhook HR memberi tahu sistem tersebut saat sesuatu terjadi.

Sebelum memulai

• Anda harus menjadi pemilik. Manajer tidak dapat membuat kunci meskipun memiliki semua hak HR.
• HR harus aktif.

Buat kunci

1. Buka HR → Pengaturan HR, lalu di Layanan mandiri dan tim, pilih API terbuka HR.
2. Centang API terbuka aktif dan pilih Simpan. Halaman menunjukkan Alamat dasar.
3. Di Buat kunci, ketik Keperluan (misalnya "biro penggajian").
4. Di Boleh, centang hanya kebutuhan sistem: baca orang, baca kehadiran, kirim catatan waktu, baca cuti, baca penggajian final, kelola webhook.
5. Pilih Buat kunci.
6. Salin kunci sekarang dan berikan kepada sistem lain. Kunci ditampilkan sekali; Kluvan hanya menyimpan hash.

Tambahkan webhook

1. Di Tambah webhook, ketik URL sistem (harus diawali https).
2. Centang peristiwa: employee.created, employee.left, punch.recorded, leave.approved, dan payroll.paid. Semuanya awalnya dicentang.
3. Pilih Tambahkan dan salin rahasia penandatanganan yang ditampilkan sekali.
4. Periksa Pengiriman untuk melihat yang dikirim, status, dan jumlah percobaan.

Perlu diketahui

• Kunci terpisah. Kunci HR memiliki sistem sendiri, terpisah dari kunci API Kluvan lainnya, dan hanya menjangkau data HR organisasi Anda.
• Kunci tidak pernah membaca detail bank, dokumen, atau data biometrik. baca penggajian final hanya mengembalikan proses yang sudah dibayar, bukan draf, tanpa IBAN atau nomor rekening.
• Pilih Cabut untuk segera menghentikan kunci. Daftar menunjukkan waktu terakhir digunakan dan jumlah panggilan setiap kunci.
• Kunci boleh membuat 10 panggilan per detik, dengan lonjakan singkat hingga 60. Periode yang diminta dapat mencapai 92 hari.
• Catatan waktu melalui API ditambahkan sebagai koreksi dengan nama kunci sebagai penulis. Kirim setiap catatan sekali: catatan yang sama dikirim dua kali muncul dua kali dalam lembar waktu, dan manajer harus menghapus salah satunya.
• Webhook ditandatangani dengan rahasia (HMAC-SHA256 pada header X-Hr-Signature). Pengiriman gagal dicoba ulang sekitar sehari; webhook yang gagal 20 kali berturut-turut dinonaktifkan sampai diaktifkan kembali.
• Belum diuji terhadap endpoint nyata: pengiriman webhook hanya diuji dalam lingkungan pengujian kami. Uji dengan sistem sendiri sebelum mengandalkannya.
• Pembuatan dan pencabutan kunci, serta setiap catatan waktu yang dikirim, ditulis ke log aktivitas.
• Untuk pengembang, referensi teknis ditautkan dari halaman: Baca cara memanggilnya.