Perangkat Kiosk Absensi - Dokumentasi Zayeen

Dipakai Oleh

Admin HR, admin IT, dan penanggung jawab kiosk

Jenis Data

master

Kunci Pencarian

ID, Nama, Grup Karyawan, Lokasi

Kapan Form Ini Dipakai

Saat perusahaan membuat device kiosk baru untuk cabang, lobi, gerbang, toko, atau gudang tertentu.
Saat mode verifikasi device berubah dari photo_only ke face_api atau webhook.
Saat admin perlu mengatur PIN proteksi untuk ganti device atau keluar dari halaman kiosk.

Sebelum Mengisi

Putuskan lebih dulu device ini akan dipakai di lokasi mana dan apakah satu device dipakai permanen atau berpindah tempat.
Tentukan mode verifikasi yang ingin dipakai: hanya foto, browser face API, atau webhook ke engine eksternal.
Jika memakai webhook, siapkan konfigurasi teknis yang dibutuhkan untuk field Engine Config.

Alur Pengaturan

Buka menu SDM & Payroll / Pengaturan / Perangkat Kiosk Absensi.
Tambahkan record baru untuk setiap device atau lokasi kiosk yang ingin dipisahkan.
Isi nama device, cakupan karyawan, dan lokasi agar mudah dikenali saat user memilih device di halaman kiosk.
Pilih Penyedia Engine sesuai kebutuhan verifikasi.
Isi Admin PIN untuk proteksi ganti device dan keluar kiosk.
Aktifkan opsi scan kamera jika device ingin dipakai untuk scan QR / barcode employee ID.
Gunakan Informasi Tambahan bila kiosk perlu menampilkan instruksi cabang, pengumuman, atau catatan antrean pada panel samping.
Simpan, lalu gunakan id device ini sebagai query ?deviceid=... pada halaman kiosk.

Field yang Perlu Diperhatikan

Field	Penjelasan Untuk Pengguna	Status
ID `id`	Nomor otomatis device. Dipakai oleh query `deviceid` saat membuka halaman kiosk.	Otomatis
Nama `name`	Nama device yang tampil saat memilih kiosk. Gunakan nama yang mudah dibedakan, misalnya “Front Office 1” atau “Gate Gudang”.	Wajib
Grup Karyawan `employeegroup`	Filter grup karyawan yang boleh memakai kiosk ini. Gunakan bila satu kiosk hanya melayani grup atau tim tertentu.	Opsional
Lokasi `locationname`	Nama lokasi fisik agar admin tahu device ini dipasang di titik mana.	Opsional
Latitude / Longitude `latitude`, `longitude`	Titik lokasi device jika perusahaan ingin menyimpan referensi posisi perangkat.	Opsional
Penyedia Engine `engineprovider`	Menentukan apakah device memakai `photo_only`, `face_api`, atau `webhook`.	Wajib
Admin PIN `adminpin`	PIN untuk proteksi ganti device dan keluar halaman kiosk. Default awal adalah `0000`, tetapi sebaiknya segera diganti.	Disarankan
Scan ID dengan Kamera `scanidwithcamera`	Aktifkan jika device kiosk perlu memindai QR code / barcode dari kamera.	Opsional
Izinkan Placeholder Verify `allowplaceholderverify`	Gunakan hanya bila implementasi membutuhkan fallback verifikasi terbatas pada device yang belum bisa menjalankan alur face verification normal.	Opsional
Aktif `isactive`	Hanya device aktif yang boleh dipakai di kiosk.	Wajib
Engine Config `engineconfig`	Konfigurasi tambahan untuk engine, terutama jika memakai mode `webhook`.	Opsional
Informasi Tambahan `additionalinfo`	HTML tambahan yang ditampilkan pada panel samping kiosk, misalnya pengumuman cabang, aturan antrean, pengingat seragam, atau kontak bantuan.	Opsional
Catatan `notes`	Catatan internal admin tentang device, lokasi, atau integrasi teknis.	Opsional

Panduan Memilih Penyedia Engine

photo_only: paling sederhana, hanya menyimpan foto proof. Cocok untuk implementasi cepat dan biaya rendah.
face_api: cocok jika ingin face matching langsung di browser dan sudah menyiapkan proses face enrollment.
webhook: cocok jika perusahaan punya engine recognition sendiri atau vendor eksternal yang menerima request verifikasi.

Catatan Operasional

Satu lokasi sebaiknya punya satu record device yang jelas agar log verifikasi dan log absensi tidak tercampur.
Jangan biarkan Admin PIN tetap 0000 untuk device yang sudah dipakai produksi.
Jika field PIN dikosongkan saat edit, sistem mempertahankan PIN lama. Jadi perubahan PIN harus diisi secara eksplisit.
Halaman kiosk dapat menampilkan HTML informasi tambahan persis seperti yang diisi di sini, jadi gunakan markup yang sederhana dan tetap nyaman dibaca di layar kecil.
Device yang tidak aktif tetap ada di master, tetapi tidak boleh dipakai untuk proses kiosk.

Masalah Umum

Halaman kiosk tidak menemukan device: cek query deviceid dan pastikan ID device memang ada di master ini.
Verifikasi wajah gagal terus: cek mode engine, template wajah karyawan, dan apakah camera permission browser sudah benar.
Tombol scan QR tidak muncul: aktifkan Scan ID dengan Kamera di master device.
User bebas ganti device: periksa apakah Admin PIN sudah terisi dan user tahu PIN lama.

Lokasi Menu

SDM & Payroll / Pengaturan / Perangkat Kiosk Absensi
/form/attendancekioskdevice